Spec

Extraits de code

curl "https://api.oanor.com/bigmac-api/v1/meta" \
  -H "x-oanor-key: oanor_test_..."

await fetch("https://api.oanor.com/bigmac-api/v1/meta", {
  headers: { "x-oanor-key": "oanor_test_..." }
});

$ch = curl_init("https://api.oanor.com/bigmac-api/v1/meta");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);

import requests
requests.get(
    "https://api.oanor.com/bigmac-api/v1/meta",
    headers={"x-oanor-key": "oanor_test_..."}
)

Exemple de réponse

Une réponse réelle de ce endpoint, capturée lors du dernier contrôle de santé.

{
    "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 — distinct from the spot-rate, central-bank and conversion APIs.",
        "latest_release": "2026-01-01",
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-12T01:41:32.943Z",
        "request_id": "501a987a-cfe3-4425-806b-6f8f5dd43668"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}