Aviso de Risco: A negociação de produtos CFD envolve um alto nível de risco e pode não ser adequada para todos os investidores.

XBTFX Trading API

Compatível com contas MetaTrader 5® da XBTFX

Opere de forma programática, gira posições, monitorize o estado da conta e transmita dados de mercado em tempo real em contas XBTFX MetaTrader 5® compatíveis através de REST e WebSocket. Construa estratégias automatizadas, conecte agentes IA e integre a sua conta em fluxos personalizados. Comece com a documentação, exemplos, AI skills ou o servidor XBTFX MCP. Pensado para developers e utilizadores com experiência em programação ou assistentes IA de código.

Contas Edge e ECN
Acesso programático completo
Modos hedging e netting
Pronto para agentes IA (MCP)
Criar conta API Console Documentação
terminal
# Send a trade to your XBTFX account curl -X POST https://interface.xbtfx.com/v1/trade \ -H "Authorization: Bearer xbtfx_live_..." \ -H "Content-Type: application/json" \ -d '{ "symbol": "EURUSD", "side": "buy", "volume": 0.10, "sl": 1.08200, "tp": 1.09000 }' # Response { "ticket": 184729, "status": "filled", "price": 1.08650, "retcode": 10009 }
Protocolo icon
REST
Protocolo
Streaming icon
WebSocket
Streaming
Weight / min icon
600
Weight / min
Formato de resposta icon
JSON
Formato de resposta

Automatize o seu trading com a XBTFX API

A XBTFX Trading API permite-lhe enviar instruções para a sua conta XBTFX MetaTrader 5® compatível. Abra posições, modifique stops, consulte saldos e transmita cotações ao vivo através de chamadas REST e WebSocket padrão.

Estratégias automatizadas
Construa bots de trading e estratégias algorítmicas que enviem ordens automaticamente para a sua conta. Execute lógica baseada em sinais, reequilíbrio de carteira ou gestão de risco personalizada.
Integração de agentes IA
Conecte assistentes IA à sua conta através do XBTFX Skills Hub ou do servidor MCP. Dê ordens de trading em linguagem natural via Claude Code, Cursor, Windsurf ou outros clientes compatíveis.
Integrações personalizadas
Construa dashboards, ligue-se a fontes externas, encaminhe sinais de outras plataformas ou integre dados da conta nos seus próprios sistemas de reporting e analytics.

Endpoints da API para trading, posições e dados de mercado

Abra e feche posições, defina stop loss e take profit, consulte saldos, recupere o histórico de operações e transmita cotações forex e cripto ao vivo via WebSocket.

POST Enviar ordens
Envie ordens de mercado para a sua conta com stop loss e take profit. Suporta os modos de margem hedging e netting.
/v1/trade
POST Fechar e modificar
Feche posições total ou parcialmente. Atualize SL/TP em posições abertas. Feche tudo, por símbolo ou nettifique posições opostas.
/v1/close · /v1/modify · /v1/close-all
GET Posições e ordens
Recupere todas as posições abertas e ordens pendentes em tempo real. Filtre por símbolo. Respostas servidas em cache com push em tempo real.
/v1/positions · /v1/orders
GET Conta e saldo
Saldo, equity, margem, margem livre, PnL flutuante e alavancagem em tempo real. Uma chamada para uma visão completa.
/v1/account
GET Símbolos e especificações
Lista completa de símbolos com bid/ask ao vivo, spread, tamanho de contrato, volume mín/máx/passo, dígitos e requisitos de margem.
/v1/symbols · /v1/symbols/:symbol
WS Streaming WebSocket
Cotações em streaming em tempo real com profundidade de mercado de 5 níveis. Subscreva os símbolos disponíveis na sua conta.
wss://ws.xbtfx.com/v1/ws

Envie a sua primeira ordem API em minutos

Algumas linhas de código na linguagem da sua escolha. HTTP padrão — qualquer linguagem capaz de enviar um pedido POST funciona.

XBTFX Trading API · examples
# Send a buy order to your XBTFX account curl -X POST https://interface.xbtfx.com/v1/trade \ -H "Authorization: Bearer $XBTFX_API_KEY" \ -H "Content-Type: application/json" \ -d '{"symbol":"EURUSD","side":"buy","volume":0.10,"sl":1.082,"tp":1.09}' # Retrieve open positions curl https://interface.xbtfx.com/v1/positions \ -H "Authorization: Bearer $XBTFX_API_KEY"
import requests API_KEY = "xbtfx_live_your_key_here" BASE = "https://interface.xbtfx.com" HEADERS = {"Authorization": f"Bearer {API_KEY}"} # Send a trade to your account r = requests.post(f"{BASE}/v1/trade", json={ "symbol": "EURUSD", "side": "buy", "volume": 0.10 }, headers=HEADERS) print(r.json()) # {"status": "filled", "retcode": 10009}
const ws = new WebSocket("wss://ws.xbtfx.com/v1/ws"); ws.onopen = () => { ws.send(JSON.stringify({ type: "auth", api_key: "xbtfx_live_..." })); ws.send(JSON.stringify({ type: "subscribe", symbols: ["EURUSD", "BTCUSD"] })); }; ws.onmessage = (e) => { const q = JSON.parse(e.data); console.log(q.symbol, q.bid, q.ask); };
main 0 errors Shell UTF-8 LF interface.xbtfx.com
AI-Ready

Execute ordens em linguagem natural

A XBTFX Trading API foi construída para ser consumida por agentes IA e modelos de linguagem grandes — JSON limpo, erros legíveis, endpoints previsíveis. Conecte via XBTFX Skills Hub ou servidor MCP e o seu cliente IA poderá enviar ordens via comandos conversacionais.

  • Ordens conversacionais — comprar, vender, fechar, condicionar a dados.
  • Raciocínio assente em ferramentas — cada ação devolve uma resposta estruturada.
  • Portátil entre clientes — Claude, Cursor, Windsurf, Codex.
Documentação API MCP Server

Menos técnico? Veja a nossa página AI Agent Trading.

Exemplo de conversa →
XBTFX Trading Agent
online · executing trades
Today · 13:25 GMT
If today's NFP prints above 200k, close all my open EURUSD and GBPUSD trades.
13:25 ✓✓
Got it. Watching the BLS release at 13:30 GMT. I'll close 4 positions if NFP > 200k.
13:25
tool · xbtfx_get_positions4 open · EURUSD ×2, GBPUSD ×2 · floating +$184.20
13:26
13:30 · NFP released — 247k (forecast 195k)
tool · xbtfx_close_all (filter: EURUSD, GBPUSD)Closed 4 positions in 38 ms · realized +$212.80
13:30

Exemplo ilustrativo. Os fluxos condicionais dependem do agente e dos feeds de dados de mercado configurados.

Casos de uso

O que os agentes IA fazem com a API

Quatro padrões comuns que vemos em fluxos automatizados e orientados por IA em contas XBTFX.

Trading orientado por eventos

A IA monitoriza notícias e dados económicos em tempo real, enviando ordens à sua conta quando são detetados eventos com impacto no mercado.

Gestão de risco inteligente

A IA acompanha a sua margem, PnL flutuante e exposição, ajustando stops, reduzindo tamanhos ou fechando posições para proteger o capital.

Reequilíbrio de carteira

Defina alocações alvo e deixe a IA mantê-las, enviando ordens de ajuste quando o desvio ultrapassa o seu limite.

Análise autónoma

Peça à sua IA para analisar o histórico de operações, calcular taxas de acerto por símbolo e identificar os seus setups mais rentáveis.

Construído para a sua conta XBTFX existente

Use a sua conta MetaTrader 5 Edge ou ECN atual, a sua moeda base existente e o seu modo de margem atual. A API liga-se à mesma conta com a qual já opera.

Especificações técnicas

Endpoints prontos para produção

Modos hedging e netting

Ambos os modos de margem MT5 são suportados. O modo fica vinculado à sua API key.

Chaves de idempotência

Envie a mesma chave em menos de 120 segundos e devolvemos a resposta em cache. Reenvios seguros, sem duplicação de ordens.

Rate limits por peso

600 weight / min por chave. Leituras e ordens custam 1, operações em massa 10. Os headers expõem o seu orçamento restante em cada resposta.

FIX 4.4 institucional

Acesso FIX 4.4 através da infraestrutura xPro para prime brokers, hedge funds e empresas de HFT. Contactar vendas.
Compatibilidade de conta

Edge ou ECN — a mesma conta

Contas Edge e ECN

Spreads mais apertados com comissão por lote. A API trata cada conta Edge / ECN da mesma forma — mesmos endpoints, mesmo JSON, mesmo fluxo de autenticação.

Contas PAMM, MAM e Copy Master

Contas de gestor podem ser controladas programaticamente através da API para alocações, reequilíbrio e execução. Contacte o onboarding para o provisionamento de credenciais.

Liquidação multi-moeda

Todas as moedas base que a XBTFX MT5 suporta para Edge e ECN: USD, EUR, USDT, BTC, ETH, XRP, SOL, LTC, ZEC, XAU. Saldos, equity, margem e PnL voltam na moeda nativa da conta — sem lógica de conversão do seu lado.

Hedging ou netting

Seja qual for o modo de margem definido na conta MT5, é o que a API utiliza. Sem reconfigurações.

Recursos para developers

Exemplos de código, ficheiros AI skill e documentação API completa — tudo o que precisa para começar.

Documentação API

Referência completa de endpoints com exemplos de pedido/resposta, guia de autenticação e integração WebSocket.
docs.xbtfx.com

Exemplos de API

Código de exemplo em Python, JavaScript, curl e mais. Copie e execute.
GitHub

AI Skills Hub

Ficheiros de skills para fluxos de trading, conta, dados de mercado e WebSocket em frameworks de agentes compatíveis.
Documentação GitHub

MCP Server

Para Claude Code, Claude Desktop, OpenAI Codex, Cursor, Windsurf e outros clientes compatíveis com MCP.
Documentação GitHub

Comece em três passos

A mesma estrutura, dois pontos de partida — escolha o que coincide com o estado da sua conta.

1
Gere uma API key
Inicie sessão em console.xbtfx.com com as suas credenciais XBTFX, selecione a sua conta de trading e gere uma chave.
Abrir Console
2
Instale uma skill ou MCP
Instale uma skill a partir do Skills Hub ou conecte o servidor MCP ao Claude Code, Cursor, Windsurf ou outros clientes compatíveis. As chaves ficam locais.
Documentação MCP
3
Comece a operar
Verifique com GET /v1/auth/status, depois envie comandos em linguagem natural ou chame os endpoints REST/WebSocket diretamente.
Ler documentação

Frequently
Asked Questions

  • O que é a XBTFX Trading API?

    A XBTFX Trading API oferece acesso REST e WebSocket para trading programático, monitorização de contas, recuperação de dados de mercado e streaming em contas XBTFX MetaTrader 5® compatíveis. É construída pela XBTFX — interage com endpoints HTTP limpos e respostas JSON para enviar ordens e recuperar dados da sua conta.

  • Que linguagens de programação posso usar?

    Qualquer linguagem capaz de fazer pedidos HTTP. Python, JavaScript, Go, Rust, C#, Java, Ruby, PHP — se conseguir enviar um POST com corpo JSON, consegue enviar ordens à sua conta XBTFX via API.

  • Posso construir estratégias de trading automatizadas?

    Sim. A XBTFX Trading API foi pensada para trading algorítmico e automatizado. Pode construir bots baseados em sinais, reequilibradores de carteira, sistemas de gestão de risco ou qualquer lógica personalizada que envie ordens à sua conta.

  • Existe um feed WebSocket de preços em tempo real?

    Sim. A XBTFX Trading API expõe um endpoint WebSocket para transmitir cotações em tempo real dos símbolos disponíveis na sua conta. Inclui profundidade de mercado de 5 níveis quando disponível. Até 1.000 subscrições de símbolos por ligação e até 10 ligações simultâneas.

  • Qual é a diferença entre os modos hedging e netting?

    São modos de margem que determinam como as posições se comportam. Hedging permite múltiplas posições independentes por símbolo, incluindo opostas de compra e venda. Netting agrega tudo numa única posição por símbolo. A sua API key herda o modo da sua conta.

  • Quais são os rate limits?

    600 weight por minuto por API key. A maior parte dos pedidos custa 1 weight — até 600 chamadas por minuto. Operações em massa como close-all custam 10 weight. Cada resposta inclui headers que mostram o orçamento restante.

  • Posso operar CFDs cripto através da API?

    Sim. Cada símbolo disponível na sua conta XBTFX é acessível através da API — incluindo CFDs sobre criptomoedas. Também pode usar a API com contas denominadas em BTC, ETH, USDT ou XRP.

  • A API é gratuita?

    Sim. A XBTFX Trading API é incluída em cada conta de trading sem custo adicional. Sem taxas de API, subscrições ou custos por chamada além das suas comissões e spreads habituais.

  • Como obtenho uma API key?

    Primeiro, crie uma conta de trading XBTFX em my.xbtfx.com se ainda não tiver uma. Depois inicie sessão na API Console em console.xbtfx.com com as suas credenciais XBTFX, selecione a conta e gere uma chave. Verifique se funciona enviando GET /v1/auth/status antes de operar.

  • Posso usar a API com uma conta demo?

    Sim. As API keys funcionam tanto em contas reais como em demo. Isto permite testar a sua integração e validar o seu código antes de passar a real — na mesma API com os mesmos endpoints.

  • O que devo fazer antes de enviar ordens?

    Verifique primeiro o estado da sua API key e da conta enviando GET /v1/auth/status. Confirma que a chave é válida, mostra as suas permissões e modo de margem, e garante que a sua conta está pronta antes de enviar pedidos de trading.

  • Preciso de experiência em programação?

    Usar a API REST diretamente exige conhecimentos básicos de programação. Contudo, com os caminhos de integração IA não precisa de escrever código — conecte o servidor XBTFX MCP ao Claude Code ou Cursor, ou instale uma skill a partir do Skills Hub, e dê ordens em linguagem natural. Familiaridade com assistentes IA de código é recomendada.

  • Posso usar IA para operar a minha conta?

    Sim. Use o XBTFX Skills Hub para frameworks de agentes que suportem ficheiros de skill, ou conecte o servidor XBTFX MCP a clientes compatíveis com MCP como Claude Code, Claude Desktop, OpenAI Codex, Cursor ou Windsurf. Ambos os caminhos permitem dar ordens em linguagem natural através da XBTFX Trading API.

  • É seguro dar acesso à minha conta a um agente IA?

    As API keys costumam ser guardadas localmente pelo agente na sua máquina e não são enviadas para servidores de terceiros. O agente envia chamadas API diretamente para os servidores da XBTFX usando a sua chave. Pode revogar a chave a qualquer momento a partir do Console. Recomendamos começar com uma conta demo para testar a configuração antes de passar a real.

Comece a construir hoje com

Chat

24/7 Chat Support

Need help with the API? Our team is available around the clock.

Chat Now →
FAQ

API Documentation

Full endpoint reference, authentication guide, and examples.

View Docs →
Blog

GitHub Repos

API examples, AI skills, and sample code ready to use.

View on GitHub →

Esta página é detida e operada pelas empresas XBTFX, incluindo:

XBTFX LLC, constituída em Antígua e Barbuda com número de registo ILLC001 e sede em Hodges Bay, P.O. Box 1348, St. John's, Antígua.

XBTFX (SC) Ltd. constituída em Seychelles com número de registo 8434947-1 e endereço comercial em Office 1, Block 2, 1st Floor, Sai-fu Building, Zone 20, Providence, Mahé, Seychelles, com Licença n.º SD169.
O processamento de pagamentos é realizado pela CLEARAY LTD, uma sociedade de responsabilidade limitada devidamente constituída ao abrigo da Lei das Sociedades, Cap. 113 da República de Chipre, com número de registo HE 462275 e sede em Archiepiskopou Makariou ΙΙΙ, 160, 1st Floor, 3026, Limassol, Chipre. A XBTFX é um fornecedor de contratos por diferença (CFDs) sobre uma multiplicidade de ativos, oferecendo serviços com base em alavancagem. Note que o valor dos seus investimentos está sujeito à volatilidade do mercado e pode subir ou descer. Consequentemente, o seu capital investido está em risco. Os criptoativos, em particular não regulados e altamente voláteis, não beneficiam de proteção ao consumidor. Adicionalmente, quaisquer lucros provenientes dos seus investimentos podem estar sujeitos a impostos. A XBTFX não presta os seus serviços a pessoas residentes em determinadas jurisdições, incluindo, mas não limitado a, EUA, Quebec (Canadá), Bélgica, Bielorrússia, Rússia, Irão, Coreia do Norte, Sudão, Iémen, ou quaisquer outras regiões onde os serviços prestados pela XBTFX violariam as leis ou regulamentos locais em vigor. Esta lista não é exaustiva e está sujeita a atualizações conforme necessário. A XBTFX não tem como alvo ativo clientes da UE/EEE. Recomendamos vivamente aos potenciais clientes que compreendam aprofundadamente a regulamentação cambial aplicável nos seus respetivos países antes de utilizarem os serviços da XBTFX. Aviso de Investimento de Alto Risco: Os Contratos por Diferença (CFDs) são instrumentos financeiros sofisticados que envolvem um risco substancial devido à sua natureza alavancada. A perda monetária rápida é uma consequência provável de operar com estes instrumentos. É imperativo que avalie cuidadosamente a sua compreensão do funcionamento dos CFDs e determine a adequação da negociação de CFDs à sua situação particular. Aconselhamos vivamente que não invista fundos que não possa perder. Os produtos alavancados podem não ser adequados a todas as pessoas e podem levar à perda total do seu capital. Por favor, leia o nosso ‘Aviso de Divulgação de Riscos’. Operar na XBTFX seguindo e/ou copiando ou replicando as operações de outros traders envolve um elevado nível de risco, mesmo ao seguir/copiar/replicar os traders de melhor desempenho. Esses riscos incluem o risco de estar a seguir/copiar as decisões de traders possivelmente inexperientes/não profissionais, ou de traders cujo objetivo, intenção ou situação financeira possam diferir dos seus. O desempenho passado não é um indicador do seu desempenho futuro. O conteúdo na plataforma de social trading da XBTFX é gerado por membros da sua comunidade e não constitui aconselhamento ou recomendações da XBTFX ou em seu nome. Aviso de Proteção Antifraude: A XBTFX presta apenas serviços de corretagem aos clientes. Adicionalmente, a XBTFX opera apenas através do URL xbtfx.com e os clientes devem certificar-se de que acedem aos nossos serviços apenas através desse URL. A XBTFX nunca lhe pedirá a sua palavra-passe nem o contactará por SMS/Telefone para tal. O conteúdo aqui contido é fornecido apenas para fins informativos e de marketing. Não constitui, nem deve ser interpretado como, aconselhamento financeiro, de investimento ou outro aconselhamento profissional ou recomendação. Também não representa uma oferta ou solicitação para comprar, vender ou negociar qualquer instrumento ou transação financeira. Os clientes devem procurar a opinião de consultores financeiros licenciados para garantir que têm o apetite de risco, a experiência e o conhecimento relevantes antes de negociarem. Esta página foi traduzida para sua conveniência. A versão em inglês de todos os termos, acordos, documentos legais e condições de negociação prevalecerá em caso de qualquer inconsistência.
2026 XBTFX LLC. All Rights Reserved.