BRbrapi-dev
Tickers

Listar tickers da B3

Changed on

Lista de tickers brasileiros com nome, tipo, setor, logo e um resumo da cotação: ações, FIIs, ETFs, BDRs e units. Os índices vêm em indexes.

Use para busca, autocomplete, validação de tickers e screeners.

search busca por parte do ticker, do nome da empresa ou de um ticker antigo. O filtro type aceita stock, fund e bdr. facets lista os valores aceitos nos filtros.

A lista não tem opções, futuros, Tesouro Direto, criptomoedas, câmbio nem indicadores econômicos. Esses dados têm endpoints próprios.

Não exige token. Para cotação completa, use a cotação de ações.

get/api/v2/tickers

Request

  • Base URL
    https://brapi.dev
  • URL
    https://brapi.dev/api/v2/tickers
  • Auth
    none declared

Query parameters

searchstring

Parte do ticker, do nome da empresa ou de um ticker antigo.

Example:PETR
sortBy'symbol' | 'name' | 'close' | 'change' | 'volume' | 'marketCap'

Campo de ordenação.

Example:volume
sortOrder'asc' | 'desc'

Ordem.

Example:desc
pageinteger

Número da página. Começa em 1.

Example:1
limitinteger

Itens por página. Máximo: 2000.

Example:20
sectorstring

Setor.

Example:Finance
subsectorstring

Subsetor.

Example:Comércio
type'stock' | 'fund' | 'bdr'

Tipo do ativo. Índices não entram neste filtro.

Example:stock
subType'stock' | 'unit' | 'fii' | 'etf' | 'fi-infra' | 'fi-agro' | 'fip' | 'fidc' | 'bdr'

Subtipo do ativo: stock, unit, fii, etf, fi-infra, fi-agro, fip, fidc ou bdr.

Example:fii

Response

Lista de tickers retornada 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",
      "name": "Petróleo Brasileiro S.A.",
      "longName": "Petroleo Brasileiro SA Petrobras Preference Shares",
      "assetType": "stock",
      "subType": "stock",
      "exchange": "B3",
      "currency": "BRL",
      "sector": "Energy Minerals",
      "subsector": "Petróleo, Gás e Biocombustíveis",
      "isActive": true,
      "logoUrl": "https://icons.brapi.dev/icons/PETR4.svg",
      "quote": {
        "lastPrice": 36.65,
        "changePercent": -0.95,
        "volume": 27681100,
        "marketCap": 483937892568
      }
    }
  ],
  "indexes": [
    {
      "symbol": "^BVSP",
      "name": "IBOVESPA",
      "exchange": "B3",
      "assetType": "index"
    }
  ],
  "facets": {
    "assetTypes": [
      "stock",
      "fund",
      "bdr"
    ],
    "subTypes": [
      "stock",
      "unit",
      "fii",
      "etf",
      "bdr"
    ]
  },
  "pagination": {
    "page": 1,
    "limit": 20,
    "totalItems": 2302,
    "totalPages": 116,
    "hasNextPage": true
  },
  "requestedAt": "2025-01-24T17:32:38.000Z",
  "took": 45
}

Changes

  • 42aa75cac54dRevision changes
    • info

      added the new optional query request parameter subsector

    • info

      added the required property / to the response with the status

    • info

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

  • 73e0f61e068fRevision changes
    • info

      endpoint added