API
Uma API só de leitura para um bot ou um canal. Ela lê uma conta demo, em percentual, e não pode alterar nada.
Nesta página
O que um token pode fazer
Um token lê uma conta demo: operações fechadas, posições abertas, estatísticas e cards de PnL. Tudo em percentual, nunca em valores. Ele não pode enviar, alterar nem cancelar nada.
Crie um token
-
Tenha uma conta demo
Os tokens leem uma conta demo, então crie uma primeiro.
-
Abra Configurações → API
Dê um nome ao token e escolha a conta que ele lê.
-
Copie na hora
Ele é mostrado uma única vez. Se perdê-lo, revogue e crie outro.
Tudo o que usar um token revogado deixa de funcionar na hora.
Requisições
A URL base é https://tarvis.trade/api/v1/agent. Toda requisição envia o cabeçalho Authorization: Bearer <token>. Os horários são UTC em ISO 8601, os ids são estáveis e você pode fazer até 120 requisições por minuto por token.
curl -H "Authorization: Bearer $TOKEN" https://tarvis.trade/api/v1/agent/meEndpoints
| Endpoint | O que retorna |
|---|---|
/trades/closed?since_id=&limit= | Novas operações fechadas depois de since_id, da mais antiga para a mais nova. Consulte este. |
/trades/{id}?lang=en|ru | Uma operação, por que entrou e saiu, e suas execuções |
/trades/{id}/card.png?theme=&lang=&size= | O card de PnL, pronto para o Telegram |
/positions/open | O que a conta tem agora |
/stats?period=7d|30d|all | Taxa de acerto, fator de lucro, drawdown, retorno, no geral e por estratégia |
/equity?from=&to=&interval=1h|1d | A curva de patrimônio, em percentual a partir do primeiro ponto |
/equity/card.png?period= | A curva de patrimônio como card |
/market/candles?symbol=&interval=&from=&to= | Candles, se você desenha o seu próprio gráfico |
/me | Se este token está ativo |
Um bot de canal em três passos
-
Consulte as novas operações
Chame
/trades/closedcom o último id que você viu, até uma vez por minuto. -
Busque o card
Para cada nova operação, baixe
/trades/{id}/card.png. -
Publique
Envie a imagem ao seu canal, com suas próprias palavras ao lado.