{"id":15442546,"url":"https://github.com/jaldekoa/nyfedapi","last_synced_at":"2026-02-08T20:34:37.920Z","repository":{"id":257780788,"uuid":"859997508","full_name":"Jaldekoa/nyfedapi","owner":"Jaldekoa","description":"A Python wrapper to easily retrieve data from the Federal Reserve Bank of New York (FRBoNY) official API  in pandas format.","archived":false,"fork":false,"pushed_at":"2024-09-19T19:56:50.000Z","size":42,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-26T04:03:28.832Z","etag":null,"topics":["api","api-wrapper","banking","data","finance","pandas","python","united-states"],"latest_commit_sha":null,"homepage":"https://dineroybanca.substack.com","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Jaldekoa.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-09-19T16:28:37.000Z","updated_at":"2025-02-18T02:05:26.000Z","dependencies_parsed_at":null,"dependency_job_id":"8116b457-436d-4b0e-8ab7-b61d83e8fc18","html_url":"https://github.com/Jaldekoa/nyfedapi","commit_stats":null,"previous_names":["jaldekoa/nyfedapi"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/Jaldekoa/nyfedapi","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jaldekoa%2Fnyfedapi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jaldekoa%2Fnyfedapi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jaldekoa%2Fnyfedapi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jaldekoa%2Fnyfedapi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Jaldekoa","download_url":"https://codeload.github.com/Jaldekoa/nyfedapi/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jaldekoa%2Fnyfedapi/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":269813749,"owners_count":24479341,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-10T02:00:08.965Z","response_time":71,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","api-wrapper","banking","data","finance","pandas","python","united-states"],"created_at":"2024-10-01T19:28:29.289Z","updated_at":"2026-02-08T20:34:37.855Z","avatar_url":"https://github.com/Jaldekoa.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# nyfedapi\nThis repository contains a Python wrapper to easily retrieve data from the Federal Reserve Bank of New York (FRBoNY) official API in pandas format.\n\n## Overview\nThe Markets Data APIs are provided to external users and applications to request data from the Federal Reserve Bank of New York. FRBoNY's API does not require tokens or registration, so feel free to use it immediately.\n\nThere are ten databases with their endpoints that the FRBoNY has exposed to the public:\n\n- Agency Mortgage-Backed Securities Operations\n- Central Bank Liquidity Swaps Operations\n- Guide Sheets\n- Primary Dealer Statistics\n- Primary Dealer Statistics Market Share\n- Reference Rates\n- Repo and Reverse Repo Operations\n- Securities Lending Operations\n- System Open Market Account Holdings\n- Treasury Securities Operations\n\n## Requirements\n- Python 3.9 or higher.\n- Requests\n- Pandas\n\n## Installation\n```terminal\npip install nyfedapi\n```\n\n## Agency Mortage-Backed Securities Operations\n\n### ambs.latest\nReturns the latest AMBS operation Announcements or Results for the current day.\n\n```python\nfrom nyfedapi import ambs\ndf = ambs.latest(operation, status, include)\n```\n\n#### Parameters\n| Parameter   | Type  | Description                                                                         |\n|-------------|-------|-------------------------------------------------------------------------------------|\n| `operation` | `str` | The operation type. Available values: [\"all\", \"purchases\", \"sales\", \"roll\", \"swap\"] |\n| `status`    | `str` | The operation status. Available values: [\"announcements\", \"results\"]                |\n| `include`   | `str` | The level of details to include. Available values: [\"summary\", \"details\"]           |\n\n#### Returns\n- `pd.DataFrame`: A DataFrame containing the latest AMBS operation announcements or results for the current day.\n\n\n### ambs.results_last_two_weeks\nReturns the last two weeks AMBS operations Results.\n\n```python\nfrom nyfedapi import ambs\ndf = ambs.results_last_two_weeks(operation, include)\n```\n\n#### Parameters\n| Parameter   | Type  | Description                                                                         |\n|-------------|-------|-------------------------------------------------------------------------------------|\n| `operation` | `str` | The operation type. Available values: [\"all\", \"purchases\", \"sales\", \"roll\", \"swap\"] |\n| `include`   | `str` | The level of details to include. Available values: [\"summary\", \"details\"]           |\n\n#### Returns\n- `pd.DataFrame`: A DataFrame containing the last two weeks AMBS operations results.\n\n\n### ambs.results_last_number\nReturns the last N number of AMBS operations Results.\n\n```python\nfrom nyfedapi import ambs\ndf = ambs.results_last_two_weeks(operation, include, number)\n```\n\n#### Parameters\n| Parameter   | Type  | Description                                                                         |\n|-------------|-------|-------------------------------------------------------------------------------------|\n| `operation` | `str` | The operation type. Available values: [\"all\", \"purchases\", \"sales\", \"roll\", \"swap\"] |\n| `include`   | `str` | The level of details to include. Available values: [\"summary\", \"details\"]           |\n| `number`    | `int` | The last N amount of operations to return.                                          |\n\n#### Returns\n- `pd.DataFrame`: A DataFrame containing the last N number of AMBS operations results.\n\n\n### ambs.results_search\nReturns AMBS operations Results.\n\n```python\nfrom nyfedapi import ambs\ndf = ambs.results_search(operation, include, **kwargs)\n```\n\n#### Parameters\n| Parameter    | Type  | Description                                                                                                                  |\n|--------------|-------|------------------------------------------------------------------------------------------------------------------------------|\n| `operation`  | `str` | The operation type. Available values: [\"all\", \"purchases\", \"sales\", \"roll\", \"swap\"]                                          |\n| `include`    | `str` | The level of details to include. Available values: [\"summary\", \"details\"]                                                    |\n| `start_date` | `str` | The start date (inclusive) from which to search. Format YYYY-MM-DD.                                                          |\n| `end_date`   | `str` | The end date (inclusive) up until which to search. Format YYYY-MM-DD.                                                        |\n| `securities` | `str` | Filter by securities (Operation Method). Available values: [\"Basket\", \"Coupon Swap\", \"Dollar Roll\", \"Specified Pool\", \"TBA\"] |\n| `cusip`      | `str` | Only return operations which include the given CUSIP. Partial identifiers are accepted.                                      |\n| `desc`       | `str` | Only return operations which include the given Security Description. Partial identifiers are accepted.                       |\n\n\n#### Returns\n- `pd.DataFrame`: A DataFrame containing the AMBS operations results.\n\n\n## Central Bank Liquidity Swaps Operations\n\n### fxs.latest\nReturns the latest Liquidity Swaps operation Results posted on current day.\n\n```python\nfrom nyfedapi import fxs\ndf = fxs.latest(operation_type)\n```\n\n#### Parameters\n| Parameter        | Type  | Description                                                                              |\n|------------------|-------|------------------------------------------------------------------------------------------|\n| `operation_type` | `str` | The operation type to search for. Available values: [\"all\", \"usdollar\", \"nonusdollar\"]   |\n\n#### Returns\n- `pd.DataFrame`: A DataFrame containing the latest Liquidity Swaps operation results posted on current day.\n\n\n### fxs.last_number\nReturns the last N number of Liquidity Swaps operations Results.\n\n```python\nfrom nyfedapi import fxs\ndf = fxs.last_number(operation_type, number)\n```\n\n#### Parameters\n| Parameter        | Type  | Description                                                                            |\n|------------------|-------|----------------------------------------------------------------------------------------|\n| `operation_type` | `str` | The operation type to search for. Available values: [\"all\", \"usdollar\", \"nonusdollar\"] |\n| `number`         | `int` | The last N amount of trades to return                                                  |\n\n#### Returns\n- `pd.DataFrame`: A DataFrame containing the last N number of Liquidity Swaps operations results.\n\n\n### fxs.search\nReturns Liquidity Swaps operation Results.\n\n```python\nfrom nyfedapi import fxs\ndf = fxs.search(operation_type, **kwargs)\n```\n\n#### Parameters\n| Parameter        | Type  | Description                                                                            |\n|------------------|-------|----------------------------------------------------------------------------------------|\n| `operation_type` | `str` | The operation type to search for. Available values: [\"all\", \"usdollar\", \"nonusdollar\"] |\n| `start_date`     | `str` | The start date (inclusive) from which to search, depending on date type. Defaults to current date. Format YYYY-MM-DD. |\n| `end_date`       | `str` | The end date (inclusive) up until which to search, depending on date type.  Format YYYY-MM-DD. |\n| `date_type`      | `str` | The date type to search for within the start and end. Defaults to trade date. Available values : [\"trade\", \"maturity\"] |\n| `counterparties` | `str` | A comma-separated list of counterparty names to search for. Partial names are accepted. |\n\n#### Returns\n- `pd.DataFrame`: A DataFrame containing Liquidity Swaps operation Results.\n\n\n### fxs.counterparties\nReturns Counterparties of Liquidity Swaps operations.\n\n```python\nfrom nyfedapi import fxs\ndf = fxs.counterparties()\n```\n\n#### Returns\n- `pd.DataFrame`: A DataFrame containing counterparties of Liquidity Swaps operations.\n\n\n## Guide Sheets\n\n### guidesheets.latest\nReturns the latest Guide Sheet. Work in Progress (WIP).\n\n```python\nfrom nyfedapi import guidesheets\ndf = guidesheets.latest()\n```\n\n#### Parameters\n| Parameter        | Type  | Description                                                |\n|------------------|-------|------------------------------------------------------------|\n| `guidesheet_type` | `str` | The guide sheet type. Available values: [\"si\", \"wi\", \"fs\"] |\n\n#### Returns\n- `pd.DataFrame`: A DataFrame containing the latest Guide Sheet.\n\n\n### guidesheets.previous\nReturns the previous Guide Sheet. Work in Progress (WIP).\n\n```python\nfrom nyfedapi import guidesheets\ndf = guidesheets.previous()\n```\n\n#### Parameters\n| Parameter        | Type  | Description                                                |\n|------------------|-------|------------------------------------------------------------|\n| `guidesheet_type` | `str` | The guide sheet type. Available values: [\"si\", \"wi\", \"fs\"] |\n\n#### Returns\n- `pd.DataFrame`: A DataFrame containing the latest Guide Sheet.\n\n\n## Primary Dealer Statistics\n\n### pd.latest\nReturns the latest Survey results for each timeseries.\n\n```python\nfrom nyfedapi import pd\ndf = pd.latest()\n```\n\n#### Parameters\n| Parameter     | Type  | Description                 |\n|---------------|-------|-----------------------------|\n| `seriesbreak` | `str` | A valid series break value. |\n\n#### Returns\n- `pd.DataFrame`: A DataFrame containing the latest Survey results for each timeseries.\n\n\n### pd.get_all_timeseries\nReturns all Survey results.\n\n```python\nfrom nyfedapi import pd\ndf = pd.get_all_timeseries()\n```\n\n#### Returns\n- `pd.DataFrame`: A DataFrame containing all Survey results.\n\n\n### pd.list_timeseries\nReturns Description of timeseries/keyids.\n\n```python\nfrom nyfedapi import pd\ndf = pd.list_timeseries()\n```\n\n#### Returns\n- `pd.DataFrame`: A DataFrame containing description of timeseries/keyids.\n\n\n### pd.list_asof\nReturns all As Of Dates with respective Series Break.\n\n```python\nfrom nyfedapi import pd\ndf = pd.list_asof()\n```\n\n#### Returns\n- `pd.DataFrame`: A DataFrame containing all as of dates with respective series break.\n\n\n### pd.list_seriesbreaks\nReturns Series Breaks including Label, Start and End Date.\n\n```python\nfrom nyfedapi import pd\ndf = pd.list_seriesbreaks()\n```\n\n#### Returns\n- `pd.DataFrame`: A DataFrame containing series breaks including label, start and end date.\n\n\n### pd.get_asof\nReturns single date Survey results.\n\n```python\nfrom nyfedapi import pd\ndf = pd.get_asof()\n```\n\n#### Parameters\n| Parameter | Type  | Description                                    |\n|-----------|-------|------------------------------------------------|\n| `date`    | `str` | The time series as of date. Format YYYY-MM-DD. |\n\n#### Returns\n- `pd.DataFrame`: A DataFrame containing single date survey results.\n\n\n### pd.get_timeseries\nReturn Survey results for given timeseries across all Series Breaks. To query multiple timeseries, separate each with underscore(_).\n\n```python\nfrom nyfedapi import pd\ndf = pd.get_timeseries()\n```\n\n#### Parameters\n| Parameter    | Type  | Description                                         |\n|--------------|-------|-----------------------------------------------------|\n| `timeseries` | `str` | A list of time series ids separated by underscores. |\n\n#### Returns\n- `pd.DataFrame`: A DataFrame containing survey results for given timeseries across all series breaks.\n\n\n### pd.get_seriesbreaks_timeseries\nReturn Survey results for given timeseries across all Series Breaks. To query multiple timeseries, separate each with underscore(_).\n\n```python\nfrom nyfedapi import pd\ndf = pd.get_seriesbreaks_timeseries()\n```\n\n#### Parameters\n| Parameter      | Type  | Description                                         |\n|----------------|-------|-----------------------------------------------------|\n| `seriesbreaks` | `str` | A valid series break value. |\n| `timeseries`   | `str` | A list of valid time series separated with underscores. |\n\n#### Returns\n- `pd.DataFrame`: A DataFrame containing survey results for given timeseries across all series breaks.\n\n\n## Primary Dealer Statistics Market Share\n\n### marketshare.qtrly_latest\nReturns the latest quarterly Market Share.\n\n```python\nfrom nyfedapi import marketshare\ndf = marketshare.qtrly_latest()\n```\n\n#### Returns\n- `pd.DataFrame`: A DataFrame containing the latest quarterly market share.\n\n\n### marketshare.ytd_latest\n\nReturns the latest year-to-date Market Share.\n\n```python\nfrom nyfedapi import marketshare\ndf = marketshare.ytd_latest()\n```\n\n#### Returns\n- `pd.DataFrame`: A DataFrame containing the latest year-to-date market share.\n\n\n## Reference Rates\n\n### rates.all_latest\nReturns the latest secured and unsecured rates.\n\n```python\nfrom nyfedapi import rates\ndf = rates.all_latest()\n```\n\n#### Returns\n- `pd.DataFrame`: A DataFrame containing the latest secured and unsecured rates.\n\n\n### rates.all_search\nReturns the latest secured and unsecured rates.\n\n```python\nfrom nyfedapi import rates\ndf = rates.all_search()\n```\n\n#### Parameters\n| Parameter    | Type  | Description                                                                                       |\n|--------------|-------|---------------------------------------------------------------------------------------------------|\n| `start_date` | `str` | The start date (inclusive) from which to search. Defaults to the current date. Format YYYY-MM-DD. |\n| `end_date`   | `str` | The end date (inclusive) up until which to search. Format YYYY-MM-DD.                             |\n| `type`       | `str` | The report type to return. Available values : [\"rate\", \"volume\"]                                                                       |\n\n#### Returns\n- `pd.DataFrame`: A DataFrame containing the latest secured and unsecured rates.\n\n\n### rates.secured_all_latest\nReturns the latest secured rates.\n\n```python\nfrom nyfedapi import rates\ndf = rates.secured_all_latest()\n```\n\n#### Returns\n- `pd.DataFrame`: A DataFrame containing the latest secured rates.\n\n\n### rates.secured_last_number\nReturns the last N number of secured rates.\n\n```python\nfrom nyfedapi import rates\ndf = rates.secured_last_number(rate_type, number)\n```\n\n#### Parameters\n| Parameter   | Type  | Description                                                          |\n|-------------|-------|----------------------------------------------------------------------|\n| `rate_type` | `str` | The rate type. Available values : [\"tgcr\", \"bgcr\", \"sofr\", \"sofrai\"] |\n| `number`    | `int` | The last N amount of rates to return.                                |\n\n#### Returns\n- `pd.DataFrame`: A DataFrame containing the last N number of secured rates.\n\n\n### rates.secured_search\nReturns secured rates and/or volume.\n\n```python\nfrom nyfedapi import rates\ndf = rates.secured_search(rate_type, **kwargs)\n```\n\n#### Parameters\n| Parameter    | Type  | Description                                                                                      |\n|--------------|-------|--------------------------------------------------------------------------------------------------|\n| `rate_type`  | `str` | The rate type. Available values : [\"all\", \"tgcr\", \"bgcr\", \"sofr\", \"sofrai\"]                      |\n| `start_date` | `str` | The start date (inclusive) from which to search. Defaults to the current date. Format YYYY-MM-DD |\n| `end_date`   | `str` | The end date (inclusive) up until which to search. Format YYYY-MM-DD                             |\n| `type`  | `str` | The report type to return. Available values : [\"rate\", \"volume\"]                                 |\n\n#### Returns\n- `pd.DataFrame`: A DataFrame containing secured rates and/or volume.\n\n\n### rates.unsecured_all_latest\nReturns the latest unsecured rates.\n\n```python\nfrom nyfedapi import rates\ndf = rates.unsecured_all_latest()\n```\n\n#### Returns\n- `pd.DataFrame`: A DataFrame containing the latest unsecured rates.\n\n\n### rates.unsecured_last_number\nReturns the last N number of unsecured rates.\n\n```python\nfrom nyfedapi import rates\ndf = rates.unsecured_last_number(rate_type, number)\n```\n\n#### Parameters\n| Parameter   | Type  | Description                                         |\n|-------------|-------|-----------------------------------------------------|\n| `rate_type` | `str` | The rate type. Available values : [\"effr\", \"obfr\"]  |\n| `number`    | `int` | The last N amount of rates to return.               |\n\n#### Returns\n- `pd.DataFrame`: A DataFrame containing the last N number of unsecured rates.\n\n\n### rates.unsecured_search\nReturns unsecured rates and/or volume.\n\n```python\nfrom nyfedapi import rates\ndf = rates.unsecured_search(rate_type, **kwargs)\n```\n\n#### Parameters\n| Parameter    | Type  | Description                                                                                       |\n|--------------|-------|---------------------------------------------------------------------------------------------------|\n| `rate_type`  | `str` | The rate type. Available values : [\"all\", \"efr\", \"obfr\"]                                          |\n| `start_date` | `str` | The start date (inclusive) from which to search. Defaults to the current date. Format YYYY-MM-DD. |\n| `end_date`   | `str` | The end date (inclusive) up until which to search. Format YYYY-MM-DD.                             |\n| `type`  | `str` | The report type to return. Available values : [\"rate\", \"volume\"]                                  |\n\n#### Returns\n- `pd.DataFrame`: A DataFrame containing unsecured rates and/or volume.\n\n\n## Repo and Reverse Repo Operations\n\n### rp.latest\nReturns the latest Repo and/or Reverse Repo operations Announcements or Results for the current day.\n\n```python\nfrom nyfedapi import rp\ndf = rp.latest(operation_type, method, status)\n```\n\n#### Parameters\n| Parameter        | Type  | Description                                                                     |\n|------------------|-------|---------------------------------------------------------------------------------|\n| `operation_type` | `str` | The operation type. Available values : [\"all\", \"repo\", \"reverserepo\"]           |\n| `method`         | `str` | The operation method. Available values : [\"all\", \"fixed\", \"single\", \"multiple\"] |\n| `status`         | `str` | The operation status. Available values : [\"announcements\", \"results\"]           |\n\n#### Returns\n- `pd.DataFrame`: A DataFrame containing the latest repo and/or reverse repo operations announcements or results for the current day.\n\n\n### rp.results_last_two_weeks\nReturns the last two weeks Repo and/or Reverse Repo operations Results.\n\n```python\nfrom nyfedapi import rp\ndf = rp.results_last_two_weeks(operation_type, method)\n```\n\n#### Parameters\n| Parameter        | Type  | Description                                                                     |\n|------------------|-------|---------------------------------------------------------------------------------|\n| `operation_type` | `str` | The operation type. Available values : [\"all\", \"repo\", \"reverserepo\"]           |\n| `method`         | `str` | The operation method. Available values : [\"all\", \"fixed\", \"single\", \"multiple\"] |\n\n#### Returns\n- `pd.DataFrame`: A DataFrame containing the last two weeks repo and/or reverse repo operations results.\n\n\n### rp.results_last_number\nReturns the last N number of Repo and/or Reverse Repo operations Results.\n\n```python\nfrom nyfedapi import rp\ndf = rp.results_last_number(operation_type, method, number)\n```\n\n#### Parameters\n| Parameter        | Type  | Description                                                                    |\n|------------------|-------|--------------------------------------------------------------------------------|\n| `operation_type` | `str` | The operation type. Available values : [\"all\", \"repo\", \"reverserepo\"]          |\n| `method`         | `str` | The operation method. Available values : [\"all\", \"fixed\", \"single\", \"multiple\"] |\n| `number`         | `int` | The last N amount of operations to return. |\n\n#### Returns\n- `pd.DataFrame`: A DataFrame containing the last N number of repo and/or reverse repo operations results.\n\n\n### rp.results_search\nReturns Repo and/or Reverse Repo operation Results.\n\n```python\nfrom nyfedapi import rp\ndf = rp.results_search(**kwargs)\n```\n\n#### Parameters\n| Parameter         | Type  | Description                                                                                                                                                                      |\n|-------------------|-------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `start_date`      | `str` | The start date (inclusive) from which to search. Format YYYY-MM-DD.                                                                                                              |\n| `end_date`        | `str` | The end date (inclusive) up until which to search. Format YYYY-MM-DD.                                                                                                            |\n| `operation_types` | `str` | The operation types (comma-delimited) by which to filter. Available values : [\"Repo\", \"Reverse Repo\"]                                                                                  |\n| `method`          | `str` | The operation method by which to filter. Available values : [\"multiple\", \"single\", \"fixed\"]                                                                                      |\n| `security_type`   | `str` | The security type (tranche) by which to filter. For specific types, only operations which include that type will be returned. Available values : [\"mbs\", \"agency\", \"tsy\", \"srf\"] |\n| `term`            | `str` | The term of the operation. Available values : [\"overnight\", \"term\"]                                                                                                              |\n\n#### Returns\n- `pd.DataFrame`: A DataFrame containing repo and/or reverse repo operation results.\n\n\n### rp.reverserepo_propositions_search\nReturns Propositions for Reverse Repo operations.\n\n```python\nfrom nyfedapi import rp\ndf = rp.reverserepo_propositions_search(**kwargs)\n```\n\n#### Parameters\n| Parameter         | Type  | Description                                                                                                                                                                      |\n|-------------------|-------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `start_date`      | `str` | The start date (inclusive) from which to search. Format YYYY-MM-DD.                                                                                                              |\n| `end_date`        | `str` | The end date (inclusive) up until which to search. Format YYYY-MM-DD.                                                                                                            |\n\n#### Returns\n- `pd.DataFrame`: A DataFrame containing propositions for reverse repo operations.\n\n\n## Securities Lending Operations\n\n### seclending.results_latest\nReturns the latest Securities Lending operation Results for the current day.\n\n```python\nfrom nyfedapi import seclending\ndf = seclending.results_latest(operation, include)\n```\n\n#### Parameters\n| Parameter   | Type  | Description                                                                                                                                                                      |\n|-------------|-------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `operation` | `str` | The operation type. Available values : [\"all\", \"seclending\", \"extensions\"].                                                                                                              |\n| `include`   | `str` | The level of details to include. Available values : [\"summary\", \"details\"].                                                                                                            |\n\n#### Returns\n- `pd.DataFrame`: A DataFrame containing the latest securities lending operation results for the current day.\n\n\n### seclending.results_last_two_weeks\nReturns the last two weeks Securities Lending operation Results and/or Extensions.\n\n```python\nfrom nyfedapi import seclending\ndf = seclending.results_last_two_weeks(operation, include)\n```\n\n#### Parameters\n| Parameter   | Type  | Description                                                                                                                                                                      |\n|-------------|-------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `operation` | `str` | The operation type. Available values : [\"all\", \"seclending\", \"extensions\"].                                                                                                              |\n| `include`   | `str` | The level of details to include. Available values : [\"summary\", \"details\"].                                                                                                            |\n\n#### Returns\n- `pd.DataFrame`: A DataFrame containing the last two weeks securities lending operation results and/or extensions.\n\n\n### seclending.results_last_number\nReturns the last N number of Securities Lending operation Results and/or Extensions.\n\n```python\nfrom nyfedapi import seclending\ndf = seclending.results_last_number(operation, include, number)\n```\n\n#### Parameters\n| Parameter   | Type  | Description                                                                                                                                                                      |\n|-------------|-------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `operation` | `str` | The operation type. Available values : [\"all\", \"seclending\", \"extensions\"].                                                                                                              |\n| `include`   | `str` | The level of details to include. Available values : [\"summary\", \"details\"].                                                                                                            |\n| `number`    | `int` | The last N amount of operations to return.                                                                                                            |\n\n#### Returns\n- `pd.DataFrame`: A DataFrame containing the last N number of securities lending operation results and/or extensions.\n\n\n### seclending.results_search\nReturns Securities Lending operation Results and/or Extensions.\n\n```python\nfrom nyfedapi import seclending\ndf = seclending.results_search(operation, include)\n```\n\n#### Parameters\n| Parameter   | Type  | Description                                                                                                                                                                      |\n|-------------|-------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `operation` | `str` | The operation type. Available values : [\"all\", \"seclending\", \"extensions\"].                                                                                                              |\n| `include`   | `str` | The level of details to include. Available values : [\"summary\", \"details\"].                                                                                                            |\n\n#### Returns\n- `pd.DataFrame`: A DataFrame containing securities lending operation results and/or extensions.\n\n\n## System Open Market Account Holdings\n\n### soma.asofdates_latest\nReturns the latest SOMA holdings As Of Date.\n\n```python\nfrom nyfedapi import soma\ndf = soma.asofdates_latest()\n```\n\n#### Returns\n- `pd.DataFrame`: A DataFrame containing the latest SOMA holdings As Of Date.\n\n\n### soma.summary\nReturns Summary Of SOMA holdings for each As of Date and holding type.\n\n```python\nfrom nyfedapi import soma\nndf = soma.summary()\n```\n\n#### Returns\n- `pd.DataFrame`: A DataFrame containing summary of SOMA holdings for each as of date and holding type.\n\n\n### soma.asofdates_list\nReturns all SOMA holdings As of Date.\n\n```python\nfrom nyfedapi import soma\ndf = soma.asofdates_list()\n```\n\n#### Returns\n- `pd.DataFrame`: A DataFrame containing all SOMA holdings as of date.\n\n\n### soma.agency_get_release_log\nReturns the last three months Agency Release and As Of Dates.\n\n```python\nfrom nyfedapi import soma\ndf = soma.agency_get_release_log()\n```\n\n#### Returns\n- `pd.DataFrame`: A DataFrame containing the last three months Agency release and as of dates.\n\n\n### soma.agency_get_asof\nReturns a single date SOMA Agency Holdings.\n\n```python\nfrom nyfedapi import soma\ndf = soma.agency_get_asof(date)\n```\n\n#### Parameters\n| Parameter | Type  | Description                                                                 |\n|-----------|-------|-----------------------------------------------------------------------------|\n| `date`    | `str` | The date for which to retrieve the agency release. Format YYYY-MM-DD.       |\n\n#### Returns\n- `pd.DataFrame`: A DataFrame containing a single date SOMA Agency holdings.\n\n\n### soma.agency_get_cusip\nReturns all SOMA Agency Holdings for a single CUSIP.\n\n```python\nfrom nyfedapi import soma\ndf = soma.agency_get_cusip(cusip)\n```\n\n#### Parameters\n| Parameter | Type  | Description                                                                 |\n|----------|-------|-----------------------------------------------------------------------------|\n| `cusip`  | `str` | The CUSIP for which to retrieve information.       |\n\n#### Returns\n- `pd.DataFrame`: A DataFrame containing all SOMA Agency Holdings for a single CUSIP.\n\n\n### soma.agency_get_holdingtype_asof\nReturns a single date SOMA Agency Holdings for a Agency holding type.\n\n```python\nfrom nyfedapi import soma\ndf = soma.agency_get_holdingtype_asof(holding_type, date)\n```\n\n#### Parameters\n| Parameter      | Type  | Description                                                                                     |\n|----------------|-------|-------------------------------------------------------------------------------------------------|\n| `holding_type` | `str` | The holding type for which to retrieve. Available values: [\"all\", \"agency debts\", \"mbs\", \"cmb\"] |\n| `date`         | `str` | The date for which to retrieve the agency release. Format YYYY-MM-DD.                           |\n\n#### Returns\n- `pd.DataFrame`: A DataFrame containing a single date SOMA Agency holdings for a Agency holding type.\n\n\n### soma.agency_wam_asof\nReturns a single date Weighted Average Maturity for Agency Debt.\n\n```python\nfrom nyfedapi import soma\ndf = soma.agency_wam_asof(date)\n```\n\n#### Parameters\n| Parameter      | Type  | Description                                                                                     |\n|----------------|-------|-------------------------------------------------------------------------------------------------|\n| `date`         | `str` | The date for which to retrieve the Weighted Average Maturity number. Format YYYY-MM-DD.                           |\n\n#### Returns\n- `pd.DataFrame`: A DataFrame containing a single date Weighted Average Maturity for Agency Debt.\n\n\n### soma.tsy_get_release_log\nReturns the last three months Treasury Release and As Of Dates.\n\n```python\nfrom nyfedapi import soma\ndf = soma.tsy_get_release_log()\n```\n\n#### Returns\n- `pd.DataFrame`: A DataFrame containing the last three months Treasury release and as of dates.\n\n\n### soma.tsy_get_asof\nReturns a single date SOMA Treasury Holdings.\n\n```python\nfrom nyfedapi import soma\ndf = soma.tsy_get_asof(date)\n```\n\n#### Parameters\n| Parameter | Type  | Description                                                             |\n|-----------|-------|-------------------------------------------------------------------------|\n| `date`    | `str` | The date for which to retrieve the treasury release. Format YYYY-MM-DD. |\n\n#### Returns\n- `pd.DataFrame`: A DataFrame containing a single date SOMA Treasury holdings.\n\n\n### soma.tsy_get_cusip\nReturns all SOMA Treasury Holdings for a single CUSIP.\n\n```python\nfrom nyfedapi import soma\ndf = soma.tsy_get_cusip(cusip)\n```\n\n#### Parameters\n| Parameter | Type  | Description                                                                 |\n|----------|-------|-----------------------------------------------------------------------------|\n| `cusip`  | `str` | The CUSIP for which to retrieve information.       |\n\n#### Returns\n- `pd.DataFrame`: A DataFrame containing all SOMA Treasury Holdings for a single CUSIP.\n\n\n### soma.tsy_get_holdingtype_asof\nReturns a single date SOMA Treasury Holdings for a Treasury holding type.\n\n```python\nfrom nyfedapi import soma\ndf = soma.tsy_get_holdingtype_asof(holding_type, date)\n```\n\n#### Parameters\n| Parameter      | Type  | Description                                                                                             |\n|----------------|-------|---------------------------------------------------------------------------------------------------------|\n| `holding_type` | `str` | The holding type for which to retrieve. Available values: [\"all\", \"bills\", \"notesbonds\", \"frn\", \"tips\"] |\n| `date`         | `str` | The date for which to retrieve the treasury release. Format YYYY-MM-DD.                                 |\n\n#### Returns\n- `pd.DataFrame`: A DataFrame containing a single date SOMA Treasury Holdings for a Treasury holding type.\n\n\n### soma.tsy_wam_holdingtype_asof\nReturns a single date Weighted Average Maturity for a Treasury holding type.\n\n```python\nfrom nyfedapi import soma\nndf = soma.tsy_wam_holdingtype_asof(holding_type, date)\n```\n\n#### Parameters\n| Parameter      | Type  | Description                                                                                             |\n|----------------|-------|---------------------------------------------------------------------------------------------------------|\n| `holding_type` | `str` | The holding type for which to retrieve. Available values: [\"all\", \"bills\", \"notesbonds\", \"frn\", \"tips\"] |\n| `date`         | `str` | The date for which to retrieve the Weighted Average Maturity number. Format YYYY-MM-DD.                 |\n\n#### Returns\n- `pd.DataFrame`: A DataFrame containing a single date Weighted Average Maturity for a Treasury holding type.\n\n\n### soma.tsy_get_monthly\nReturns all SOMA Treasury Holdings at monthly intervals.\n\n```python\nfrom nyfedapi import soma\ndf = soma.tsy_get_monthly()\n```\n\n#### Returns\n- `pd.DataFrame`: A DataFrame containing all SOMA Treasury Holdings at monthly intervals.\n\n\n## Treasury Securities Operations\n\n### tsy.latest\nReturns the latest Treasury operation Announcements or Results for the current day.\n\n```python\nfrom nyfedapi import tsy\ndf = tsy.latest(operation, status, include)\n```\n\n#### Parameters\n| Parameter   | Type  | Description                                                                         |\n|-------------|-------|-------------------------------------------------------------------------------------|\n| `operation` | `str` | The operation type. Available values: [\"all\", \"purchases\", \"sales\"]                 |\n| `status`    | `str` | The operation status. Available values: [\"announcements\", \"results\", \"operations\"\"] |\n| `include`   | `str` | The level of details to include. Available values: [\"summary\", \"details\"]           |\n\n#### Returns\n- `pd.DataFrame`: A DataFrame containing the latest Treasury operation announcements or results for the current day.\n\n\n### tsy.results_last_two_weeks\nReturns the last two weeks Treasury operations Results.\n\n```python\nfrom nyfedapi import tsy\ndf = tsy.results_last_two_weeks(operation, include)\n```\n\n#### Parameters\n| Parameter   | Type  | Description                                                                         |\n|-------------|-------|-------------------------------------------------------------------------------------|\n| `operation` | `str` | The operation type. Available values: [\"all\", \"purchases\", \"sales\"]                 |\n| `include`   | `str` | The level of details to include. Available values: [\"summary\", \"details\"]           |\n\n#### Returns\n- `pd.DataFrame`: A DataFrame containing the last two weeks Treasury operations results.\n\n\n### tsy.results_last_number\nReturns the last N number of Treasury operations Results.\n\n```python\nfrom nyfedapi import tsy\ndf = tsy.results_last_number(operation, include, number)\n```\n\n#### Parameters\n| Parameter   | Type  | Description                                                               |\n|-------------|-------|---------------------------------------------------------------------------|\n| `operation` | `str` | The operation type. Available values: [\"all\", \"purchases\", \"sales\"]       |\n| `include`   | `str` | The level of details to include. Available values: [\"summary\", \"details\"] |\n| `number`    | `int` | The last amount of results to return from current date.                   |\n\n#### Returns\n- `pd.DataFrame`: A DataFrame containing the last N number of Treasury operations Results.\n\n\n### tsy.results_search\nReturns Treasury operation Results.\n\n```python\nfrom nyfedapi import tsy\ndf = tsy.results_search(operation, include)\n```\n\n#### Parameters\n| Parameter   | Type  | Description                                                               |\n|-------------|-------|---------------------------------------------------------------------------|\n| `operation` | `str` | The operation type. Available values: [\"all\", \"purchases\", \"sales\"]       |\n| `include`   | `str` | The level of details to include. Available values: [\"summary\", \"details\"] |\n\n#### Returns\n- `pd.DataFrame`: A DataFrame containing Treasury operation results.\n\n\n## TODO\n- [ ] Add a keyword argument (kwargs) translator. Example: startDate -\u003e start_date\n- [ ] Implement the marketshare and guidesheets endpoints, as they currently do not support CSV format download.\n- [ ]  Issue with ```seclending.results_search()```: Although startDate and endDate are not required, omitting them results in a 404 error with the response: [\"Cannot exceed allowed span of 1 year\"].\n- [ ] Issue with ```ambs.results_search()```: Although startDate and endDate are not required, omitting them results in a 404 error with the response: [\"Cannot exceed allowed span of 2 years\"].\n\n## API Documentation\n- [Markets Data APIs: Federal Reserve Bank of New York (FRBoNY)](https://markets.newyorkfed.org/static/docs/markets-api.html)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjaldekoa%2Fnyfedapi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjaldekoa%2Fnyfedapi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjaldekoa%2Fnyfedapi/lists"}