{"uid":"cap_SlHlePSAYB9P9chB2KZpO","slug":"greeneris-fx-official-rates-467d160f","name":"Greeneris FX Official Rates","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://data.greeneris.io/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":{"type":"json","example":{"as_of":"2026-06-30","count":2,"rates":[{"country":"Euro Zone","currency":"Euro","record_date":"2026-06-30","rate_per_usd":0.877,"effective_date":"2026-06-30","country_currency":"Euro Zone-Euro"}],"source":"US Treasury FiscalData, Reporting Rates of Exchange (quarterly official rates, public domain)"}},"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_xe75KfhvzeFz_71Mkby10","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":"Retrieves official US Treasury quarterly foreign exchange rates (rate per USD) for one or more currencies, optionally filtered by date","exampleAgentPrompt":"What is the official US Treasury exchange rate for Euro Zone-Euro as of 2025-06-30?","exampleUseCases":null,"resultDescription":"Returns a JSON object with the as-of date, count of results, and an array of rate records each containing country, currency, country_currency descriptor, record_date, effective_date, and rate_per_usd. Source is US Treasury FiscalData quarterly official rates.","failureModes":["Invalid date format returns an error — must be YYYY-MM-DD","Unknown or misspelled Country-Currency descriptor returns empty or error","No rate available before the requested date returns empty result set","Requesting more than 30 currencies in one call may be rejected","HTTP 402 returned if payment not provided — must pay 0.005 USDC on Base via x402 protocol before retrying"],"whenToPreferThis":"Use this endpoint when you need official, government-authoritative USD exchange rates (US Treasury quarterly rates) rather than real-time market rates — ideal for compliance, invoicing, financial reporting, or any scenario requiring a defensible official rate source. Prefer this over market FX feeds when audit-readiness or official sourcing matters.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:54:37.759Z","isFirstParty":false}