GET /api/v1/market/positions/completed
Получение истории закрытых позиций авторизованного пользователя с поддержкой пагинации.
Аутентификация
Обязательно. Bearer-токен в заголовке Authorization.
Запрос
Параметры запроса
| Параметр | Тип | Обязательно | Описание |
|---|---|---|---|
cursor | string | Нет | Курсор пагинации из поля next_cursor предыдущего ответа. |
limit | int | Нет | Максимальное количество позиций на страницу. |
Пример
curl "https://intotes.com/api/v1/market/positions/completed?limit=10" \
-H "Authorization: Bearer <token>"
Ответ
200 OK
{
"positions": [
{
"id": 401,
"user_id": 7,
"market_id": 30,
"token_type": "YES",
"amount": 2000,
"avg_price": 4000,
"pnl": 1200,
"won_side": 0,
"closed_at": "2026-04-02T18:30:00Z",
"event_id": 8,
"event_name": "Will BTC hit $100K in Q1?",
"pool_id": 3,
"pool_name": "Crypto",
"market_name": "BTC > $100K"
},
{
"id": 402,
"user_id": 7,
"market_id": 35,
"token_type": "NO",
"amount": 500,
"avg_price": 6000,
"pnl": -500,
"won_side": 0,
"closed_at": "2026-04-01T10:00:00Z",
"event_id": 9,
"event_name": "Premier League: Liverpool vs Arsenal",
"pool_id": 6,
"pool_name": "Football",
"market_name": "Liverpool wins"
}
],
"next_cursor": "eyJpZCI6NDAyfQ==",
"has_more": true
}
Поля ответа
| Поле | Тип | Описание |
|---|---|---|
positions | array | Массив объектов ClosedPositionWithDetails. |
next_cursor | string | Курсор для следующей страницы. null, если результатов больше нет. |
has_more | bool | Есть ли ещё позиции за пределами текущей страницы. |
ClosedPositionWithDetails
| Поле | Тип | Описание |
|---|---|---|
id | int64 | Уникальный идентификатор позиции. |
user_id | int64 | ID владельца позиции. |
market_id | int64 | Рынок, на котором была позиция. |
token_type | string | "YES" или "NO". |
amount | int | Количество акций в позиции. |
avg_price | int | Средняя цена входа в базисных пунктах. |
pnl | int | Реализованная прибыль/убыток в центах. |
won_side | string | Выигравшая сторона рынка при разрешении. |
closed_at | string | Временная метка закрытия позиции в формате ISO 8601. |
event_id | int64 | ID родительского события. |
event_name | string | Название родительского события. |
pool_id | int64 | ID родительского пула. |
pool_name | string | Название родительского пула. |
market_name | string | Название рынка. |
Ошибки
| Статус | Код | Описание |
|---|---|---|
| 401 | UNAUTHORIZED | Отсутствует или недействителен Bearer-токен. |