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
| Header | Exemplo | Obrigatório |
|---|---|---|
| Authorization | Bearer dfk_live_... | Sim |
| X-DF-Secret | sk_... | 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.
