Referência da API

Macro

Séries macroeconômicas, expectativas Focus e regime

GET/v1/macro/gearsgetMacroGears

Engrenagens macro (sinais por seção)

Parâmetros

gearquerystring [monetary, inflation, growth, employment, credit, fiscal, external, sovereign_risk, global, currency, cross_asset]

atquerystring

Resposta 200

Sinais por engrenagem

object

as_ofstring | null

gearsobject[]

gearstring

indicatorsobject[]RegimeSignal

namestring

valuenumber | null

directionstring | nullupdownflatnull

lineageobjectLineage

sourcestring

referencestring

urlstring | null

unitstring | null

labelstring | null

datestring | null

Chamada

curl

curl -H "Authorization: Bearer db_live_xxxxxxxxxxxx" \
  "https://api.databolsa.com/v1/v1/macro/gears"

python · httpx

import httpx

resp = httpx.get(
    "https://api.databolsa.com/v1/v1/macro/gears",
    headers={"Authorization": "Bearer db_live_xxxxxxxxxxxx"},
)
resp.raise_for_status()
data = resp.json()

javascript · fetch

const resp = await fetch("https://api.databolsa.com/v1/v1/macro/gears", {
  headers: { Authorization: "Bearer db_live_xxxxxxxxxxxx" },
});
const data = await resp.json();

GET/v1/macro/regimegetMacroRegime

Regime econômico (quadrante crescimento × inflação)

Parâmetros

atquerystring

Resposta 200

Snapshot do regime

objectRegimeSnapshot

as_ofstring | null

quadrantstring | nullgrowth_up_inflation_upgrowth_up_inflation_downgrowth_down_inflation_upgrowth_down_inflation_downnull

growthobject

directionstring | nullupdownflatnull

signalsobject[]RegimeSignal

namestring

valuenumber | null

directionstring | nullupdownflatnull

lineageobjectLineage

sourcestring

referencestring

urlstring | null

unitstring | null

labelstring | null

datestring | null

inflationobject

directionstring | nullupdownflatnull

signalsobject[]RegimeSignal

namestring

valuenumber | null

directionstring | nullupdownflatnull

lineageobjectLineage

sourcestring

referencestring

urlstring | null

unitstring | null

labelstring | null

datestring | null

cross_assetobject

dy_vs_selic_spreadnumber | null

equity_risk_premiumnumber | null

real_selicnumber | null

Chamada

curl

curl -H "Authorization: Bearer db_live_xxxxxxxxxxxx" \
  "https://api.databolsa.com/v1/v1/macro/regime"

python · httpx

import httpx

resp = httpx.get(
    "https://api.databolsa.com/v1/v1/macro/regime",
    headers={"Authorization": "Bearer db_live_xxxxxxxxxxxx"},
)
resp.raise_for_status()
data = resp.json()

javascript · fetch

const resp = await fetch("https://api.databolsa.com/v1/v1/macro/regime", {
  headers: { Authorization: "Bearer db_live_xxxxxxxxxxxx" },
});
const data = await resp.json();

GET/v1/macro/expectationsgetMarketExpectations

Expectativas Focus (consenso por indicador)

Parâmetros

indicator *querystring [ipca, selic, pib, cambio]

referencequerystring

fromquerystring

toquerystring

Resposta 200

Expectativas

object

indicatorstring

referencestring | null

realizednumber | null

surveysobject[]Expectation

survey_datestring

referencestring

mediannumber | null

meannumber | null

std_devnumber | null

respondentsnumber | null

basenumber | null

Chamada

curl

curl -H "Authorization: Bearer db_live_xxxxxxxxxxxx" \
  "https://api.databolsa.com/v1/v1/macro/expectations?indicator=ipca"

python · httpx

import httpx

resp = httpx.get(
    "https://api.databolsa.com/v1/v1/macro/expectations",
    params={"indicator": "ipca"},
    headers={"Authorization": "Bearer db_live_xxxxxxxxxxxx"},
)
resp.raise_for_status()
data = resp.json()

javascript · fetch

const resp = await fetch("https://api.databolsa.com/v1/v1/macro/expectations?indicator=ipca", {
  headers: { Authorization: "Bearer db_live_xxxxxxxxxxxx" },
});
const data = await resp.json();

GET/v1/serieslistSeries

Catálogo de séries (BCB/IBGE/FRED/...)

Parâmetros

cursorquerystring

limitqueryinteger

sourcequerystring [bcb_sgs, bcb_focus, ibge_sidra, fred, ipeadata, tesouro_direto]

searchquerystring

Resposta 200

Página do catálogo

object

dataobject[]SeriesMeta

sourcestring

series_idstring

namestring | null

labelstring | null

unitstring | null

frequencystring | null

first_datestring | null

last_datestring | null

metaobject

next_cursorstring | null

countintegerItens nesta página

Chamada

curl

curl -H "Authorization: Bearer db_live_xxxxxxxxxxxx" \
  "https://api.databolsa.com/v1/v1/series"

python · httpx

import httpx

resp = httpx.get(
    "https://api.databolsa.com/v1/v1/series",
    headers={"Authorization": "Bearer db_live_xxxxxxxxxxxx"},
)
resp.raise_for_status()
data = resp.json()

javascript · fetch

const resp = await fetch("https://api.databolsa.com/v1/v1/series", {
  headers: { Authorization: "Bearer db_live_xxxxxxxxxxxx" },
});
const data = await resp.json();

GET/v1/series/{source}/{series_id}getSeries

Observações de uma série (com acumulados opcionais)

Parâmetros

source *pathstring

series_id *pathstring

fromquerystring

toquerystring

accumulatedquerystring [none, 12m]

Resposta 200

Série com metadados e observações

object

metaobjectSeriesMeta

sourcestring

series_idstring

namestring | null

labelstring | null

unitstring | null

frequencystring | null

first_datestring | null

last_datestring | null

observationsobject[]Observation

datestring

valuenumber | null

Chamada

curl

curl -H "Authorization: Bearer db_live_xxxxxxxxxxxx" \
  "https://api.databolsa.com/v1/v1/series/bcb_sgs/432"

python · httpx

import httpx

resp = httpx.get(
    "https://api.databolsa.com/v1/v1/series/bcb_sgs/432",
    headers={"Authorization": "Bearer db_live_xxxxxxxxxxxx"},
)
resp.raise_for_status()
data = resp.json()

javascript · fetch

const resp = await fetch("https://api.databolsa.com/v1/v1/series/bcb_sgs/432", {
  headers: { Authorization: "Bearer db_live_xxxxxxxxxxxx" },
});
const data = await resp.json();