Cotação de criptomoedas

beta

Este endpoint possibilita realizar a consulta da cotação de criptomoedas. O valor retornado para cada criptomoeda é referente à última atualização no mercado (finalPrice).

Pré-requisitos

Para que seja possível utilizar este endpoint, é necessário que:

O cliente do parceiro possua uma conta ativa.

Requisição (Request)

Requisição HTTP

GET https://api-mtls.sandbox.bankly.com.br/v2/crypto/prices?market={market}

--request GET \
--url 'https://api-mtls.sandbox.bankly.com.br/v2/crypto/prices?market=BTC:BRL' \
--header 'accept: application/json' \
--header 'bankly-version: 2023-01-30' \
--header 'authorization: Bearer {token}'
--header 'bankly-correlation-id: 5a88c4ae-99cd-494e-96b7-39b8109c8a77'

Autorização

Para garantir a segurança nas requisições, todos os endpoints do Bankly utilizam scopes como parte do seu fluxo de autorização.
Esta requisição requer o scope descrito a seguir:

Scope	Descrição
`crypto.price.read`	Concede acesso para consultar cotações de criptomoedas.

Cabeçalhos (Headers)

Nome	Descrição
`bankly-version`	Obrigatório. Data em que ocorreu a alteração no contrato. Neste caso, insira 2023-01-30.
`authorization`	Obrigatório. Token de autorização do tipo Bearer.
`bankly-correlation-id`	Obrigatório. Informe um GUID v4. A cada requisição, deve-se gerar um novo GUID.

Parâmetros da rota (Path)

No path desta requisição, envie o seguinte campo:

Nome	Tipo	Descrição
`market`	`query`	Mercado, o qual é constituído da sigla da criptomoeda com a sigla do real. Exemplo: BTC:BRL.

Corpo da requisição (Body)

Não é necessário enviar campos no body desta requisição.

Resposta (Response)

O status code 200 indicará sucesso na consulta.
Sendo bem-sucedido, o retorno irá trazer uma lista de objetos contendo os seguintes campos em formato JSON:

Nome	Tipo	Descrição
`data`	`object`	Objeto que contém informações sobre a cotação de criptomoedas.
`data.market`	`string`	Mercado, o qual é constituído da sigla da criptomoeda com a sigla do real. Exemplo: BTC:BRL.
`data.ask`	`object`	Objeto que contém informações sobre o valor de compra da criptomoeda.
`data.ask.value`	`number`	Preço final da criptomoeda.
`data.ask.currency`	`string`	Código da criptomoeda.
`data.bid`	`object`	Objeto que contém informações sobre o valor da venda da criptomoeda.
`data.bid.value`	`number`	Preço final da criptomoeda.
`data.bid.currency`	`string`	Código da criptomoeda.
`data.timestamp`	`string`	Data e hora da consulta, no formato ISO 8601 - UTC.
`metadata`	`dictionary<string, object>`	Dicionário de metadados que pode conter informações adicionais da requisição, de acordo com o modelo de negócio do cliente.
`links[]`	`array of objects`	Objeto que poderá conter propriedades adicionais.

{
  "data": {
    "market": "BTC:BRL",
    "ask": {
      "value": 103258.5,
      "currency": "BRL"
    },
    "bid": {
      "value": 103258.5,
      "currency": "BRL"
    },
    "timestamp": "2023-03-10T12:19:32.507Z"
  },
  "metadata": {},
  "links": []
}

👍
Dica
Para simular uma requisição nesse endpoint, acesse o API Reference.

Erros

Este endpoint pode retornar alguns erros específicos, conforme a tabela a seguir:

Status Code	Código	Descrição
422	UNPROCESSABLE_ ENTITY	Requisição não pode ser processada, devido uma regra de negócio.

Além disso, este endpoint também poderá retornar erros comuns entre todos os endpoints.

Eventos

Este endpoint não possui eventos relacionados a ele.