{"openapi":"3.1.0","info":{"title":"Banco Central do Brasil API","version":"1.0.0","description":"Live official Brazilian monetary and FX data, served straight from the Central Bank of Brazil's open SGS and PTAX APIs — no key, nothing cached. Brazil is the largest economy in Latin America and one of the highest-yielding major markets, and this exposes its headline numbers as clean JSON. The indicators endpoint returns the whole dashboard in one call: the Selic policy target rate set by the Copom, the CDI interbank rate, IPCA monthly and 12-month inflation, and the official USD/BRL and EUR/BRL PTAX exchange rates — in mid-2026 Selic sat at 14.50%, 12-month IPCA near 4.4% and the dollar around 5.17 reais. The selic endpoint returns the policy rate the Central Bank uses to steer the economy, with recent history. The inflation endpoint returns IPCA, Brazil's official consumer price index, both monthly and accumulated over twelve months. The exchange endpoint returns the official PTAX USD/BRL and EUR/BRL closing rates with recent history. The series endpoint exposes any of the thousands of time series in the Central Bank's SGS database by its numeric code, so you can pull Brazilian interest rates, prices, credit and monetary aggregates on demand. Everything is the Central Bank's own published data, live, nothing stored. This is the Brazil rates-and-FX layer for any fixed-income, forex, emerging-markets or macro app. Distinct from the ECB, Fed, Bank of Canada, Norges Bank and Bank of England APIs — this is Brazil's Selic, IPCA and the real. 6 endpoints, no key on our side.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/bcb-api","description":"oanor gateway"}],"tags":[{"name":"Brazil"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/exchange":{"get":{"operationId":"get_v1_exchange","tags":["Brazil"],"summary":"PTAX USD/BRL and EUR/BRL","description":"","parameters":[{"name":"history","in":"query","required":false,"description":"Days of USD/BRL history (default 20)","schema":{"type":"string"},"example":"10"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"base":"BRL","source":"Banco Central do Brasil (PTAX)","eur_brl":{"date":"2026-06-08","rate":5.9682},"usd_brl":{"date":"2026-06-08","rate":5.1695},"usd_brl_history":[{"date":"2026-05-25","rate":5.0072},{"date":"2026-05-26","rate":5.0211},{"date":"2026-05-27","rate":5.0579},{"date":"2026-05-28","rate":5.0517},{"date":"2026-05-29","rate":5.0569},{"date":"2026-06-01","rate":5.0303},{"date":"2026-06-02","rate":5.016},{"date":"2026-06-03","rate":5.0415},{"date":"2026-06-05","rate":5.1244},{"date":"2026-06-08","rate":5.1695}],"quote_convention":"1 USD / 1 EUR in BRL (PTAX sell)"},"meta":{"timestamp":"2026-06-09T11:38:29.580Z","request_id":"a074e72d-010a-400e-9cc5-657462d1697d"},"status":"ok","message":"Exchange rates retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/indicators":{"get":{"operationId":"get_v1_indicators","tags":["Brazil"],"summary":"Headline dashboard","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"source":"Banco Central do Brasil","country":"Brazil","eur_brl":{"date":"2026-06-08","value":5.9682},"usd_brl":{"date":"2026-06-08","value":5.1695},"currency":"BRL","ipca_12m_pct":{"date":"2026-04-01","value":4.39},"cdi_daily_pct":{"date":"2026-06-05","value":0.0534},"ipca_month_pct":{"date":"2026-04-01","value":0.67},"selic_target_pct":{"date":"2026-06-17","value":14.5}},"meta":{"timestamp":"2026-06-09T11:38:31.003Z","request_id":"9c7661db-9976-4c95-923b-9ee33388f62f"},"status":"ok","message":"Indicators retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/inflation":{"get":{"operationId":"get_v1_inflation","tags":["Brazil"],"summary":"IPCA inflation","description":"","parameters":[{"name":"history","in":"query","required":false,"description":"Number of past months (default 12)","schema":{"type":"string"},"example":"6"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"unit":"%","month":"2026-04-01","source":"Banco Central do Brasil","history":[{"date":"2025-11-01","month_pct":0.18},{"date":"2025-12-01","month_pct":0.33},{"date":"2026-01-01","month_pct":0.33},{"date":"2026-02-01","month_pct":0.7},{"date":"2026-03-01","month_pct":0.88},{"date":"2026-04-01","month_pct":0.67}],"indicator":"IPCA — Brazil official consumer price index","month_pct":0.67,"accumulated_12m_pct":4.39,"accumulated_12m_date":"2026-04-01"},"meta":{"timestamp":"2026-06-09T11:38:31.542Z","request_id":"20bf6d3a-73b3-4e70-8fe8-61bb7e1967f4"},"status":"ok","message":"Inflation retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/selic":{"get":{"operationId":"get_v1_selic","tags":["Brazil"],"summary":"Selic policy target rate","description":"","parameters":[{"name":"history","in":"query","required":false,"description":"Number of past values (default 12)","schema":{"type":"string"},"example":"6"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"date":"2026-06-17","unit":"% per year","source":"Banco Central do Brasil","history":[{"date":"2026-06-12","rate_pct":14.5},{"date":"2026-06-13","rate_pct":14.5},{"date":"2026-06-14","rate_pct":14.5},{"date":"2026-06-15","rate_pct":14.5},{"date":"2026-06-16","rate_pct":14.5},{"date":"2026-06-17","rate_pct":14.5}],"rate_pct":14.5,"indicator":"Selic — Brazil policy target rate (Copom)"},"meta":{"timestamp":"2026-06-09T11:38:32.085Z","request_id":"862e0e5b-9a01-4eb0-a4be-78546025b9e1"},"status":"ok","message":"Selic retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/series":{"get":{"operationId":"get_v1_series","tags":["Brazil"],"summary":"Any SGS time series by code","description":"","parameters":[{"name":"code","in":"query","required":true,"description":"Numeric SGS series code","schema":{"type":"string"},"example":"433"},{"name":"n","in":"query","required":false,"description":"Number of observations (default 12, max 1000)","schema":{"type":"string"},"example":"6"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":6,"latest":{"date":"2026-04-01","value":0.67},"source":"Banco Central do Brasil — SGS","sgs_code":433,"observations":[{"date":"2025-11-01","value":0.18},{"date":"2025-12-01","value":0.33},{"date":"2026-01-01","value":0.33},{"date":"2026-02-01","value":0.7},{"date":"2026-03-01","value":0.88},{"date":"2026-04-01","value":0.67}]},"meta":{"timestamp":"2026-06-09T11:38:32.453Z","request_id":"261fce0a-f494-43e0-b85b-fc3b0018952b"},"status":"ok","message":"Series retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Spec","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":1000,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1000,"monthly_call_quota":20000,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2700,"monthly_call_quota":120000,"rps_limit":15,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":6400,"monthly_call_quota":700000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/bcb-api"}