Compare o produto da API que será usado
Uma corretora pode oferecer spot, derivativos e serviços regionais separados. Compatibilidade com um deles não significa compatibilidade com os demais. Peça o nome exato do produto, os tipos de conta e as ordens atendidas. Confira diretamente com a corretora se você pode usar aquele serviço.
| Corretora e API | O que conferir na conexão | Distinção no ambiente de teste |
|---|---|---|
| Binance Spot | Tipo de chave de assinatura aceito e permissão explícita para negociar. | A Spot Testnet usa ativos virtuais. Separe credenciais de teste e de produção. |
| Kraken Spot | Permissões distintas para criar, cancelar e consultar ordens ou dados da conta. | AddOrder com validate=true valida uma ordem sem executá-la; não simula o preenchimento. |
| Coinbase Advanced Trade | Suporte específico a Advanced Trade, além da menção genérica à Coinbase. | O sandbox devolve respostas predeterminadas de contas e ordens, sem execução em mercado real. |
| OKX API v5 | Permissões Read, Trade e Withdraw e o modo configurado para a conta. | O modo demo exige configuração própria e não inclui todas as funções de produção. |
| Bybit V5 | Serviço regional, categoria do produto e ambiente aceitos pelo conector. | Demo e testnet são ambientes distintos. A demo oferece apenas parte das APIs. |
Conectar a corretora não é conectar uma carteira
Em uma conexão com uma corretora centralizada, os ativos da conta permanecem sob custódia da corretora. A autorização API permite que o programa realize ações definidas nessa conta. Isso difere de conectar uma carteira de autocustódia ou autorizar o uso de um token na blockchain. Você não precisa entregar a senha de login da corretora nem as palavras de recuperação da carteira para esse tipo de conexão.
Desativar saques limita uma ação importante, mas a permissão de negociação ainda pode causar prejuízos por ordens indesejadas, taxas ou exposição. Registre cada permissão solicitada e sua finalidade. Se uma opção reunir capacidades além do fluxo pretendido, revise o alcance antes de aceitá-la.
Faça três avaliações separadas
Uma resposta válida comprova apenas o comportamento que foi testado. Um sandbox estático pode ajudar a verificar a interpretação de mensagens, mas não mostra a que preço uma ordem seria executada. Validar parâmetros também não cria uma negociação. Mantenha esses resultados separados nas anotações.
- Conexão: consulte a conta esperada e seus saldos com o menor acesso compatível. Confira identidade, produto e ambiente; receber uma resposta autenticada não basta.
- Tratamento de ordens: use demo, testnet ou simulador compatível para avaliar rejeição, execução parcial, cancelamento e queda da conexão. Registre os cenários que esse ambiente não consegue reproduzir.
- Regra: reproduza decisões hipotéticas com taxas, spread, atraso e limites de exposição explícitos. Reserve dados separados para avaliar uma regra depois de alterá-la. Um backtest favorável não comprova resultados futuros.
Exemplo: a resposta da ordem se perde
Imagine uma regra fictícia que pode enviar uma ordem de 100 unidades da moeda de cotação. A solicitação atinge o tempo limite sem confirmação. Reenviar imediatamente pode dobrar a exposição pretendida se a primeira ordem tiver chegado à corretora. Parar a animação da tela não resolve o estado da operação.
O teste deve exigir que o aplicativo pause novos envios, consulte ordens e execuções usando seus identificadores e calcule a exposição antes da próxima ação. Repita o cenário com execução parcial e cancelamento atrasado. Aprovar o teste significa conseguir explicar o estado final da conta, não apenas exibir uma mensagem de sucesso.
| Situação | Evidência a solicitar |
|---|---|
| A conexão cai | Último estado confirmado e procedimento documentado para reconciliar a atividade. |
| Você pausa uma regra | Distinção clara entre impedir novas ordens e cancelar as existentes. |
| Uma chave API é revogada | Confirmação de fim do acesso e conferência de ordens abertas na corretora. |
| Um par ou valor mínimo muda | Dados atuais e tratamento de rejeição que não repita solicitações sem controle. |
Preencha uma ficha que possa ser verificada
Anote a entidade da corretora, o tipo de conta, os mercados, as permissões, a restrição de IP, o tamanho máximo da ordem, a exposição total e o procedimento de parada. Acrescente data e fonte oficial. Mantenha as informações desconhecidas sinalizadas até o fornecedor esclarecê-las.
Evite escolher só pela taxa anunciada ou por uma afirmação genérica de suporte a várias corretoras. O custo depende da conta, do produto e da execução. Confira tarifas e recursos atuais diretamente. O SharkRule prepara automação conectada a corretoras, começando pela Binance; esta comparação não anuncia disponibilidade para Kraken, Coinbase, OKX ou Bybit.
Perguntas frequentes
Qual é a melhor API para um robô de trading?
Depende da conta e do produto necessário. Compare elegibilidade, permissões, recuperação de ordens e opções de teste. Recursos verificáveis ajudam mais que uma promessa de rentabilidade.
A mesma chave API serve em várias corretoras?
Não. As credenciais pertencem a uma corretora e ambiente específicos. Um aplicativo com várias conexões deve lidar separadamente com as chaves e regras de cada uma.
Uma demo bem-sucedida comprova que o robô está pronto?
Não. Registre os limites da demo e teste falhas separadamente. Respostas simuladas, validação de parâmetros e mercados virtuais verificam aspectos diferentes; nenhum garante resultados futuros.
Fontes oficiais
Elaborado com auxílio de IA a partir da documentação oficial indicada. Os exemplos são hipotéticos; não foram realizados testes em contas reais nem comparações de rentabilidade.
- Binance: documentação oficial da Spot Testnet
https://github.com/binance/binance-spot-api-docs/blob/master/testnet/general-info.md - Kraken: AddOrder
https://docs.kraken.com/api-reference/trading/add-order - Coinbase: visão geral de Advanced Trade
https://docs.cdp.coinbase.com/coinbase-app/advanced-trade-apis/overview - Coinbase: sandbox de Advanced Trade
https://docs.cdp.coinbase.com/coinbase-app/advanced-trade-apis/sandbox - OKX: documentação da API v5
https://www.okx.com/docs-v5/en/ - Bybit: operações demo
https://bybit-exchange.github.io/docs/v5/demo - Bybit: guia de integração
https://bybit-exchange.github.io/docs/v5/guide