# 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¤cy=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¤cy=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¤cy=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¤cy=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.