Документация к API

Endpoint Method Description Parameters
/api/login POST Аутентификация и получение токена
  • nickname: Your username
  • password: Your password
/api/submit_order POST Отправить рыночную заявку
Без указания цены. Заявка исполнится по лучшей доступной цене на бирже
  • direction: 'B' Покупка или 'S' Продажа
  • secid: Код бумаги ('SBER', 'LKOH', ...)
  • position: Объем позиции, доля от капитала (1-100)
  • bot: Наименование портфеля/бота (string)
/api/trades GET Получить свои сделки за сегодня Можно посмотреть в личном кабинете
/api/positions GET Получить свои открытые позиции Можно посмотреть в личном кабинете
/api/bot_trade_limits GET Получить информацию о лимитах торговли для своих ботов
  • Возвращает кол-во сделок для бота
  • Лимит: 1000 сделок в день на бота
  • Показывает оставшееся кол-во сделок для бота

Authentication

Шаг 1: Получи токен

Получи токен и используй его во всех последующих запросах.

cURL 
curl -X POST "https://arenago.ru/api/login" \
     -H "Content-Type: application/json" \
     -d '{
         "nickname": "your_username",
         "password": "your_password"
     }'
Python 
import requests

url = "https://arenago.ru/api/login"
payload = {
    "nickname": "your_username",
    "password": "your_password"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)
token = response.json().get("token")
print(f"Token: {token}")
Response
{
    "token": "your_authentication_token",
    "message": "Authentication successful"
}

Make trades

Шаг 2: Отправь рыночную заявку

Используй токен аутентификации для отправки заявок на покупку или продажу доступных ценных бумаг.

cURL 
curl -X POST "https://arenago.ru/api/submit_order" \
     -H "Content-Type: application/json" \
     -H "Authorization: your_token" \
     -d '{
         "direction": "B",
         "secid": "SBER",
         "position": 100,
         "bot": "MyTradingBot"
     }'
Python 
import requests

url = "https://arenago.ru/api/submit_order"
payload = {
    "direction": "B",  # "B" for Buy, "S" for Sell
    "secid": "SBER",   # Stock ticker
    "position": 100,   # Capital amount (1-100)
    "bot": "MyTradingBot"  # Your bot's name
}
headers = {
    "Content-Type": "application/json",
    "Authorization": "your_token"
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())
Success Response
{
    "success": true,
    "message": "Trade submitted successfully",
    "trade_limits": {
        "bot_name": "MyTradingBot",
        "trades_today": 251,
        "max_trades": 1000,
        "remaining_trades": 749
    }
}
Error Responses
{"error": "ERROR: MARKET CLOSED"} - Trading hours: 07:00 - 15:40 MSK
{"error": "ERROR: NOT VALID SECID"} - Security ID not in allowed list
{"error": "ERROR: SUBMIT MAX COUNT LIMIT EXCEEDED"} - Reached max 1000 trades per day
{"error": "ERROR: BOT {bot_name} HAS REACHED DAILY TRADE LIMIT OF 1000"} - Bot specific trade limit reached
{"error": "ERROR: MAX POSITION EXCEEDED"} - Total position exceeds 100 limit

Check Bot Trade Limits

Отслеживай лимиты торговли ботов

Проверяй, сколько сделок осталось у каждого бота на сегодня

Python 
import requests

url = "https://arenago.ru/api/bot_trade_limits"
headers = {"Authorization": "your_token"}

response = requests.get(url, headers=headers)
data = response.json()

print(f"Date: {data['date']}")
for bot in data['bot_limits']:
    print(f"Bot: {bot['bot_name']}")
    print(f"  Trades Today: {bot['trades_today']}")
    print(f"  Remaining: {bot['remaining_trades']} of {bot['max_trades']}")
Response Example
{
    "date": "2025-04-14",
    "bot_limits": [
        {
            "bot_name": "MyTradingBot",
            "trades_today": 250,
            "max_trades": 1000,
            "remaining_trades": 750,
            "last_updated": "2025-04-14T15:30:25.123456"
        },
        {
            "bot_name": "AlphaTrader",
            "trades_today": 520,
            "max_trades": 1000,
            "remaining_trades": 480,
            "last_updated": "2025-04-14T15:45:12.654321"
        }
    ]
}

Get My Trades & Positions

Шаг 3: Отслеживай свои сделки и позиции

Получи информацию о сделках и текущих позициях, чтобы отслеживать их эффективность

Get Trades
Python 
import requests

url = "https://arenago.ru/api/trades"
headers = {"Authorization": "your_token"}

response = requests.get(url, headers=headers)
trades = response.json()
for trade in trades:
    print(f"{trade['tradedate']} {trade['tradetime']}: "
          f"{trade['direction']} {trade['secid']} "
          f"x{trade['position']} by {trade['bot']}")
Get Positions
Python 
import requests

url = "https://arenago.ru/api/positions"
headers = {"Authorization": "your_token"}

response = requests.get(url, headers=headers)
positions = response.json()
for pos in positions:
    print(f"{pos['secid']}: {pos['position']} units "
          f"(updated: {pos['updatetime']}, "
          f"bot: {pos['bot']})")

Доступные ценные бумаги

Для торговли доступны 36 ценных бумаг:

GAZP SBER T VTBR LKOH NVTK GMKN YDEX X5 SMLT ROSN AFLT MTLR MGNT PLZL SPBE AFKS MOEX RNFT PIKK TATN TRNFP VKCO POSI NLMK CHMF UPRO SNGSP SNGS FLOT SIBN SVCB ALRS HEAD SBERP MTSS

Полные правила и подробности соревнования смотри на странице Arena Rules