Runtime nativo de IA para estratégias de trading na Ripio
Desenvolva no Cursor, Claude Code ou em qualquer IDE de IA. Faça o deploy a partir do GitHub em um runtime gerenciado na nuvem com controle MCP de primeira classe, logs e seleção de região.
Seção 01 · Visão rápida
Visão rápida
- Plataforma
- Ripio
- Tipo de plataforma
- Exchange de cripto (América Latina, 8 jurisdições)
- Classe de ativos
- Cripto com cotação multi-fiat da América Latina (BRL, ARS, MXN, EUR, USD)
- Produtos suportados
- Trading spot em pares filtrados por país (BTC_BRL, ETH_BRL, BTC_ARS, BTC_MXN, BTC_EUR e outros), stablecoins locais (wARS, wBRL, wMXN), Ripio Trade API v4
- Modelo de runtime
- Runtime de estratégia em container
- Origem do deploy
- GitHub
- Linguagens
- Qualquer linguagem compatível com containers
- Integrações comuns
- Conexão nativa via REST e WebSocket com a Ripio Trade API v4, CCXT, conectores personalizados
- 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 via MCP
- Papel de Ripio
- Conta na exchange, acesso à API, acesso ao mercado, ambiente de execução
- Afiliação
- O TradingHost é independente e não possui afiliação com a Ripio
Seção 02 · O que Ripio oferece
O que Ripio oferece
A Ripio oferece trading spot em 8 jurisdições da América Latina com pares cotados em múltiplas moedas fiduciárias (BRL, ARS, MXN, EUR, USD) e stablecoins locais (wARS, wBRL, wMXN). As estratégias se autenticam na Ripio Trade API v4 e operam sob limites de requisições (rate limits) baseados no nível de KYC. A disponibilidade de pares filtrados por país através do parâmetro de consulta `countries` permite que uma única estratégia seja implantada para diferentes conjuntos de produtos regionais. Os detalhes dos endpoints mudam com o tempo. A estrutura geral é estável; os pesos exatos de rate limit, as listas de pares e os tamanhos mínimos estão disponíveis na documentação oficial da Ripio.
Mercados e padrões de estratégia
- Estratégias spot com cotação em BRL (BTC_BRL, ETH_BRL, USDC_BRL)
- Estratégias spot com cotação em ARS para pares em peso argentino
- Estratégias spot com cotação em MXN para pares em peso mexicano
- Trading de stablecoins locais (wARS, wBRL, wMXN)
- Estratégias de arbitragem entre moedas fiduciárias da América Latina
- Descoberta de pares filtrados por país via parâmetro de consulta `countries`
- Inscrições em tópicos sensíveis de WebSocket autenticadas por ticket
- Planejamento de uso de rate limit baseado no nível de KYC por conta
Superfície da API
- Superfícies de produtos
- Trading spot em pares filtrados por país na Argentina, Brasil, México, Espanha, Uruguay, Colômbia, Chile e EUA. Os códigos dos pares usam a notação com sublinhado (BTC_BRL, ETH_BRL, BTC_ARS, BTC_MXN). Stablecoins locais (wARS, wBRL, wMXN) permitem operações diretas com moedas digitais. Os valores de min_amount, min_value e price_tick devem ser consultados individualmente para cada par.
- Métodos de conexão
- REST para envio de ordens, consultas de conta e descoberta de pares. Streams de WebSocket para dados de mercado em tempo real. O acesso a tópicos sensíveis de WebSocket exige um ticket obtido via POST `/v4/ticket` antes da inscrição, e não apenas a chave de API.
- Autenticação
- Limites de requisições da API baseados no nível de KYC. Contas não verificadas: 1 requisição por segundo (~86.400 diárias). Contas verificadas: 3,5 requisições por segundo (~302.400 diárias). Exceder o limite do nível retorna HTTP 429 com o cabeçalho padrão retry-after.
Para detalhes específicos, consulte Ripio
Endpoints específicos, pesos de rate limit, listas de pares, faixas de taxas e histórico de versões estão disponíveis na documentação da Ripio. Utilize-os como a fonte oficial de informações.
Seção 03 · Desenvolva com IA
Desenvolva sua estratégia para Ripio 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 Ripio
Controle direto sobre comportamentos específicos da Ripio, incluindo a descoberta de pares filtrados por país e o roteamento de ordens em moedas fiduciárias da América Latina.
CCXT
Interface comum entre a Ripio e outras exchanges de cripto. O CCXT expõe a Ripio Trade por meio da classe unificada `ripio` para trading spot.
Freqtrade ou Hummingbot
Nenhum dos frameworks lista a Ripio como uma exchange com suporte nativo atualmente. O melhor caminho é usar implementações personalizadas ou baseadas em CCXT.
Conector personalizado
Seu próprio motor de trading interno ou integração proprietária com a Ripio Trade API v4 usando as interfaces REST e WebSocket.
Suporte de frameworks para produtos Ripio
A cobertura varia de acordo com o framework. A Ripio opera apenas no mercado spot (sem contratos perpétuos ou opções nativas no Trade), por isso a matriz é simplificada por design. O CCXT expõe o mercado spot da Ripio Trade por meio de sua classe unificada `ripio`. Nem o Freqtrade nem o Hummingbot listam a Ripio como uma exchange com suporte nativo atualmente; o acesso direto à API nativa alcança todos os recursos publicados pela Ripio Trade v4.
✓ suporte confirmado de acordo com a documentação oficial do framework. "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 Ripio fornece a exchange e o acesso à API. A TradingHost fornece o ambiente de produção onde sua estratégia conectada à Ripio é 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 à Ripio.
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 o TradingHost para o repositório existente da sua estratégia ou faça um fork de um runtime de framework do TradingHost (CCXT) para obter uma base funcional integrada à Ripio Trade API v4.
- PASSO 03
Implante em um contêiner da TradingHost
Escolha uma região (EU ou US-East), informe as variáveis de ambiente necessárias para a sua estratégia (chave de API do Ripio Trade, código do país, configurações de ticket do WebSocket) 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. 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 Ripio
Detalhes importantes ao executar uma estratégia para a Ripio em um runtime em nuvem baseado em containers, que não constam na documentação da Ripio nem nos arquivos README dos frameworks. Cada ponto abaixo foi citado ou parafraseado da própria documentação da Ripio; as orientações de implantação são baseadas na execução dessas estratégias no TradingHost.
01 · Limites de requisições baseados em KYC
Contas não verificadas recebem 1 rps; contas verificadas recebem 3,5 rps
Os limites de requisições da Ripio Trade API v4 são definidos pelo nível de KYC, e não pela família de endpoints. Contas não verificadas são limitadas a 1 requisição por segundo (cerca de 86.400 diárias). Contas verificadas passam para 3,5 requisições por segundo (cerca de 302.400 diárias). Exceder o limite do nível retorna HTTP 429. Uma estratégia que começa em modo não verificado e é promovida para verificada posteriormente pode quadruplicar sua frequência segura de consultas; por outro lado, uma estratégia desenvolvida para o nível verificado que rode em uma conta não verificada sofrerá erros 429 desde o primeiro dia. Defina o nível de KYC como uma configuração de runtime para que o limite de requisições fique explícito.
02 · Pares filtrados por país
O parâmetro de consulta `countries` é a fonte oficial para os pares negociáveis
A Ripio opera em 8 jurisdições (AR, BR, MX, ES, UY, CO, CL, US) com níveis de conformidade específicos para cada país, e a disponibilidade de pares é filtrada pelo parâmetro de consulta `countries`, em vez de uma lista global única de símbolos. Um par negociado no Brasil pode não estar disponível na Argentina, e vice-versa. Estratégias que definem uma lista fixa de símbolos baseada no mercado brasileiro falharão silenciosamente se executadas em uma conta argentina. Identifique os pares na inicialização usando o endpoint filtrado por país, em vez de fixá-los no código.
03 · Códigos de pares usam underscore
BTC_BRL e ETH_BRL, não BTCBRL
Os códigos de pares da Ripio usam a notação com underscore: BTC_BRL, ETH_BRL, BTC_ARS, BTC_MXN, BTC_EUR. Essa convenção difere da Binance e da maioria das exchanges globais, onde os pares são concatenados (BTCBRL). O CCXT normaliza o símbolo para BTC/BRL em sua interface unificada, mas qualquer requisição direta à API nativa deve usar o formato com underscore. Códigos de estratégia portados de outras plataformas costumam falhar silenciosamente com erro de par não encontrado até que o formato seja corrigido.
04 · Mínimos por par
`min_amount`, `min_value` e `price_tick` são específicos de cada par e devem ser consultados
Os valores mínimos e variações de preço (price ticks) são específicos para cada par fiduciário. Pares em BRL, ARS e MXN têm seus próprios valores de `min_amount`, `min_value` e `price_tick`, que devem ser consultados por par antes do envio de ordens. Uma estratégia que utilize um valor mínimo fixo para pares em BRL e ARS poderá abrir posições com tamanhos incorretos (maiores ou menores do que o esperado), dependendo do país ativo. Faça o cache desses campos por par na inicialização e revalide-os antes de cada ordem, em vez de assumir um mínimo global.
05 · Autenticação de ticket via WebSocket
Tópicos confidenciais de WebSocket exigem um ticket obtido via POST `/v4/ticket`
Tópicos públicos de WebSocket (dados de mercado, livro de ofertas) são abertos. Tópicos confidenciais (estado da conta, eventos de ordens) exigem um ticket obtido via POST `/v4/ticket` antes da inscrição, e não apenas uma chave de API. O ticket tem um tempo de vida útil (TTL) curto e deve ser atualizado periodicamente em estratégias de longa execução. Containers que perderem a conexão WebSocket e se reconectarem precisarão solicitar um novo ticket a cada tentativa; reutilizar um ticket expirado fará com que a inscrição falhe silenciosamente, interrompendo o recebimento de callbacks de estado de ordens.
06 · Stablecoins locais
wARS, wBRL e wMXN permitem operações diretas com moedas digitais
A Ripio emite as stablecoins locais wARS, wBRL e wMXN, que permitem operações diretas com moedas digitais nos mercados de BRL, ARS e MXN. Elas diferem de USDT/USDC e podem apresentar características distintas de liquidez, liquidação e taxas. Estratégias desenvolvidas com base em premissas do USDT não se aplicam automaticamente ao wARS ou wBRL. Valide a profundidade do livro e o spread nos pares de stablecoins locais separadamente antes de definir o tamanho da exposição real.
Seção 06 · Indicado para
Indicado para
Os runtimes da TradingHost para a Ripio são ideais para:
- Desenvolvedores que criam estratégias em IDEs de IA (Cursor, Claude Code)
- Traders sistemáticos de cripto
- Desenvolvedores quant
- Usuários do CCXT
- Equipes migrando de hospedagem VPS para implantação em containers
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 qualquer afiliação com a Ripio.
Não. O código da sua estratégia se conecta à Ripio 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 ambiente de execução (runtime) onde esse código roda.
Não. O acesso à API é fornecido pela própria Ripio. Você é o responsável por sua conta na Ripio, permissões de API, credenciais e conformidade com os termos de uso da Ripio.
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 prontos. Com a TradingHost, você escreve ou gera a estratégia por conta própria (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 e o Cryptohopper controlam a lógica da estratégia; a TradingHost apenas executa a sua estratégia.
A AWS e a DigitalOcean oferecem computação bruta. Você precisa gerenciar atualizações de sistema operacional, orquestração de containers, envio de logs, rotação de segredos, failover de região e monitoramento de uptime por conta própria. A TradingHost oferece um runtime gerenciado e desenvolvido especificamente para estratégias de trading: implantação nativa via GitHub, controle baseado em MCP a partir de IDEs de IA, além de interfaces prontas para logs e monitoramento de integridade. Se você prefere operar a infraestrutura por conta própria, a AWS atende bem. Se deseja o runtime como um serviço gerenciado, a TradingHost é o caminho mais curto.
Sim. A TradingHost executa estratégias em Python; basta escolher o runtime de framework compatível com a sua stack ou implantar seu próprio repositório.
Sim. A TradingHost suporta qualquer linguagem que possa ser executada dentro de um container.
Sim. O CCXT disponibiliza uma classe unificada `ripio` que abrange o trading spot em pares da Ripio Trade. Adicione sua estratégia CCXT a um container, aponte para o GitHub e a TradingHost a executará como qualquer outro projeto Python ou Node. Consulte a página do runtime do framework CCXT para ver o processo completo de configuração.
Sim. Os pares fiduciários da Ripio na América Latina (BTC_BRL, ETH_BRL, BTC_ARS, BTC_MXN, BTC_EUR, entre outros) são acessados por meio das mesmas APIs REST e WebSocket dos pares globais. O código da estratégia dentro do seu container se autentica com a sua chave de API da Ripio Trade, e a TradingHost é agnóstica em relação à exchange no nível do runtime. Lembre-se de que a disponibilidade de pares é filtrada por país por meio do parâmetro de consulta `countries`, portanto, identifique os pares na inicialização em vez de defini-los de forma fixa no código.
Sim, caso 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 maior 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 para um projeto pronto para implantação. Ou conecte seu próprio repositório de estratégias 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ê essas chaves em tempo de execução por meio de segredos de repositório do GitHub, segredos de ambiente ou pelo seu próprio processo homologado de gerenciamento de segredos. A TradingHost não precisa da custódia de sua chave de API e segredo. Consulte a seção de segredos da plataforma para entender o modelo completo de tratamento.
Não. As estratégias nunca devem precisar de permissões de saque. Limite o escopo da sua chave de API apenas para operações de trading e leitura de estado da conta, mantendo a função de saque totalmente desativada para essa chave.
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, analisar 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 das operações. Consulte a seção sobre a interface de controle MCP para obter detalhes.
Ambos. A interface de controle MCP funciona perfeitamente tanto a partir de agentes baseados em CLI (Claude Code CLI, clientes MCP personalizados, chamadas de script MCP) quanto de dentro de uma IDE. O ciclo 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 a falha 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 conhecer a interface de logs e integridade.
Os limites de taxa da Ripio Trade API v4 são divididos em níveis com base no status de KYC. Contas não verificadas têm direito a 1 requisição por segundo; contas verificadas têm 3,5 requisições por segundo. Exceder o limite do nível retorna HTTP 429. A solução é ajustar a cadência de requisições ao nível em que sua conta se encontra, tratar o nível como uma configuração de runtime (e não como uma constante) e aplicar backoff com jitter exponencial ao receber um erro 429. Consulte a seção de Notas operacionais acima para ver o guia completo.
O TradingHost opera nas regiões EU e US-East. Escolha a região mais próxima do mecanismo de matching do qual sua estratégia depende. Consulte a página de regiões para obter detalhes de roteamento e proximidade.
Não. A TradingHost é focada em runtime de produção e deployment. O backtesting deve ser feito em sua stack de pesquisa, framework ou no AlgoBuilder.