Primeiros passos¶

A Open API do cTrader é um serviço que pode utilizar para desenvolver aplicações personalizadas ligadas ao backend do cTrader. Esta documentação fornece tudo o que precisa de saber, incluindo informações sobre SDKs, tutoriais estruturados, snippets de código e muito mais.

O que é a Open API? ¶

A Open API do cTrader é um serviço que permite que qualquer pessoa com um cTrader ID (cTID) crie uma aplicação que envia e recebe informações de e para o backend do cTrader. Pode utilizar esta API para desenvolver aplicações ou serviços orientados para negociação ou integrar o backend do cTrader com quaisquer soluções existentes que possa ter.

Utilizar esta API envolve enviar e receber mensagens de e para o backend do cTrader. Isto é feito enviando e recebendo objetos JSON ou Google Protocol Buffers (Protobufs). Ambos estes meios de serialização e desserialização de dados são neutros em termos de linguagem, o que significa que pode utilizar qualquer linguagem de programação que desejar para interagir com a API.

Nomes de mensagens

Quando esta documentação referencia mensagens específicas (por exemplo, ProtoOAApplicationAuthReq), utiliza a notação Protobuf com ProtoOA... no início do nome da mensagem.

A Open API do cTrader está disponível para qualquer pessoa registada num corretor afiliado ao cTrader.

Casos de uso

Aqui estão apenas algumas das possíveis aplicações que pode criar ao interagir com a Open API do cTrader:

Uma aplicação de negociação personalizada que encaminha novos utilizadores para criar novas contas com um determinado corretor.
Um bot do Telegram que informa automaticamente os seus seguidores sobre quaisquer novas negociações que possa ter realizado.
Uma aplicação para wearables que mostra o P&L atual das cinco posições mais recentes abertas pelo utilizador.
Uma aplicação móvel que fornece uma visão geral do mercado utilizando um serviço de IA generativa.

Como pode ver, a Open API do cTrader é perfeita para traders profissionais que querem envolver-se socialmente e interagir com os seus seguidores.

Funcionalidade essencial ¶

Aqui está uma lista não exaustiva do que a Open API do cTrader permite que o seu código faça:

Aceda a dados do mercado em tempo real.
Realizar todos os tipos possíveis de operações de negociação permitidas nas aplicações oficiais do cTrader.
Recuperar e processar informações sobre operações passadas, atuais e pendentes (incluindo negócios, ordens e posições).

Como mostrado nos nossos Termos de uso, a API pode ser acedida por qualquer pessoa com um cTID e, por predefinição, é suportada por todas as contas de negociação de quaisquer corretores afiliados ao cTrader.

Limitação de taxa

Note que existem alguns limites sobre a frequência com que pode realizar determinados pedidos ao backend do cTrader.

Pode realizar um máximo de 50 pedidos por segundo por ligação para quaisquer pedidos de dados não históricos.
Pode realizar um máximo de 5 pedidos por segundo por ligação para quaisquer pedidos de dados históricos.

Negociação demo e real ¶

Pode utilizar a Open API do cTrader para negociar em nome de contas demo e reais.

Recomendamos utilizar contas demo para desenvolvimento e testes, e depois mudar para real após garantir que a sua integração com a Open API do cTrader funciona como pretendido. No entanto, não existem restrições rígidas, e pode livremente escolher começar o desenvolvimento e testes numa conta real.

SDKs ¶

Ao integrar com o Open API, pode usar JSON ou Protobufs para serialização e desserialização de dados.

Pode usar qualquer linguagem para implementar o Open API da cTrader. No entanto, se pretender usar Protobufs, recomendamos vivamente que use uma linguagem que tenha suporte SDK oficial da Spotware. Até à data, estas são as linguagens disponíveis.

Cada SDK oficial listado acima contém métodos e classes auxiliares que tornam a implementação do Open API da cTrader o mais simples possível.

Se pretender usar JSON, não é necessário usar os nossos SDKs, pois o tratamento da serialização e desserialização neste caso é relativamente simples.