GET /api/v1/partner/users/{external_user_id}

Возвращает состояние суб-аккаунта одного пользователя партнёра: его баланс, стоимость открытых позиций и список самих позиций.

Аутентификация

Обязательно. API-ключ партнёра в заголовке X-Partner-Key.

Запрос

Параметры пути

Параметр	Тип	Обязательно	Описание
external_user_id	string	Да	Идентификатор пользователя в вашей системе. Закодируйте значение для URL.

Пример

curl https://yoyo.market/api/v1/partner/users/user_42 \
  -H "X-Partner-Key: <partner_key>"

Ответ

200 OK

Денежные поля — целые числа в копейках (100 копеек = 1 RUB). См. Формат денежных значений.

{
  "external_user_id": "user_42",
  "exists": true,
  "user_id": 987654,
  "balance_kopecks": 12000,
  "open_positions_kopecks": 48000,
  "positions": [
    {
      "market_id": 12345,
      "side": "yes",
      "shares": 91234,
      "avg_price_bps": 5480,
      "value_kopecks": 48000
    }
  ]
}

Если exists равно false, пользователь ещё не делал ставок и суб-аккаунт для него не создан. Суб-аккаунт создаётся автоматически при первой ставке пользователя через Place Bet.

Значение balance_kopecks включает выплаты от продажи позиций через Sell Position: они остаются на суб-аккаунте, и их можно использовать под следующие ставки.

Поля ответа

Поле	Тип	Описание
external_user_id	string	Идентификатор пользователя в вашей системе. Повторяет значение из пути.
exists	bool	Существует ли суб-аккаунт для этого пользователя.
user_id	int64	ID суб-аккаунта Yoyo Market, привязанного к external_user_id.
balance_kopecks	int	Баланс на суб-аккаунте, в копейках.
open_positions_kopecks	int	Текущая стоимость всех открытых позиций, в копейках.
positions	array	Открытые позиции суб-аккаунта.
positions[].market_id	int64	Рынок, на котором открыта позиция.
positions[].side	string	Сторона позиции: "yes" или "no".
positions[].shares	int	Количество акций в позиции. 100 акций = 1 токен.
positions[].avg_price_bps	int	Средняя цена входа в базисных пунктах. 10000 = 1 RUB.
positions[].value_kopecks	int	Текущая стоимость позиции, в копейках.

О том, что означают акции, цена входа и стоимость позиции, см. Позиции.

Ошибки

Собственные коды ошибок для этого эндпоинта не документированы. Ошибки аутентификации, общие для всех партнёрских эндпоинтов, перечислены в разделе Обзор, а полный справочник кодов — в разделе Обработка ошибок.