SHARKRULE / Aprender

API da Coinbase: configuração, permissões e segurança

Prepare uma conta elegível Coinbase Advanced para o lançamento Spot do SharkRule no Reino Unido. Confira os ativos, acesso, permissões e regras de compra e venda que você aprova. Novas ativações com dinheiro real ainda não estão abertas; as orientações para conexões existentes e recuperação continuam disponíveis.

SharkRule · Revisado em

Confira se a conexão está disponível

Este guia preserva as instruções de chave manual para conexões existentes. O método de acesso para novos clientes ainda requer confirmação da Coinbase antes da ativação no Reino Unido. Siga apenas o método oferecido em sua conta; uma verificação técnica bem-sucedida não demonstra autorização do provedor para acesso hospedado.

Antes de começar: Você precisa ter sua própria conta na Coinbase. Se ainda não tiver uma, crie a conta diretamente na corretora e conclua as verificações exigidas antes de criar uma chave de API. A SharkRule não cria uma conta na corretora para você.

Você pode experimentar uma simulação da SharkRule sem ter conta em uma corretora.

O lançamento inicial no Reino Unido está sendo preparado para Coinbase Advanced Spot. A lista inclui Bitcoin (BTC), Ethereum (ETH) e Solana (SOL), cada um em pares com GBP, USD ou USDC quando a conta Coinbase do cliente permitir. Você escolhe e aprova o ativo, valor, entrada, saída e limites. Estratégias existentes de apenas compra não recebem venda automática.

A conexão preparada aceita uma carteira de consumidor ou padrão, com View e Trade ativos e Transfer desativado. A elegibilidade da conta e os produtos liberados pela Coinbase continuam valendo.

Se aparecer “Verifique sua empresa”

O portal da Coinbase reúne vários produtos. O cartão de verificação de empresa para APIs de custódia faz parte de um processo diferente daquele da chave de API da conta pessoal usada pela SharkRule.

Abra o menu (☰ no celular) e acesse API Keys → Secret API Keys. Você também pode abrir novamente o link direto da página de chaves depois de fazer login. Continue com sua conta pessoal da Coinbase e selecione a carteira que pretende usar; o nome exibido pode ser Primary.

Se Secret API Keys ou sua carteira pessoal não estiver disponível, entre em contato com o suporte da Coinbase para verificar o acesso da sua conta antes de continuar.

Crie sua chave de API secreta

  1. Entre na Coinbase e abra a página oficial de chaves: https://portal.cdp.coinbase.com/api-keys/secret. Em API Keys, escolha Secret API Keys e Create API key. Confira o endereço antes de informar dados de acesso.
  2. Em API key nickname, digite SharkRule para reconhecer a chave depois. Mantenha esta chave separada das usadas por outros programas.
  3. Em IP allowlist, informe apenas os endereços IP do servidor exibidos na página de conexão após entrar na SharkRule. Deixe Allow requests from any IP address desmarcado. Os endereços de exemplo da Coinbase, como 192.168.1.0/24 e 2001:db8::/32, são apenas exemplos de preenchimento, não endereços da SharkRule. Não use o IP da sua casa ou do celular. Se a SharkRule não mostrar endereços do servidor, aguarde a liberação da configuração.
  4. Abra Advanced settings. Em Coinbase App & Advanced Trade, selecione a carteira que pretende usar; ela pode se chamar Primary. Marque View (read-only) e Trade (execute trades on your behalf). Deixe Transfer (initiate transfer of funds) e Receive (receive inbound payments) desmarcados. Em Account → Non-custodial, deixe também Export (export private key) e Manage (modify policies) desmarcados. A SharkRule não precisa dessas permissões extras.
  5. Em Signature algorithm, selecione ECDSA (Legacy SDKs), mesmo que Ed25519 apareça como Recommended. A conexão atual da SharkRule exige ECDSA / ES256. A indicação Legacy SDKs não significa que você deva usar credenciais antigas da Coinbase Pro.
  6. Selecione Create e conclua as verificações de segurança da Coinbase. Na janela Save your API key, copie API key ID e Secret para os campos correspondentes na SharkRule. API key ID é o valor completo que começa com organizations/…/apiKeys/…; o apelido SharkRule é apenas um rótulo. Secret é sua chave privada ECDSA. Preserve as linhas BEGIN e END e todas as quebras de linha. Salve os dois valores com segurança antes de fechar essa janela, que aparece uma única vez; a Coinbase também oferece Download API key. Nunca inclua o segredo em capturas de tela, e-mails ou mensagens ao suporte.

Se não for possível selecionar Trade, consulte o suporte da Coinbase sobre o acesso à sua conta e carteira antes de continuar. Uma chave apenas com View não pode automatizar operações; ativar outras permissões não resolve isso.

Faça a preparação pelo celular

Abra o mesmo endereço do CDP no navegador do celular. Se algum controle não aparecer, solicite a versão para computador ou conclua em um computador. Este procedimento não depende de um botão de aprovação automática no aplicativo da Coinbase.

Ao copiar Secret, preserve as quebras de linha da chave privada e as linhas BEGIN e END. Não a envie por aplicativos de mensagem nem use uma área de transferência compartilhada.

Conectar e revisar na SharkRule

  1. Abra Minha corretora na SharkRule e escolha Coinbase. Cole os valores completos de API key ID e Secret da janela Save your API key da Coinbase nos campos correspondentes. Verificar e conectar confere a conta e as permissões; não envia ordens.
  2. Pares Spot preparados: BTC-GBP, BTC-USD, BTC-USDC, ETH-GBP, ETH-USD, ETH-USDC, SOL-GBP, SOL-USD e SOL-USDC. Um par só pode ser usado se estiver disponível para sua conta elegível e for confirmado na revisão. Mantenha a moeda de cotação correspondente no portfólio conectado.
  3. Escolha uma compra após uma queda, com monitoramento por 24 horas, ou compras programadas com intervalo mínimo de uma hora. Defina o orçamento total com taxas, o máximo por compra e até 100 compras programadas.
  4. Confira o par exato, valor, entrada, limites de compra e taxas. Para vender automaticamente, informe seu alvo de alta, porcentagem de stop loss ou ambos antes da revisão. Deixe os dois vazios para apenas comprar. Cada condição usa o preço médio daquela compra antes das taxas e se aplica somente ao ativo comprado pela estratégia. Aprove expressamente as regras antes de iniciar quando a ativação estiver disponível. A primeira compra programada pode ocorrer após o início.

A SharkRule monitora a venda automática; ela não é uma ordem stop ou bracket pendente na Coinbase. O serviço, a conexão e as permissões precisam continuar disponíveis. Saltos de preço, liquidez, taxas, mínimos da corretora e interrupções podem impedir a venda ou deixar um pequeno saldo. Um stop loss não garante uma perda máxima. As compras programadas respeitam a quantidade e o orçamento aprovados; as vendas não aumentam esses limites.

As ordens devem ser executadas por completo no preço limite ou melhor, ou são canceladas. Uma compra não executada interrompe novas compras; saídas já aprovadas continuam sendo monitoradas. Após confirmar uma venda não executada, o SharkRule pode tentar novamente, até três tentativas de venda por compra, com intervalo mínimo de 30 segundos. O limite de compras conta tentativas de compra. Resultados desconhecidos são verificados antes de qualquer outra ordem.

A Coinbase determina as taxas reais. Se os custos informados excederem o valor aprovado, novas compras param para revisão; a reserva para taxas não é uma garantia da corretora.

Conectar a Coinbase à SharkRule

Se a verificação falhar

Confira se API key ID foi cortado, faltam linhas em Secret, a chave é Ed25519 em vez de ECDSA, os IPs estão incorretos, Transfer está ativo ou a carteira é outra. Uma chave válida ainda pode pertencer a um tipo de conta não aceito. Entenda o erro antes de criar novas chaves.

O saldo disponível pode ser menor que o valor total por causa de ordens abertas ou recursos em outra carteira. Considere também os valores mínimos das ordens e as taxas. Ao pedir ajuda, envie somente o erro sem dados sensíveis e o horário.

Remover o acesso no provedor

Pare a estratégia na SharkRule antes de desconectar. Parar impede novas compras e vendas automáticas; não vende seus ativos. Uma ordem já enviada pode ser concluída e deve ser verificada antes de desconectar. Não envie outra ordem para adivinhar um resultado desconhecido. Se a chave for exposta, revogue-a imediatamente na Coinbase e revise a atividade.

Perguntas frequentes

Preciso informar minha senha da Coinbase na SharkRule?

Não. Use apenas os campos CDP da conexão habilitada. Senhas, códigos de verificação e frases de recuperação não devem ser enviados à SharkRule ou ao suporte.

A autorização acontece com um clique?

Não. Este guia descreve a criação manual de uma chave API. Outros fluxos de autorização e sua disponibilidade precisam ser confirmados separadamente.

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.