Open Economics API

A free, read-only semantic routing layer for authoritative Brazilian economic data.

• Semantic API: https://open-economics-data.knbf982hkn.chatgpt.site/api/v2
• Stable series API: https://open-economics-data.knbf982hkn.chatgpt.site/api/v1
• MCP: https://open-economics-data.knbf982hkn.chatgpt.site/api/mcp
• Ask the data: https://open-economics-data.knbf982hkn.chatgpt.site/en/ask
• MCP setup: https://open-economics-data.knbf982hkn.chatgpt.site/en/mcp
• Agent installer: llms-install.md
• Documentation: https://open-economics-data.knbf982hkn.chatgpt.site/en/docs
• Runnable examples: https://open-economics-data.knbf982hkn.chatgpt.site/en/guides
• Source and issue tracker: https://github.com/felipegambettadesouza6-jpg/open-economics
• Reliability policy: RELIABILITY.md
• 2.0 release evidence: benchmarks/RELEASE-READINESS.md
• Contributing: CONTRIBUTING.md
• Security: SECURITY.md

Run a real economic question → · Connect the MCP server →

Open Economics 2.0 starts with a real economic-information need, resolves its meaning independently of current coverage, and then routes it to official data. Its synchronized catalog currently exposes 12,875 BCB SGS series and IBGE aggregates, plus direct SICONFI fiscal-report, MDIC Comex Stat, and ANP fuel-price access and versioned EPE electricity-consumption, MTE Novo Caged, CVM investment-fund, Tesouro RTN fiscal, and RMD Federal Public Debt data (12,886 official datasets in total). The 32 convenient v1 series IDs remain compatible.

Discovery, REST, the existing product, and MCP share one semantic core. A resolved concept is kept separate from availability, so an unsupported need is reported explicitly instead of being silently mapped to a nearby series. Units, dimensions, reference periods, source identifiers, raw values, methodology links, and retrieval provenance travel with the data.

Start with the economic need

curl --fail --silent \
  "https://open-economics-data.knbf982hkn.chatgpt.site/api/v2/search?q=desemprego%20desde%202015"

curl --fail --silent \
  "https://open-economics-data.knbf982hkn.chatgpt.site/api/v2/datasets/ibge-aggregates%3A6381/schema"

For BCB, /api/v2/datasets/bcb-sgs:{code}/observations provides direct series access with authoritative frequency, unit, source, coverage, formula, and warning metadata. For IBGE, inspect /schema, then send explicit variable, periods, locality, and classification selections to /observations. SICONFI DCA, RREO, and RGF use the same dataset routes while retaining entity, reporting period, annex, account, column, and raw value. Official multidimensional structure is preserved instead of flattened away. Comex Stat preserves trade-flow dimensions and metrics. ANP fuel-price queries return period/geography/product aggregates calculated from official station observations, with source counts and the transformation disclosed while station identity and address fields are excluded. EPE and MTE serve compact, versioned snapshots of official workbooks: electricity retains geography/class/market, while adjusted Novo Caged stock and flows retain their separate national, region/state, or economic-activity breakdowns. CVM daily fund reports retain fund/class identity and quota values; classification aggregates sum only additive measures and identify incomplete filing dates. RTN retains its monthly account hierarchy and above-the-line cash/effective-payment conventions. RMD debt statistics keep composition, holder, maturity, and cost tables separate, with their official units, defini

... View full README on GitHub