Mercado

Cotações de mercado BTC/USD e USD/BRL.

Visão geral

Endpoint de leitura para obter cotação atual de BTC em USD e taxa USD/BRL, incluindo variação percentual nas últimas 24h. Útil para conversões e exibição de preços em interfaces.

Autenticação

Requer chave de API com scope read. Headers Authorization, X-DF-Secret e X-DF-Passphrase são obrigatórios.

Headers

HeaderExemploObrigatório
AuthorizationBearer dfk_live_...Sim
X-DF-Secretsk_...Sim
X-DF-Passphrase...Sim

Cotações

GET /v1/market/rates
  • Scope: read
  • Rate limit: 60 req/min, burst 10/5s

Retorna cotação BTC/USD e USD/BRL com variação percentual nas últimas 24h. Dados atualizados periodicamente em cache.

Exemplo de requisição

bash
curl https://api.deflow.exchange/v1/market/rates \
  -H "Authorization: Bearer dfk_live_..." \
  -H "X-DF-Secret: sk_..." \
  -H "X-DF-Passphrase: minha-passphrase"

Exemplo de resposta da requisição

json
{
  "data": {
    "crypto": {
      "bitcoin": {
        "usd": 78000.76,
        "usd_24h_change": -0.974
      }
    },
    "usdBrl": {
      "rate": 5.0518,
      "pctChange": 0.955232
    }
  },
  "meta": {
    "timestamp": "2026-05-16T13:59:43.834Z"
  }
}

Campos

Resposta contém os campos abaixo dentro de data:

  • crypto.bitcoin.usd — preço atual BTC/USD (USD).
  • crypto.bitcoin.usd_24h_change — variação percentual nas últimas 24h.
  • usdBrl.rate — taxa de conversão USD → BRL.
  • usdBrl.pctChange — variação percentual da taxa USD/BRL.

Cache

Cache de ~60s no servidor. Considere staleness no cliente para exibição em tempo real.