# Cobertura por Ticker
URL: /docs/tickers/cobertura.mdx

Descubra quais superfícies de dados da brapi estão disponíveis para cada ticker e quais endpoints usar em seguida.

***

title: Cobertura por Ticker
description: >-
Descubra quais superfícies de dados da brapi estão disponíveis para cada
ticker e quais endpoints usar em seguida.
full: true
keywords: brapi, api, tickers, cobertura, disponibilidade, endpoints
lang: pt-BR
\_openapi:
method: GET
route: /api/v2/tickers/coverage
-------------------------------

Endpoint **público** para verificar o que a brapi consegue consultar para cada
ticker B3.

Use quando sua integração precisa decidir o próximo passo automaticamente:
cotação, histórico, dividendos de ações, rendimentos de FIIs, indicadores de
FIIs, relatórios ou endpoints de carteira e imóveis.

A resposta é por símbolo. Um ticker desconhecido não derruba a chamada inteira:
ele retorna `status: "unknown"` com recomendações de busca. Tickers antigos são
resolvidos antes da checagem e retornam `status: "renamed"` quando houver
mapeamento conhecido.

Este endpoint não retorna os dados de mercado em si. Ele informa quais endpoints
usar.





## Swagger Documentation

# brapi - API do Mercado Financeiro Brasileiro - /api/v2/tickers/coverage

Single endpoint documentation for /api/v2/tickers/coverage

## Base URLs

- `https://brapi.dev` - Servidor principal da API brapi
- `http://localhost:3001` - Servidor local para desenvolvimento

## GET /api/v2/tickers/coverage

**Summary:** Verificar cobertura por ticker


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


**Tags:** Tickers

### Parameters

- **symbols** (query) *required*

### Responses

#### 200

Cobertura retornada com sucesso.

#### 400

Requisição inválida

#### 500

Erro interno do servidor

## Schemas

The following schemas are used by this endpoint:

### ErrorResponse

Erro interno do servidor

**Properties:**

- **error** (boolean) - Options: `true` *(required)*

- **message** (string) *(required)*

- **code** (string)


### TickerAvailableData

**Properties:**

- **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)*


### TickerCoverageResponse

**Properties:**

- **results** (array) *(required)*
  Array items:
    Reference to: **TickerCoverageResult**

- **requestedAt** (string, date-time) *(required)*
  Data e hora da requisição em formato ISO 8601

- **took** (integer) *(required)*
  Tempo de processamento em milissegundos


### TickerCoverageResult

**Properties:**

- **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** (string) - Options: `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** *(required)*
  Reference to: **TickerAvailableData**

- **recommendedEndpoints** (object) *(required)*
  Endpoints brapi recomendados para o símbolo