Cotações

Cotação de ativos (v1)

Changed on

Cotação de um ou mais ativos brasileiros. A mesma resposta pode trazer histórico de preços, proventos e dados das demonstrações financeiras.

Use para integrações que já usam este formato. Para integrações novas, use os endpoints /api/v2/stocks/*, que trazem um tipo de dado por chamada. Veja o guia de migração.

Este é o endpoint original da brapi. Ele continua ativo e não tem data de remoção.

AXIA5 e AXIA6 retornam a cotação de uma ação AXIA3. Seus preços históricos e proventos continuam separados por classe. Os campos historicalSymbol e dividendsSymbol identificam o ticker desses históricos.

A resposta sempre traz a cotação: preço, variação, volume, máxima e mínima do dia, faixa de 52 semanas e marketCap. Estes parâmetros adicionam outros dados:

  • range e interval, ou startDate e endDate: historicalDataPrice, a série de preços.
  • includeRaw=true: os preços originais sem ajuste rawOpen, rawHigh, rawLow e rawClose, só em intervalos diários. Exige o plano Pro.
  • dividends=true: dividendsData, com dividendos, JCP e eventos em ações.
  • modules: um objeto para cada módulo pedido.

Módulos aceitos em modules, separados por vírgula:

  • summaryProfile: cadastro da empresa.
  • defaultKeyStatistics: múltiplos dos últimos 12 meses, como P/L, P/VP e dividend yield.
  • financialData: receita, EBITDA, margens e dívida dos últimos 12 meses.
  • balanceSheetHistory: balanço patrimonial anual.
  • incomeStatementHistory: DRE anual.
  • cashflowHistory: fluxo de caixa anual.
  • valueAddedHistory: DVA anual.

Cada módulo de demonstração tem uma versão trimestral com o sufixo Quarterly, como balanceSheetHistoryQuarterly. defaultKeyStatistics e financialData também aceitam os sufixos History e HistoryQuarterly. Os dados trimestrais seguem as mesmas regras dos endpoints v2 de DRE, fluxo de caixa e DVA.

O plano define os valores aceitos em range, interval e modules. Um valor fora do plano retorna erro.

PETR4, MGLU3, VALE3 e ITUB4 respondem sem token. Se a chamada juntar um deles com outro ticker, ela exige token.

get/api/quote/{tickers}

Request

  • Base URL
    https://brapi.dev
  • URL
    https://brapi.dev/api/quote/{tickers}
  • Auth
    HTTP bearer

Path parameters

tickersstring required

Tickers separados por vírgula. Ex.: PETR4,VALE3.

Example:PETR4,VALE3

Query parameters

range'1d' | '2d' | '5d' | '7d' | '1mo' | '3mo' | '6mo' | '1y' | '2y' | '5y' | '10y' | 'ytd' | 'max'

Janela relativa da série de preços.

interval'1m' | '2m' | '5m' | '15m' | '30m' | '60m' | '90m' | '1h' | '1d' | '5d' | '1wk' | '1mo' | '3mo'

Intervalo entre os pontos da série de preços.

startDatestring

Data inicial da série de preços no formato YYYY-MM-DD.

Example:2024-01-01
endDatestring

Data final da série de preços no formato YYYY-MM-DD. Sem startDate, range conta para trás a partir desta data.

Example:2024-12-31
dividends'true' | 'false'

Inclui dividendsData com dividendos, JCP e eventos em ações.

includeRaw'true' | 'false'

Inclui os preços originais sem ajuste (rawOpen, rawHigh, rawLow, rawClose) em intervalos diários. Exige o plano Pro.

Example:true
modulesstring

Módulos extras separados por vírgula.

Example:summaryProfile,balanceSheetHistory,financialData
tokenstring

Token de acesso. Use no lugar do header Authorization.

Response

Dados dos ativos recuperados com sucesso.

requestedAtstring date-time required

Data e hora da requisição em ISO 8601.

tookinteger required

Tempo de processamento, em milissegundos.

Example response

{
  "results": [
    {
      "symbol": "PETR4",
      "shortName": "PETR4",
      "longName": "Petroleo Brasileiro SA Pfd",
      "currency": "BRL",
      "regularMarketPrice": 36.65,
      "regularMarketDayHigh": 37.27,
      "regularMarketDayLow": 36.45,
      "regularMarketDayRange": "36.45 - 37.27",
      "regularMarketChange": -0.35,
      "regularMarketChangePercent": -0.95,
      "regularMarketTime": "2026-02-08T16:24:54.000Z",
      "marketCap": 483937892568,
      "regularMarketVolume": 27681100,
      "regularMarketPreviousClose": 36.7,
      "regularMarketOpen": 37.21,
      "fiftyTwoWeekRange": "28.86 - 38.66",
      "fiftyTwoWeekLow": 28.86,
      "fiftyTwoWeekHigh": 38.66,
      "priceEarnings": 6.09,
      "earningsPerShare": 6.01,
      "logourl": "https://icons.brapi.dev/icons/PETR4.svg"
    }
  ],
  "requestedAt": "2026-02-08T16:25:28.170Z",
  "took": 3
}

Changes

    • info

      added the optional property ///// to the response with the status

    • info

      added the required property //// to the response with the status

    • info

      added the required property //// to the response with the status