🔐 Autenticação
Todas as requisições devem ser autenticadas utilizando HMAC-SHA256. Envie os headers abaixo em todas as chamadas.
x-api-key— Chave públicax-signature— Assinatura HMAC-SHA256 em hexx-timestamp— Epoch em ms ou ISOx-nonce— opcional (anti-replay)
A assinatura é calculada sobre o payload canônico. Use exatamente a mesma serialização do body (se houver).
Payload canônico
METHOD + PATH + BODY + TIMESTAMP + NONCE
Onde BODY é vazio em requisições sem body (GET) e NONCE é vazio quando
não enviado.
🔄 Fluxo de Integração
- Solicitar cotação OTC
- Confirmar compra usando
quoteId - Acompanhar ordens
- Consultar saldos
POST /api/v1/trades/quote
POST /api/v1/trades/buy
GET /api/v1/orders
GET /api/v1/accounts/balances
🧪 Exemplo (curl)
Solicitar cotação:
curl -X POST https://laas.o3trade.com/api/v1/trades/quote \
-H "x-api-key: SUA_API_KEY" \
-H "x-signature: ASSINATURA" \
-H "x-timestamp: 1710000000000" \
-H "Content-Type: application/json" \
-d '{
"pair": "USDTBRL",
"amount": "1000",
"settlement": "d0"
}'