{"uid":"cap_9xQ0_yuiuxMRAzg-1P6EV","slug":"nairarate-dev-historical-fx-rates-c413aade","name":"nairarate.dev Historical FX Rates","description":"CBN official rate, parallel market rate, USDT/USDC street price, and the spread between them. x402-gated API, no API key, no account.","url":"https://nairarate.dev/v1/rates/history","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"],"type":"string"},"queryParams":{"type":"object","required":["currency","market"],"properties":{"days":{"type":"integer","description":"1-365. Default 7. Charge scales with this."},"market":{"type":"string","description":"official, parallel, or crypto_street."},"currency":{"type":"string","description":"One of: USD, EUR, GBP, CAD, USDT, USDC, AED, CNY, ZAR, XOF, XAF, CHF, JPY, DKK, SAR."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"days":7,"trend":{"low":1362.09,"high":1375.31,"direction":"appreciating","change_pct":-0.71},"market":"official","currency":"USD","snapshots":[{"ask":1365.53,"bid":1364.53,"mid":1365.53,"date":"2026-07-28"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_wJ8TuXrn9J79IKV2rbD0g","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns daily historical Nigerian naira exchange rate series (official, parallel, or crypto street) for a given currency, including trend, high, and low, for up to 365 days.","exampleAgentPrompt":"Pull me the last 90 days of naira exchange rate history for USD on the parallel market, including the trend and daily high and low.","exampleUseCases":[{"title":"Naira depreciation trend analysis","prompt":"Get me the naira to USD rate history for the past 365 days on the official CBN market — I want to see the trend and daily highs and lows to understand how the naira has moved over the past year."},{"title":"Crypto stablecoin street price research","prompt":"What have USDT street prices in Nigeria looked like over the last 30 days? Pull the crypto_street market history so I can see the daily rates, highs, and lows."},{"title":"Parallel vs official rate comparison","prompt":"Fetch 7 days of naira to GBP rate history for both the official and parallel markets so I can compare them side by side."}],"resultDescription":"A time-series array of daily Nigerian naira exchange rate records for the requested currency and market, covering up to 365 days. Each record includes the date, exchange rate, and likely high, low, and trend indicators for that day. Metadata may include the market type and currency pair queried.","failureModes":["Unsupported currency code returns an error — only specific currencies (USD, EUR, GBP, CAD, USDT, USDC, AED, CNY, ZAR, XOF, XAF, CHF, JPY, DKK, SAR) are accepted","Invalid market value (not 'official', 'parallel', or 'crypto_street') causes a validation error","Days parameter outside 1-365 range is rejected","Payment failure or missing x402 payment results in 402 Payment Required response","Requesting official data before 2001 may return empty or partial series","Network timeout on large date ranges (close to 365 days)"],"whenToPreferThis":"Choose this endpoint when you need historical daily naira FX rate data specifically — especially for Nigerian market contexts requiring official CBN rates, parallel (black market) rates, or crypto street prices. It is the right choice when you need trend, high, and low data over a configurable window up to one year. Prefer the 'upto' pricing scheme for shorter windows to reduce cost. Not suitable for real-time tick data, non-Nigerian currency pairs, or non-naira base currencies.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:31:48.238Z","isFirstParty":false}