---
title: "Cotação de criptomoedas"
method: GET
path: "/api/v2/crypto"
tags: ["Criptomoedas"]
---

# Cotação de criptomoedas

`GET /api/v2/crypto`

## Request

- Base URL: `https://brapi.dev`
- URL: `https://brapi.dev/api/v2/crypto`
- Auth: HTTP bearer

Cotação de uma ou mais criptomoedas, com preço, variação, máxima, mínima e
volume de 24 horas. O preço vem na moeda de `currency`, com BRL como padrão.

Use para mostrar preços de cripto, montar carteiras e gerar gráficos.

Peça várias moedas em `coin`, como `coin=BTC,ETH,SOL`. Para o histórico,
passe `range` ou `interval`, como `range=1mo&interval=1d`. A resposta
traz os pontos em `historicalDataPrice` e o período aplicado em
`usedRange` e `usedInterval`. Intervalos curtos limitam o período.

O histórico diário aceita `startDate` e `endDate` no formato YYYY-MM-DD,
com `interval=1d` ou sem intervalo. Use datas sem `range`.
Sem data inicial, o período é de 30 dias até a data final.
As datas são inclusivas. `usedRange` vem como `custom` em consultas por data.
`range=max&interval=1d` retorna todos os dias disponíveis, sem limite de
1.000 pontos. O histórico diário inclui somente dias completos em UTC.
A primeira data depende da criptomoeda. Se a cotação atual estiver
indisponível, os campos de cotação usam o último dia completo disponível.
Nesse caso, a variação e o volume também correspondem a esse dia em UTC.
Confira a data em `regularMarketTime`.

Cripto negocia 24 horas por dia. A variação é uma janela móvel de 24 horas.
O histórico usa o câmbio diário da data de fechamento em UTC. Em dias sem
cotação de câmbio, usa a última cotação disponível até essa data. Todos os
preços de um ponto usam esse câmbio. Moedas vinculadas ao dólar usam
paridade de 1:1 com USD. A conversão histórica aceita BRL, USD, EUR, GBP,
JPY, CHF, CAD, AUD, DKK, NOK e SEK. Sem câmbio histórico disponível, os
preços do ponto vêm como `null`. O campo `currencyRateFromUSD` informa
o câmbio atual, não o câmbio de cada ponto histórico.
`marketCap` vem sempre como 0.

Uma sigla indisponível retorna 400, inclusive em chamadas com várias siglas. Uma cotação ausente ou inválida retorna 503.

Veja as siglas em [listar criptomoedas](https://brapi.dev/docs/criptomoedas/available).
Planos Startup e Pro. Os períodos e intervalos aceitos dependem do plano.

## Query parameters

- `coin` string: Siglas das criptomoedas, separadas por vírgula. Ex.: BTC,ETH.
- `currency` string: Moeda da cotação, como BRL, USD ou EUR. Padrão: BRL.
- `startDate` string: Data inicial do histórico diário no formato YYYY-MM-DD. Use sem range.
- `endDate` string: Data final inclusiva do histórico diário no formato YYYY-MM-DD. Padrão: hoje.
- `range` string: Período do histórico, como 5d, 1mo ou 1y. Padrão: 1mo quando há histórico.
- `interval` string: Intervalo entre os pontos do histórico, como 1h ou 1d. Padrão: 1d.

## 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 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.** Cotação ausente, inválida ou serviço temporariamente indisponível.

## Changes

- **2026-10-16** `62eafb05acb0`: 2 info
  - added the new optional `query` request parameter `endDate`
  - added the new optional `query` request parameter `startDate`
- **2026-04-07** `19f807c15a24`: 54 breaking, 1 warning, 34 info
  - for the `query` request parameter `currency`, default value `BRL` was removed
  - removed the enum value `10y` from the `query` request parameter `range`
  - removed the enum value `15m` from the `query` request parameter `interval`
  - removed the enum value `1d` from the `query` request parameter `interval`
  - …85 more

[Operation history](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/changes/api/v2/crypto/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)