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

# Verificar cobertura por ticker

`GET /api/v2/tickers/coverage`

Verifica quais superfícies de dados da brapi estão disponíveis para cada ticker
informado e recomenda os endpoints corretos para continuar a integração.

Use este endpoint quando precisar responder "o que posso consultar para este
ativo?" antes de chamar cotações, histórico, dividendos, fundamentos ou
endpoints específicos de FIIs.

### Exemplos

```bash
curl "https://brapi.dev/api/v2/tickers/coverage?symbols=PETR4,MXRF11"
curl "https://brapi.dev/api/v2/tickers/coverage?symbols=VVAR3"
```

**Plano mínimo:** Gratuito
**Autenticação:** Não necessária

## Query parameters

- `symbols` string, required — Tickers separados por vírgula, máximo 20

## Response `200`

Cobertura retornada com sucesso.

- TickerCoverageResponse
  - `results` TickerCoverageResult[], required
    - `requestedSymbol` string, required — Ticker informado pelo usuário
    - `symbol` string, required — Ticker canônico usado para consulta
    - `changed` boolean, required — Indica se o ticker informado foi normalizado
    - `status` 'available' | 'renamed' | 'unknown' | 'wrong_endpoint', required — Status da cobertura: disponível, renomeado, desconhecido ou endpoint incorreto para o tipo de símbolo
    - `assetType` string, nullable, required — Tipo amplo do ativo quando disponível
    - `subType` string, nullable, required — Subtipo do ativo quando disponível
    - `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
    - `recommendedEndpoints` object, required — Endpoints brapi recomendados para o símbolo
  - `requestedAt` string, date-time, required — Data e hora da requisição em formato ISO 8601
  - `took` integer, required — Tempo de processamento em milissegundos

## Other responses

- `400` — Requisição inválida
- `500` — Erro interno do servidor

---

[API](https://skmtc.net/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro.md) · [All operations](https://skmtc.net/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/brapi-dev/brapi-api-do-mercado-financeiro-brasileiro/versions/f275d46193ea/schema)