Быстрый старт

Это руководство проведет вас через создание аккаунта, просмотр событий и размещение вашей первой сделки на Intotes -- все за примерно 5 минут.

Базовый URL: https://intotes.com/api/v1

Все примеры используют curl. Ответы сокращены для наглядности.

---

Шаг 1: Создание аккаунта

Зарегистрируйтесь с помощью электронной почты и пароля. Пароль должен содержать не менее 8 символов.

curl -X POST https://intotes.com/api/v1/auth/sign-up \
  -H "Content-Type: application/json" \
  -d '{
    "email": "you@example.com",
    "password": "your_secure_password",
    "language": "en"
  }'

Ответ (201):

{
  "success": true,
  "message": "User created successfully. Please check your email for verification code.",
  "user_id": 42
}

На вашу электронную почту отправлен 4-значный код подтверждения. Запомните user_id -- он понадобится на следующем шаге.

Вы также можете передать необязательное поле referral_code, если вас пригласил другой пользователь.

---

Шаг 2: Подтверждение электронной почты

Введите код подтверждения из полученного письма.

curl -X POST https://intotes.com/api/v1/auth/verify-email \
  -H "Content-Type: application/json" \
  -c cookies.txt \
  -d '{
    "user_id": 42,
    "verification_code": "1234"
  }'

Ответ (200):

{
  "success": true,
  "message": "Email verified successfully",
  "user": {
    "id": 42,
    "email": "you@example.com",
    "balance": 0,
    "email_verified": true
  }
}

Этот ответ также устанавливает два HTTP-only cookie: access_token и refresh_token. Флаг -c cookies.txt сохраняет их в файл, чтобы последующие запросы могли использовать их автоматически с помощью -b cookies.txt.

---

Шаг 3: Получение профиля

Убедитесь, что аутентификация работает, запросив свой профиль.

curl https://intotes.com/api/v1/auth/me \
  -b cookies.txt

Ответ (200):

{
  "id": 42,
  "email": "you@example.com",
  "name": "User42",
  "balance": 0,
  "bonus_balance": 0,
  "email_verified": true,
  "language": "en",
  "theme": "s"
}

---

Шаг 4: Просмотр событий

Получите ленту событий, чтобы увидеть, на что можно торговать. Этот эндпоинт не требует аутентификации.

curl https://intotes.com/api/v1/events/feed

Ответ (200):

{
  "events": [
    {
      "event": {
        "id": 1,
        "title": "Will BTC reach $100k by end of 2026?",
        "status": "active",
        "image_url": "https://..."
      },
      "main_pool": {
        "id": 10,
        "event_id": 1,
        "title": "Main",
        "finish_at": "2026-12-31T23:59:59Z"
      },
      "markets": [
        {
          "id": 100,
          "pool_id": 10,
          "title": "Yes",
          "yes_probability": 6500,
          "volume": 5000000
        }
      ],
      "total_volume": 5000000
    }
  ],
  "next_cursor": "eyJpZCI6...",
  "has_more": true
}

Обратите внимание на market_id (например, 100) -- вы будете использовать его для совершения сделки. Вероятности указаны в диапазоне 0-10000, поэтому 6500 означает 65.00%.

---

Шаг 5: Совершение сделки через LMSR

Купите акции YES на рынке, используя автоматический маркетмейкер LMSR. В этом примере расходуется 1000 копеек (10.00 RUB) на акции YES на рынке 100.

curl -X POST https://intotes.com/api/v1/lmsr/trade \
  -H "Content-Type: application/json" \
  -b cookies.txt \
  -d '{
    "market_id": 100,
    "side": "buy_yes",
    "amount_type": "spend",
    "amount": 1000
  }'

Параметры:

Поле	Тип	Описание
market_id	integer	Рынок для торговли.
side	string	Одно из: buy_yes, sell_yes, buy_no, sell_no.
amount_type	string	spend (сколько копеек потратить) или shares (количество акций).
amount	integer	Сумма в копейках. Должна быть положительной.

Вы также можете установить "use_bonus": true, чтобы оплатить бонусным балансом.

Ответ (200):

{
  "trade_id": 501,
  "market_id": 100,
  "side": "buy_yes",
  "shares": 1450,
  "cost": 1000,
  "avg_price": 6896,
  "new_yes_probability": 6700
}

Вы потратили 1000 копеек и получили 1450 акций YES. Вероятность на рынке изменилась с 65.00% до 67.00%.

Перед торговлей вы можете просмотреть стоимость без исполнения, вызвав:

curl "https://intotes.com/api/v1/lmsr/preview?market_id=100&side=buy_yes&amount_type=spend&amount=1000" \
  -b cookies.txt

---

Шаг 6: Проверка позиций

Просмотрите все ваши открытые позиции на всех рынках.

curl https://intotes.com/api/v1/market/positions/my \
  -b cookies.txt

Ответ (200):

[
  {
    "market_id": 100,
    "market_title": "Yes",
    "pool_id": 10,
    "event_id": 1,
    "event_title": "Will BTC reach $100k by end of 2026?",
    "side": "long",
    "shares": 1450,
    "avg_price": 6896,
    "current_price": 6700,
    "unrealized_pnl": -284
  }
]

Позиция long означает, что вы держите токены YES. Позиция short означает, что вы держите токены NO.

---

Что дальше?

• Прочитайте Ключевые концепции, чтобы понять полную структуру рынка: события, пулы, рынки и расчеты.
• Изучите эндпоинты книги ордеров для размещения лимитных ордеров по конкретным ценам.
• Настройте WebSocket-соединение к /api/v1/ws/trades для получения обновлений сделок в реальном времени.