Referência da API

Stocks

Ações — cotações, indicadores, proventos e eventos

GET/v1/stocks/{ticker}getStock

Perfil e última cotação do papel

Parâmetros

ticker *pathstring

Resposta 200

Ação

objectStock

tickerstring

isinstring | null

typeunknown

companyobject | null

cvm_codeinteger | null

namestring | null

tickersobject[]Papéis (classes) da empresa — cada um analisável em /stocks/{ticker}/indicators

tickerstring

typeunknown

shares_outstandingnumber | null

latest_quoteobject

datestring

closenumber | null

adjust_typestring | null

adjust_qualitystring | null

Chamada

curl

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

python · httpx

import httpx

resp = httpx.get(
    "https://api.databolsa.com/v1/v1/stocks/PETR4",
    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/stocks/PETR4", {
  headers: { Authorization: "Bearer db_live_xxxxxxxxxxxx" },
});
const data = await resp.json();

GET/v1/stocks/{ticker}/quoteslistQuotes

Série de cotações OHLCV

Ajustada por eventos por default; `from`/`to` filtram o período (from <= to).

Parâmetros

ticker *pathstring

cursorquerystring

limitqueryinteger

fromquerystring

toquerystring

adjustedquerystring

Resposta 200

Página de cotações

object

dataobject[]Quote

datestring

opennumber | null

highnumber | null

lownumber | null

closenumber | null

close_rawnumber | nullFechamento bruto (não ajustado), como reportado pela B3

close_trnumber | nullFechamento de retorno total: ajustado por eventos + proventos reinvestidos (bruto). = close quando não há fonte de proventos (units/FII)

volumenumber | nullVolume financeiro (R$)

quantitynumber | null

tradesnumber | nullNº de negócios — null: fonte aberta dá quantidade, não contagem

adjustedboolean

adjust_typestring | null

adjust_qualitystring | null

metaobject

next_cursorstring | null

countintegerItens nesta página

Chamada

curl

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

python · httpx

import httpx

resp = httpx.get(
    "https://api.databolsa.com/v1/v1/stocks/PETR4/quotes",
    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/stocks/PETR4/quotes", {
  headers: { Authorization: "Bearer db_live_xxxxxxxxxxxx" },
});
const data = await resp.json();

GET/v1/stocks/{ticker}/indicatorsgetStockIndicators

Indicadores fundamentalistas (snapshot TTM)

Parâmetros

ticker *pathstring

namesquerystring

atquerystring

Resposta 200

Indicadores do papel

object

tickerstring

reference_datestring

is_financialboolean

indicatorsobject[]IndicatorValue

namestring

labelstring

valuenumber | nullnull quando não calculável — ver reason

unitstringratiopercentbrlbrl_per_sharecountdays

reasonstring | null

reference_datestring | null

ttmboolean

lineageobjectLineage

sourcestring

referencestring

urlstring | null

methodology_urlstring

Chamada

curl

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

python · httpx

import httpx

resp = httpx.get(
    "https://api.databolsa.com/v1/v1/stocks/PETR4/indicators",
    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/stocks/PETR4/indicators", {
  headers: { Authorization: "Bearer db_live_xxxxxxxxxxxx" },
});
const data = await resp.json();

GET/v1/stocks/{ticker}/indicators/historygetStockIndicatorHistory

Histórico de um indicador (trimestral)

Parâmetros

ticker *pathstring

name *querystring

fromquerystring

toquerystring

Resposta 200

Série do indicador

object

tickerstring

namestring

labelstring

unitstringratiopercentbrlbrl_per_sharecountdays

observationsobject[]Observation

datestring

valuenumber | null

Chamada

curl

curl -H "Authorization: Bearer db_live_xxxxxxxxxxxx" \
  "https://api.databolsa.com/v1/v1/stocks/PETR4/indicators/history"

python · httpx

import httpx

resp = httpx.get(
    "https://api.databolsa.com/v1/v1/stocks/PETR4/indicators/history",
    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/stocks/PETR4/indicators/history", {
  headers: { Authorization: "Bearer db_live_xxxxxxxxxxxx" },
});
const data = await resp.json();

GET/v1/stocks/{ticker}/dividendslistDividends

Proventos (dividendos e JCP)

Parâmetros

ticker *pathstring

cursorquerystring

limitqueryinteger

fromquerystring

toquerystring

Resposta 200

Página de proventos

object

dataobject[]Dividend

typestring | null

ex_datestring | null

payment_datestring | null

value_per_share_grossnumber | null

value_per_share_netnumber | null

metaobject

next_cursorstring | null

countintegerItens nesta página

Chamada

curl

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

python · httpx

import httpx

resp = httpx.get(
    "https://api.databolsa.com/v1/v1/stocks/PETR4/dividends",
    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/stocks/PETR4/dividends", {
  headers: { Authorization: "Bearer db_live_xxxxxxxxxxxx" },
});
const data = await resp.json();

GET/v1/stocks/{ticker}/eventslistCorporateEvents

Eventos societários (desdobramentos, grupamentos, bonificações)

Parâmetros

ticker *pathstring

fromquerystring

toquerystring

Resposta 200

Lista de eventos

object[]CorporateEvent

typestring | null

approved_datestring | null

ex_datestring | null

factornumber | null

detailstring | null

Chamada

curl

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

python · httpx

import httpx

resp = httpx.get(
    "https://api.databolsa.com/v1/v1/stocks/PETR4/events",
    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/stocks/PETR4/events", {
  headers: { Authorization: "Bearer db_live_xxxxxxxxxxxx" },
});
const data = await resp.json();

GET/v1/stocks/{ticker}/insiderlistInsiderMoves

Movimentações de insiders (CVM VLMO, por mês)

Parâmetros

ticker *pathstring

fromquerystring

toquerystring

Resposta 200

Saldo mensal de insiders

object

tickerstring

dataobject[]InsiderMove

reference_monthstringAAAA-MM

net_sharesnumber | null

net_value_brlnumber | null

buy_value_brlnumber | null

sell_value_brlnumber | null

lineageobjectLineage

sourcestring

referencestring

urlstring | null

Chamada

curl

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

python · httpx

import httpx

resp = httpx.get(
    "https://api.databolsa.com/v1/v1/stocks/PETR4/insider",
    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/stocks/PETR4/insider", {
  headers: { Authorization: "Bearer db_live_xxxxxxxxxxxx" },
});
const data = await resp.json();