{"uid":"cap_qJ9cvIg0T89MD4JCPfFkH","slug":"us-treasury-official-rates-of-exchange-fbar-8938-45ed59f8","name":"US Treasury Official Rates of Exchange (FBAR/8938)","description":"Official US Treasury Reporting Rates of Exchange: the legal USD conversion rates required for FBAR/8938 filings and US federal accounting, covering ~170 currencies including exotics absent from ECB feeds. Query: ?currencies=Euro Zone-Euro,Japan-Yen (optional, all if omitted) and ?date=YYYY-MM-DD (latest quarterly rate at or before that date, default today). Returns units of foreign currency per 1 USD. Source updates quarterly; served with a 7-day cache.","url":"https://x402-datashop-production.up.railway.app/v1/fx/official","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{"date":{"type":"string","description":"YYYY-MM-DD; latest quarterly rate at or before this date (default today)"},"currencies":{"type":"string","description":"Comma-separated Treasury 'Country-Currency' descriptors, max 30 (optional -> all)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_NG4gwmaiLqV9Y0q1XdB5S","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the official US Treasury quarterly exchange rates required for FBAR and Form 8938 filings, covering ~170 currencies including exotics, as units of foreign currency per 1 USD.","exampleAgentPrompt":"What is the official US Treasury exchange rate for the Euro and Japanese Yen as of December 31, 2023? I need it for my FBAR filing.","exampleUseCases":null,"resultDescription":"Returns a JSON object mapping each requested currency (using Treasury 'Country-Currency' descriptors) to its official quarterly exchange rate expressed as units of foreign currency per 1 USD, as of the latest quarterly publication at or before the specified date. Cached for 7 days.","failureModes":["Invalid or unrecognized currency descriptor returns an error or empty result for that currency","Date prior to Treasury data coverage returns no rate","More than 30 currencies in a single request may be rejected","Malformed date format returns a 400-level error","Source data not yet updated for very recent quarter may return previous quarter's rate"],"whenToPreferThis":"Use this endpoint when you need the legally mandated US Treasury exchange rates for tax compliance purposes (FBAR, Form 8938, federal accounting), especially for exotic currencies not covered by ECB or commercial FX feeds. Prefer this over market-rate FX APIs whenever official/legal rates are required rather than real-time trading rates.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:49:04.466Z","isFirstParty":false}