# Cotação de Criptomoedas
URL: /docs/criptomoedas.mdx

Endpoints focados na obtenção de dados sobre Criptomoedas. Inclui consulta de cotações atuais em diversas moedas fiduciárias, dados históricos e listagem de criptomoedas suportadas pela API.

***

title: Cotação de Criptomoedas
description: >-
Endpoints focados na obtenção de dados sobre Criptomoedas. Inclui consulta de
cotações atuais em diversas moedas fiduciárias, dados históricos e listagem de
criptomoedas suportadas pela API.
full: true
keywords: brapi, api, documentação, criptomoedas
openGraph:
title: Cotação de Criptomoedas
description: >-
Endpoints focados na obtenção de dados sobre Criptomoedas. Inclui consulta
de cotações atuais em diversas moedas fiduciárias, dados históricos e
listagem de criptomoedas suportadas pela API.
type: website
locale: pt\_BR
lastUpdated: '2025-04-28T01:22:35.254Z'
lang: pt-BR
\_openapi:
method: GET
route: /api/v2/crypto
toc:

* depth: 2
  title: Buscar Cotação Detalhada de Criptomoedas
  url: '#buscar-cotação-detalhada-de-criptomoedas'
  structuredData:
  headings:
  * content: Buscar Cotação Detalhada de Criptomoedas
    id: buscar-cotação-detalhada-de-criptomoedas
    contents:
  * content: >-
    Obtenha cotações atualizadas e dados históricos para uma ou mais
    criptomoedas.

    ### Funcionalidades:

    * **Cotação Múltipla:** Consulte várias criptomoedas em uma única
      requisição usando o parâmetro `coin`.

    * **Moeda de Referência:** Especifique a moeda fiduciária para a
      cotação com `currency` (padrão: BRL).

    * **Dados Históricos:** Solicite séries históricas usando `range` e
      `interval` (similar ao endpoint de ações).

    ### Autenticação:

    Requer token de autenticação via `token` (query) ou `Authorization`
    (header).

    ### Exemplo de Requisição:

    **Cotação de Bitcoin (BTC) e Ethereum (ETH) em Dólar Americano
    (USD):**

    ```bash

    curl -X GET
    "https://brapi.dev/api/v2/crypto?coin=BTC,ETH&currency=USD&token=SEU_TOKEN"

    ```

    **Cotação de Cardano (ADA) em Real (BRL) com histórico do último mês
    (intervalo diário):**

    ```bash

    curl -X GET
    "https://brapi.dev/api/v2/crypto?coin=ADA&currency=BRL&range=1mo&interval=1d&token=SEU_TOKEN"

    ```

    ### Resposta:

    A resposta contém um array `coins`, onde cada objeto representa uma
    criptomoeda solicitada, incluindo sua cotação atual, dados de mercado
    e, opcionalmente, a série histórica (`historicalDataPrice`).
    heading: buscar-cotação-detalhada-de-criptomoedas

***

import { Callout } from 'fumadocs-ui/components/callout';

Endpoints focados na obtenção de dados sobre **Criptomoedas**.

<DocsQuickInfo>
  <Callout title="Fontes de Dados" type="info">
    Dados agregados de provedores de mercado crypto. Cotações em tempo real para BTC, ETH e 100+ criptoativos em BRL, USD e EUR.
  </Callout>

  <AnswerBox
    question="Como obter a cotação de Bitcoin?"
    answer="GET /api/v2/crypto?coin=BTC&currency=BRL retorna cotação em tempo real."
    relatedEndpoints={[
  { name: "Cotação", path: "/api/v2/crypto" },
  { name: "Lista", path: "/api/v2/crypto/available" }
]}
    codeExample={`const crypto = await client.crypto.retrieve('BTC');
console.log(crypto.coins[0].regularMarketPrice);`}
    note="Histórico: ?range=1mo&interval=1d. Moedas: BRL, USD, EUR."
  />
</DocsQuickInfo>

Inclui consulta de cotações atuais em diversas moedas fiduciárias, dados
históricos e listagem de criptomoedas suportadas pela API.





## Swagger Documentation

# brapi - API do Mercado Financeiro Brasileiro - /api/v2/crypto

Single endpoint documentation for /api/v2/crypto

## Base URLs

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

## GET /api/v2/crypto

**Summary:** Obter Cotações de Criptomoedas


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


**Tags:** Criptomoedas

### Parameters

- **coin** (query)
- **currency** (query)
- **range** (query)
- **interval** (query)

### Responses

#### 200

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

#### 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.

## Schemas

The following schemas are used by this endpoint:

### CryptoCoinSimple

**Properties:**

- **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** (array)
  Array items:
    **Properties:**

    - **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** (array)
  Array items:
    **Type:** string


- **validIntervals** (array)
  Array items:
    **Type:** string



### CryptoResponseSimple

**Properties:**

- **coins** (array) *(required)*
  Array items:
    Reference to: **CryptoCoinSimple**

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

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


### ErrorResponse

Erro interno do servidor

**Properties:**

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

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

- **code** (string)