Tempo de leitura: … min

Runtime nativo de IA para estratégias de trading na OANDA

Desenvolva estratégias OANDA v20 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.

Pela equipe de engenharia da TradingHost

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

Visão rápida

Corretora
OANDA
Tipo de corretora
Corretora de Forex e CFD
Classe de ativos
Forex, índices, commodities, metais, títulos
Produtos compatíveis
Mais de 70 pares de moedas spot FX, CFDs de principais índices, ouro e prata (XAU/USD, XAG/USD), energias (WTI, Brent), CFDs de títulos
Modelo de runtime
Runtime de estratégia em container
Origem do deploy
GitHub
Linguagens
Qualquer linguagem executável em container
Integrações comuns
OANDA v20 REST e streaming, FIX 4.4, NautilusTrader, Backtrader, SDKs nativos em Python e Java, conectores personalizados
Integração com fluxos 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, controle MCP
Papel da OANDA
Conta na corretora, acesso à API, acesso ao mercado, ambiente de execução
Reguladores
OANDA Corporation (CFTC RFED, NFA ID 0325821, EUA), OANDA Australia Pty Limited (ASIC AFSL 412981), OANDA Europe Markets Ltd (CySEC, Malta), OANDA Global Markets Ltd (BVI FSC), OANDA (Canada) Corp (CIRO)
Limites de alavancagem para varejo
EUA (OANDA Corporation, NFA Rule 2-43b): 50:1 em FX principal, 20:1 em FX secundário. Austrália (ASIC) e Europa (CySEC, alinhada à ESMA): 30:1 em FX principal, 20:1 em FX secundário e ouro, 10:1 em commodities exceto ouro e índices secundários, 5:1 em ações, 2:1 em CFDs de cripto. A entidade offshore (BVI FSC) pode permitir alavancagem maior conforme a entidade de cadastro correspondente.
Afiliação
A TradingHost é independente e não é afiliada à OANDA Corporation ou a qualquer entidade do OANDA Group

Seção 02 · O que OANDA oferece

O que OANDA oferece

A OANDA oferece forex spot em mais de 70 pares de moedas, CFDs de índices e commodities, metais preciosos e CFDs de títulos por meio da API REST v20, streaming v20 via HTTP long-poll e uma sessão FIX 4.4. As estratégias se autenticam com um token bearer por conta. Os ambientes de simulação (fxPractice) e real (fxTrade) são separados, com hosts e tokens distintos. Os detalhes dos endpoints constam na documentação da OANDA e mudam com o tempo.

Mercados e padrões de estratégia

  • Estratégias REST OANDA v20 em mais de 70 pares de moedas FX
  • Estratégias de carry trade em EUR/USD e USD/JPY
  • Rompimento de CFDs de principais índices (SPX500, US30, NAS100, UK100)
  • Estratégias de metais preciosos em XAU/USD e XAG/USD
  • Estratégias de CFDs de petróleo WTI e Brent
  • Estratégias de momentum baseadas em streaming de preços (HTTP long-poll)
  • Deploys validados no fxPractice e promovidos para o fxTrade
  • Estratégias de varejo nos EUA em conformidade com o FIFO da NFA Rule 2-43b

Superfície da API

Superfícies de produtos
Mais de 70 pares de moedas spot FX (principais, secundárias, exóticas), CFDs de principais índices (SPX500, US30, NAS100, UK100, GER40, JP225), metais preciosos (XAU/USD, XAG/USD), energias (WTI, Brent) e CFDs de títulos. O ambiente fxPractice espelha a mesma gama de produtos em um host de simulação para que as estratégias possam ser validadas nos mesmos endpoints v20 sem capital real.
Métodos de conexão
OANDA v20 REST para envio de ordens, contas, operações e posições. Streaming v20 para preços e transações via HTTP chunked long-poll (uma única conexão TCP aberta em vez de WebSocket). FIX 4.4 para fluxos institucionais e de varejo profissional. SDKs nativos em Python e Java encapsulam o REST e o streaming v20.
Autenticação
Token Bearer: cabeçalho HTTP "Authorization: Bearer <token>" em cada requisição autenticada. Um token por conta OANDA, gerado em Manage API Access no portal do usuário. Os tokens de simulação (fxPractice) e real (fxTrade) são restritos aos seus respectivos ambientes e não são intercambiáveis.

Para detalhes específicos, consulte OANDA

Endpoints específicos, limites de taxa (rate limits), listas de pares de moedas, identificadores de instrumentos e histórico de versões estão disponíveis na documentação da OANDA. Considere-os como a fonte oficial de informação.

Seção 03 · Desenvolva com IA

Desenvolva sua estratégia para OANDA 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 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.

  • API nativa OANDA v20

    Controle direto sobre o comportamento específico da OANDA, estado da conta, streaming de preços e execução de ordens.

  • NautilusTrader

    Framework em Python de alta performance com um adaptador OANDA documentado e modelo de ator orientado a eventos.

    Começar com o NautilusTrader

  • Backtrader

    Framework estável em Python cuja classe de corretora `OandaV20Store` torna a OANDA v20 um ambiente de execução de primeira classe.

    Começar com o Backtrader

  • FIX 4.4 ou conector personalizado

    Sessão OANDA FIX 4.4 ou sua própria integração em Python ou Java sobre o REST e streaming v20.

Suporte de frameworks para produtos OANDA

A cobertura acompanha o conjunto de produtos da OANDA. As entidades de varejo da OANDA não oferecem CFDs de ações ou CFDs de cripto, por isso essas colunas estão marcadas honestamente como "não" em vez de serem deixadas em branco.

FrameworkFXÍndicesCommoditiesCFDCFDs de cripto
Native OANDA v20CompatívelCompatívelCompatívelNão documentado como compatívelNão documentado como compatível
NautilusTraderCompatívelCompatívelCompatívelNão documentado como compatívelNão documentado como compatível
BacktraderCompatívelCompatívelCompatívelNão documentado como compatívelNão documentado como compatível
FIX 4.4CompatívelCompatívelCompatívelNão documentado como compatívelNão documentado como compatível

✓ suporte confirmado de acordo com os documentos oficiais do framework e o conjunto de produtos da OANDA. "não" indica que a OANDA não oferece essa classe de produto, não sendo uma limitação do framework. Os links de fluxo de trabalho apontam para páginas de /workflows/ atualmente em desenvolvimento.

O TradingHost não impõe um framework. Ele executa o seu projeto.

Desenvolva com IA

Os templates de framework acima funcionam perfeitamente com AI IDEs. A interface de controle MCP do TradingHost fecha o ciclo: as ferramentas de IA podem inspecionar implantações, analisar logs e gerenciar o ambiente de execução junto com você, sem nunca interferir no caminho de execução das ordens.

Seção 04 · Execute no TradingHost

Execute seu código no TradingHost

A OANDA fornece a conta da corretora e o acesso à API. O TradingHost fornece o ambiente de produção onde sua estratégia conectada à OANDA é executada.

Em vez de rodar o código da estratégia em um notebook, computador desktop, VPS genérico ou servidor configurado manualmente, você faz a implantação a partir do GitHub em um ambiente de execução de containers gerenciado pelo TradingHost.

Você

  • Seu repositório contém seu código.
  • Sua implantação define como ele é executado.
  • Sua estratégia se conecta à OANDA.

TradingHost

  • Mantém o ambiente de execução online.
  • Disponibiliza logs e verificações de integridade.
  • Seleção de região.
  • Interface de implantação controlada.

Fluxo de implantação

  1. PASSO 01

    Conectar ao GitHub

    Autorize o TradingHost a acessar sua conta do GitHub.

  2. PASSO 02

    Vincule um repositório ou comece com um framework

    Aponte a TradingHost para o repositório existente da sua estratégia ou faça um fork de um runtime de framework da TradingHost (NautilusTrader ou Backtrader para OANDA, ou o starter OANDA v20) para ter uma base funcional.

  3. PASSO 03

    Implante em um container do TradingHost

    Escolha uma região (EU para entidades europeias da OANDA, US-East para a OANDA Corporation nos EUA), insira as variáveis de ambiente que sua estratégia precisa (token bearer v20, ID da conta, host fxPractice ou fxTrade) 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 requer instalação local do Docker.

  4. PASSO 04

    Monitore logs e integridade

    Acompanhe logs em tempo real, a integridade e o estado do ambiente de execução diretamente no painel do TradingHost. Essa mesma interface pode ser acessada via MCP a partir de qualquer AI IDE, permitindo que o Cursor, o Claude Code ou um agente de CLI leiam o estado da implantação e gerenciem o ambiente de execução junto com você.

  5. PASSO 05

    Atualize e reimplante

    Envie as alterações para a branch principal do seu GitHub (main) e o TradingHost fará a nova implantação de forma automática.

Deploy

Seção 05 · Notas operacionais

Notas operacionais para a OANDA

Problemas reais que surgem ao executar uma estratégia OANDA em um runtime de nuvem em container — longe das páginas de marketing da OANDA e dos READMEs de frameworks. Cada afirmação abaixo foi parafraseada da própria documentação da OANDA ou do livro de regras do regulador correspondente; as orientações de deploy vêm da experiência de rodar essas estratégias na TradingHost.

  1. 01 · Divisão de hosts

    fxTrade (real) e fxPractice (demo) são hosts distintos com tokens separados

    O host REST de produção (live) é api-fxtrade.oanda.com, e o host REST de simulação (practice) é api-fxpractice.oanda.com. Os tokens são gerados em Manage API Access no ambiente correspondente e não são intercambiáveis: um token do fxTrade não funcionará no fxPractice e vice-versa. Os IDs das contas também diferem entre os ambientes (IDs do fxPractice geralmente começam com o prefixo `101-`). Mantenha os tokens de demonstração e produção em entradas separadas de Secrets do TradingHost; nunca reutilize um token entre ambientes e evite codificar a string do host diretamente no código que é implantado entre os ambientes.

    FonteOANDA v20 development guide

  2. 02 · Autenticação

    Token Bearer no cabeçalho Authorization, um token por conta OANDA

    Toda requisição autenticada para a v20 contém `Authorization: Bearer <token>`. O token é gerado no portal do usuário da OANDA em Manage API Access e é associado ao usuário para o qual foi criado; a seleção da conta ocorre pelo caminho da URL (`/v3/accounts/<accountID>/...`), e não por um cabeçalho separado. Rotacione o token se ele vazar e armazene-o no GitHub Secrets do seu repositório, nunca no código commitado ou em arquivos de ambiente.

    FonteOANDA v20 authentication

  3. 03 · Streaming

    Streaming de preços e transações via HTTP chunked (long-poll), e não WebSocket

    Os endpoints de streaming da OANDA (`/v3/accounts/<accountID>/pricing/stream`, `/v3/accounts/<accountID>/transactions/stream`) mantêm uma única conexão TCP aberta e emitem blocos (chunks) JSON separados por quebras de linha. Não há uma camada de frames WebSocket. A lógica de reconexão do container deve tratar quedas de conexão, blocos parciais e timeouts de inatividade de forma explícita. O stream emite um objeto heartbeat periódico para que o cliente detecte conexões inativas; aja com base na ausência de heartbeats em vez de esperar pelo timeout do sistema operacional.

    FonteOANDA v20 pricing endpoint (streaming)

  4. 04 · NFA Rule 2-43b

    OANDA Corporation (US) exige execução de ordens FIFO e proíbe hedge por instrumento

    Sob a NFA Rule 2-43b, os clientes de varejo da OANDA Corporation nos EUA não podem manter posições de compra (long) e venda (short) simultâneas no mesmo instrumento e devem fechar posições opostas na ordem em que foram abertas (first-in, first-out). Uma estratégia que envia uma ordem de hedge no mesmo par fará com que a ordem seja compensada (netting) contra a posição existente, em vez de abrir uma posição separada. Essa regra não se aplica às entidades não americanas da OANDA (Austrália, Europa, BVI). Para estratégias executadas em diferentes entidades, o mesmo código pode gerar atribuições de P&L distintas entre contas dos EUA e de fora dos EUA.

    FonteNFA Compliance Rule 2-43b

  5. 05 · Limites de requisição

    Limites de requisição por token; respeite o cabeçalho retry-after em erros 429

    A OANDA impõe limites de taxa de requisição por token na v20. Limites excedidos retornam HTTP 429 com um corpo indicando limitação (throttling). Containers sob condições de mercado voláteis (abertura de sessão, divulgação de notícias) podem estourar o limite se cada iteração do loop chamar endpoints de conta ou de preço. Prefira o endpoint de streaming de preços ao polling, agrupe requisições relacionadas e use backoff exponencial ao receber 429. Os limites específicos de requisições por segundo estão na documentação da OANDA e mudam com o tempo; trate a documentação como a fonte oficial.

    FonteOANDA v20 best practices

  6. 06 · ID da conta

    O ID da conta é vinculado ao caminho (path) na maioria dos endpoints v20

    Operações, posições, transações, preços e a maioria dos endpoints de conta usam o formato `/v3/accounts/<accountID>/<resource>`. O token bearer autentica o usuário; o caminho seleciona a conta. Um usuário com uma subconta e uma conta principal possui dois accountIDs distintos, e a estratégia deve selecionar o correto. O endpoint `/v3/accounts` lista todos os accountIDs que o token pode acessar, e `/v3/accounts/<accountID>/summary` confirma a moeda, a entidade de alavancagem e o saldo antes que a estratégia comece a enviar ordens.

    FonteOANDA v20 account endpoint

  7. 07 · Relatórios de operações

    O envio de relatórios EMIR, MiFID II e Dodd-Frank é de responsabilidade da OANDA, não do TradingHost

    A OANDA Europe Markets Ltd reporta sob as regras da EMIR e MiFID II. A OANDA Corporation reporta sob as regras de relatório de dados de swap do Dodd-Frank Title VII como uma CFTC RFED. A OANDA Australia reporta sob as regras de relatório de operações de derivativos da ASIC. O TradingHost não realiza relatórios regulatórios de operações em seu nome e não é um serviço de relatórios. O código da estratégia que você executa no TradingHost é de sua inteira responsabilidade algorítmica; a obrigação de relatórios recai sobre a corretora registrada, que é a entidade da OANDA que mantém a conta.

    FonteOANDA Europe regulatory information

Seção 06 · Desenvolvido para

Desenvolvido para

Os runtimes do TradingHost para OANDA são mais adequados para:

  • Desenvolvedores criando estratégias em IDEs de IA (Cursor, Claude Code)
  • Desenvolvedores de estratégias quantitativas de FX
  • Traders de carry trade e momentum de índices
  • Usuários do NautilusTrader e Backtrader
  • Equipes migrando do MetaTrader e hospedagem VPS para implantação em containers

Conectar o GitHub e criar sua primeira estratégia é grátis.

Seção 08 · FAQ

Perguntas frequentes

Não. O TradingHost é independente e não é afiliado à OANDA Corporation ou a qualquer entidade do OANDA Group.

Não. O TradingHost não é uma corretora e não é uma empresa de investimento registrada. O TradingHost é um ambiente de execução em nuvem (runtime) que roda o código da sua estratégia. O relacionamento com a corretora, a conta, a alavancagem, a execução e as proteções regulatórias pertencem à OANDA. Você se cadastra diretamente na entidade da OANDA correspondente à sua jurisdição.

Não. O código da sua estratégia se conecta à OANDA e envia instruções de acordo com sua própria lógica, permissões de conta e método de integração. O TradingHost fornece apenas o ambiente de execução onde esse código roda.

Não. O acesso à API v20 da OANDA é fornecido pela própria OANDA. Você é responsável por sua conta OANDA, permissões de acesso à API, rotação de tokens bearer e conformidade com os termos da OANDA.

Sim. O TradingHost executa estratégias em Python; escolha um framework de runtime que corresponda à sua stack (NautilusTrader, Backtrader ou o starter da OANDA v20) ou faça o deploy do seu próprio repositório. O SDK nativo v20-python da OANDA é suportado.

Sim. O TradingHost suporta qualquer linguagem que possa ser executada dentro de um container. Como os endpoints REST e de streaming da v20 da OANDA usam HTTP, qualquer linguagem com um cliente HTTP pode chamá-los.

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 diferentes runtimes para isolamento e clareza operacional. Consulte a página de runtime do TradingHost para entender o modelo de multiestratégia.

O TradingHost executa cargas de trabalho em nuvem containerizadas, não terminais desktop do MetaTrader 4 ou MetaTrader 5. Se a sua estratégia da OANDA for um Expert Advisor (EA) de MT4 ou MT5 compilado em MQL, esse EA roda dentro do terminal MetaTrader e tradicionalmente exige um VPS Windows para permanecer online. Para usar o TradingHost, porte a lógica para um cliente REST v20 ou streaming v20; esse formato é compatível com o TradingHost.

O caminho mais rápido é fazer um fork de um framework de runtime do TradingHost: tanto o NautilusTrader quanto o Backtrader possuem suporte nativo de alto nível para a OANDA. 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.

Sim. A alavancagem é definida pela entidade da OANDA que mantém a sua conta, não pelo TradingHost. A OANDA Corporation (US) limita a alavancagem de varejo em 50:1 para os principais pares de FX (majors) e 20:1 para pares secundários (minors) conforme a NFA Rule 2-43b. A OANDA Australia (ASIC) e a OANDA Europe Markets (CySEC) limitam os principais pares de FX em 30:1, pares secundários e ouro em 20:1, com limites menores para outros instrumentos. A OANDA Global Markets (BVI) permite alavancagens maiores conforme as regras da BVI FSC. Os limites de alavancagem seguem o órgão regulador da entidade onde sua conta está registrada; a interface da API é a mesma.

No seu fluxo de trabalho de secrets controlado pelo GitHub. O TradingHost lê o token 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 secrets. O TradingHost não precisa da custódia do seu token.

Não. Os tokens v20 da OANDA concedem acesso a operações, estado da conta e preços, não a saques ou depósitos. Depósitos e saques ocorrem pelo portal do usuário da OANDA, não pela API. Mantenha operações que exijam permissão de saque totalmente fora da interface da v20.

Sim. O TradingHost oferece suporte a 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 do runtime. O MCP é uma interface de controle e observabilidade, não o caminho de execução de ordens.

Não. O reporte de operações sob a EMIR e MiFID II é de responsabilidade da corretora. A OANDA Europe Markets Ltd reporta sob a EMIR e MiFID II como a empresa de investimento regulamentada. A OANDA Corporation reporta sob as regras de reporte de dados de swap da Dodd-Frank Title VII como uma CFTC RFED. A OANDA Australia reporta sob as regras de reporte de transações de derivativos da ASIC. O TradingHost executa seu código; a corretora registrada lida com o reporte regulatório.

O TradingHost opera nas regiões EU e US-East. A região EU é a escolha ideal para o tráfego da OANDA Europe Markets e OANDA Australia; a US-East é ideal para o tráfego da OANDA Corporation (US).

Não. O TradingHost é focado em runtime de produção e implantação. O backtesting faz parte da sua stack de pesquisa, framework (o backtester do NautilusTrader, o motor do Backtrader, vectorbt) ou do AlgoBuilder.