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 tickerclose
- Preço de fechamentochange
- Variação percentualchange_abs
- Variação no preço absolutovolume
- Volume de negociaçãomarket_cap_basic
- Capitalização de mercadosector
- 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 decrescenteasc
- 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âmetro | Valor |
---|---|
search | TR |
sortBy | 5d |
sortOrder | 1d |
limit | true |
token | eJGEyu8vVHctULdVdHYzQd |
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"
}