Runtime nativo de IA para estratégias de trading na Bitvavo
Desenvolva no Cursor, Claude Code ou em qualquer IDE de IA. Faça o deploy a partir do GitHub em um runtime de nuvem gerenciado com controle MCP de primeira classe, logs e seleção de região na UE.
Seção 01 · Visão rápida
Visão rápida
- Plataforma
- Bitvavo
- Tipo de plataforma
- Exchange de cripto (centralizada, sediada na UE)
- Classe de ativos
- Cripto
- Produtos suportados
- Apenas Spot. Sem margem, sem futuros, sem derivativos; alavancagem de 1:1 em uma única plataforma spot.
- Modelo de runtime
- Runtime de estratégia em container
- Origem do deploy
- GitHub
- Linguagens
- Qualquer linguagem que rode em um container
- Integrações comuns
- REST e WebSocket nativos da Bitvavo, CCXT (`bitvavo`), CCXT Pro, Freqtrade, SDKs oficiais da Bitvavo (Python, Node.js, Go, Java), personalizado
- Integração com fluxo de IA
- Interface de controle MCP para Cursor, Claude Code, GitHub Copilot e agentes de CLI
- Papel da TradingHost
- Runtime, deploy, logs, monitoramento de integridade, seleção de região, controle MCP
- Papel de Bitvavo
- Conta na exchange, acesso à API, acesso ao mercado, ambiente de execução, canais de EUR
- Afiliação
- A TradingHost é independente e não é afiliada à Bitvavo. A Bitvavo B.V. é supervisionada pela AFM sob a MiCA (autorização concedida em junho de 2025) e registrada no De Nederlandsche Bank (DNB).
Seção 02 · O que Bitvavo oferece
O que Bitvavo oferece
A Bitvavo é uma exchange sediada na UE que opera exclusivamente no mercado spot, com canais de moedas fiduciárias nativos em EUR (SEPA, SEPA Instant, iDEAL) e autorização MiCA em todo o EEA. As estratégias se conectam à plataforma via REST e WebSocket, autenticadas por chaves de API assinadas com HMAC-SHA256 e limitadas a permissões específicas. Não há derivativos, margem ou contratos perpétuos; a interface é intencionalmente mais simples do que em exchanges de cripto multiprodutos.
Mercados e padrões de estratégia
- Grid trading spot em EUR
- DCA recorrente em EUR nas principais criptomoedas
- Arbitragem de pares fiduciários em EUR contra plataformas em USD
- Execução de baixa latência na região da UE a partir de runtime adjacente a Amsterdã
- Market making spot em pares de EUR
- Reversão à média em pares de EUR / altcoins
- Rebalanceamento de portfólio entre ativos spot
- Hospedagem de estratégias de varejo em conformidade com a MiCA (passaporte EEA)
Superfície da API
- Superfícies de produtos
- Apenas Spot. Sem futuros, sem margem, sem opções. Pares cotados em EUR predominam; mercados cotados em USDC, USDT e BTC também estão disponíveis.
- Métodos de conexão
- REST em `https://api.bitvavo.com/v2/`. WebSocket em `wss://ws.bitvavo.com/v2/`. A API FIX também é oferecida para clientes institucionais (não disponível para autoatendimento).
- Autenticação
- Chave de API mais requisições assinadas com HMAC-SHA256. Cabeçalhos: `Bitvavo-Access-Key`, `Bitvavo-Access-Signature`, `Bitvavo-Access-Timestamp`, `Bitvavo-Access-Window` (padrão de 10000 ms). A assinatura equivale ao digest hexadecimal HMAC SHA-256 de `timestamp + method + url + body`, usando a chave secreta da API. Lista de permissões de IP opcional por chave (fortemente recomendada). Permissões da chave de API: View, Trade, Withdraw, Subaccount, Internal Transfer, Administrative.
Para detalhes específicos, consulte Bitvavo
Endpoints específicos, pesos de limite de taxa, listas de símbolos e faixas de taxas estão na documentação da Bitvavo. Considere-os como a fonte oficial de informações.
Seção 03 · Desenvolva com IA
Desenvolva sua estratégia para Bitvavo com IA
Escolha um método de integração, faça um fork de um starter de framework da TradingHost e desenvolva sua estratégia em uma AI IDE. Cursor, Claude Code, GitHub Copilot e agentes de IA baseados em CLI funcionam com o mesmo fluxo de deploy nativo do GitHub.
API nativa da Bitvavo
Controle direto sobre o comportamento específico da Bitvavo, dados da conta e lógica de execução de ordens via REST, WebSocket ou FIX institucional.
CCXT
Interface comum entre a Bitvavo e outras exchanges de cripto. O CCXT Pro adiciona suporte a WebSocket.
Freqtrade
Deploys baseados em framework usando a estrutura de estratégia do Freqtrade. O suporte à Bitvavo é testado pela comunidade via CCXT; sem stoploss na exchange.
Conector personalizado
Seu próprio motor de trading interno ou integração proprietária com a Bitvavo, ou um dos SDKs oficiais da Bitvavo (Python, Node.js, Go, Java).
Suporte de frameworks para a Bitvavo
A Bitvavo opera apenas no mercado spot, portanto a matriz de frameworks é mais simples do que em plataformas multiprodutos: não há colunas para USD-M, COIN-M ou opções. Se sua estratégia precisa de contratos perpétuos ou futuros com margem em USD, combine a Bitvavo com outra plataforma (como Binance, Bybit ou OKX) para a parte de derivativos. Para estratégias spot na Bitvavo, os três principais frameworks e a API nativa são suportados; o Hummingbot atualmente não oferece um conector para a Bitvavo.
✓ suporte confirmado de acordo com os documentos oficiais do framework. "no connector" indica que o framework não oferece um conector para a Bitvavo. Os links de fluxo de trabalho direcionam para as páginas /workflows/ atualmente em desenvolvimento.
A TradingHost não impõe nenhum framework. Ela executa o seu projeto.
Desenvolva com IA
Os starters de framework acima combinam perfeitamente com AI IDEs. A interface de controle MCP da TradingHost fecha o ciclo: as ferramentas de IA podem inspecionar deploys, analisar logs e gerenciar o runtime junto com você, sem nunca interferir no caminho de execução das ordens.
Seção 04 · Execute na TradingHost
Execute seu código na TradingHost
A Bitvavo fornece a exchange e o acesso à API. A TradingHost fornece o ambiente de produção onde sua estratégia conectada à Bitvavo é executada.
Em vez de executar o código da estratégia em um notebook, computador desktop, VPS genérico ou servidor configurado manualmente, você faz o deploy a partir do GitHub em um runtime de container gerenciado pela TradingHost.
Você
- Seu repositório contém seu código.
- Seu deploy define como ele é executado.
- Sua estratégia se conecta à Bitvavo.
TradingHost
- Mantém o runtime online.
- Exibe logs e health checks.
- Seleção de região.
- Superfície de deploy controlada.
Fluxo de deploy
- PASSO 01
Conecte o GitHub
Autorize a TradingHost a acessar sua conta do GitHub.
- PASSO 02
Vincule um repositório ou comece a partir de um framework
Aponte a TradingHost para o repositório da sua estratégia existente ou faça um fork de um runtime de framework da TradingHost (CCXT ou Freqtrade) para obter uma base funcional.
- PASSO 03
Implante em um contêiner da TradingHost
Escolha uma região (EU ou US-East), informe as variáveis de ambiente que sua estratégia precisa (chaves de API da Bitvavo: os cabeçalhos `Bitvavo-Access-Key`, `Bitvavo-Access-Signature`, `Bitvavo-Access-Timestamp` e `Bitvavo-Access-Window` são gerados a partir delas) e faça o deploy. A TradingHost compila seu container a partir do repositório e executa sua estratégia em uma infraestrutura gerenciada de Kubernetes. Não é necessário instalar o Docker localmente.
- PASSO 04
Monitore logs e integridade
Acompanhe logs em tempo real, a integridade e o estado do runtime diretamente pelo painel da TradingHost. Essa mesma interface pode ser acessada via MCP a partir de qualquer AI IDE — assim, o Cursor, o Claude Code ou um agente de CLI podem ler o estado do deploy e gerenciar o runtime junto com você.
- PASSO 05
Atualize e faça o redeploy
Faça push das alterações para a branch principal do seu GitHub e a TradingHost realiza o redeploy de forma automática.
Seção 05 · Notas operacionais
Notas operacionais para Bitvavo
Problemas práticos que você enfrenta ao rodar uma estratégia para a Bitvavo em um runtime de nuvem em container, que não estão nos documentos da Bitvavo nem nos READMEs dos frameworks. Cada afirmação abaixo foi extraída ou parafraseada da própria documentação da Bitvavo; as orientações de deploy são baseadas na execução dessas estratégias na TradingHost.
01 · Limites de taxa
Limite de taxa baseado em peso, 1000 pontos por minuto
A Bitvavo aplica um limite de taxa ponderado compartilhado entre REST e WebSocket. O teto padrão é de 1000 pontos de peso por minuto, rastreado por chave de API quando autenticado e por IP caso contrário. As respostas incluem os cabeçalhos `bitvavo-ratelimit-limit`, `bitvavo-ratelimit-remaining` e `bitvavo-ratelimit-resetat`. Exceder esse limite retorna HTTP 429 com `errorCode 105` e bloqueia chamadas autenticadas por 1 minuto (não autenticadas por 15 minutos).
FonteBitvavo rate limits02 · WebSocket
Endpoint único, inscrições baseadas em ações JSON
Um único endpoint WebSocket em `wss://ws.bitvavo.com/v2/` lida tanto com dados de mercado públicos quanto com negociações autenticadas. As inscrições e operações de ordens são enviadas como mensagens JSON com um parâmetro `action`. O limite padrão (throttling) permite até 5000 mensagens por segundo; o Market Data Pro limita a 50/s; ambos retornam `errorCode 112` em caso de estouro do limite.
03 · Chaves de API
Escopos de permissão granulares e whitelist de IP
Ao criar uma chave no painel da Bitvavo, você escolhe qualquer combinação dos escopos View, Trade, Withdraw, Subaccount, Internal Transfer e Administrative. A whitelist de IP é opcional, mas fortemente recomendada; sem ela, qualquer pessoa que possua as credenciais poderá operar na conta. A Bitvavo alerta que saques iniciados via API ignoram o 2FA, portanto, o escopo Withdraw deve ser ativado apenas quando for realmente necessário.
04 · Erros de autenticação
305 / 307 / 309 são as falhas de assinatura e IP a serem observadas
As falhas de autenticação mais comuns que os desenvolvedores enfrentam são o `errorCode 307` ("this key does not allow access from this IP") quando o host de origem está fora da whitelist, e o `errorCode 309` ("the signature is invalid") quando o HMAC foi gerado incorretamente ou o secret foi copiado com espaços em branco. O `errorCode 304` cobre divergências de timestamp/window. A Bitvavo recomenda gerar novas chaves em vez de depurar problemas de nonce ou de copiar e colar.
05 · Canais de depósito em EUR
Depósitos via SEPA, SEPA Instant e iDEAL
O aporte de moedas fiduciárias é nativo em EUR via transferência bancária SEPA gratuita (1 dia útil para contas holandesas, 2 para outros países do EEA), SEPA Instant para bancos compatíveis e iDEAL de até € 50.000 por transação. Depósitos recorrentes via SEPA também são suportados. Não há rampa de entrada para USD; as estratégias devem precificar em EUR ou aceitar a exposição cambial.
06 · Redes de depósito
Uma rede por ativo, sem stablecoins TRC-20
Ao contrário de exchanges multichain, a Bitvavo suporta deliberadamente apenas uma rede blockchain por ativo listado para reduzir o risco de envios incorretos. Notavelmente, depósitos em TRC-20 de ativos cotados em Ethereum não são suportados. A derivação do endereço de depósito deve verificar a lista de redes suportadas pela Bitvavo para cada ativo antes de gerar um endereço; fundos enviados incorretamente não podem ser recuperados.
07 · Regulamentação
Autorizada pelo MiCA via AFM, com passaporte do EEA ativo
A Bitvavo recebeu autorização do MiCA pela AFM holandesa em junho de 2025, cobrindo custódia, operação de plataforma de negociação e transferência de criptoativos em todos os estados-membros da UE, além de Noruega, Islândia e Liechtenstein. O registro anterior no DNB permanece ativo para supervisão de AML/CFT. A janela de transição do MiCA para CASPs não licenciadas na maioria dos estados-membros terminou em meados de 2026; usar uma plataforma licenciada pelo MiCA é agora o padrão de conformidade para operadores de estratégias residentes no EEA.
Seção 06 · Indicado para
Indicado para
Os runtimes da TradingHost para a Bitvavo são ideais para:
- Desenvolvedores criando estratégias em IDEs de IA (Cursor, Claude Code)
- Traders sistemáticos de cripto
- Desenvolvedores quant baseados na UE
- Usuários de CCXT e Freqtrade
- Equipes migrando de hospedagem VPS para implantação em contêineres
Conectar o GitHub e criar sua primeira estratégia é grátis.
Seção 08 · Perguntas frequentes
Perguntas frequentes
Não. A TradingHost é independente e não é afiliada à Bitvavo.
Não. O código da sua estratégia se conecta à Bitvavo e envia instruções de acordo com a sua própria lógica, permissões de conta e método de integração. A TradingHost fornece o runtime onde esse código é executado.
Não. O acesso à API da Bitvavo é fornecido pela própria Bitvavo. Você é responsável por sua conta da Bitvavo, permissões de API, credenciais e conformidade com os termos da Bitvavo.
Não. A TradingHost é o runtime em nuvem onde o código da sua estratégia é executado. Nós não fornecemos sinais, modelos de previsão de IA ou bots pré-configurados. Com a TradingHost, você mesmo escreve ou gera a estratégia (geralmente com o Cursor ou Claude Code), mantém o código no seu GitHub e usa a TradingHost para executá-lo em produção. Produtos como o 3Commas, Cryptohopper e similares são donos da lógica da estratégia; a TradingHost apenas executa a sua estratégia.
A AWS e a DigitalOcean fornecem computação bruta. Você mesmo precisa lidar com atualizações de sistema operacional, orquestração de contêineres, envio de logs, rotação de segredos, failover de região e monitoramento de uptime. A TradingHost oferece um runtime gerenciado criado especificamente para estratégias de trading: implantação nativa do GitHub, controle via MCP a partir de IDEs de IA, além de interfaces de logs e monitoramento de integridade prontas para uso. Se você prefere operar a infraestrutura por conta própria, a AWS funciona. Se você quer o runtime como um serviço gerenciado, a TradingHost é o caminho mais curto.
Sim. A TradingHost executa estratégias em Python; escolha o runtime de framework que corresponda à sua stack ou faça o deploy do seu próprio repositório.
Sim. A TradingHost suporta qualquer linguagem que possa ser executada dentro de um contêiner.
Sim. A Bitvavo é suportada tanto no CCXT quanto no CCXT Pro sob o ID de exchange bitvavo, cobrindo REST e WebSocket. A Bitvavo também publica SDKs oficiais em Python, Node.js, Go e Java, caso prefira o cliente nativo. Consulte o runtime do framework CCXT para ver o processo completo de configuração.
Sim, se o seu projeto for projetado dessa forma. Você pode executar múltiplos processos ou serviços de estratégia dentro de um único runtime, ou separá-los em runtimes diferentes para fins de isolamento e clareza operacional. Consulte a página de runtimes da TradingHost para conhecer o modelo multiestratégia.
O caminho mais rápido é fazer um fork de um runtime de framework da TradingHost: CCXT ou Freqtrade para um projeto pronto para implantação. Ou conecte seu próprio repositório de estratégia do GitHub. Vincular um repositório do GitHub e criar uma estratégia é gratuito; os planos de runtime estão listados na página de preços.
No seu fluxo de trabalho de segredos controlado pelo GitHub. A TradingHost lê as chaves em tempo de execução por meio de segredos de repositório do GitHub, segredos de ambiente ou seu próprio processo aprovado de gerenciamento de segredos. A TradingHost não precisa da custódia da sua chave de API e do seu secret. Consulte a seção de segredos da plataforma para ver o modelo completo de tratamento.
Não. As estratégias nunca devem precisar do escopo Withdraw. Use apenas os escopos View e Trade, e ative a whitelist de IP onde for apropriado. A Bitvavo alerta que saques iniciados via API ignoram o 2FA, portanto, o escopo Withdraw é de alto risco e deve ser reservado para chaves que você opera manualmente a partir de um host com IP fixo.
Sim. A TradingHost suporta controle baseado em MCP para IDEs de IA, incluindo Cursor, Claude Code, GitHub Copilot e agentes de IA baseados em CLI. As ferramentas de IA podem inspecionar implantações, revisar logs, reiniciar estratégias e gerenciar fluxos de trabalho de runtime. O MCP é uma interface de controle e observabilidade, não o caminho de execução de ordens. Consulte a interface de controle MCP para ver o panorama completo.
Ambos. A interface de controle do MCP funciona igualmente bem a partir de agentes baseados em CLI (Claude Code CLI, clientes MCP personalizados, chamadas MCP via script) e de dentro de uma IDE. O fluxo de implantação nativo do GitHub também funciona sem qualquer ferramenta de IA: um simples git push para a sua branch principal aciona uma nova implantação.
O runtime detecta o crash e expõe os logs e informações de integridade relevantes. Onde houver suporte, a estratégia afetada pode ser reiniciada sem interromper outras estratégias em execução no mesmo container. O código da sua estratégia continua sendo o responsável pelo tratamento seguro de erros, proteção contra ordens duplicadas e controles de risco. Consulte a seção de observabilidade para acessar os logs e a interface de integridade.
Esta é uma rejeição de lista de permissões (whitelist) de IP da Bitvavo. Adicione o IP de saída (egress IP) do runtime do TradingHost à whitelist da chave de API no painel da Bitvavo ou gere novamente a chave sem uma whitelist (não recomendado). Confirme o IP de saída por meio das informações de runtime do TradingHost antes de adicioná-lo à whitelist.
O HMAC foi gerado incorretamente ou o segredo da API foi copiado com espaços em branco adicionais. Recalcule a assinatura como o digest hexadecimal de HMAC-SHA256(secret, timestamp + method + url + body), certifique-se de que a string do corpo da requisição corresponda exatamente ao que foi assinado e verifique se o Bitvavo-Access-Timestamp está em milissegundos dentro do Bitvavo-Access-Window. Gerar a chave novamente é a solução mais rápida caso o segredo esteja corrompido.
Não. A Bitvavo opera apenas no mercado à vista (spot) com alavancagem de 1:1; não há futuros, perpétuos, opções ou produtos de margem. Para perpétuos ou futuros USD-M, implante uma estratégia separada integrada à Binance, Bybit ou OKX.
Sim. A Bitvavo é autorizada sob a MiCA pela AFM holandesa (junho de 2025) e registrada no De Nederlandsche Bank desde 2020. A autorização da MiCA oferece passaporte para todo o EEA, de modo que um operador de estratégia residente no EEA pode hospedar sua operação em uma plataforma licenciada sem a necessidade de registros individuais por país. A Bitvavo é um CASP, não uma instituição de crédito; isso não estende as proteções da MiFID às atividades de negociação.
EUR via transferência bancária SEPA gratuita (1 a 2 dias úteis), SEPA Instant onde houver suporte do seu banco, ou iDEAL para depósitos instantâneos de bancos holandeses de até € 50.000 por transação. Não há canais de fiat em USD; o PnL denominado em USD exige conversão para stablecoin ou câmbio (FX).
A TradingHost opera nas regiões EU e US-East. Especificamente para a Bitvavo, a região EU é a mais próxima geograficamente do mecanismo de correspondência da Bitvavo, localizado próximo a Amsterdã, e geralmente oferece o menor tempo de resposta (round-trip). Consulte a página de regiões para obter detalhes sobre rotas e proximidade.
Não. O TradingHost é focado em runtime de produção e implantação. O backtesting deve ser feito em sua própria pilha de pesquisa, framework ou no AlgoBuilder.