Token API
API baca-saja untuk bot atau saluran. Membaca satu akun demo, dalam persen, dan tidak bisa mengubah apa pun.
Di halaman ini
Apa yang bisa dilakukan token
Token membaca satu akun demo: transaksi tertutup, posisi terbuka, statistik, dan kartu PnL. Semuanya dalam persen, tidak pernah dalam nominal. Token tidak bisa memasang, mengubah, atau membatalkan apa pun.
Buat token
-
Siapkan akun demo
Token membaca akun demo, jadi buatlah satu lebih dulu.
-
Buka Pengaturan → API
Beri nama token dan pilih akun yang dibacanya.
-
Salin segera
Token hanya ditampilkan sekali. Jika hilang, cabut lalu buat yang baru.
Apa pun yang memakai token yang sudah dicabut langsung berhenti bekerja.
Request
Base URL-nya adalah https://tarvis.trade/api/v1/agent. Setiap request mengirim header Authorization: Bearer <token>. Waktu dalam UTC ISO 8601, id bersifat tetap, dan Anda bisa membuat hingga 120 request per menit per token.
curl -H "Authorization: Bearer $TOKEN" https://tarvis.trade/api/v1/agent/meEndpoint
| Endpoint | Yang dikembalikan |
|---|---|
/trades/closed?since_id=&limit= | Transaksi tertutup baru setelah since_id, terlama lebih dulu. Polling endpoint ini. |
/trades/{id}?lang=en|ru | Satu transaksi, alasan masuk dan keluarnya, serta fill-nya |
/trades/{id}/card.png?theme=&lang=&size= | Kartu PnL, siap untuk Telegram |
/positions/open | Apa yang dipegang akun saat ini |
/stats?period=7d|30d|all | Win rate, profit factor, drawdown, imbal hasil, keseluruhan dan per strategi |
/equity?from=&to=&interval=1h|1d | Kurva ekuitas, dalam persen dari titik pertama |
/equity/card.png?period= | Kurva ekuitas sebagai kartu |
/market/candles?symbol=&interval=&from=&to= | Candle, jika Anda menggambar grafik sendiri |
/me | Apakah token ini aktif |
Bot saluran dalam tiga langkah
-
Polling transaksi baru
Panggil
/trades/closeddengan id terakhir yang sudah Anda lihat, sesering sekali per menit. -
Ambil kartunya
Untuk setiap transaksi baru, unduh
/trades/{id}/card.png. -
Posting
Kirim gambarnya ke saluran Anda, dengan kata-kata Anda sendiri di sampingnya.