One economy's inflation-expectations and economic-situation balances

Code snippets

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

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

$ch = curl_init("https://api.oanor.com/consumersurvey-api/v1/country");
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/country",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

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

{
    "data": {
        "code": "USA",
        "name": "United States",
        "note": "One economy's consumer survey: the inflation-expectations balance (how much households expect prices to rise over the year ahead) and the economic-situation balance (whether they expect the economy to improve), each a percentage balance around zero with the month-on-month change. Soft data that leads consumer spending and informs central-bank policy. Monthly, cached a few hours.",
        "period": "2026-05",
        "source": "OECD Consumer Opinion Surveys (SDMX)",
        "is_aggregate": false,
        "economic_situation": {
            "change": -6,
            "balance": -51
        },
        "inflation_expectations": {
            "change": 0.7,
            "balance": 8.3
        }
    },
    "meta": {
        "timestamp": "2026-06-12T19:36:33.811Z",
        "request_id": "798eb911-f464-400e-8764-b345254f5aee"
    },
    "status": "ok",
    "message": "Country consumer survey retrieved successfully",
    "success": true
}