API 令牌
供机器人或频道使用的只读 API。它读取一个模拟账户，以百分比显示，不能修改任何东西。
-
先有一个模拟账户
令牌读取的是模拟账户，所以请先创建一个。
-
打开 设置 → API
给令牌起个名字，并选择它读取的账户。
-
立即复制
令牌只显示一次。丢了的话，撤销它再创建一个新的。
使用已撤销令牌的一切都会立即停止工作。
请求
基础 URL 是 https://tarvis.trade/api/v1/agent。每个请求都要携带请求头 Authorization: Bearer <token>。时间均为 UTC ISO 8601，ID 固定不变，每个令牌每分钟最多120次请求。
curl -H "Authorization: Bearer $TOKEN" https://tarvis.trade/api/v1/agent/me接口
| 接口 | 返回内容 |
|---|---|
/trades/closed?since_id=&limit= | since_id 之后新平仓的交易，最早的在前。请轮询这个接口。 |
/trades/{id}?lang=en|ru | 单笔交易，包括入场和出场的原因及成交明细 |
/trades/{id}/card.png?theme=&lang=&size= | PnL 卡片，可直接发到 Telegram |
/positions/open | 账户当前持有的仓位 |
/stats?period=7d|30d|all | 胜率、盈利因子、回撤、收益，总体和各策略数据 |
/equity?from=&to=&interval=1h|1d | 权益曲线，以首个点为基准的百分比 |
/equity/card.png?period= | 卡片形式的权益曲线 |
/market/candles?symbol=&interval=&from=&to= | K线数据，供你自己绘制图表 |
/me | 此令牌是否有效 |
三步做一个频道机器人
-
轮询新交易
带上你见过的最后一个 id 调用
/trades/closed，最快可以每分钟一次。 -
获取卡片
对每笔新交易，下载
/trades/{id}/card.png。 -
发布
把图片发到你的频道，旁边配上你自己的文字。