API-токены
API только для чтения для бота или канала. Он читает один демо-аккаунт, в процентах, и ничего не может изменить.
Что может токен
Токен читает один демо-аккаунт: закрытые сделки, открытые позиции, статистику и карточки PnL. Всё в процентах, без сумм. Он не может ничего выставить, изменить или отменить.
Создание токена
-
Заведите демо-аккаунт
Токены читают демо-аккаунт, поэтому сначала создайте его.
-
Откройте Настройки → 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 | Win rate, profit factor, просадка, доходность, в целом и по каждой стратегии |
/equity?from=&to=&interval=1h|1d | Кривая капитала в процентах от первой точки |
/equity/card.png?period= | Кривая капитала в виде карточки |
/market/candles?symbol=&interval=&from=&to= | Свечи, если рисуете свой график |
/me | Работает ли этот токен |
Бот для канала в три шага
-
Опрашивайте новые сделки
Вызывайте
/trades/closedс последним id, который вы видели, вплоть до раза в минуту. -
Получите карточку
Для каждой новой сделки скачайте
/trades/{id}/card.png. -
Опубликуйте её
Отправьте картинку в свой канал, добавив свои слова.