Como utilizar os endpoints de Trades na API Bloquo?

Como utilizar os endpoints de Trades na API Bloquo?

🔄 API Bloquo: Endpoints de Trades

Visão Geral

Os endpoints de Trades permitem realizar operações de câmbio dentro da plataforma, incluindo solicitação de cotações, aceitação de ordens e consulta ao histórico de negociações.

💲 Solicitar Cotação

POST Request Quote

Solicita uma cotação para uma operação de câmbio entre duas moedas especificadas.

Endpoint:

POST /trade/customer//quote

Parâmetros obrigatórios no corpo da requisição:

  • CustomerId

  • BaseCurrency / QuoteCurrency

  • BaseAccountId / QuoteAccountId

  • Side (buy/sell)

  • BaseAmount ou QuoteAmount

📎 Link para exemplo completo de requisição

✅ Confirmar Cotação

PUT Accept Quote

Confirma a execução de uma cotação gerada anteriormente, finalizando a operação com a taxa de câmbio informada.

Endpoint:

PUT /trade/customer//execute/:quoteOrder

📋 Link para exemplo completo de requisição

📊 Consultar Trades

GET List Trades

Retorna o histórico de negociações do cliente, incluindo filtros por moedas, status, valores e contas.

Endpoint:

GET /trade/customer//order

📎 Link para exemplo completo de requisição

❓ FAQ – Dúvidas Frequentes

1. Preciso estar autenticado para usar os endpoints de trade?

Sim. É necessário gerar um Bearer Token via autenticação com clientId e clientSecret.

2. Como sei se uma cotação ainda é válida?

Verifique o campo expireAt na resposta da cotação.

3. Posso informar o valor em moeda de destino ao invés do valor base?

Sim, pode usar QuoteAmount em vez de BaseAmount. Apenas um dos dois deve ser preenchido.

4. O que acontece após aceitar a cotação?

A ordem de trade é executada e confirmada imediatamente se todos os dados estiverem corretos.

5. Consigo consultar negociações passadas?

Sim, utilize o endpoint de listagem com filtros opcionais como moedas, contas e status.

    • Related Articles

    • Como utilizar os endpoints de Notifications na API Bloquo?

      ? API Bloquo: Endpoints de Notifications Visão Geral Os endpoints de Notifications permitem que o cliente consulte o histórico de notificações enviadas pela plataforma (como alertas de transação, mudanças de status) e reenvie manualmente mensagens, ...

    • Como utilizar os endpoints de Orders na API Bloquo?

      ? API Bloquo: Endpoints de Orders Visão Geral Os endpoints da seção Orders da API Bloquo permitem criar, listar e estornar ordens de depósitos e saques. Essa funcionalidade é essencial para gerenciar transações de entrada e saída na plataforma. ? ...

    • Como utilizar os endpoints de Accounting na API Bloquo?

      ?API Bloquo: Endpoints de Accounting ✅ Visão Geral Os endpoints da seção Accounting da API Bloquo permitem a consulta de dados financeiros do cliente autenticado, como: Dados cadastrais do cliente Contas (FIAT e CRIPTO) Saldos atualizados Transações ...

    • Integração de Webhooks Bloquo: Recebendo Notificações de Status de Pedidos

      ? Integração de Webhooks Bloquo: Recebendo Notificações de Status de Pedidos ? Visão Geral do Recurso Os Webhooks da Bloquo são um mecanismo essencial de notificação em tempo real que garante que os clientes sejam informados imediatamente sobre ...

    • Como consultar as moedas disponíveis?

      ? API Bloquo: Endpoints de Reference (Moedas) Visão Geral Os endpoints de Reference da API Bloquo fornecem dados fundamentais, como a lista de moedas suportadas pela plataforma. Isso permite validar operações, configurar contas e consultar ...