# Business & Consumer Confidence API > How optimistic the firms and households of each economy are right now — the OECD Business and Consumer Confidence Indicators as an API, live from the OECD's official statistics, no key. Confidence is soft data: it comes from monthly surveys asking businesses about orders, output and expectations, and consumers about their finances and the outlook, and it moves before the hard data does, which makes it one of the most-watched early reads on demand. The OECD standardises both into amplitude-adjusted indices that oscillate around 100 — above 100 means confidence is above its long-term average (optimism), below 100 means below average (pessimism) — and the direction (rising or falling) tells you whether sentiment is improving or deteriorating. The business endpoint returns the Business Confidence Indicator (BCI) for every economy the OECD tracks (and the aggregates — G7, G20, OECD, the euro area), ranked, each with its current value, month-on-month change, optimism/pessimism reading and direction. The consumer endpoint returns the Consumer Confidence Indicator (CCI) the same way. The country endpoint puts both side by side for one economy — the firm view and the household view together, with a combined read. Discontinued series are excluded and each reading carries its own period, so the board is genuinely current. The survey-based confidence / soft-data cut — distinct from the OECD composite-leading-indicator board (a different measure built to lead GDP), from the bond-yield and inflation boards, and from the generic multi-provider data aggregator. Figures are monthly; this is the sentiment lens on the world's economies. ## 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/confidence-api/..." ``` ## Pricing - **Free** (Free) — 860 calls/Mo, 2 req/s - **Starter** ($11/Mo) — 19,100 calls/Mo, 6 req/s - **Pro** ($32/Mo) — 96,500 calls/Mo, 16 req/s - **Business** ($73/Mo) — 524,000 calls/Mo, 40 req/s ## Endpoints ### Business #### `GET /v1/business` — Business Confidence Indicator for every economy, ranked **Parameters:** - `countries_only` (query, optional, string) — Drop aggregate groups (true) Example: `true` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/confidence-api/v1/business?countries_only=true" ``` **Response:** ```json { "data": { "note": "The OECD amplitude-adjusted Business Confidence Indicator (BCI) for every tracked economy (and aggregates unless countries_only=true), ranked. The index oscillates around 100: above 100 = confidence above its long-term average (optimism), below 100 = pessimism; direction gives whether sentiment is improving or deteriorating. Survey-based soft data, leads the hard data. Each row carries its own period (economies report with a varying lag); discontinued series are excluded. Monthly, cached a few hours.", "board": [ { "code": "HRV", "mood": "optimism", "name": "Croatia", "value": 101.877, "change": 0.497, "period": "2026-04", "reading": "optimistic and improving", "previous": 101.38, "direction": "rising", "is_aggregate": false }, { "code": "ISR", "mood": "optimism", "name": "Israel", "value": 101.724, "change": -0.381, "period": "2026-03", "reading": "optimistic but softening", "previous": 102.105, "direction": "falling", "is_aggregate": false }, { "code": "GRC", "mood": "optimism", "name": "Greece", " …(truncated, see openapi.json for full schema) ``` ### Consumer #### `GET /v1/consumer` — Consumer Confidence Indicator for every economy, ranked **Parameters:** - `countries_only` (query, optional, string) — Drop aggregate groups (true) Example: `true` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/confidence-api/v1/consumer?countries_only=true" ``` **Response:** ```json { "data": { "note": "The OECD amplitude-adjusted Consumer Confidence Indicator (CCI) for every tracked economy (and aggregates unless countries_only=true), ranked. The index oscillates around 100: above 100 = confidence above its long-term average (optimism), below 100 = pessimism; direction gives whether sentiment is improving or deteriorating. Survey-based soft data, leads the hard data. Each row carries its own period (economies report with a varying lag); discontinued series are excluded. Monthly, cached a few hours.", "board": [ { "code": "CRI", "mood": "optimism", "name": "Costa Rica", "value": 105.41, "change": 0.518, "period": "2026-02", "reading": "optimistic and improving", "previous": 104.892, "direction": "rising", "is_aggregate": false }, { "code": "HUN", "mood": "optimism", "name": "Hungary", "value": 102.429, "change": 0.885, "period": "2026-05", "reading": "optimistic and improving", "previous": 101.545, "direction": "rising", "is_aggregate": false }, { "code": "IND", "mood": "optimism", "name": "India", …(truncated, see openapi.json for full schema) ``` ### Country #### `GET /v1/country` — Business + consumer confidence side by side for one economy **Parameters:** - `country` (query, required, string) — ISO-3 code or name Example: `USA` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/confidence-api/v1/country?country=USA" ``` **Response:** ```json { "data": { "code": "USA", "name": "United States", "note": "One economy's OECD Business and Consumer Confidence side by side. Both indices oscillate around 100 (above = optimism). Survey-based soft data that leads the hard data. Monthly, cached a few hours.", "period": "2026-04", "source": "OECD Business & Consumer Confidence (SDMX)", "is_aggregate": false, "combined_read": "both firms and households pessimistic", "business_confidence": { "mood": "pessimism", "value": 99.97, "change": 0.057, "reading": "pessimistic but recovering", "direction": "rising" }, "consumer_confidence": { "mood": "pessimism", "value": 95.631, "change": -0.466, "reading": "pessimistic and deteriorating", "direction": "falling" } }, "meta": { "timestamp": "2026-06-12T19:37:51.816Z", "request_id": "eeee82a7-94d4-4b77-9f4b-8f3d98b1c25b" }, "status": "ok", "message": "Country confidence retrieved successfully", "success": true } ``` ### Meta #### `GET /v1/meta` — Service metadata **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/confidence-api/v1/meta" ``` **Response:** ```json { "data": { "note": "business and consumer take countries_only (true to drop aggregates). country takes country (ISO-3 code or name, required). meta takes no parameters. Index values are points around 100; the mood is above/below 100 and the direction is rising/falling. Monthly data; a multi-hour protective cache fronts the OECD upstream.", "source": "OECD Business (BCICP) & Consumer (CCICP) Confidence via OECD SDMX API, amplitude-adjusted, live, keyless", "service": "confidence-api", "endpoints": { "GET /v1/meta": "This document.", "GET /v1/country": "Business + consumer confidence side by side for one economy (country=USA).", "GET /v1/business": "Business Confidence Indicator (BCI) for every economy, ranked (countries_only optional).", "GET /v1/consumer": "Consumer Confidence Indicator (CCI) for every economy, ranked (countries_only optional)." }, "description": "OECD Business & Consumer Confidence — how optimistic firms and households are in each economy, live from the OECD (no key). Both are amplitude-adjusted survey indices around 100 (above = optimism, below = pessimism) that lead the hard data. business returns the Business Confidence Indicator for every economy ranked; consumer returns the Consumer Confidence Indicator; country puts both side by side for one economy with a combined read. The survey-based soft-data / sentiment cut — distinct from the OECD composite-l …(truncated, see openapi.json for full schema) ``` --- Marketplace page: https://www.oanor.com/api/confidence-api OpenAPI spec: https://www.oanor.com/api/confidence-api/openapi.json