# 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

***

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.





## 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:3000` - Servidor local para desenvolvimento

## GET /api/v2/crypto

**Summary:** Buscar Cotação Detalhada de Criptomoedas

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`).

**Tags:** Criptomoedas

### Parameters

- **coin** (query) *required*: **Obrigatório.** Uma ou mais siglas (tickers) de criptomoedas que você deseja consultar. Separe múltiplas siglas por vírgula (`,`). 

*   **Exemplos:** `BTC`, `ETH,ADA`, `SOL`.
- **currency** (query): **Opcional.** A sigla da moeda fiduciária na qual a cotação da(s) criptomoeda(s) deve ser retornada. Se omitido, o padrão é `BRL` (Real Brasileiro).
- **range** (query): **Opcional.** Define o período para os dados históricos de preço (`historicalDataPrice`). Funciona de forma análoga ao endpoint de ações. Se omitido, apenas a cotação mais recente é retornada (a menos que `interval` seja usado).

*   Valores: `1d`, `5d`, `1mo`, `3mo`, `6mo`, `1y`, `2y`, `5y`, `10y`, `ytd`, `max`.
- **interval** (query): **Opcional.** Define a granularidade (intervalo) dos dados históricos de preço (`historicalDataPrice`). Requer que `range` também seja especificado. Funciona de forma análoga ao endpoint de ações.

*   Valores: `1m`, `2m`, `5m`, `15m`, `30m`, `60m`, `90m`, `1h`, `1d`, `5d`, `1wk`, `1mo`, `3mo`.
- **undefined** (undefined)

### Responses

#### 200

**Sucesso.** Retorna os dados das criptomoedas solicitadas, incluindo cotação e, opcionalmente, dados históricos.

#### 400

**Bad Request.** A requisição pode estar malformada, um parâmetro `range` ou `interval` pode ser inválido, ou uma das criptomoedas (`coin`) solicitadas pode não ser suportada ou encontrada.

**Example Response:**

```json
{
  "error": true,
  "message": "Something went wrong while fetching the data"
}
```

#### 401

#### 417

**Expectation Failed.** Parâmetro obrigatório ausente. Geralmente ocorre se o parâmetro `coin` não for fornecido.

**Example Response:**

```json
{
  "error": true,
  "message": "Missing required parameter: `coin`"
}
```

## Schemas

The following schemas are used by this endpoint:

### CryptoCoin

Contém os dados detalhados de uma criptomoeda específica retornada pelo endpoint `/api/v2/crypto`.

**Properties:**

- **currency** (string)
  Sigla da moeda fiduciária na qual os preços estão cotados (ex: `BRL`, `USD`).

- **currencyRateFromUSD** (number, float)
  Taxa de câmbio da `currency` em relação ao USD (Dólar Americano). `1 USD = X currency`.

- **coinName** (string)
  Nome completo da criptomoeda (ex: `Bitcoin`, `Ethereum`).

- **coin** (string)
  Sigla (ticker) da criptomoeda (ex: `BTC`, `ETH`).

- **regularMarketChange** (number, float)
  Variação absoluta do preço nas últimas 24 horas (ou período relevante).

- **regularMarketPrice** (number, float)
  Preço atual da criptomoeda na `currency` especificada.

- **regularMarketChangePercent** (number, float)
  Variação percentual do preço nas últimas 24 horas (ou período relevante).

- **regularMarketDayLow** (number, float)
  Preço mínimo nas últimas 24 horas (ou período relevante).

- **regularMarketDayHigh** (number, float)
  Preço máximo nas últimas 24 horas (ou período relevante).

- **regularMarketDayRange** (string)
  String formatada mostrando o intervalo de preço das últimas 24h (Mínimo - Máximo).

- **regularMarketVolume** (integer, int64)
  Volume negociado nas últimas 24 horas (na `currency` especificada).

- **marketCap** (integer, int64)
  Capitalização de mercado da criptomoeda na `currency` especificada.

- **regularMarketTime** (string, date-time)
  Timestamp da última atualização da cotação. Formato ISO 8601.

- **coinImageUrl** (string, url)
  URL da imagem do logo da criptomoeda.

- **usedInterval** (string) *(nullable)*
  O intervalo (`interval`) efetivamente utilizado para os dados históricos, se solicitado.

- **usedRange** (string) *(nullable)*
  O período (`range`) efetivamente utilizado para os dados históricos, se solicitado.

- **historicalDataPrice** (array) *(nullable)*
  Array contendo a série histórica de preços, retornado se `range` ou `interval` forem especificados.
  Array items:
    Reference to: **CryptoHistoricalData**

- **validRanges** (array)
  Lista dos valores válidos para o parâmetro `range` nesta criptomoeda.
  Array items:
    **Type:** string


- **validIntervals** (array)
  Lista dos valores válidos para o parâmetro `interval` nesta criptomoeda.
  Array items:
    **Type:** string



### CryptoHistoricalData

Representa um ponto na série histórica de preços de uma criptomoeda.

**Properties:**

- **date** (integer, int64)
  Data do ponto de dados, representada como um timestamp UNIX.

- **open** (number, float)
  Preço de abertura da criptomoeda no intervalo.

- **high** (number, float)
  Preço máximo atingido no intervalo.

- **low** (number, float)
  Preço mínimo atingido no intervalo.

- **close** (number, float)
  Preço de fechamento da criptomoeda no intervalo.

- **volume** (integer, int64)
  Volume negociado no intervalo (na criptomoeda ou na moeda de referência, verificar contexto).

- **adjustedClose** (number, float)
  Preço de fechamento ajustado (geralmente igual ao `close` para cripto).


### CryptoResponse

Resposta principal do endpoint `/api/v2/crypto`.

**Properties:**

- **coins** (array)
  Array contendo os resultados detalhados para cada criptomoeda solicitada.
  Array items:
    Reference to: **CryptoCoin**


### ErrorResponse

Schema padrão para respostas de erro da API.

**Properties:**

- **error** (boolean) *(required)*
  Indica se a requisição resultou em erro. Sempre `true` para este schema.

- **message** (string) *(required)*
  Mensagem descritiva do erro ocorrido.


