# Big Mac Index API > The Economist's Big Mac Index — "burgernomics" — as an API: how over- or under-valued the world's currencies are, measured by the price of a Big Mac. The same burger costing different amounts across countries reveals purchasing-power-parity (PPP) misalignment in exchange rates. The index endpoint returns the latest release for every country — the local Big Mac price, its US-dollar price at the market exchange rate, and the raw and GDP-adjusted over/under-valuation of that currency against a chosen base (USD, EUR, GBP, JPY or CNY). The country endpoint returns one country's full history — the valuation trend over every release since 2000. The extremes endpoint returns the most over-valued and most under-valued currencies in the latest release. A positive valuation means the currency is over-valued versus the base; negative means under-valued; the GDP-adjusted figure corrects for cheaper labour in poorer countries. This is a PPP / currency-valuation data-cut — a fundamental gauge, not a live FX tick — distinct from the spot-rate, central-bank and conversion APIs in the catalogue. Live from the open dataset, no key on the upstream, nothing stored. ## Authentication All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys. ```bash curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/bigmac-api/..." ``` ## Pricing - **Free** (Free) — 24,000 calls/Mo, 5 req/s - **Starter** ($6/Mo) — 290,000 calls/Mo, 12 req/s - **Pro** ($17/Mo) — 1,230,000 calls/Mo, 30 req/s - **Scale** ($39/Mo) — 4,400,000 calls/Mo, 80 req/s ## Endpoints ### Index #### `GET /v1/country` — One country's valuation history since 2000 **Parameters:** - `country` (query, required, string) — Country name, ISO3 or currency code Example: `Switzerland` - `base` (query, optional, string) — Base currency Example: `usd` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/bigmac-api/v1/country?country=Switzerland&base=usd" ``` **Response:** ```json { "data": { "iso3": "CHE", "latest": { "iso3": "CHE", "country": "Switzerland", "currency": "CHF", "local_price": 7.3, "dollar_price": 9.08412145345943, "raw_valuation_pct": 48.4, "dollar_exchange_rate": 0.8036, "adjusted_valuation_pct": 52.8 }, "source": "The Economist", "country": "Switzerland", "history": [ { "date": "2000-04-01", "local_price": 5.9, "dollar_price": 3.47058823529412, "raw_valuation_pct": 54.9, "adjusted_valuation_pct": 68.6 }, { "date": "2001-04-01", "local_price": 6.3, "dollar_price": 3.64161849710983, "raw_valuation_pct": 62.6, "adjusted_valuation_pct": 86.6 }, { "date": "2002-04-01", "local_price": 6.3, "dollar_price": 3.79518072289157, "raw_valuation_pct": 61.5, "adjusted_valuation_pct": 79.6 }, { "date": "2003-04-01", "local_price": 6.3, "dollar_price": 4.5985401459854, "raw_valuation_pct": 86.9, "adjusted_valuation_pct": 111.8 }, { "date": "2004-05-01", …(truncated, see openapi.json for full schema) ``` #### `GET /v1/extremes` — Most over- and under-valued currencies now **Parameters:** - `base` (query, optional, string) — Base currency Example: `usd` - `limit` (query, optional, string) — How many each side (max 25) Example: `5` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/bigmac-api/v1/extremes?base=usd&limit=5" ``` **Response:** ```json { "data": { "source": "The Economist", "release_date": "2026-01-01", "base_currency": "USD", "most_overvalued": [ { "iso3": "CHE", "country": "Switzerland", "currency": "CHF", "local_price": 7.3, "dollar_price": 9.08412145345943, "raw_valuation_pct": 48.4, "dollar_exchange_rate": 0.8036, "adjusted_valuation_pct": 52.8 }, { "iso3": "URY", "country": "Uruguay", "currency": "UYU", "local_price": 339, "dollar_price": 8.7585583257977, "raw_valuation_pct": 43.1, "dollar_exchange_rate": 38.705, "adjusted_valuation_pct": 83.9 }, { "iso3": "NOR", "country": "Norway", "currency": "NOK", "local_price": 76, "dollar_price": 7.51548833368768, "raw_valuation_pct": 22.8, "dollar_exchange_rate": 10.11245, "adjusted_valuation_pct": 27.4 }, { "iso3": "SWE", "country": "Sweden", "currency": "SEK", "local_price": 67, "dollar_price": 7.25901689075721, "raw_valuation_pct": 18.6, "dollar_exchang …(truncated, see openapi.json for full schema) ``` #### `GET /v1/index` — Latest Big Mac index for every country **Parameters:** - `base` (query, optional, string) — Base currency: usd, eur, gbp, jpy, cny Example: `usd` - `sort` (query, optional, string) — valuation, name or price Example: `valuation` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/bigmac-api/v1/index?base=usd&sort=valuation" ``` **Response:** ```json { "data": { "count": 54, "source": "The Economist", "countries": [ { "iso3": "CHE", "country": "Switzerland", "currency": "CHF", "local_price": 7.3, "dollar_price": 9.08412145345943, "raw_valuation_pct": 48.4, "dollar_exchange_rate": 0.8036, "adjusted_valuation_pct": 52.8 }, { "iso3": "URY", "country": "Uruguay", "currency": "UYU", "local_price": 339, "dollar_price": 8.7585583257977, "raw_valuation_pct": 43.1, "dollar_exchange_rate": 38.705, "adjusted_valuation_pct": 83.9 }, { "iso3": "NOR", "country": "Norway", "currency": "NOK", "local_price": 76, "dollar_price": 7.51548833368768, "raw_valuation_pct": 22.8, "dollar_exchange_rate": 10.11245, "adjusted_valuation_pct": 27.4 }, { "iso3": "SWE", "country": "Sweden", "currency": "SEK", "local_price": 67, "dollar_price": 7.25901689075721, "raw_valuation_pct": 18.6, "dollar_exchange_rate": 9.2299, "adjusted_valuation_pc …(truncated, see openapi.json for full schema) ``` ### Meta #### `GET /v1/meta` — Spec **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/bigmac-api/v1/meta" ``` **Response:** ```json { "data": { "note": "A positive valuation means the currency is over-valued versus the base; negative means under-valued. base is usd (default), eur, gbp, jpy or cny. The GDP-adjusted figure corrects for the fact that cheap labour makes burgers cheaper in poorer countries. country accepts a name, ISO3 code or currency code.", "source": "The Economist big-mac-data (GitHub, updated ~twice a year)", "service": "bigmac-api", "countries": 54, "endpoints": { "GET /v1/meta": "This document.", "GET /v1/index": "Latest Big Mac index for every country — price & valuation vs a base (base=usd, sort=valuation).", "GET /v1/country": "One country's valuation history since 2000 (country=Switzerland or country=CHF).", "GET /v1/extremes": "The most over- and under-valued currencies right now (base=usd, limit=5)." }, "description": "The Economist's Big Mac Index ('burgernomics') as an API — how over- or under-valued the world's currencies are, from the price of a Big Mac (purchasing-power parity). index returns the latest release for every country (local price, US-dollar price, raw and GDP-adjusted valuation vs a base currency); country returns one country's valuation history since 2000; extremes returns the most over- and under-valued currencies now. Live from the open dataset, no key, nothing stored. A PPP / currency-valuation data-cut — fundamental, not a live FX tick — distinc …(truncated, see openapi.json for full schema) ``` --- Marketplace page: https://www.oanor.com/api/bigmac-api OpenAPI spec: https://www.oanor.com/api/bigmac-api/openapi.json