Docs
Ações, Fundos Imobiliários, Índices e BDRs
/api/quote/list

Cotações de todas as ações, fundos, índices e BDRs

Esse endpoint fornece informações detalhadas sobre cotações de ações, fundos, índices e BDRs permitindo que você obtenha um resumo de todos os tickers disponíveis. Ela oferece flexibilidade para ordenar, filtrar e buscar os tickers que você deseja.

Endpoint

O endpoint que você deve utilizar para obter a cotação de todos os tickers disponíveis é o seguinte:

GET /api/quote/list

Parâmetros da Solicitação

Para utilizar este endpoint, você deve fornecer os seguintes parâmetros na solicitação:

token (obrigatório)

Um token de autenticação exclusivo. Você pode obtê-lo em https://brapi.dev/dashboard (opens in a new tab). A autenticação é necessária para acessar os recursos da API.

search (opcional)

Permite buscar por um ticker específico. Você pode usar este parâmetro para encontrar um ticker com base em uma consulta.

Exemplo de uso: ?search=ibo

sortBy (opcional)

Este parâmetro permite que você ordene os tickers por um tipo específico. Os valores aceitáveis são:

  • name - Nome do ticker
  • close - Preço de fechamento
  • change - Variação percentual
  • change_abs - Variação no preço absoluto
  • volume - Volume de negociação
  • market_cap_basic - Capitalização de mercado
  • sector - Setor da ação

Exemplo de uso: ?sortBy=close

sortOrder (opcional)

Este parâmetro determina se os filtro de sortBy será ordenado em ordem crescente ou decrescente. Os valores aceitáveis são:

  • desc - Ordem decrescente
  • asc - Ordem crescente

Exemplo de uso: ?sortOrder=desc

limit (opcional)

Limite a quantidade de tickers retornados por página. Este parâmetro define o número máximo de tickers que serão exibidos em uma única resposta.

Exemplo de uso: ?limit=10

page (opcional)

Especifica a página atual dos resultados. Útil para a paginação dos resultados quando há muitos tickers disponíveis.

Exemplo de uso: ?page=1

Esta flexibilidade permite que você ajuste suas solicitações para atender a uma variedade de necessidades, desde a obtenção de uma lista completa de tickers até a obtenção de uma lista de tickers específicos.

Exemplo de Solicitação

Para uma requisição que busca por um ticker que contenha as letras TR, ordenado pelo preço de fechamento em ordem decrescente, com limite de 10 tickers por página e na página 1, a solicitação ficaria assim:

curl -X GET \
"https://brapi.dev/api/quote/list?search=TR&sortBy=close&sortOrder=desc&limit=10&token=eJGEyu8vVHctULdVdHYzQd"
ParâmetroValor
searchTR
sortBy5d
sortOrder1d
limittrue
tokeneJGEyu8vVHctULdVdHYzQd

Resposta da Solicitação

200 OK

A solicitação foi bem-sucedida.

{
  "indexes": [
    {
      "stock": "^DJI",
      "name": "Dow Jones Industrial Average"
    },
    {
      "stock": "^JN0U.JO",
      "name": "Top 40 USD Net TRI Index"
    }
  ],
  "stocks": [
    {
      "stock": "TRXB11",
      "name": "FII TRX R IICI ER",
      "close": 125,
      "change": 0,
      "volume": 1,
      "market_cap": null,
      "logo": "https://s3-symbol-logo.tradingview.com/fii-trxe-corci--big.svg",
      "sector": null
    },
    {
      "stock": "TRXF11",
      "name": "FII TRX REALCI ER",
      "close": 108.09,
      "change": -0.588614,
      "volume": 39340,
      "market_cap": null,
      "logo": "https://s3-symbol-logo.tradingview.com/fii-trxe-corci--big.svg",
      "sector": null
    },
    {
      "stock": "RZTR11",
      "name": "FII RIZA TX CI ER",
      "close": 100.7,
      "change": 0.25886101,
      "volume": 11243,
      "market_cap": null,
      "logo": "https://s3-symbol-logo.tradingview.com/fii--big.svg",
      "sector": null
    },
    {
      "stock": "TRBL11",
      "name": "FII SDI LOG CI ER",
      "close": 99.370003,
      "change": -0.72926773,
      "volume": 9187,
      "market_cap": null,
      "logo": "https://brapi.dev/favicon.svg",
      "sector": null
    },
    {
      "stock": "BTRA11",
      "name": "FII BTG TAGRCI",
      "close": 67.150002,
      "change": -0.01489279,
      "volume": 5283,
      "market_cap": null,
      "logo": "https://s3-symbol-logo.tradingview.com/fii--big.svg",
      "sector": "Miscellaneous"
    },
    {
      "stock": "EKTR4",
      "name": "ELEKTRO PN",
      "close": 39,
      "change": 6.84931507,
      "volume": 1000,
      "market_cap": 6796570423,
      "logo": "https://s3-symbol-logo.tradingview.com/elektro-pn--big.svg",
      "sector": "Utilities"
    },
    {
      "stock": "PETR3",
      "name": "PETROBRAS",
      "close": 37.860001,
      "change": 4.09678867,
      "volume": 11557100,
      "market_cap": 458395962214,
      "logo": "https://s3-symbol-logo.tradingview.com/brasileiro-petrobras--big.svg",
      "sector": "Energy Minerals"
    },
    {
      "stock": "TRIG11",
      "name": "TRG SMIC CAPCI",
      "close": 37.799999,
      "change": 0.39839839,
      "volume": 6205,
      "market_cap": null,
      "logo": "https://s3-symbol-logo.tradingview.com/trg-smic-capci--big.svg",
      "sector": null
    },
    {
      "stock": "PETR3F",
      "name": "PETROBRAS",
      "close": 37.740002,
      "change": 3.48231688,
      "volume": 27185,
      "market_cap": 458395962214,
      "logo": "https://s3-symbol-logo.tradingview.com/brasileiro-petrobras--big.svg",
      "sector": "Energy Minerals"
    },
    {
      "stock": "EKTR4F",
      "name": "ELEKTRO PN",
      "close": 36.709999,
      "change": 0.38282472,
      "volume": 127,
      "market_cap": 6796570423,
      "logo": "https://s3-symbol-logo.tradingview.com/elektro-pn--big.svg",
      "sector": "Utilities"
    }
  ],
  "currentPage": 1,
  "totalPages": 3,
  "itemsPerPage": 10,
  "totalCount": 28,
  "hasNextPage": true
}

200 Empty Response

Não encontramos nenhum ativo com o ticker informado.

{
  "indexes": [],
  "stocks": []
}

401 Unauthorized

O token de autenticação não foi informado ou é inválido.

{
  "error": true,
  "message": "O seu token é inválido, por favor, verifique o seu token em brapi.dev/dashboard"
}

417 Bad Request

A solicitação foi malformada ou inválida.

{
  "error": true,
  "message": "Campo 'sortBy' inválido. sortBy válidos: name, close, change, change_abs, volume, market_cap_basic"
}