Tokens de API
Una API de solo lectura para un bot o un canal. Lee una cuenta demo, en porcentaje, y no puede cambiar nada.
En esta página
Qué puede hacer un token
Un token lee una cuenta demo: operaciones cerradas, posiciones abiertas, estadísticas y tarjetas de PnL. Todo va en porcentaje, nunca en importes. No puede colocar, cambiar ni cancelar nada.
Crea un token
-
Ten una cuenta demo
Los tokens leen una cuenta demo, así que crea una primero.
-
Abre Ajustes → API
Ponle un nombre al token y elige la cuenta que lee.
-
Cópialo enseguida
Solo se muestra una vez. Si lo pierdes, revócalo y crea otro.
Todo lo que use un token revocado deja de funcionar al instante.
Solicitudes
La URL base es https://tarvis.trade/api/v1/agent. Cada solicitud envía la cabecera Authorization: Bearer <token>. Las horas son ISO 8601 en UTC, los ids son estables y puedes hacer hasta 120 solicitudes por minuto por token.
curl -H "Authorization: Bearer $TOKEN" https://tarvis.trade/api/v1/agent/meEndpoints
| Endpoint | Qué devuelve |
|---|---|
/trades/closed?since_id=&limit= | Operaciones cerradas nuevas después de since_id, de la más antigua a la más reciente. Consulta este. |
/trades/{id}?lang=en|ru | Una operación, por qué entró y salió, y sus ejecuciones |
/trades/{id}/card.png?theme=&lang=&size= | La tarjeta de PnL, lista para Telegram |
/positions/open | Lo que tiene la cuenta ahora |
/stats?period=7d|30d|all | Win rate, profit factor, drawdown, rendimiento, en conjunto y por estrategia |
/equity?from=&to=&interval=1h|1d | La curva de capital, en porcentaje desde el primer punto |
/equity/card.png?period= | La curva de capital como tarjeta |
/market/candles?symbol=&interval=&from=&to= | Velas, si dibujas tu propio gráfico |
/me | Si este token está activo |
Un bot de canal en tres pasos
-
Consulta las operaciones nuevas
Llama a
/trades/closedcon el último id que hayas visto, hasta una vez por minuto. -
Descarga la tarjeta
Por cada operación nueva, descarga
/trades/{id}/card.png. -
Publícala
Envía la imagen a tu canal, con tus propias palabras al lado.