Skip to content
GET /v1/economy

Economies ranked by the consumer economic-situation outlook

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/consumersurvey-api

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

Get an API key

Code snippets

curl "https://api.oanor.com/consumersurvey-api/v1/economy" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/consumersurvey-api/v1/economy", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/consumersurvey-api/v1/economy");
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/consumersurvey-api/v1/economy",
    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 the consumer economic-situation balance — the share of households expecting the general economy to improve over the next year minus those expecting it to worsen. A positive balance means households are optimistic; it leads consumer spending. Each row carries its own month; discontinued series excluded. Monthly, cached a few hours.",
        "board": [
            {
                "code": "CHN",
                "name": "China (People’s Republic of)",
                "change": -0.6,
                "period": "2026-04",
                "balance": 90.5,
                "is_aggregate": false
            },
            {
                "code": "MEX",
                "name": "Mexico",
                "change": -1.6,
                "period": "2026-05",
                "balance": 43.3,
                "is_aggregate": false
            },
            {
                "code": "CHL",
                "name": "Chile",
                "change": 1.2,
                "period": "2026-05",
                "balance": 41.3,
                "is_aggregate": false
            },
            {
                "code": "HUN",
                "name": "Hungary",
                "change": 27,
                "period": "2026-05",
                "balance": 10.5,
                "is_aggregate": false
            },
            {
                "code": "COL",
                "name": "Colombia",
                "change": -10.5,
                "period": "2026-04",
                "balance": 9.2,
                "is_aggregate": false
            },
            {
                "code": "KOR",
                "name": "Korea",
                "change": 14,
                "period": "2026-05",
                "balance": -7,
                "is_aggregate": false
            },
            {
                "code": "CZE",
                "name": "Czechia",
                "change": 3,
                "period": "2026-05",
                "balance": -13.3,
                "is_aggregate": false
            },
            {
                "code": "SWE",
                "name": "Sweden",
                "change": 2.4,
                "period": "2026-05",
                "balance": -14.2,
                "is_aggregate": false
            },
            {
                "code": "LTU",
                "name": "Lithuania",
                "change": 6.7,
                "period": "2026-05",
                "balance": -16.2,
                "is_aggregate": false
            },
            {
                "code": "TUR",
                "name": "Türkiye",
                "change": 3.1,
                "period": "2026-05",
                "balance": -18.6,
                "is_aggregate": false
            },
            {
                "code": "POL",
                "name": "Poland",
                "change": 2.9,
                "period": "2026-05",
                "balance": -20.9,
                "is_aggregate": false
            },

…