---
title: "Obter Cotações de Criptomoedas"
method: GET
path: "/api/v2/crypto"
tags: ["Criptomoedas"]
---

# Obter Cotações de Criptomoedas

`GET /api/v2/crypto`

Retorna cotações atualizadas de uma ou mais criptomoedas, com conversão para diferentes moedas fiduciárias.

### Funcionalidades:
*   **Cotação Atual:** Preço, variação 24h, volume, market cap
*   **Múltiplas Moedas:** Consulte várias criptos em uma requisição (separadas por vírgula)
*   **Conversão de Moeda:** BRL (padrão), USD, EUR e outras
*   **Dados Históricos:** OHLCV via parâmetros `range` e `interval`

### Autenticação:
Bearer token ou query param `token`. Obtenha em brapi.dev/dashboard.

### Exemplos de Requisição:
```bash
curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/crypto?coin=BTC&currency=BRL"
curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/crypto?coin=BTC,ETH,SOL&currency=USD"
curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/crypto?coin=BTC&currency=BRL&range=1mo&interval=1d"
```

### Moedas de Conversão:
BRL (Real), USD (Dólar), EUR (Euro), GBP (Libra) e outras

### Campos da Resposta:
*   `coin` — Símbolo da criptomoeda
*   `coinName` — Nome completo
*   `currency` — Moeda de cotação
*   `regularMarketPrice` — Preço atual
*   `regularMarketChange` — Variação em valor absoluto
*   `regularMarketChangePercent` — Variação percentual (%)
*   `regularMarketDayHigh` / `regularMarketDayLow` — Máxima/Mínima do dia
*   `regularMarketVolume` — Volume negociado

**Plano Mínimo:** Startup
**Autenticação:** Necessária

## Query parameters

- `coin` string — Sigla(s) das criptomoedas separadas por vírgula
- `currency` string — Moeda para cotação (padrão: BRL)
- `range` string — Período para dados históricos
- `interval` string — Intervalo dos dados históricos

## Response `200`

Cotações das criptomoedas solicitadas na moeda especificada retornadas com sucesso.

- CryptoResponseSimple
  - `coins` CryptoCoinSimple[], required
    - `currency` string, required
    - `currencyRateFromUSD` number, required
    - `coinName` string, required
    - `coinImageUrl` string
    - `coin` string, required
    - `regularMarketChange` number, required
    - `regularMarketPrice` number, required
    - `regularMarketChangePercent` number, required
    - `regularMarketDayLow` number, required
    - `regularMarketDayHigh` number, required
    - `regularMarketDayRange` string, required
    - `regularMarketVolume` number, required
    - `marketCap` number, required
    - `regularMarketTime` string, required
    - `usedInterval` string
    - `usedRange` string
    - `historicalDataPrice` object[]
      - `date` integer, required
      - `open` number, nullable, required
      - `high` number, nullable, required
      - `low` number, nullable, required
      - `close` number, nullable, required
      - `volume` number, nullable, required
      - `adjustedClose` number, nullable, required
    - `validRanges` string[]
    - `validIntervals` string[]
  - `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.** Parâmetro `coin` não fornecido ou inválido.
- `401` — **Não Autorizado.** Token de autenticação não fornecido ou inválido.
- `403` — **Acesso Proibido.** Seu plano não tem acesso ao módulo de criptomoedas.
- `429` — Limite de requisições excedido
- `500` — **Erro Interno.** Erro interno ao processar a requisição.
- `503` — **Serviço Indisponível.** Serviço externo temporariamente indisponível.

---

[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/revisions/f275d46193ea/schema)