Spec

Extraits de code

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

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

$ch = curl_init("https://api.oanor.com/bcb-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/bcb-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": {
        "source": "Banco Central do Brasil — SGS + PTAX (live)",
        "service": "bcb-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/selic": "Selic policy target rate + history (history=N).",
            "GET /v1/series": "Any SGS time series by code (code=433, n=).",
            "GET /v1/exchange": "Official PTAX USD/BRL and EUR/BRL + USD/BRL history.",
            "GET /v1/inflation": "IPCA monthly + 12-month accumulated + history.",
            "GET /v1/indicators": "Headline dashboard in one call: Selic, CDI, IPCA, USD/BRL, EUR/BRL."
        },
        "description": "Live official Brazilian monetary and FX data from the Central Bank of Brazil's open SGS and PTAX APIs: a one-call indicators dashboard (Selic target, CDI, IPCA monthly and 12-month, USD/BRL and EUR/BRL); the Selic policy rate with history; IPCA inflation monthly and accumulated over twelve months; the official PTAX USD/BRL and EUR/BRL closing rates with history; and any of the thousands of SGS time series by code. Live, no key, nothing stored. Distinct from the ECB, Fed, Bank of Canada, Norges Bank and Bank of England APIs — this is Brazil's Selic, IPCA and the real.",
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-09T11:38:32.847Z",
        "request_id": "03e54084-3681-4944-87dc-09cc7e9d1187"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}