{"uid":"cap_KWZnTuaMmxgO1cvHPncqE","slug":"2s-io-8f769820","name":"2s.io US Treasury Official Exchange Rates","description":"Official US Treasury exchange rates via US Treasury Fiscal Data. Used by federal agencies to report foreign-currency transactions in USD. Quarterly + ad-hoc updates per country/currency pair. Each row carries record_date, country, currency, country_currency_desc, exchange_rate, effective_date. Pair with `/api/fx/rates` (ECB Frankfurter, daily market rates) for cross-validation. Use Fiscal Data filter syntax — e.g. `filter=country:eq:Brazil` to scope to a single country.","url":"https://2s.io/api/treasury/exchange-rates","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"const":"http"},"method":{"const":"GET"},"queryParams":{"properties":{"sort":{"type":"string","default":"-record_date"},"fields":{"type":"string"},"filter":{"type":"string","description":"e.g. country:eq:Brazil,record_date:gte:2024-01-01"},"pageSize":{"type":"integer","default":100,"maximum":10000,"minimum":1},"pageNumber":{"type":"integer","minimum":1}}}}}}},"responseSchema":{"type":"json","schema":{"type":"object","properties":{"ok":{"type":"boolean"},"meta":{"type":"object","properties":{"links":{},"labels":{},"dataTypes":{}}},"page":{"type":"object","properties":{"size":{"type":"integer"},"pages":{},"number":{"type":"integer"}}},"items":{"type":"array","items":{"type":"object","properties":{"country":{"type":"string"},"currency":{"type":"string"},"record_date":{"type":"string"},"exchange_rate":{"type":"string"},"effective_date":{"type":"string"},"country_currency_desc":{"type":"string"}}}},"total":{"type":"integer"},"source":{"type":"object","properties":{"url":{"type":"string"},"license":{"type":"string"},"provider":{"type":"string"}}}}},"example":{"ok":true,"meta":{"links":null,"labels":null,"dataTypes":null},"page":{"size":100,"pages":null,"number":1},"items":[{"country":"Brazil","currency":"Real","record_date":"2026-03-31","exchange_rate":"5.254","effective_date":"2026-03-31","country_currency_desc":"Brazil-Real"}],"total":5421,"source":{"url":"https://fiscaldata.treasury.gov/api-documentation/","license":"US Government work, public domain.","provider":"US Treasury Fiscal Data API (Bureau of the Fiscal Service)"}}},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"sort":"-record_date","filter":"country:eq:Canada","pageSize":10,"pageNumber":1}}},"response":{"data":{"ok":true,"meta":{"links":{"last":"&page%5Bnumber%5D=11&page%5Bsize%5D=10","next":"&page%5Bnumber%5D=2&page%5Bsize%5D=10","prev":null,"self":"&page%5Bnumber%5D=1&page%5Bsize%5D=10","first":"&page%5Bnumber%5D=1&page%5Bsize%5D=10"},"labels":{"country":"Country","currency":"Currency","record_date":"Record Date","src_line_nbr":"Source Line Number","exchange_rate":"Exchange Rate","effective_date":"Effective Date","record_fiscal_year":"Fiscal Year","record_calendar_day":"Calendar Day Number","record_calendar_year":"Calendar Year","country_currency_desc":"Country - Currency Description","record_calendar_month":"Calendar Month Number","record_fiscal_quarter":"Fiscal Quarter Number","record_calendar_quarter":"Calendar Quarter Number"},"dataTypes":{"country":"STRING","currency":"STRING","record_date":"DATE","src_line_nbr":"INTEGER","exchange_rate":"NUMBER","effective_date":"DATE","record_fiscal_year":"YEAR","record_calendar_day":"DAY","record_calendar_year":"YEAR","country_currency_desc":"STRING","record_calendar_month":"MONTH","record_fiscal_quarter":"QUARTER","record_calendar_quarter":"QUARTER"}},"page":{"size":10,"pages":11,"number":1},"items":[{"country":"Canada","currency":"Dollar","record_date":"2026-03-31","src_line_nbr":"27","exchange_rate":"1.393","effective_date":"2026-03-31","record_fiscal_year":"2026","record_calendar_day":"31","record_calendar_year":"2026","country_currency_desc":"Canada-Dollar","record_calendar_month":"03","record_fiscal_quarter":"2","record_calendar_quarter":"1"},{"country":"Canada","currency":"Dollar","record_date":"2025-12-31","src_line_nbr":"28","exchange_rate":"1.369","effective_date":"2025-12-31","record_fiscal_year":"2026","record_calendar_day":"31","record_calendar_year":"2025","country_currency_desc":"Canada-Dollar","record_calendar_month":"12","record_fiscal_quarter":"1","record_calendar_quarter":"4"},{"country":"Canada","currency":"Dollar","record_date":"2025-09-30","src_line_nbr":"29","exchange_rate":"1.392","effective_date":"2025-09-30","record_fiscal_year":"2025","record_calendar_day":"30","record_calendar_year":"2025","country_currency_desc":"Canada-Dollar","record_calendar_month":"09","record_fiscal_quarter":"4","record_calendar_quarter":"3"},{"country":"Canada","currency":"Dollar","record_date":"2025-06-30","src_line_nbr":"28","exchange_rate":"1.367","effective_date":"2025-06-30","record_fiscal_year":"2025","record_calendar_day":"30","record_calendar_year":"2025","country_currency_desc":"Canada-Dollar","record_calendar_month":"06","record_fiscal_quarter":"3","record_calendar_quarter":"2"},{"country":"Canada","currency":"Dollar","record_date":"2025-03-31","src_line_nbr":"31","exchange_rate":"1.435","effective_date":"2025-03-31","record_fiscal_year":"2025","record_calendar_day":"31","record_calendar_year":"2025","country_currency_desc":"Canada-Dollar","record_calendar_month":"03","record_fiscal_quarter":"2","record_calendar_quarter":"1"},{"country":"Canada","currency":"Dollar","record_date":"2024-12-31","src_line_nbr":"30","exchange_rate":"1.438","effective_date":"2024-12-31","record_fiscal_year":"2025","record_calendar_day":"31","record_calendar_year":"2024","country_currency_desc":"Canada-Dollar","record_calendar_month":"12","record_fiscal_quarter":"1","record_calendar_quarter":"4"},{"country":"Canada","currency":"Dollar","record_date":"2024-09-30","src_line_nbr":"30","exchange_rate":"1.352","effective_date":"2024-09-30","record_fiscal_year":"2024","record_calendar_day":"30","record_calendar_year":"2024","country_currency_desc":"Canada-Dollar","record_calendar_month":"09","record_fiscal_quarter":"4","record_calendar_quarter":"3"},{"country":"Canada","currency":"Dollar","record_date":"2024-06-30","src_line_nbr":"28","exchange_rate":"1.37","effective_date":"2024-06-30","record_fiscal_year":"2024","record_calendar_day":"30","record_calendar_year":"2024","country_currency_desc":"Canada-Dollar","record_calendar_month":"06","record_fiscal_quarter":"3","record_calendar_quarter":"2"},{"country":"Canada","currency":"Dollar","record_date":"2024-03-31","src_line_nbr":"27","exchange_rate":"1.355","effective_date":"2024-03-31","record_fiscal_year":"2024","record_calendar_day":"31","record_calendar_year":"2024","country_currency_desc":"Canada-Dollar","record_calendar_month":"03","record_fiscal_quarter":"2","record_calendar_quarter":"1"},{"country":"Canada","currency":"Dollar","record_date":"2023-12-31","src_line_nbr":"27","exchange_rate":"1.326","effective_date":"2023-12-31","record_fiscal_year":"2024","record_calendar_day":"31","record_calendar_year":"2023","country_currency_desc":"Canada-Dollar","record_calendar_month":"12","record_fiscal_quarter":"1","record_calendar_quarter":"4"}],"total":101,"source":{"url":"https://fiscaldata.treasury.gov/api-documentation/","license":"US Government work, public domain.","provider":"US Treasury Fiscal Data API (Bureau of the Fiscal Service)"}},"meta":{"cost":{"usd":0.0012,"tier":0},"caller":"x402","version":null,"endpoint":"treasury.exchange-rates","settlement":{"txHash":"0xe45d6186d33ffde6bd0cc9bf2aa675f9e04ea66c59a3efa1612a6fd22fbb11c6","network":"eip155:8453","success":true}}}},"exampleRequest":{"sort":"-record_date","filter":"country:eq:Canada","pageSize":10,"pageNumber":1},"tags":["x402"],"displayCostAmount":"0.0012","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.0012/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm__Rgu_7wKHYcqPOHFSHm3p","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns official US Treasury exchange rates for foreign currencies, sourced from the Treasury Fiscal Data API, with quarterly and ad-hoc updates per country/currency pair.","exampleAgentPrompt":"What is the official US Treasury exchange rate for Brazil? Pull the most recent record and show me the country, currency, exchange rate, and effective date.","exampleUseCases":null,"resultDescription":"A paginated list of Treasury exchange rate records, each containing record_date, country, currency, country_currency_desc (e.g. 'Brazil-Real'), exchange_rate (USD equivalent), and effective_date. Sorted by record_date descending by default.","failureModes":["Invalid filter syntax returns a 400 or empty result set","Unknown country or currency name in filter returns zero rows","pageSize exceeding 10000 is rejected","Network or upstream Treasury Fiscal Data outage returns 5xx","Stale data if Treasury hasn't published a new quarterly update yet"],"whenToPreferThis":"Use this endpoint when you need the official US government-sanctioned exchange rate for foreign-currency reporting — specifically the rate used by federal agencies — rather than live market rates. Prefer it over ECB Frankfurter (/api/fx/rates) when regulatory compliance or cross-validation with official Treasury figures is required. Best for quarterly historical lookups or auditing foreign-currency transactions reported in USD.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:55:56.468Z","isFirstParty":false}