Skip to content
GET /v1/board

Economies ranked by year-on-year retail-sales growth

Try it live

10 free calls per day — no sign-up, no API key. Goes through the oanor gateway.

Custom headers (optional)
api.oanor.com/retailsales-api

It works. Grab an API key and use it in your project.

Get an API key

Code snippets

curl "https://api.oanor.com/retailsales-api/v1/board" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/retailsales-api/v1/board", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/retailsales-api/v1/board");
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/retailsales-api/v1/board",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "note": "Economies ranked by year-on-year retail-sales (retail trade volume) growth — the real, inflation-adjusted volume of goods sold. The headline read on consumer demand; feeds GDP nowcasts. Growth computed from the OECD's seasonally-adjusted retail-trade-volume index. Each row carries its own period; discontinued series are excluded. Monthly, cached a few hours.",
        "board": [
            {
                "mom": 2.59,
                "yoy": 20.64,
                "code": "TUR",
                "name": "Türkiye",
                "period": "2026-03",
                "reading": "consumers spending strongly",
                "is_aggregate": false
            },
            {
                "mom": 1.17,
                "yoy": 8.99,
                "code": "COL",
                "name": "Colombia",
                "period": "2026-03",
                "reading": "consumers spending strongly",
                "is_aggregate": false
            },
            {
                "mom": 1.87,
                "yoy": 8.23,
                "code": "LTU",
                "name": "Lithuania",
                "period": "2026-04",
                "reading": "consumers spending strongly",
                "is_aggregate": false
            },
            {
                "mom": -0.85,
                "yoy": 8.21,
                "code": "BGR",
                "name": "Bulgaria",
                "period": "2026-04",
                "reading": "consumers spending strongly",
                "is_aggregate": false
            },
            {
                "mom": -0.21,
                "yoy": 5.63,
                "code": "LUX",
                "name": "Luxembourg",
                "period": "2026-04",
                "reading": "consumers spending strongly",
                "is_aggregate": false
            },
            {
                "mom": 0.51,
                "yoy": 5.14,
                "code": "ISR",
                "name": "Israel",
                "period": "2026-02",
                "reading": "consumers spending strongly",
                "is_aggregate": false
            },
            {
                "mom": -0.75,
                "yoy": 4.86,
                "code": "PRT",
                "name": "Portugal",
                "period": "2026-04",
                "reading": "consumers spending strongly",
                "is_aggregate": false
            },
            {
                "mom": -0.4,
                "yoy": 4.47,
                "code": "SWE",
                "name": "Sweden",
                "period": "2026-04",
                "reading": "consumers spending strongly",
                "is_aggregate": false
            },
            {
                "mom": -1.12,
                "yoy": 3.31,
                "code": "HUN",
                "name": "Hungary",
                "period": "2026-04",
                "reading": "retail growing",
                "is_aggregate": false
            },
            {
…