---
title: "Cobertura por ticker"
method: GET
path: "/api/v2/tickers/coverage"
tags: ["Tickers"]
---

# Cobertura por ticker

`GET /api/v2/tickers/coverage`

## Request

- Base URL: `https://brapi.dev`
- URL: `https://brapi.dev/api/v2/tickers/coverage`
- Auth: none declared

Mostra quais dados a brapi tem para cada ticker e quais endpoints usar em seguida: cotação, histórico, dividendos, fundamentos, dados de FII ou de fundos.

Use antes de montar uma integração, para saber quais endpoints servem para cada ativo.

Envie até 20 tickers em `symbols`. Um ticker antigo é trocado pelo atual e vem com `status` igual a `renamed`. Um ticker desconhecido não gera erro. Ele vem com `status` igual a `unknown` e links de busca. Um ticker de opção vem com `wrong_endpoint` e links para os endpoints de opções.

Para ETFs e outros fundos listados, os links de proventos, taxas e cota apontam para os endpoints de fundos.

Em conversões de ações, os links de histórico e proventos usam o ticker da classe original.

Este endpoint não traz dados de mercado. Não exige token.

## Query parameters

- `symbols` string, required: Tickers separados por vírgula, até 20.

## Response `200`

Cobertura retornada com sucesso.

- TickerCoverageResponse
  - `results` TickerCoverageResult[], required
    - `requestedSymbol` string, required: Ticker enviado na requisição.
    - `symbol` string, required: Ticker atual usado na verificação.
    - `changed` boolean, required: `true` quando o ticker enviado foi trocado pelo ticker atual.
    - `status` 'available' | 'renamed' | 'unknown' | 'wrong_endpoint', required: `available`: o ticker tem dados. `renamed`: o ticker mudou e tem dados. `unknown`: o ticker não foi encontrado. `wrong_endpoint`: o ticker é de uma opção.
    - `assetType` string, nullable, required: Tipo do ativo. Pode ser nulo.
    - `subType` string, nullable, required: Subtipo do ativo. Pode ser nulo.
    - `availableData` TickerAvailableData, required
      - `ticker` boolean, required
      - `quote` boolean, required
      - `historical` boolean, required
      - `stockDividends` boolean, required
      - `fiiDividends` boolean, required
      - `profile` boolean, required
      - `statistics` boolean, required
      - `financialStatements` boolean, required
      - `fiiIndicators` boolean, required
      - `fiiReports` boolean, required
      - `fiiPortfolio` boolean, required
      - `fiiProperties` boolean, required
      - `fundReports` boolean, required: Relatórios mensais do fundo nos endpoints de fundos. Hoje vale para FIAGRO.
      - `fundPortfolio` boolean, required: Carteira mensal do fundo nos endpoints de fundos. Hoje vale para FIAGRO.
    - `recommendedEndpoints` object, required: Endpoints para consultar os dados do ticker.
  - `requestedAt` string, date-time, required: Data e hora da requisição em ISO 8601.
  - `took` integer, required: Tempo de processamento, em milissegundos.

## Other responses

- `400`: Requisição inválida. Confira os parâmetros.
- `500`: Erro interno do servidor.

## Changes

- **2026-10-26** `6421c298be9e`: 2 info
  - added the required property `results/items/availableData/fundPortfolio` to the response with the `200` status
  - added the required property `results/items/availableData/fundReports` to the response with the `200` status
- **2026-06-15** `73e0f61e068f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/changes/api/v2/tickers/coverage/get.md)

---

[API](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro.md) - [All operations](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/llms.txt) - [OpenAPI document](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/revisions/7c732d79148a?raw)