Documentação da API

Referência completa para a API BR Market Data

Primeiros Passos

A API BR Market Data fornece acesso a dados do mercado de ações brasileiro e indicadores financeiros. Todas as requisições da API devem ser enviadas para a URL base:

https://api.brmarketdata.com

Todos os endpoints retornam dados no formato JSON. Não é necessária autenticação no momento.

Indicadores Disponíveis

A API disponibiliza diversos indicadores fundamentalistas. Você pode utilizar os códigos abaixo nos endpoints de indicadores.

Endpoint de Histórico de Preços

Obtenha o histórico de preços para uma ação específica

Endpoint

GET /precos/historico

Parâmetros

Parâmetro	Tipo	Obrigatório	Descrição
ticker	string	Sim	Código da ação (ex: BBAS3)
start	string	Não	Data inicial no formato AAAA-MM-DD
end	string	Não	Data final no formato AAAA-MM-DD
sort	string	Não	Ordenar por data: "asc" ou "desc"
currency	string	Não	Moeda: "BRL", "USD" ou "EUR"

Exemplo de Requisição

https://api.brmarketdata.com/precos/historico?ticker=BBAS3&start=2015-04-30&end=2026-01-01

Exemplo de Resposta

[
  {
    "ticker": "BBAS3",
    "price": 7.33,
    "date": "2015-04-30",
    "currency": "BRL"
  },
  {
    "ticker": "BBAS3",
    "price": 7.28,
    "date": "2015-05-04",
    "currency": "BRL"
  },
  ... (continua)
]

Endpoint de Preços por Data

Obtenha preços de todas as ações disponíveis em uma determinada data.
Se não for informada uma data, será retornado o preço mais recente disponível.

Endpoint

GET /precos/por-data

Parâmetros

Parâmetro	Tipo	Obrigatório	Descrição
date	string	Não	Data no formato AAAA-MM-DD
currency	string	Não	Moeda: "BRL", "USD" ou "EUR"

Exemplo de Requisição

https://api.brmarketdata.com/precos/por-data?date=2024-06-30

Exemplo de Resposta

[
  {
    "ticker": "VALE3",
    "price": 59.94,
    "date": "2024-06-30",
    "currency": "BRL"
  },
  {
    "ticker": "LREN3",
    "price": 11.13,
    "date": "2024-06-30",
    "currency": "BRL"
  },
  {
    "ticker": "KLBN11",
    "price": 20.67,
    "date": "2024-06-30",
    "currency": "BRL"
  },
  ... (continua)
]

Endpoint de Histórico de Indicadores

Obtenha dados históricos para um indicador e ticker específicos

Endpoint

GET /indicadores/historico

Parâmetros

Parâmetro	Tipo	Obrigatório	Descrição
ticker	string	Sim	Código da ação (ex: BBAS3)
indicador	string	Sim	Código do indicador financeiro (ex: p_l)
sort	string	Não	Ordenar por data: "asc" ou "desc"

Exemplo de Requisição

https://api.brmarketdata.com/indicadores/historico?ticker=BBAS3&indicador=p_l

Exemplo de Resposta

[
  {
    "ticker": "BBAS3",
    "date": "2010-12-31",
    "key": "p_l",
    "name": "P/L",
    "value": 7.946
  },
  {
    "ticker": "BBAS3",
    "date": "2011-12-31",
    "key": "p_l",
    "name": "P/L",
    "value": 5.1842
  },
  ... (continua)
]

Endpoint de Indicadores por Ticker

Obtenha todos os indicadores disponíveis para um ticker específico

Endpoint

GET /indicadores/por-ticker

Parâmetros

Parâmetro	Tipo	Obrigatório	Descrição
ticker	string	Sim	Código da ação (ex: BBAS3)

Exemplo de Requisição

https://api.brmarketdata.com/indicadores/por-ticker?ticker=BBAS3

Exemplo de Resposta

[
  {
    "ticker": "KLBN11",
    "date": "2025-04-29",
    "key": "dy12m",
    "name": "DIVIDEND YIELD (DY)",
    "value": 6.6
  },
  {
    "ticker": "KLBN11",
    "date": "2025-04-29",
    "key": "evEbit",
    "name": "EV/EBIT",
    "value": 12.36
  },
  {
    "ticker": "KLBN11",
    "date": "2025-04-29",
    "key": "roic",
    "name": "ROIC",
    "value": 9.22
  },
  ... (continua)
]

Endpoint de Ações por Indicador

Obtenha o valor do indicador para todas as ações disponíveis

Endpoint

GET /indicadores/por-indicador

Parâmetros

Parâmetro	Tipo	Obrigatório	Descrição
indicador	string	Sim	Código do indicador financeiro (ex: p_l)

Exemplo de Requisição

https://api.brmarketdata.com/indicadores/por-indicador?indicador=p_l

Exemplo de Resposta

[
  {
    "ticker": "BBAS3",
    "date": "2025-04-29",
    "key": "p_l",
    "name": "P/L",
    "value": 6.23
  },
  {
    "ticker": "BBDC3",
    "date": "2025-04-29",
    "key": "p_l",
    "name": "P/L",
    "value": 7.47
  },
  ... (continua)
]