Tempo de leitura: … min

Runtime nativo para IA para estratégias de trading no Bitfinex

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.

Pela equipe de engenharia da TradingHost

Seção 01 · Visão rápida

Visão rápida

Plataforma
Bitfinex
Tipo de plataforma
Exchange de cripto (spot, margem, derivativos)
Classe de ativos
Cripto
Produtos suportados
Spot, margem (financiada por um funding pool peer-to-peer), derivativos (contratos perpétuos) em derivatives.bitfinex.com. Tokens de valores mobiliários via Bitfinex Securities operam como um ambiente separado.
Modelo de runtime
Runtime de estratégia em contêiner (Kubernetes)
Origem do deploy
GitHub
Linguagens
Qualquer linguagem executada em contêiner
Integrações comuns
REST v2 nativo do Bitfinex, WebSocket v2, Honeycomb FIX 4.4, CCXT (bitfinex, bitfinex2), Freqtrade (via CCXT), personalizado
Integração com fluxo de IA
Superfície de controle MCP para Cursor, Claude Code, GitHub Copilot e agentes de CLI
Papel da TradingHost
Runtime, deploy, logs, verificações de integridade, seleção de região, segredos, controle MCP
Papel de Bitfinex
Conta da exchange, emissão de chaves de API, acesso ao mercado, correspondência de ordens, custódia, liquidação
Afiliação
O TradingHost é independente e não possui afiliação com o Bitfinex ou com a iFinex Financial Technologies Limited. O Bitfinex não atende clientes domiciliados nos EUA.

Seção 02 · O que Bitfinex oferece

O que Bitfinex oferece

O Bitfinex oferece negociação de spot, margem e derivativos por meio de REST v2 e WebSocket v2, além do Honeycomb FIX 4.4 para clientes institucionais. A margem é financiada por um funding pool peer-to-peer em vez da exchange, o que torna o lado de empréstimo (lending) uma superfície de estratégia por si só. Contratos perpétuos são negociados em derivatives.bitfinex.com sob a convenção de F0 symbols (por exemplo, tBTCF0:USTF0) e exigem USDt0 em uma carteira de derivativos dedicada. As especificidades dos endpoints mudam com o tempo; a estrutura geral é durável, mas os pesos exatos de limite de taxa, faixas de taxas e listas de símbolos estão documentados diretamente no Bitfinex.

Mercados e padrões de estratégia

  • Market making de spot em tBTCUSD e tETHUSD
  • Trading de margem financiado via funding pool peer-to-peer
  • Trading de contratos perpétuos em derivatives.bitfinex.com (F0 symbols)
  • Estratégias de taxa de financiamento no lado de empréstimo (ofertas de fUSD, fBTC)
  • HFT institucional via Honeycomb FIX 4.4
  • Isolamento de estratégia com escopo de sub-accounts
  • Envio de ordens post-only e ocultas (order flags)
  • Lógica de ordem bracket One-Cancels-Other (OCO)

Superfície da API

Superfícies de produtos
Spot, margem (funding pool), derivativos (perpétuos via F0 symbols, requer USTF0 na carteira de derivativos), valores mobiliários (separado). Paper trading via tTESTBTCF0:TESTUSDTF0.
Métodos de conexão
REST v2 (público em api-pub.bitfinex.com, autenticado em api.bitfinex.com), WebSocket v2 (wss://api-pub.bitfinex.com/ws/2 e wss://api.bitfinex.com/ws/2), Honeycomb FIX 4.4 para institucional. REST e WS v1 continuam disponíveis, mas a v2 é recomendada.
Autenticação
Chave de API mais segredo com nonce estritamente crescente e assinatura HMAC-SHA384. O limite máximo (nonce ceiling) é 9007199254740991. Cada cliente simultâneo precisa de sua própria chave para evitar colisões de nonce. As permissões têm escopo por chave (informações da conta, ordens, margem, financiamento, saques).

Para detalhes específicos, consulte Bitfinex

Endpoints específicos, pesos de limite de taxa, listas de símbolos, faixas de taxas e histórico de versões estão na documentação do Bitfinex. Use-os como a fonte única de verdade.

Seção 03 · Desenvolva com IA

Desenvolva sua estratégia para Bitfinex com IA

Escolha um método de integração, faça um fork de um starter framework do TradingHost e desenvolva sua estratégia em uma IDE de IA. Cursor, Claude Code, GitHub Copilot e agentes de IA baseados em CLI funcionam com o mesmo fluxo de deploy nativo do GitHub. O modelo de margem diferenciado do Bitfinex — um funding pool peer-to-peer em vez de margem financiada pela exchange — e a convenção de F0 symbols no ambiente de derivativos separado moldam como cada framework se mapeia na plataforma.

  • API nativa do Bitfinex

    Controle direto sobre o comportamento específico do Bitfinex, dados da conta e lógica de execução de ordens via REST v2 and WebSocket v2.

  • CCXT

    Interface comum entre o Bitfinex e outras exchanges de cripto. O CCXT expõe o Bitfinex sob dois IDs: `bitfinex` (v1) e `bitfinex2` (v2). Novos códigos devem focar no `bitfinex2`.

    Comece com CCXT

  • Freqtrade ou Hummingbot

    Deploys baseados em frameworks usando suas estruturas de estratégia e modelos de configuração. O Freqtrade acessa o Bitfinex via CCXT; o Hummingbot historicamente oferece um conector spot para o Bitfinex.

    Comece com FreqtradeComece com Hummingbot

  • Conector personalizado

    Seu próprio motor de trading interno ou integração proprietária com o Bitfinex, incluindo Honeycomb FIX 4.4 para clientes institucionais.

Suporte de frameworks para produtos Bitfinex

A cobertura varia de acordo com o framework. A API nativa REST v2 com WebSocket v2 cobre toda a superfície do Bitfinex, incluindo os perpétuos F0 no ambiente de derivativos e o funding pool. O CCXT expõe o Bitfinex via dois IDs (`bitfinex` para v1, `bitfinex2` para v2); o `bitfinex2` é recomendado para novas estratégias. O Freqtrade acessa o Bitfinex via CCXT para spot, sem suporte oficial para margem e futuros. O Hummingbot oferece um conector apenas para spot do Bitfinex.

FrameworkSpotMargemPerp
Native Bitfinex (REST v2 + WS v2)SuportadoSuportadoSuportado
CCXT (bitfinex, bitfinex2)SuportadoParcialmente suportadoParcialmente suportado
FreqtradeSuportadoParcialmente suportadoNão documentado como suportado
HummingbotSuportadoNão documentado como suportadoNão documentado como suportado

✓ suporte confirmado de acordo com a documentação oficial do framework. "parcial" ou "limitado" indica que o framework acessa a superfície, mas não cobre todo o produto do Bitfinex. "não" indica que não há suporte documentado oficialmente. Os links de fluxo de trabalho direcionam para as páginas de /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 Bitfinex fornece a exchange e o acesso à API. A TradingHost fornece o ambiente de produção onde sua estratégia conectada à Bitfinex é 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 à Bitfinex.

TradingHost

  • Mantém o runtime online.
  • Exibe logs e health checks.
  • Seleção de região.
  • Superfície de deploy controlada.

Fluxo de deploy

  1. PASSO 01

    Conecte o GitHub

    Autorize a TradingHost a acessar sua conta do GitHub.

  2. PASSO 02

    Vincule um repositório ou comece a partir de um framework

    Aponte a TradingHost para o seu repositório de estratégia existente ou faça um fork de um runtime de framework da TradingHost (CCXT, Freqtrade ou Hummingbot) para obter uma base funcional.

  3. PASSO 03

    Implante em um contêiner da TradingHost

    Escolha uma região (EU ou US-East), insira as variáveis de ambiente que sua estratégia exige (chave de API e segredo da Bitfinex, etc.) e faça o deploy. O TradingHost compila seu container a partir do repositório e executa sua estratégia em uma infraestrutura gerenciada de Kubernetes. Como a Bitfinex exige monotonicidade estrita de nonce por chave, execute apenas uma chave de API por processo worker. Para rodar múltiplas estratégias simultâneas, gere uma chave para cada estratégia sob uma sub-account para evitar colisões no espaço de nonce compartilhado. Sem necessidade de instalação local do Docker.

  4. 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ê.

  5. 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.

Deploy

Seção 05 · Notas operacionais

Notas operacionais para Bitfinex

Problemas práticos que surgem ao rodar uma estratégia do Bitfinex em um runtime de nuvem em contêiner — detalhes que não estão na documentação do Bitfinex nem nos READMEs dos frameworks. Cada afirmação abaixo foi citada ou parafraseada da própria documentação do Bitfinex; as orientações de deploy vêm da experiência de rodar essas estratégias no TradingHost.

  1. 01 · Monotonicidade de nonce

    Estritamente crescente por chave, com um limite máximo rígido

    Cada requisição autenticada precisa de um nonce estritamente crescente por chave de API; o valor também tem um limite máximo rígido (nonce ceiling) de 9007199254740991. Processos simultâneos que compartilham uma chave sofrerão colisão. Solução: uma chave de API por estratégia ou contêiner em execução, isoladas via sub-accounts.

    FonteBitfinex requirements and limitations

  2. 02 · v1 vs v2

    A v2 é o caminho recomendado para o futuro

    A REST v1 ainda autentica com os cabeçalhos X-BFX-APIKEY, X-BFX-PAYLOAD e X-BFX-SIGNATURE e um payload JSON em Base64. A v2 é o caminho suportado, com endpoints mais rápidos e respostas unificadas; novos códigos devem focar na v2.

    FonteBitfinex API introduction

  3. 03 · Sub-accounts

    Uma conta master, múltiplas sub-accounts, espaço de nonce separado

    A Bitfinex suporta múltiplas sub-accounts sob uma única conta master. Cada sub-account possui suas próprias chaves de API, carteiras e espaço de nonce, que é a abordagem recomendada para isolar estratégias e evitar conflitos de nonce.

    FonteBitfinex API access

  4. 04 · Funding pool

    A margem é peer-to-peer, não financiada pela exchange

    A margem na Bitfinex é financiada por credores peer-to-peer que publicam ofertas em fUSD, fBTC, etc. Tanto as estratégias de tomada de empréstimo quanto as de concessão rodam contra o mesmo livro de ofertas; a flag No Var Rates (524288) impede a correspondência com ofertas de taxa variável.

    FonteBitfinex flag values

  5. 05 · Divisão de derivativos

    Contratos perpétuos são negociados como F0 symbols em um ambiente separado

    Os contratos perpétuos são negociados como F0 symbols (por exemplo, tBTCF0:USTF0, tETHF0:USTF0) operados pela iFinex Financial Technologies Limited. Eles exigem USDt0 em uma carteira de derivativos dedicada; use o endpoint Transfer Between Wallets para transferir fundos. A alavancagem padrão é de 10x, configurável de 1 a 100 diretamente na ordem.

    FonteBitfinex derivatives

  6. 06 · Honeycomb FIX

    O FIX 4.4 é um acesso institucional restrito

    O FIX é a interface institucional; o acesso não é self-service a partir da página padrão de API. Planeje um processo adicional de integração e credenciamento antes de depender do FIX em uma implantação na TradingHost.

    FonteBitfinex Honey Framework (FIX) reference

  7. 07 · Limites de requisição

    Limites de REST por IP e limites de conexão WebSocket

    Os limites de REST variam de aproximadamente 10 a 90 requisições por minuto por IP, dependendo do endpoint, com um tempo de espera de 60 segundos em caso de violação. Limites de WebSocket: 5 conexões autenticadas a cada 15 segundos, 20 conexões públicas por minuto e 25 inscrições de canais por conexão. Estratégias que operam em muitos mercados devem agrupar canais em vez de abrir múltiplos sockets.

    FonteBitfinex requirements and limitations

Seção 06 · Indicado para

Indicado para

Os runtimes da TradingHost para a Bitfinex são ideais para:

  • Market makers de spot que buscam um mercado de USD/USDT profundo e de longo prazo
  • Traders de margem que buscam especificamente o modelo de funding pool peer-to-peer
  • Credores de funding que executam estratégias de taxa em ofertas de fUSD, fBTC e fETH
  • Traders de perpétuos que utilizam tBTCF0:USTF0 e outros pares F0
  • Mesas institucionais que precisam de conectividade FIX 4.4 junto com HTTP e WebSocket

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 possui afiliação com a Bitfinex ou com a iFinex Financial Technologies Limited, operadora do ambiente de derivativos da Bitfinex.

Não. O código da sua estratégia se conecta à Bitfinex 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 Bitfinex é fornecido pela própria Bitfinex. Você é o responsável por sua conta na Bitfinex, permissões de API, credenciais e conformidade com os termos da Bitfinex.

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 por IA ou bots pré-configurados. Com a TradingHost, você mesmo escreve ou gera a estratégia (geralmente usando o Cursor ou o Claude Code), mantém o código no GitHub e usa a TradingHost para executá-lo em produção. Produtos como o 3Commas, o Cryptohopper e similares são donos da lógica da estratégia; a TradingHost 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 containers, envio de logs, rotação de segredos, failover de região e monitoramento de uptime. A TradingHost oferece um runtime gerenciado e desenvolvido especificamente para estratégias de trading: implantação nativa do GitHub, controle via MCP a partir de IDEs de IA, além de interfaces prontas para logs e status de saúde da aplicação. Se você prefere gerenciar a infraestrutura por conta própria, a AWS atende bem. 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 framework runtime compatível com a sua stack ou implante o seu próprio repositório.

Sim. A TradingHost suporta qualquer linguagem que possa ser executada dentro de um container.

Sim. O CCXT expõe a Bitfinex sob dois IDs: bitfinex aponta para a API v1 e bitfinex2 aponta para a v2. Use o bitfinex2 para novas estratégias; a v2 é o caminho recomendado. Note que algumas listagens de pares da Bitfinex usam USD quando o ativo subjacente é, na verdade, USDT, o que o CCXT normaliza durante a conversão. Consulte o framework runtime do CCXT para ver o guia completo de configuração.

A margem é financiada por um livro de ofertas peer-to-peer, não pela exchange. Os credores publicam ofertas de financiamento em fUSD, fBTC, etc.; os tomadores as consomem ao abrir posições de margem. O lado da concessão de empréstimos (lending) é, por si só, uma área para aplicação de estratégias, o que é incomum entre as principais exchanges.

Os contratos perpétuos são negociados em derivatives.bitfinex.com sob F0 symbols (por exemplo, tBTCF0:USTF0). Eles exigem USDt0 em uma carteira de derivativos dedicada, operada pela iFinex Financial Technologies Limited. Transfira fundos por meio do endpoint Transfer Between Wallets. A alavancagem é configurável por ordem, com padrão de 10x, podendo chegar a até 100x.

Não. A Bitfinex não atende clientes domiciliados nos EUA. Se você estiver nos EUA, utilize a Coinbase ou a Kraken. A TradingHost executa o seu runtime independentemente da região, mas a própria exchange precisa aceitar a sua conta.

Sim, caso o seu projeto seja estruturado dessa forma. Você pode executar múltiplos processos ou serviços de estratégia dentro de um único runtime, ou separá-los em diferentes runtimes para obter isolamento e clareza operacional. Cada estratégia em execução deve ter sua própria chave de API (idealmente sob uma sub-account) para evitar colisões na monotonicidade estrita de nonce por chave. Consulte a página de runtime da TradingHost para entender o modelo multiestratégia.

O caminho mais rápido é fazer um fork de um framework runtime 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 secrets controlado pelo GitHub. A TradingHost lê essas chaves em tempo de execução por meio de secrets do repositório do GitHub, secrets de ambiente ou pelo 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 segredo. Consulte a seção de secrets da plataforma para ver o modelo completo de tratamento.

Não. As estratégias nunca devem precisar de permissões de saque. Use permissões com escopo limitado (informações da conta, ordens, margem, funding) e ative apenas as áreas que sua estratégia realmente acessa.

Sim. O 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 deploys, revisar logs, reiniciar estratégias e gerenciar fluxos de trabalho do runtime. O MCP é uma interface de controle e observabilidade, não o caminho de execução de ordens. Veja a interface de controle MCP para mais detalhes.

Ambos. A interface de controle 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 deploy nativo do GitHub também funciona sem qualquer ferramenta de IA: um simples git push para a sua branch principal dispara um novo deploy.

O runtime detecta o crash e expõe os logs e informações de integridade (health) 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 ainda é responsável pelo tratamento seguro de erros, proteção contra ordens duplicadas e controles de risco. Veja a seção de observabilidade para acessar a interface de logs e integridade.

A Bitfinex exige um nonce estritamente crescente por chave de API, limitado a 9007199254740991. Dois processos compartilhando a mesma chave colidirão e um deles será rejeitado. Corrija isso atribuindo a cada estratégia em execução sua própria chave de API, idealmente em sua própria sub-account. Veja a seção de Notas operacionais acima para obter a orientação completa.

O TradingHost opera nas regiões EU e US-East. Escolha a região mais próxima do matching engine utilizado pela sua estratégia. Acesse a página de regiões para conferir os detalhes de roteamento e proximidade.

Não. O TradingHost é focado em runtime de produção e deploy. O backtesting deve ser feito em sua stack de pesquisa, framework ou AlgoBuilder.