Economies ranked by year-on-year retail-sales growth
API · /retailsales-api
Retail Sales API
healthy
3,680 Subscribers
How much consumers in each economy are actually spending, and which way the high street is turning — the OECD retail trade volume as an API, live from the OECD's official statistics, no key. Retail trade volume is the headline monthly read on consumer demand: it measures the real, inflation-adjusted volume of goods sold by retailers, and its year-on-year change tells you whether households are opening their wallets or pulling back. Consumer spending is the largest part of most economies, so the retail print moves markets and feeds straight into GDP nowcasts — and the latest month-on-month move is the bit traders react to first. The OECD publishes a seasonally-adjusted retail-trade-volume index for each economy; this API turns it into the numbers people use — the year-on-year and month-on-month growth of retail sales. The board endpoint ranks every economy by its year-on-year retail growth, so you can see where consumers are spending and where demand is fading. The momentum endpoint ranks by the latest month-on-month move — who is accelerating or rolling over right now. The country endpoint gives one economy's retail growth, year-on-year and month-on-month, with a plain-language read. Each reading carries its own period and discontinued series are excluded, so the board is genuinely current. The consumer-demand / retail hard-data cut — distinct from the industrial-production board (the supply side, factory output), the leading-indicator and confidence boards (soft survey data), and the generic multi-provider data aggregator. Figures are monthly, in percent.
api.oanor.com/retailsales-api
API health
healthy- Uptime
- 100.00%
- Server probes · 24h
- Avg latency
- 840 ms
- Server probes · 24h
- Subscribers
- 3,680
- active
- Total calls
- 68
- last 7 days
Pricing
Pick a tier — billed monthly, cancel anytime.
Free
Free
- 795 calls / month
- 2 requests / second
- Hard cap (429 above quota, no overage)
- 795 calls/month
- 2 req/sec
- All endpoints
- No credit card
Starter
€11.30 /month
- 17,600 calls / month
- 6 requests / second
- Hard cap (429 above quota, no overage)
- 17,600 calls/month
- 6 req/sec
- Retail & momentum boards
- Email support
Pro
€34.20 /month
- 89,800 calls / month
- 16 requests / second
- Hard cap (429 above quota, no overage)
- 89,800 calls/month
- 16 req/sec
- All economies
- Priority support
Business
€77.80 /month
- 499,000 calls / month
- 40 requests / second
- Hard cap (429 above quota, no overage)
- 499,000 calls/month
- 40 req/sec
- Desk-grade throughput
- Dedicated SLA
Built by
Related APIs
Other APIs with overlapping tags.
OECD Economic Indicators API
Key macroeconomic indicators for the 38 OECD member countries, sourced from the official OECD SDMX data service. Pull the harmonised unemployment rate, the consumer price index and the long-term (10-year government bond) interest rate for any member country, look up a single indicator for one country, or read a full country snapshot with all indicators at once. Every value carries the indicator label, its unit and the exact period it refers to, and always resolves to the latest published observation — no date juggling. Coverage spans Australia to the United States, with the United Kingdom, Germany, Japan, France and every other OECD member in between. Built for dashboards, macro research and currency or rates models that need authoritative, comparable cross-country economic data. Distinct from market and FX feeds: this surfaces official OECD statistics.
api.oanor.com/oecd-api
Net International Investment Position API
The stock of external wealth — how much each economy owns abroad versus how much the rest of the world owns of it, live from the OECD's official balance-of-payments statistics, no key. Where the current account is the yearly flow of external lending or borrowing, the net international investment position (Net IIP) is the accumulated stock those flows pile up into: a country running persistent surpluses builds a large positive Net IIP and becomes a net creditor to the world (Norway, Japan, Germany, Switzerland), while persistent deficits build a large negative one — a net debtor, like the United States. The Net IIP is one of the deepest gauges of external sustainability and a structural anchor for a currency: a big positive position earns net income on foreign assets and is a buffer in a crisis, while a large negative one leaves a currency exposed to the willingness of foreigners to keep funding it. The board endpoint ranks economies by their Net IIP as a share of GDP — the size-neutral cross-country screen — from biggest net creditors to biggest net debtors. The gross endpoint ranks by gross external assets as a share of GDP, a measure of financial openness and international integration where small financial hubs tower with foreign assets worth multiples of GDP. The country endpoint gives one economy's full external balance sheet: the Net IIP in dollars and as a share of GDP, its gross foreign assets and liabilities, and the net position broken down by function — direct investment, portfolio investment, other investment and reserve assets, which sum to the net position — with a plain-language read. Each reading carries its own quarter and discontinued series are filtered out. This is the external-stock / net-foreign-wealth cut — the companion to, and distinct from, the current-account balance (the yearly flow, not the accumulated stock), trade growth, and the gross-government-debt and debt-service feeds (public-sector domestic debt, not the whole economy's external position). Positions are in billions of US dollars and percent of GDP; figures are quarterly end-of-period stocks.
api.oanor.com/netiip-api
Current Account Balance API
Whether each economy earns more from the rest of the world than it spends — the current-account balance, live from the OECD's official balance-of-payments statistics, no key. The current account is the single most important external-balance number in macro: it nets a country's trade in goods and services, its cross-border investment income, and its transfers into one figure. A surplus means the economy is a net lender to the world and is accumulating foreign claims; a deficit means it is a net borrower, financing its spending with foreign capital. Persistent current-account positions are one of the deepest drivers of exchange rates — surplus currencies (the yen, the euro-area core, the Nordics) tend to be structurally supported, while large-deficit currencies depend on continued capital inflows and are vulnerable when risk appetite turns. The board endpoint ranks economies by their current-account balance as a share of GDP — the size-neutral cross-country screen — from biggest surpluses to biggest deficits. The goods endpoint ranks by the merchandise (goods) trade balance as a share of GDP, separating the trade story from services and income. The country endpoint gives one economy's full external decomposition: the headline balance as a share of GDP, the goods / services / primary-income / secondary-income balances in US dollars (which sum exactly to the current account) and as shares of GDP, the six-quarter trend, and a plain-language read of whether the position is improving or deteriorating and what drives it. Each reading carries its own quarter and discontinued series are filtered out. This is the external-balance / balance-of-payments cut — distinct from trade growth (real export and import growth rates, the flow of volumes, not the net balance), and from the inflation, labour-cost and confidence feeds. The headline is percent of GDP; the decomposition is in billions of US dollars per quarter and percent of GDP; figures are quarterly, seasonally adjusted.
api.oanor.com/currentaccount-api
CPI Inflation Rate API
The headline consumer-price inflation print for every major economy, broken into its core and its drivers, live from the OECD's official price statistics — no key. Consumer-price inflation is the single most-watched macro number on earth: the gauge every central bank targets, the thing that sets the real value of wages, debts and savings, and a number whose surprises move bonds, currencies and equities within seconds. This API serves the year-on-year national CPI the way it is actually reported, for ~50 economies — and crucially it does not stop at the headline. For each economy it also serves the core rate (all items excluding food and energy, the measure policymakers really steer by), plus the food, energy and services rates themselves. That decomposition tells you whether a reading is a temporary food/energy shock or a stickier, demand-driven core problem: headline above core means volatile food/energy are pushing prices up; headline below core means they are dragging the print down while underlying inflation stays hot. The board endpoint ranks economies by headline inflation with core alongside; core ranks by the core rate; country gives one economy's full breakdown with the headline-vs-core read. Each reading carries its own month and discontinued series are filtered out, so the board is genuinely current. This is the realised-inflation cut — distinct from the inflation calculator (arithmetic from a rate you supply, not live data), from consumer inflation expectations (a survey of what households think prices will do, not what they did), and from unit labour costs and wages. Rates are percent year-on-year; figures are monthly.
api.oanor.com/cpiinflation-api
Frequently asked questions
Quick answers about pricing, quotas, and integration.
How do I get an API key for Retail Sales API?
Sign up for free at oanor.com, generate an API key from the developer dashboard, and call Retail Sales API with the x-oanor-key header. No credit card needed for the free tier.
What's the rate limit for Retail Sales API?
Free tier allows 1 request per second. Paid plans scale up to 50 requests per second on the Mega tier. Hard limits return HTTP 429 above the quota — no surprise overage charges.
How much does Retail Sales API cost?
Retail Sales API has a free tier with 100 calls / month. Paid plans start at €11.30 / month with higher quotas and faster rate limits.
Can I cancel my subscription anytime?
Yes. Plans are billed monthly and you can cancel anytime from your billing dashboard. No long-term contracts and no cancellation fee.
Is Retail Sales API GDPR-compliant?
All requests to Retail Sales API go through our EU-based gateway. Your upstream API key never leaves our server and no personal data is shared with the upstream provider beyond the request you send.
Pick an endpoint from the list on the left to see its details and try it.
Code snippets
Sign up to get an API key, then call any path under your slug.
curl https://api.oanor.com/retailsales-api/SOME_PATH \
-H "x-oanor-key: oanor_test_..."const res = await fetch("https://api.oanor.com/retailsales-api/SOME_PATH", {
headers: { "x-oanor-key": "oanor_test_..." }
});
const data = await res.json();$ch = curl_init("https://api.oanor.com/retailsales-api/SOME_PATH");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
$response = curl_exec($ch);import requests
r = requests.get(
"https://api.oanor.com/retailsales-api/SOME_PATH",
headers={"x-oanor-key": "oanor_test_..."},
)
print(r.json())Ratings
Sign in to rate.
No reviews yet.
Discussion
Ask questions, share usage tips, get answers from the provider and other developers. Public — anyone can read.
Sign in to start a thread or reply.
Sign inNew thread
📌 Pinned
🔒 Locked
·
·
·
-
Provider answer
🔒 This thread is locked — no new replies.
-
·
- No threads yet — start the discussion.
Support
Private 1:1 support with the provider — billing questions, integration issues, account problems. Only you and the provider team can see these threads.
Sign in to open a support ticket.
Sign inOpen new ticket
Describe what you need help with. The provider team gets an email and replies on the ticket page.
-
·
Urgent - No tickets yet for this API.