🔌 PriceRadar Data API

Programmatic access to PriceRadar's daily-archived Nigerian price data. FX, petrol, gas, /how-much bands, bus fares, product cheapest — accumulating from May 2026 onward as a uniquely citable NG dataset.

Quickstart

Try it right now — no key needed:

curl https://www.priceradar.ng/api/history?series=fx.usd

Using this commercially?

The free tier works for hobby + attribution use. Banks, research firms, fintechs and media — see licensing tiers for higher limits, dedicated subdomain, SLA, and bulk CSV exports.

See pricing →

Endpoints

GET
/api/history
Returns dates range, count, list of all archived days. Use this to discover the data window.
GET
/api/history?date=2026-05-24
All series captured on that date: FX, petrol, gas, bands, bus, product cheapest.
GET
/api/history?series=fx.usd
USD/NGN rate every available day. Dot notation: bucket.key. Examples: fx.usd, petrol.lagos, gas.kano, bands.bag-of-cement, bus.lagos-to-abuja, product.iphone-15-128gb.
GET
/api/history?series=fx.usd&fmt=csv
Two-column CSV (date,value) suitable for Excel/Sheets/R/Python.

Series keys

Series are addressed by bucket.key. Lookup is case-insensitive on the key.

FX (currencies → NGN)
fx.usd · fx.gbp · fx.eur · fx.cad ·
fx.aed · fx.zar · fx.ghs · …
Petrol (PMS, NGN/L)
petrol.national · petrol.lagos ·
petrol.abuja · petrol.kano · …
Gas (LPG, NGN/kg)
gas.national · gas.lagos · gas.rivers · …
/how-much bands (typical ₦)
bands.bag-of-cement · bands.bag-of-rice ·
bands.rent-2-bedroom-lagos · …
Bus fares (cheapest ₦)
bus.lagos-to-abuja · bus.lagos-to-ph · …
Products (cheapest ₦)
product.<id> · product.median.<category>
What you get
Free · forever
No key, no signup, no rate limits beyond standard IP throttling.
  • Unlimited reads of /api/history (manifest + single-day + single-series)
  • JSON + CSV output formats
  • 1-hour edge cache (responses served from Vercel CDN)
  • Same source data the public PriceRadar site uses
  • No API key required — no signup
  • Free for any use, including commercial

Terms + attribution

Use the API freely for anything — personal projects, research, commercial products. Attribution requested: link to priceradar.ng/data wherever you display the data, but it's a request not a requirement. PriceRadar retains rights to the dataset; you get an unlimited-use license to query and redistribute the responses.