{"name":"Treasury Fiscal Data Exchange Rates API","description":"US Treasury reporting rates of exchange: the exchange rate of each country's currency against the US dollar, with country, currency, record date and effective date.","api_id":"generated_c2a79885d6c82dcd59fb439a","slug":"treasury-fiscal-data-exchange-rates-api","source":{"name":"Treasury","domain":"api.fiscaldata.treasury.gov","url":"https://api.fiscaldata.treasury.gov/"},"category":"public_data","countries":[],"languages":[],"record_types":[],"tags":[],"limitations":[],"updated":"2026-11-20","note":"Sample records are saved samples, not a live run. CleanedWeb is not affiliated with the source.","version":"1.0","versions":[{"major":1,"latest_minor":"1.0","status":"current","sunset_at":null}],"changelog":[{"version":"1.0","date":"2026-11-19T07:11:16.000Z","kind":"major","changes":[]}],"version_note":"Pin a major with \"version\": N in the run body (an integer). Leave it out and the call runs on the latest major. A sunset major runs on the latest major and the response says rerouted. An unknown major answers 404 catalog_version_not_found and lists the available majors.","endpoints":[{"endpoint_id":"generated_c2a79885d6c82dcd59fb439a_search","name":"List Treasury Fiscal Data Exchange Rates","description":"Return records within the accepted scope.","definition_version":"8b593885a719f220627c3c8f1e482ca0aaaf106c39476bf11ce9425cf6e266f7","method":"POST","path":"/v1/catalog/public/apis/generated_c2a79885d6c82dcd59fb439a/endpoints/generated_c2a79885d6c82dcd59fb439a_search/run","url":"https://api.cleanedweb.com/v1/catalog/public/apis/generated_c2a79885d6c82dcd59fb439a/endpoints/generated_c2a79885d6c82dcd59fb439a_search/run","authentication":{"type":"bearer","scheme":"Authorization: Bearer <API key>","scope":"run","note":"Reading this file and the live catalog needs no credential. A run needs a CleanedWeb account and uses the credits of its workspace.","docs":"https://cleanedweb.com/docs/run-catalog-api/"},"required_headers":[{"name":"Authorization","value":"Bearer YOUR_API_KEY","description":"An API key with the run scope."},{"name":"Idempotency-Key","value":"UNIQUE_REQUEST_ID","description":"Required. Save it before you send; reuse it only to retry the same request and to read the result. 1-200 characters: letters, numbers, . _ : -"},{"name":"Content-Type","value":"application/json","description":"The body is JSON."}],"request_body":{"input":"An object that follows input_schema.","max_items":"Optional. Stop after this many records.","timeout_seconds":"Optional, 60-86400, default 10800.","wait_seconds":"Optional, 0-86400, default 90. How long the request waits before answering 202.","version":"Optional integer major. Leave it out for the latest major."},"input_schema":{"type":"object","properties":{"sort":{"type":"string","enum":["-record_date","record_date"],"default":"-record_date","description":"Optional. One verified value(s) of the page's own \"sort\" control (-record_date = -record_date; record_date = record_date). Omit it for the page's own selection."},"country":{"examples":["Mexico","Canada"],"anyOf":[{"type":"string","minLength":1,"maxLength":200,"pattern":"^[^,()\\r\\n]+$"},{"type":"array","items":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[^,()\\r\\n]+$"},"minItems":1,"uniqueItems":true}],"description":"Optional. The exact value of the source's \"country\" field to keep, or a list of values to keep records holding any of them (each as typed, without commas or parentheses). Omit it for the listing's own selection of this field.","x-source-keys":["filter"]},"currency":{"examples":["Dollar","Peso"],"anyOf":[{"type":"string","minLength":1,"maxLength":200,"pattern":"^[^,()\\r\\n]+$"},{"type":"array","items":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[^,()\\r\\n]+$"},"minItems":1,"uniqueItems":true}],"description":"Optional. The exact value of the source's \"currency\" field to keep, or a list of values to keep records holding any of them (each as typed, without commas or parentheses). Omit it for the listing's own selection of this field.","x-source-keys":["filter"]},"record_date_from":{"type":"string","minLength":1,"maxLength":200,"examples":["2024-01-01","2025-01-01"],"pattern":"^[^,()\\r\\n]+$","description":"Optional. Lowest value of the source's \"record_date\" field to keep (inclusive), written as the records write it (for example 2024-01-01). Omit it to leave this side open.","x-source-keys":["filter"]},"record_date_to":{"type":"string","minLength":1,"maxLength":200,"examples":["2024-12-31","2023-12-31"],"pattern":"^[^,()\\r\\n]+$","description":"Optional. Highest value of the source's \"record_date\" field to keep (inclusive), written as the records write it (for example 2024-12-31). Omit it to leave this side open.","x-source-keys":["filter"]},"effective_date_from":{"type":"string","minLength":1,"maxLength":200,"examples":["2024-01-01","2025-01-01"],"pattern":"^[^,()\\r\\n]+$","description":"Optional. Lowest value of the source's \"effective_date\" field to keep (inclusive), written as the records write it (for example 2024-01-01). Omit it to leave this side open.","x-source-keys":["filter"]},"effective_date_to":{"type":"string","minLength":1,"maxLength":200,"examples":["2024-12-31","2023-12-31"],"pattern":"^[^,()\\r\\n]+$","description":"Optional. Highest value of the source's \"effective_date\" field to keep (inclusive), written as the records write it (for example 2024-12-31). Omit it to leave this side open.","x-source-keys":["filter"]},"exchange_rate_min":{"type":"string","minLength":1,"maxLength":200,"examples":["1.0","2.0"],"pattern":"^[^,()\\r\\n]+$","description":"Optional. Lowest value of the source's \"exchange_rate\" field to keep (inclusive), written as the records write it (for example 1.0). Omit it to leave this side open.","x-source-keys":["filter"]},"exchange_rate_max":{"type":"string","minLength":1,"maxLength":200,"examples":["2.0","1.0"],"pattern":"^[^,()\\r\\n]+$","description":"Optional. Highest value of the source's \"exchange_rate\" field to keep (inclusive), written as the records write it (for example 2.0). Omit it to leave this side open.","x-source-keys":["filter"]},"record_fiscal_year":{"examples":["2024","2025"],"anyOf":[{"type":"string","minLength":1,"maxLength":200,"pattern":"^[^,()\\r\\n]+$"},{"type":"array","items":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[^,()\\r\\n]+$"},"minItems":1,"uniqueItems":true}],"description":"Optional. The exact value of the source's \"record_fiscal_year\" field to keep, or a list of values to keep records holding any of them (each as typed, without commas or parentheses). Omit it for the listing's own selection of this field.","x-source-keys":["filter"]},"record_fiscal_quarter":{"examples":["2","3"],"anyOf":[{"type":"string","minLength":1,"maxLength":200,"pattern":"^[^,()\\r\\n]+$"},{"type":"array","items":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[^,()\\r\\n]+$"},"minItems":1,"uniqueItems":true}],"description":"Optional. The exact value of the source's \"record_fiscal_quarter\" field to keep, or a list of values to keep records holding any of them (each as typed, without commas or parentheses). Omit it for the listing's own selection of this field.","x-source-keys":["filter"]}},"required":[],"additionalProperties":false},"output_schema":{"additionalProperties":false,"properties":{"country":{"type":["string"]},"country_currency_desc":{"type":["string"]},"currency":{"type":["string"]},"effective_date":{"type":["string"]},"exchange_rate":{"type":["string"]},"record_calendar_day":{"type":["string"]},"record_calendar_month":{"type":["string"]},"record_calendar_quarter":{"type":["string"]},"record_calendar_year":{"type":["string"]},"record_date":{"type":["string"]},"record_fiscal_quarter":{"type":["string"]},"record_fiscal_year":{"type":["string"]},"row_id":{"type":["string"]},"src_line_nbr":{"type":["string"]},"typed_exchange_rate":{"type":"number","description":"Numeric reading of exchange_rate; source preserved."}},"required":["row_id"],"type":"object"},"examples":[{"kind":"saved_validation_records","saved_at":"2026-11-19T07:11:16.554Z","live_verified":false,"request":{"input":{}},"records_shown":2,"records_saved":2,"records":[{"country":"Canada","country_currency_desc":"Canada-Dollar","currency":"Dollar","effective_date":"2026-09-30","exchange_rate":"1.418","record_calendar_day":"30","record_calendar_month":"09","record_calendar_quarter":"3","record_calendar_year":"2026","record_date":"2026-09-30","record_fiscal_quarter":"4","record_fiscal_year":"2026","row_id":"4170160c999d7c901cf1f6f1d9153ebb8afd57e14d631d588788999f02a27aa3","src_line_nbr":"27","typed_exchange_rate":1.418},{"country":"Canada","country_currency_desc":"Canada-Dollar","currency":"Dollar","effective_date":"2001-09-30","exchange_rate":"1.549","record_calendar_day":"30","record_calendar_month":"09","record_calendar_quarter":"3","record_calendar_year":"2001","record_date":"2001-09-30","record_fiscal_quarter":"4","record_fiscal_year":"2001","row_id":"b875a439131d1d306a20e8ed0654b9e3c6ae9ec79f56d1c55e22540712e8cff1","src_line_nbr":"33","typed_exchange_rate":1.549}]}],"request_example":{"body":{"input":{"country":"Canada"},"version":1,"max_items":25},"curl":"curl -X POST https://api.cleanedweb.com/v1/catalog/public/apis/generated_c2a79885d6c82dcd59fb439a/endpoints/generated_c2a79885d6c82dcd59fb439a_search/run \\\n  -H \"Authorization: Bearer YOUR_API_KEY\" \\\n  -H \"Idempotency-Key: UNIQUE_REQUEST_ID\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n  \"input\": {\n    \"country\": \"Canada\"\n  },\n  \"version\": 1,\n  \"max_items\": 25\n}'"},"result":{"method":"GET","url":"https://api.cleanedweb.com/v1/catalog/public/apis/generated_c2a79885d6c82dcd59fb439a/endpoints/generated_c2a79885d6c82dcd59fb439a_search/result","note":"A run that does not end within wait_seconds answers 202. Read the result with the same API key and the same Idempotency-Key."},"links":{"page":"https://cleanedweb.com/catalog/treasury-fiscal-data-exchange-rates-api/","markdown":"https://cleanedweb.com/catalog/treasury-fiscal-data-exchange-rates-api/index.md","live_contract":"https://app.cleanedweb.com/api/catalog/apis/generated_c2a79885d6c82dcd59fb439a/endpoints/generated_c2a79885d6c82dcd59fb439a_search/contract","run_docs":"https://cleanedweb.com/docs/run-catalog-api/"}}],"links":{"page":"https://cleanedweb.com/catalog/treasury-fiscal-data-exchange-rates-api/","markdown":"https://cleanedweb.com/catalog/treasury-fiscal-data-exchange-rates-api/index.md","contract":"https://cleanedweb.com/catalog/treasury-fiscal-data-exchange-rates-api/contract.json","catalog":"https://cleanedweb.com/catalog/","index":"https://cleanedweb.com/catalog/index.json","openapi":"https://cleanedweb.com/catalog/openapi.json"}}
