Token API
Một API chỉ đọc cho bot hoặc kênh. Nó đọc một tài khoản mô phỏng, theo phần trăm, và không thể thay đổi bất cứ thứ gì.
Token làm được gì
Một token đọc một tài khoản mô phỏng: giao dịch đã đóng, vị thế đang mở, thống kê và thẻ PnL. Mọi thứ đều theo phần trăm, không bao giờ theo số tiền. Nó không đặt, sửa hay hủy được bất cứ thứ gì.
Tạo token
-
Có một tài khoản mô phỏng
Token đọc một tài khoản mô phỏng, nên hãy tạo một tài khoản trước.
-
Mở Cài đặt → API
Đặt tên cho token và chọn tài khoản nó sẽ đọc.
-
Sao chép ngay
Token chỉ hiện một lần. Nếu bạn làm mất, hãy thu hồi nó và tạo token mới.
Mọi thứ đang dùng một token đã thu hồi sẽ ngừng hoạt động ngay.
Yêu cầu
URL gốc là https://tarvis.trade/api/v1/agent. Mỗi yêu cầu gửi header Authorization: Bearer <token>. Thời gian theo UTC ISO 8601, id cố định, và bạn có thể gửi tối đa 120 yêu cầu mỗi phút cho mỗi token.
curl -H "Authorization: Bearer $TOKEN" https://tarvis.trade/api/v1/agent/meEndpoint
| Endpoint | Nó trả về gì |
|---|---|
/trades/closed?since_id=&limit= | Các giao dịch mới đóng sau since_id, cũ nhất trước. Hãy poll endpoint này. |
/trades/{id}?lang=en|ru | Một giao dịch, vì sao vào và thoát lệnh, cùng các lần khớp của nó |
/trades/{id}/card.png?theme=&lang=&size= | Thẻ PnL, sẵn sàng cho Telegram |
/positions/open | Tài khoản đang nắm giữ gì |
/stats?period=7d|30d|all | Win rate, profit factor, drawdown, lợi nhuận, tổng thể và theo từng chiến lược |
/equity?from=&to=&interval=1h|1d | Đường cong vốn, theo phần trăm so với điểm đầu tiên |
/equity/card.png?period= | Đường cong vốn dạng thẻ |
/market/candles?symbol=&interval=&from=&to= | Nến, nếu bạn tự vẽ biểu đồ |
/me | Token này còn hoạt động không |
Bot kênh trong ba bước
-
Poll các giao dịch mới
Gọi
/trades/closedvới id cuối cùng bạn đã thấy, thường xuyên nhất là mỗi phút một lần. -
Lấy thẻ
Với mỗi giao dịch mới, tải
/trades/{id}/card.png. -
Đăng nó
Gửi ảnh lên kênh của bạn, kèm lời của riêng bạn bên cạnh.