--- type: "firecrawl-provider" description: "US Treasury Fiscal Data (fiscaldata.treasury.gov): the dataset catalog, filtered rows from any of the ~180 API tables (Debt to the Penny, Daily and Monthly Treasury Statements, auctions, average interest rates, interest expense, gold reserve, rates of exchange, MSPD, ...), latest observations of the headline tables, the release calendar and published report files." use_when: "US Treasury Fiscal Data (fiscaldata.treasury.gov): the dataset catalog, filtered rows from any of the ~180 API tables (Debt to the Penny, Daily and Monthly Treasury Statements, auctions, average interest rates, interest expense, gold reserve, rates of exchange, MSPD, ...), latest observations of the headline tables, the release calendar and published report files." categories: "Public records" capabilities: 5 credits_per_call: 5 --- # US Treasury Fiscal Data on Firecrawl Alexandria US Treasury Fiscal Data (fiscaldata.treasury.gov): the dataset catalog, filtered rows from any of the ~180 API tables (Debt to the Penny, Daily and Monthly Treasury Statements, auctions, average interest rates, interest expense, gold reserve, rates of exchange, MSPD, ...), latest observations of the headline tables, the release calendar and published report files. - Categories: Public records - Category index: [Public records category](https://firecrawl.dev/alexandria/agents/categories/public-records) - Provider key: `fiscaldata-treasury-gov` - Access: Firecrawl credits - Cost: 5 credits per call ## More - [Human guide](https://firecrawl.dev/app/alexandria/fiscaldata-treasury-gov) - [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/fiscaldata-treasury-gov/openapi.json) ## Capabilities - [Data](https://firecrawl.dev/alexandria/agents/providers/fiscaldata-treasury-gov/fiscal-data/data): Rows from one Fiscal Data API table by `endpoint` path (from `datasets`, e.g. v2/accounting/od/debt_to_penny, v1/accounting/dts/operating_cash_balance, v1/accounting/mts/mts_table_4, v1/accounting/od/auctions_query, v1/accounting/od/rates_of_exchange) with optional column selection, eq/lt/lte/gt/gte/in filters, multi-key sort and page_size/cursor pagination. Rows come back exactly as published (strings; the source token 'null' becomes null) with the column labels, data types and formats. The sort is always explicit (default: record_date descending) so pages are stable. Dates in filters are YYYY-MM-DD. An unknown table path is not_found; an unknown column or operator is invalid_input carrying the upstream message. - [Datasets](https://firecrawl.dev/alexandria/agents/providers/fiscaldata-treasury-gov/fiscal-data/datasets): Search the Fiscal Data catalog (56 datasets, ~180 API tables): keyword match over dataset id, title, descriptions, table names and column names, or an exact dataset_id lookup. Each dataset lists its API tables with the `endpoint` path accepted by `data`, row counts, date coverage, update cadence and every column with its published data type. - [Latest](https://firecrawl.dev/alexandria/agents/providers/fiscaldata-treasury-gov/fiscal-data/latest): The newest rows of one headline Fiscal Data table by a friendly name: debt_to_the_penny, dts_operating_cash_balance, dts_deposits_withdrawals, mts_summary, mts_receipts, mts_outlays, mspd_summary, auctions, upcoming_auctions, average_interest_rates, interest_expense, gold_reserve or exchange_rates. Sorted by the table's date column descending, optionally filtered (e.g. exchange_rates for one country_currency_desc). Same row shape as `data`. - [Published reports](https://firecrawl.dev/alexandria/agents/providers/fiscaldata-treasury-gov/fiscal-data/published_reports): Published report files (PDF, XLS, TXT) of one dataset from the Fiscal Data published-files service, e.g. every Daily Treasury Statement PDF (dataset 015-BFS-2014Q1-03) or Monthly Treasury Statement (015-BFS-2014Q1-13): report date, report group and the download URL on fiscaldata.treasury.gov. Optional substring match on the path and report-date range; newest first. not_found when the dataset id is unknown or publishes no files. - [Release calendar](https://firecrawl.dev/alexandria/agents/providers/fiscaldata-treasury-gov/fiscal-data/release_calendar): Scheduled and completed Fiscal Data releases from the release calendar (about the next three months, all datasets): dataset_id, date, Eastern time and whether the release has happened. Filter by dataset_id and/or date range; soonest first. ## 1. Choose this provider when US Treasury Fiscal Data (fiscaldata.treasury.gov): the dataset catalog, filtered rows from any of the ~180 API tables (Debt to the Penny, Daily and Monthly Treasury Statements, auctions, average interest rates, interest expense, gold reserve, rates of exchange, MSPD, ...), latest observations of the headline tables, the release calendar and published report files. ## 2. Minimal request Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls. ```json { "provider": "fiscaldata-treasury-gov", "capability": "fiscal-data/data", "options": { "endpoint": "v2/accounting/od/debt_to_penny", "filter": [ { "field": "record_date", "op": "eq", "value": "2024-01-31" } ] } } ``` ## 3. Add provider options Use only the options needed for the task: - `cursor` (string): next_cursor from the previous page of the same query. Example: `` - `endpoint` (string, required): Table path under /services/api/fiscal_service/, e.g. v2/accounting/od/debt_to_penny (the `endpoint` of a table in `datasets`). Pattern: ^/?v[12](/[a-z0-9_]+){2,5}/?$. Example: `` - `fields` (string[]): Columns to return (record_date is always included). Omitted or null returns every column. Notes: Fiscal Data aggregates rows that become identical when columns are dropped, and sort keys must be among the returned columns (sorting on a dropped column is rejected upstream). Example: `[]` - `filter` (object[]): Clauses are ANDed. Example: `[]` - `page_size` (number): page_size Example: `100` - `sort` (object[]): Sort keys in priority order. Omitted or null sorts by record_date descending (newest first). Example: `[]` ## 4. Request through your preferred interface ### JavaScript ```javascript const result = await firecrawl.scrape({ alexandria: { provider: "fiscaldata-treasury-gov", capability: "fiscal-data/data", options: { endpoint: "v2/accounting/od/debt_to_penny", filter: [ { field: "record_date", op: "eq", value: "2024-01-31", }, ], }, }, }); ``` ### Python ```python result = firecrawl.scrape_alexandria({ "provider": "fiscaldata-treasury-gov", "capability": "fiscal-data/data", "options": { "endpoint": "v2/accounting/od/debt_to_penny", "filter": [ { "field": "record_date", "op": "eq", "value": "2024-01-31" } ] } }) ``` ### cURL ```sh curl https://api.firecrawl.dev/v2/scrape \ -H "Authorization: Bearer $FIRECRAWL_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "alexandria": { "provider": "fiscaldata-treasury-gov", "capability": "fiscal-data/data", "options": { "endpoint": "v2/accounting/od/debt_to_penny", "filter": [ { "field": "record_date", "op": "eq", "value": "2024-01-31" } ] } } }' ``` ### CLI ```sh firecrawl scrape 'fiscaldata-treasury-gov/fiscal-data/data' \ --options '{"endpoint":"v2/accounting/od/debt_to_penny","filter":[{"field":"record_date","op":"eq","value":"2024-01-31"}]}' ``` ### MCP Call the FCX MCP retrieve tool with this object: ```json { "provider": "fiscaldata-treasury-gov", "capability": "fiscal-data/data", "options": { "endpoint": "v2/accounting/od/debt_to_penny", "filter": [ { "field": "record_date", "op": "eq", "value": "2024-01-31" } ] } } ``` Ask for only the returned fields needed by the task. ## 5. Full request shape ```json { "provider": "fiscaldata-treasury-gov", "capability": "fiscal-data/data", "options": { "endpoint": "v2/accounting/od/debt_to_penny", "filter": [ { "field": "record_date", "op": "eq", "value": "2024-01-31" } ] } } ``` ## 6. Response data The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`: ```json { "api_url": "https://api.fiscaldata.treasury.gov/services/api/fiscal_service/v2/accounting/od/debt_to_penny", "count": 1, "endpoint": "v2/accounting/od/debt_to_penny", "fields": [ { "currency": "USD", "data_type": "CURRENCY", "format": "$10.20", "label": "Debt Held by the Public", "name": "debt_held_public_amt" }, { "currency": "USD", "data_type": "CURRENCY", "format": "$10.20", "label": "Intragovernmental Holdings", "name": "intragov_hold_amt" }, { "currency": null, "data_type": "DAY", "format": "DD", "label": "Calendar Day Number", "name": "record_calendar_day" }, { "currency": null, "data_type": "MONTH", "format": "MM", "label": "Calendar Month Number", "name": "record_calendar_month" }, { "currency": null, "data_type": "QUARTER", "format": "Q", "label": "Calendar Quarter Number", "name": "record_calendar_quarter" }, { "currency": null, "data_type": "YEAR", "format": "YYYY", "label": "Calendar Year", "name": "record_calendar_year" }, { "currency": null, "data_type": "DATE", "format": "YYYY-MM-DD", "label": "Record Date", "name": "record_date" }, { "currency": null, "data_type": "QUARTER", "format": "Q", "label": "Fiscal Quarter Number", "name": "record_fiscal_quarter" }, { "currency": null, "data_type": "YEAR", "format": "YYYY", "label": "Fiscal Year", "name": "record_fiscal_year" }, { "currency": null, "data_type": "INTEGER", "format": "10", "label": "Source Line Number", "name": "src_line_nbr" }, { "currency": "USD", "data_type": "CURRENCY", "format": "$10.20", "label": "Total Public Debt Outstanding", "name": "tot_pub_debt_out_amt" } ], "filter": "record_date:eq:2024-01-31", "next_cursor": null, "observed_at_ms": 1790008936959, "page": 1, "page_size": 100, "records": [ { "debt_held_public_amt": "27071861894841.00", "intragov_hold_amt": "7119288507552.64", "record_calendar_day": "31", "record_calendar_month": "01", "record_calendar_quarter": "1", "record_calendar_year": "2024", "record_date": "2024-01-31", "record_fiscal_quarter": "2", "record_fiscal_year": "2024", "src_line_nbr": "1", "tot_pub_debt_out_amt": "34191150402393.64" } ], "sort": "-record_date", "source_url": "https://api.fiscaldata.treasury.gov/services/api/fiscal_service/v2/accounting/od/debt_to_penny?filter=record_date:eq:2024-01-31&sort=-record_date&page%5Bsize%5D=100&page%5Bnumber%5D=1", "total_count": 1, "total_pages": 1 } ``` ## API reference-derived contract The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec. ### Data - Capability: `fiscal-data/data` - Description: Rows from one Fiscal Data API table by `endpoint` path (from `datasets`, e.g. v2/accounting/od/debt_to_penny, v1/accounting/dts/operating_cash_balance, v1/accounting/mts/mts_table_4, v1/accounting/od/auctions_query, v1/accounting/od/rates_of_exchange) with optional column selection, eq/lt/lte/gt/gte/in filters, multi-key sort and page_size/cursor pagination. Rows come back exactly as published (strings; the source token 'null' becomes null) with the column labels, data types and formats. The sort is always explicit (default: record_date descending) so pages are stable. Dates in filters are YYYY-MM-DD. An unknown table path is not_found; an unknown column or operator is invalid_input carrying the upstream message. - Instructions: Any question that needs the actual numbers from a Fiscal Data table. Use `datasets` first when the endpoint path is unknown; use `latest` for the newest rows of a headline table. - Cost: 5 credits per call - Capability file: [Data](https://firecrawl.dev/alexandria/agents/providers/fiscaldata-treasury-gov/fiscal-data/data) Accepted options: - `cursor` (string): next_cursor from the previous page of the same query. Example: `` - `endpoint` (string, required): Table path under /services/api/fiscal_service/, e.g. v2/accounting/od/debt_to_penny (the `endpoint` of a table in `datasets`). Pattern: ^/?v[12](/[a-z0-9_]+){2,5}/?$. Example: `` - `fields` (string[]): Columns to return (record_date is always included). Omitted or null returns every column. Notes: Fiscal Data aggregates rows that become identical when columns are dropped, and sort keys must be among the returned columns (sorting on a dropped column is rejected upstream). Example: `[]` - `filter` (object[]): Clauses are ANDed. Example: `[]` - `page_size` (number): page_size Example: `100` - `sort` (object[]): Sort keys in priority order. Omitted or null sorts by record_date descending (newest first). Example: `[]` Response schema example: ```json { "api_url": "https://api.fiscaldata.treasury.gov/services/api/fiscal_service/v2/accounting/od/debt_to_penny", "count": 1, "endpoint": "v2/accounting/od/debt_to_penny", "fields": [ { "currency": "USD", "data_type": "CURRENCY", "format": "$10.20", "label": "Debt Held by the Public", "name": "debt_held_public_amt" }, { "currency": "USD", "data_type": "CURRENCY", "format": "$10.20", "label": "Intragovernmental Holdings", "name": "intragov_hold_amt" }, { "currency": null, "data_type": "DAY", "format": "DD", "label": "Calendar Day Number", "name": "record_calendar_day" }, { "currency": null, "data_type": "MONTH", "format": "MM", "label": "Calendar Month Number", "name": "record_calendar_month" }, { "currency": null, "data_type": "QUARTER", "format": "Q", "label": "Calendar Quarter Number", "name": "record_calendar_quarter" }, { "currency": null, "data_type": "YEAR", "format": "YYYY", "label": "Calendar Year", "name": "record_calendar_year" }, { "currency": null, "data_type": "DATE", "format": "YYYY-MM-DD", "label": "Record Date", "name": "record_date" }, { "currency": null, "data_type": "QUARTER", "format": "Q", "label": "Fiscal Quarter Number", "name": "record_fiscal_quarter" }, { "currency": null, "data_type": "YEAR", "format": "YYYY", "label": "Fiscal Year", "name": "record_fiscal_year" }, { "currency": null, "data_type": "INTEGER", "format": "10", "label": "Source Line Number", "name": "src_line_nbr" }, { "currency": "USD", "data_type": "CURRENCY", "format": "$10.20", "label": "Total Public Debt Outstanding", "name": "tot_pub_debt_out_amt" } ], "filter": "record_date:eq:2024-01-31", "next_cursor": null, "observed_at_ms": 1790008936959, "page": 1, "page_size": 100, "records": [ { "debt_held_public_amt": "27071861894841.00", "intragov_hold_amt": "7119288507552.64", "record_calendar_day": "31", "record_calendar_month": "01", "record_calendar_quarter": "1", "record_calendar_year": "2024", "record_date": "2024-01-31", "record_fiscal_quarter": "2", "record_fiscal_year": "2024", "src_line_nbr": "1", "tot_pub_debt_out_amt": "34191150402393.64" } ], "sort": "-record_date", "source_url": "https://api.fiscaldata.treasury.gov/services/api/fiscal_service/v2/accounting/od/debt_to_penny?filter=record_date:eq:2024-01-31&sort=-record_date&page%5Bsize%5D=100&page%5Bnumber%5D=1", "total_count": 1, "total_pages": 1 } ``` ### Datasets - Capability: `fiscal-data/datasets` - Description: Search the Fiscal Data catalog (56 datasets, ~180 API tables): keyword match over dataset id, title, descriptions, table names and column names, or an exact dataset_id lookup. Each dataset lists its API tables with the `endpoint` path accepted by `data`, row counts, date coverage, update cadence and every column with its published data type. - Instructions: Start here to find the `endpoint` for `data` or the `dataset_id` for `release_calendar` and `published_reports`. - Cost: 5 credits per call - Capability file: [Datasets](https://firecrawl.dev/alexandria/agents/providers/fiscaldata-treasury-gov/fiscal-data/datasets) Accepted options: - `cursor` (string): next_cursor from the previous page of the same query. Example: `` - `dataset_id` (string): Exact Fiscal Data dataset id such as 015-BFS-2014Q3-065; not_found when the catalog has no such dataset. Pattern: ^015-BFS-[0-9]{4}Q[1-4]-[0-9A-Za-z]{2,4}$. Example: `` - `page_size` (number): Datasets per page. Example: `10` - `query` (string): Keywords; every word must match (case-insensitive) somewhere in the dataset id, title, descriptions, table names or column names. Omit to list every dataset. Example: `` Response schema example: ```json { "count": 1, "datasets": [ { "dataset_id": "015-BFS-2014Q3-065", "dataset_url": "https://fiscaldata.treasury.gov/datasets/debt-to-the-penny/", "notes_and_known_limitations": "***Total Public Debt Outstanding Disclaimer***\n\nThere are six datasets on Fiscal Data which include the national debt, which is referred to as Total Public Debt Outstanding (TPDO). TPDO is the sum of Debt Held by the Public and Intragovernmental (Intragov) Holdings. Some datasets include debt issued by the Federal Financing Bank (FFB). The datasets listed below only include debt issued by the Treasury Department. The list below provides information on where there are differences in debt calculations related to the national debt.\n\nDebt to the Penny contains TPDO, as well as a breakout of Debt Held by the Public and Intragov Holdings. In this dataset, Intragov Holdings includes debt issued by the FFB.\n\nHistorical Debt Outstanding contains TPDO, but no breakout of Debt Held by the Public and Intragov Holdings. In this dataset, TPDO includes debt issued by the FFB.\n\nDaily Treasury Statement (DTS) contains Debt Held by the Public and Intragov Holdings, but does not aggregate these two categories into TPDO. In this dataset, Intragov Holdings includes debt issued by the FFB. Dollar values for Debt Held by the Public and Intragov Holdings are rounded in millions to cohere with other data in the dataset. Please note that the published reports on the Fiscal Service site contain TPDO values.\n\nMonthly Treasury Statement (MTS) contains TPDO, as well as a breakout of Debt Held by the Public and Intragov Holdings. In this dataset, Intragov Holdings includes debt issued by the FFB.\n\nMonthly Statement of the Public Debt (MSPD) contains TPDO, as well as a breakout of Debt Held by the Public and Intragov Holdings. In this dataset, Intragov Holdings includes debt issued by the FFB. Dollar values are rounded in millions to cohere with other data in the dataset.\n\nSchedules of Federal Debt contains Debt Held by the Public and Intragov Holdings, but does not aggregate these two categories into TPDO. In this dataset, Intragov Holdings do not include debt issued by the FFB. Dollar values are rounded in millions to cohere with other data in the dataset.\n\n***End Total Public Debt Outstanding Disclaimer***\n\nDebt broken out by intragovernmental holdings and debt held by the public has not always been provided. Where this occurred, the dataset shows a value of $0.00 instead of a null value. Debt held by the public and intragovernmental holdings data is available yearly (on a fiscal basis) from 9/30/1997 through 9/30/2001, monthly from 9/30/2001 through 3/31/2005, and daily from 4/4/2005 to today. Some columns in this dataset overlap with the [Monthly Statement of the Public Debt (MSPD)](https://fiscaldata.treasury.gov/datasets/monthly-statement-public-debt/), [Monthly Treasury Statement (MTS)](https://fiscaldata.treasury.gov/datasets/monthly-treasury-statement/), [Daily Treasury Statement (DTS)](https://fiscaldata.treasury.gov/datasets/daily-treasury-statement/), and [Schedules of Federal Debt](https://fiscaldata.treasury.gov/datasets/schedules-federal-debt/) datasets. Debt issued by the Federal Financing Bank (FFB) is included in the intragovernmental holdings in the Debt to the Penny dataset, but not in the Schedules of Federal Debt dataset because it is not debt managed by the Bureau of the Fiscal Service. The difference between these datasets is equal to the amount of debt issued by the FFB.\n\nDownloaded CSV files with values greater than $10 trillion may have the final two digits (cents) excluded due to digit limits enforced by the application used to access the file. The JSON and XML file downloads are not impacted by this limitation.\n\nTotal Public Debt Outstanding = Debt Held by the Public + Intragovernmental Holdings\n\nPlease note that Total Public Debt Outstanding may be calculated differently within different datasets. See those datasets Notes & Known Limitations section for calculation details.", "publisher": "Office of Accounting", "short_description": "Total outstanding debt of the U.S. government reported daily. Includes a breakout of intragovernmental holdings (federal debt held by U.S. government) and debt held by the public (federal debt held by entities outside the U.S. government).", "slug": "debt-to-the-penny", "tables": [ { "api_id": 143, "api_url": "https://api.fiscaldata.treasury.gov/services/api/fiscal_service/v2/accounting/od/debt_to_penny", "earliest_date": "1993-04-01", "endpoint": "v2/accounting/od/debt_to_penny", "fields": [ { "data_type": "DATE", "definition": "The date that data was published.", "label": "Record Date", "name": "record_date", "required": true }, { "data_type": "CURRENCY", "definition": "All federal debt held by individuals, corporations, state or local governments, Federal Reserve Banks, foreign governments, and other entities outside the United States Government less Federal Financing Bank (FFB) securities. Debt held by the public is composed of Treasury Bills, Notes, Bonds, Treasury Inflation-Protected Securities (TIPS), Floating Rate Notes (FRNs), Domestic Series, Foreign Series, State and Local Government Series (SLGS), United States Savings Securities, and a portion of Government Account Series (GAS) securities.", "label": "Debt Held by the Public", "name": "debt_held_public_amt", "required": true }, { "data_type": "CURRENCY", "definition": "Government Account Series (GAS) securities held by Government trust funds, revolving funds, and special funds; and Federal Financing Bank (FFB) securities.", "label": "Intragovernmental Holdings", "name": "intragov_hold_amt", "required": true }, { "data_type": "CURRENCY", "definition": "Total of intragovernmental holdings and debt held by the public.", "label": "Total Public Debt Outstanding", "name": "tot_pub_debt_out_amt", "required": true }, { "data_type": "INTEGER", "definition": "Indicates the row of the corresponding table where a data point can be found. This can assist in structuring the data in a similar format to the published report and in understanding potential hierarchies within the table.", "label": "Source Line Number", "name": "src_line_nbr", "required": true }, { "data_type": "YEAR", "definition": "The fiscal year associated with record_date. The federal government's fiscal year runs from October 1 to September 30.", "label": "Fiscal Year", "name": "record_fiscal_year", "required": true }, { "data_type": "QUARTER", "definition": "The fiscal quarter associated with record_date. For the federal government these quarters are: Q1 - October to December, Q2 - January to March, Q3 - April to June, Q4 - July to September.", "label": "Fiscal Quarter Number", "name": "record_fiscal_quarter", "required": true }, { "data_type": "YEAR", "definition": "The calendar year associated with record_date.", "label": "Calendar Year", "name": "record_calendar_year", "required": true }, { "data_type": "QUARTER", "definition": "The calendar quarter associated with record_date.", "label": "Calendar Quarter Number", "name": "record_calendar_quarter", "required": true }, { "data_type": "MONTH", "definition": "The calendar month associated with record_date.", "label": "Calendar Month Number", "name": "record_calendar_month", "required": true }, { "data_type": "DAY", "definition": "The calendar day associated with record_date.", "label": "Calendar Day Number", "name": "record_calendar_day", "required": true } ], "last_updated": "2026-09-18", "latest_date": "2026-09-17", "row_count": 8395, "table_description": "Outstanding U.S. debt on a daily basis.", "table_name": "Debt to the Penny", "update_frequency": "Daily" } ], "title": "Debt to the Penny", "update_frequency": "Daily" } ], "next_cursor": null, "observed_at_ms": 1790008963927, "query": "debt to the penny", "source_url": "https://api.fiscaldata.treasury.gov/services/dtg/metadata/", "total_count": 1 } ``` ### Latest - Capability: `fiscal-data/latest` - Description: The newest rows of one headline Fiscal Data table by a friendly name: debt_to_the_penny, dts_operating_cash_balance, dts_deposits_withdrawals, mts_summary, mts_receipts, mts_outlays, mspd_summary, auctions, upcoming_auctions, average_interest_rates, interest_expense, gold_reserve or exchange_rates. Sorted by the table's date column descending, optionally filtered (e.g. exchange_rates for one country_currency_desc). Same row shape as `data`. - Instructions: Current values without knowing the endpoint path: today's national debt, the latest cash balance, the last auctions, the current exchange rate table. - Cost: 5 credits per call - Capability file: [Latest](https://firecrawl.dev/alexandria/agents/providers/fiscaldata-treasury-gov/fiscal-data/latest) Accepted options: - `filter` (object[]): Optional ANDed filter clauses, as in `data`. Example: `[]` - `n` (number): Rows to return (newest first). Example: `10` - `table` (string, required): table Example: `debt_to_the_penny` Response schema example: ```json { "api_url": "https://api.fiscaldata.treasury.gov/services/api/fiscal_service/v1/accounting/od/rates_of_exchange", "count": 2, "endpoint": "v1/accounting/od/rates_of_exchange", "fields": [ { "currency": null, "data_type": "STRING", "format": "String", "label": "Country", "name": "country" }, { "currency": null, "data_type": "STRING", "format": "String", "label": "Country - Currency Description", "name": "country_currency_desc" }, { "currency": null, "data_type": "STRING", "format": "String", "label": "Currency", "name": "currency" }, { "currency": null, "data_type": "DATE", "format": "YYYY-MM-DD", "label": "Effective Date", "name": "effective_date" }, { "currency": null, "data_type": "NUMBER", "format": "10.2", "label": "Exchange Rate", "name": "exchange_rate" }, { "currency": null, "data_type": "DAY", "format": "DD", "label": "Calendar Day Number", "name": "record_calendar_day" }, { "currency": null, "data_type": "MONTH", "format": "MM", "label": "Calendar Month Number", "name": "record_calendar_month" }, { "currency": null, "data_type": "QUARTER", "format": "Q", "label": "Calendar Quarter Number", "name": "record_calendar_quarter" }, { "currency": null, "data_type": "YEAR", "format": "YYYY", "label": "Calendar Year", "name": "record_calendar_year" }, { "currency": null, "data_type": "DATE", "format": "YYYY-MM-DD", "label": "Record Date", "name": "record_date" }, { "currency": null, "data_type": "QUARTER", "format": "Q", "label": "Fiscal Quarter Number", "name": "record_fiscal_quarter" }, { "currency": null, "data_type": "YEAR", "format": "YYYY", "label": "Fiscal Year", "name": "record_fiscal_year" }, { "currency": null, "data_type": "INTEGER", "format": "10", "label": "Source Line Number", "name": "src_line_nbr" } ], "filter": "country_currency_desc:eq:Canada-Dollar,record_date:lte:2025-06-30", "next_cursor": "2", "observed_at_ms": 1790008943787, "page": 1, "page_size": 2, "records": [ { "country": "Canada", "country_currency_desc": "Canada-Dollar", "currency": "Dollar", "effective_date": "2025-06-30", "exchange_rate": "1.367", "record_calendar_day": "30", "record_calendar_month": "06", "record_calendar_quarter": "2", "record_calendar_year": "2025", "record_date": "2025-06-30", "record_fiscal_quarter": "3", "record_fiscal_year": "2025", "src_line_nbr": "28" }, { "country": "Canada", "country_currency_desc": "Canada-Dollar", "currency": "Dollar", "effective_date": "2025-03-31", "exchange_rate": "1.435", "record_calendar_day": "31", "record_calendar_month": "03", "record_calendar_quarter": "1", "record_calendar_year": "2025", "record_date": "2025-03-31", "record_fiscal_quarter": "2", "record_fiscal_year": "2025", "src_line_nbr": "31" } ], "sort": "-record_date", "source_url": "https://api.fiscaldata.treasury.gov/services/api/fiscal_service/v1/accounting/od/rates_of_exchange?filter=country_currency_desc:eq:Canada-Dollar,record_date:lte:2025-06-30&sort=-record_date&page%5Bsize%5D=2&page%5Bnumber%5D=1", "total_count": 98, "total_pages": 49 } ``` ### Published reports - Capability: `fiscal-data/published_reports` - Description: Published report files (PDF, XLS, TXT) of one dataset from the Fiscal Data published-files service, e.g. every Daily Treasury Statement PDF (dataset 015-BFS-2014Q1-03) or Monthly Treasury Statement (015-BFS-2014Q1-13): report date, report group and the download URL on fiscaldata.treasury.gov. Optional substring match on the path and report-date range; newest first. not_found when the dataset id is unknown or publishes no files. - Instructions: To get the official PDF/XLS of a statement for a given date rather than the table rows. - Cost: 5 credits per call - Capability file: [Published reports](https://firecrawl.dev/alexandria/agents/providers/fiscaldata-treasury-gov/fiscal-data/published_reports) Accepted options: - `cursor` (string): next_cursor from the previous page of the same query. Example: `` - `dataset_id` (string, required): Fiscal Data dataset id from `datasets`, e.g. 015-BFS-2014Q1-03 (Daily Treasury Statement). Pattern: ^015-BFS-[0-9]{4}Q[1-4]-[0-9A-Za-z]{2,4}$. Example: `` - `from` (string): Earliest report_date to include (inclusive). Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `` - `page_size` (number): page_size Example: `50` - `path_contains` (string): Case-sensitive substring the file path must contain, e.g. `/mts/`, `.xls` or `MonthlyTreasuryStatement_2025`. Applied to the dataset's full file list, so total_count reflects the filtered set. Example: `/mts/` - `to` (string): Latest report_date to include (inclusive). Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `` Response schema example: ```json { "count": 4, "dataset_id": "015-BFS-2014Q1-03", "next_cursor": null, "observed_at_ms": 1790008948303, "reports": [ { "path": "/static-data/published-reports/dts/DailyTreasuryStatement_20260917.pdf", "report_date": "2026-09-17", "report_group_desc": "Daily Treasury Statement (.pdf)", "report_group_id": "13", "sort_order": 1, "url": "https://fiscaldata.treasury.gov/static-data/published-reports/dts/DailyTreasuryStatement_20260917.pdf" }, { "path": "/static-data/published-reports/dts/DailyTreasuryStatement_20260916.pdf", "report_date": "2026-09-16", "report_group_desc": "Daily Treasury Statement (.pdf)", "report_group_id": "13", "sort_order": 1, "url": "https://fiscaldata.treasury.gov/static-data/published-reports/dts/DailyTreasuryStatement_20260916.pdf" }, { "path": "/static-data/published-reports/dts/DailyTreasuryStatement_20260915.pdf", "report_date": "2026-09-15", "report_group_desc": "Daily Treasury Statement (.pdf)", "report_group_id": "13", "sort_order": 1, "url": "https://fiscaldata.treasury.gov/static-data/published-reports/dts/DailyTreasuryStatement_20260915.pdf" }, { "path": "/static-data/published-reports/dts/DailyTreasuryStatement_20260914.pdf", "report_date": "2026-09-14", "report_group_desc": "Daily Treasury Statement (.pdf)", "report_group_id": "13", "sort_order": 1, "url": "https://fiscaldata.treasury.gov/static-data/published-reports/dts/DailyTreasuryStatement_20260914.pdf" } ], "source_url": "https://api.fiscaldata.treasury.gov/services/dtg/publishedfiles?dataset_id=015-BFS-2014Q1-03", "total_count": 4 } ``` ### Release calendar - Capability: `fiscal-data/release_calendar` - Description: Scheduled and completed Fiscal Data releases from the release calendar (about the next three months, all datasets): dataset_id, date, Eastern time and whether the release has happened. Filter by dataset_id and/or date range; soonest first. - Instructions: When a dataset will next be updated, or whether today's release is already out. - Cost: 5 credits per call - Capability file: [Release calendar](https://firecrawl.dev/alexandria/agents/providers/fiscaldata-treasury-gov/fiscal-data/release_calendar) Accepted options: - `cursor` (string): next_cursor from the previous page of the same query. Example: `` - `dataset_id` (string): Restrict to one dataset (from `datasets`). not_found when the id is not in the catalog. Pattern: ^015-BFS-[0-9]{4}Q[1-4]-[0-9A-Za-z]{2,4}$. Example: `` - `from` (string): Earliest release date to include (inclusive). Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `` - `page_size` (number): page_size Example: `100` - `to` (string): Latest release date to include (inclusive). Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `` Response schema example: ```json { "count": 5, "dataset_id": "015-BFS-2014Q3-065", "next_cursor": "5", "observed_at_ms": 1790008968084, "releases": [ { "dataset_id": "015-BFS-2014Q3-065", "date": "2026-09-21", "released": false, "time": "20:15" }, { "dataset_id": "015-BFS-2014Q3-065", "date": "2026-09-22", "released": false, "time": "20:15" }, { "dataset_id": "015-BFS-2014Q3-065", "date": "2026-09-23", "released": false, "time": "20:15" }, { "dataset_id": "015-BFS-2014Q3-065", "date": "2026-09-24", "released": false, "time": "20:15" }, { "dataset_id": "015-BFS-2014Q3-065", "date": "2026-09-25", "released": false, "time": "20:15" } ], "source_url": "https://api.fiscaldata.treasury.gov/services/calendar/release", "total_count": 71 } ```