API

Аккаунт

Аккаунт Seeryx из кода: средства, позиции, открытые ордера, активность, рассчитанные раунды, прибыль/убыток, публичные профили и рейтинг.

Обзор

Одно чтение — всё состояние. GET /api/account возвращает средства, позиции и открытые ордера из одного согласованного снимка — это тот же объект, который WebSocket присылает при каждом изменении.
История разбита на страницы. /api/activity, /api/settled и /api/feed отдают записи от новых к старым с курсором. heads в снимке аккаунта показывает, когда появилось что-то новое.
Комиссии в истории. У каждой строки активности есть fee: положительное значение — уплаченная комиссия тейкера, отрицательное — полученный возврат мейкеру. /api/pnl суммирует и то и другое.
Публичные профили. Результаты, позиции и сделки любого трейдера может посмотреть кто угодно; средства, пополнения и открытые ордера остаются закрытыми.

Эндпоинты аккаунта

Только аккаунт, в который выполнен вход. Деньги в USDC, доли — до 4 знаков после запятой, цены в центах, время в миллисекундах Unix.

GET/api/account

Средства, позиции и открытые ордера одним чтением

Нужен вход

Запрос

curl "https://seeryx.com/api/account" \
  -H "X-Auth-Token: $TOKEN"

Ответ

{ "positions": [{ "slug": "btc-updown-5m-1791916200", "side": "down", "shares": 50.3462, "cost": 18.126554 }],
  "orders": [{ "id": 25538, "slug": "btc-updown-5m-1791916200", "side": "down", "action": "buy", "shares": 10, "limit": 48, "createdAt": 1791916330045 }],
  "balance": { "available": 474.097965, "locked": 0, "total": 474.097965, "currency": "USDC" },
  "heads": { "activity": 116, "settled": null } }

Один согласованный снимок — тот же объект, который присылает WebSocket. heads — id новейших записей activity и settled: когда один из них меняется, прочитайте /activity или /settled заново.

GET/api/balance

Средства

Нужен вход

Запрос

curl "https://seeryx.com/api/balance" \
  -H "X-Auth-Token: $TOKEN"

Ответ

{ "total": 474.097965, "available": 474.097965, "locked": 0, "currency": "USDC" }

Открытые ордера на покупку не блокируют средства; locked всегда 0. Правило о средствах — в разделе «Торговля».

GET/api/positions

Открытые позиции

Нужен вход

Запрос

curl "https://seeryx.com/api/positions" \
  -H "X-Auth-Token: $TOKEN"

Ответ

[{ "slug": "btc-updown-5m-1791916200", "side": "up", "shares": 10, "cost": 4.665126 }]

cost — сколько стоили доли в USDC, с учётом комиссий и возвратов.

GET/api/orders

Открытые ордера, от новых к старым

Нужен вход

Запрос

curl "https://seeryx.com/api/orders" \
  -H "X-Auth-Token: $TOKEN"

Ответ

[{ "id": 25538, "slug": "btc-updown-5m-1791916200", "side": "down", "action": "buy", "shares": 10, "limit": 48, "createdAt": 1791916330045 }]

shares — то, что ещё открыто; limit в центах.

GET/api/activity

Сделки, разделения, объединения, выплаты и отмены, от новых к старым

Нужен вход

Поле	Тип	Описание
`limit`строка запросанеобязательно	number	Строк на странице, 1–200
`before`строка запросанеобязательно	number	Курсор: nextBefore предыдущей страницы
`paged`строка запросанеобязательно	1	Ответ { items, nextBefore }; без него — простой массив последних строк
`slug`строка запросанеобязательно	string	Один раунд или событийный рынок
`prefix`строка запросанеобязательно	string	Один рынок, например btc-updown-5m-

Запрос

curl "https://seeryx.com/api/activity?paged=1&limit=50" \
  -H "X-Auth-Token: $TOKEN"

Ответ

{ "items": [{ "id": 116, "time": 1791916330063, "type": "buy", "slug": "btc-updown-5m-1791916200", "side": "up", "shares": 10, "price": 47, "amount": -4.665126, "pnl": null, "fee": -0.034874, "tx": "5Kq3...", "txStatus": "confirmed" }], "nextBefore": 116 }

type: buy, sell, split, merge, settle, void, cancel, expire или revert (сделка, отклонённая программой и отменённая). nextBefore null означает последнюю страницу.
amount — изменение средств с учётом комиссий; fee — уплаченная комиссия тейкера (положительное значение) или полученный возврат мейкеру (отрицательное), null, если её нет. tx — транзакция Solana, по которой прошёл расчёт строки, с txStatus pending, confirmed или failed.

GET/api/settled

Рассчитанные позиции, от новых к старым

Нужен вход

Поле	Тип	Описание
`limit`строка запросанеобязательно	number	Строк на странице, 1–200
`before`строка запросанеобязательно	number	Курсор: nextBefore предыдущей страницы
`paged`строка запросанеобязательно	1	Как в /activity
`slug`строка запросанеобязательно	string	Один раунд
`prefix`строка запросанеобязательно	string	Один рынок

Запрос

curl "https://seeryx.com/api/settled?paged=1" \
  -H "X-Auth-Token: $TOKEN"

Ответ

{ "items": [{ "id": 21, "slug": "btc-updown-5m-1791915600", "side": "up", "shares": 10, "cost": 4.7, "payout": 10, "outcome": "up", "settledAt": 1791915905877, "hedged": false }], "nextBefore": null }

Один элемент — один раунд. Раунд, в котором у вас были обе стороны, — тоже один элемент: hedged true, side null, cost и payout обеих сторон вместе.

GET/api/feed

Сделки и пополнения или выводы одним списком, от новых к старым

Нужен вход

Поле	Тип	Описание
`limit`строка запросанеобязательно	number	1–200, по умолчанию 100
`before`строка запросанеобязательно	string	Курсор: next предыдущей страницы

Запрос

curl "https://seeryx.com/api/feed?limit=50" \
  -H "X-Auth-Token: $TOKEN"

Ответ

{ "items": [{ "kind": "trade", "id": 116, "time": 1791916330063, "type": "buy", ... }, { "kind": "transfer", "id": 2, "time": 1791916168000, "type": "deposit", "amount": 500, "status": "completed", ... }], "next": "1791916168000:0:2" }

GET/api/pnl

Реализованная прибыль и убыток, комиссии, процент выигрышей и график

Нужен вход

Поле	Тип	Описание
`period`строка запросанеобязательно	1D \| 1W \| 1M \| ALL	По умолчанию ALL
`from`строка запросанеобязательно	number	Вместо period: начало, мс Unix
`to`строка запросанеобязательно	number	Конец, мс Unix, по умолчанию — сейчас
`buckets`строка запросанеобязательно	number	Точек графика, 1–200, по умолчанию 60

Запрос

curl "https://seeryx.com/api/pnl?period=1D" \
  -H "X-Auth-Token: $TOKEN"

Ответ

{ "from": 1791829989226, "to": 1791916389226, "realized": -3.110355, "breakdown": { "sell": 0, "merge": -3.110355, "settle": 0 },
  "events": 53, "trades": 13, "volume": 55.845724, "fees": { "paid": 0.354231, "rebates": 0.29792 },
  "closed": 3, "closedWins": 0, "winRate": 0, "series": [{ "t": 1791916330038, "value": -3.110355 }], "best": {...}, "worst": {...}, ... }

fees.paid — уплаченные вами комиссии тейкера, fees.rebates — полученные возвраты мейкеру. «Вверх» и «Вниз», которые вы держите вместе в одном раунде, считаются одной позицией.

GET/api/transactions

Последние пополнения и выводы

Нужен вход

Поле	Тип	Описание
`limit`строка запросанеобязательно	number	1–200, по умолчанию 50

Запрос

curl "https://seeryx.com/api/transactions" \
  -H "X-Auth-Token: $TOKEN"

Ответ

{ "transactions": [{ "id": 2, "type": "deposit", "currency": "USDC", "amount": 500, "status": "completed", "tx_hash": "4eCe...", "created_at": "2026-10-13 18:29:28", "completed_at": "2026-10-13 18:29:28" }] }

Время здесь — текст в UTC.

GET/api/rewards/liquidity

Ваши баллы за ликвидность и то, что ваши ордера в стакане зарабатывают сейчас

Нужен вход

Запрос

curl "https://seeryx.com/api/rewards/liquidity" \
  -H "X-Auth-Token: $TOKEN"

Ответ

{ "today": 3.25, "total": 41.8, "since": "2026-10-10", "last7": [{ "day": "2026-10-07", "points": 0 }, ...],
  "ratePerHour": 4.5, "scoringOrders": 3, "twoSidedMarkets": 1, "earns": true,
  "eligibleMarkets": [{ "label": "BTC 5 min", "market": "btc-5m" }, ..., { "label": "Event markets", "market": "events" }],
  "rules": { "maxSpreadCents": 3, "perDollarHour": 0.1, "twoSidedBonus": 0.5, "sampleSeconds": 60, "minRestSeconds": 60, "minValue": 5, "minShares": 5, "sideCap": 500 } }

Начисление описано на странице «Бот для маркет-мейкинга». Дни считаются по UTC.

Рейтинг и профили

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

GET/api/leaderboard

Топ-100 трейдеров по реализованной прибыли и убытку

Публичный

Поле	Тип	Описание
`period`строка запросанеобязательно	1D \| 1W \| 1M \| ALL	По умолчанию ALL

Запрос

curl "https://seeryx.com/api/leaderboard?period=1W"

Ответ

{ "period": "1W", "traders": [{ "rank": 1, "name": "satoshi_bot", "handle": "satoshi_bot", "address": "Cp8bSK...z3ji", "avatar": null, "pnl": 53.950184, "volume": 1084.342964, "trades": 542 }] }

Кэшируется на 15 секунд.

GET/api/profiles

Найти трейдеров по началу имени или полному адресу кошелька

Публичный

Поле	Тип	Описание
`q`строка запросаобязательно	string	sat, @sat или адрес кошелька

Запрос

curl "https://seeryx.com/api/profiles?q=sat"

Ответ

[{ "name": "satoshi_bot", "handle": "satoshi_bot", "address": "Cp8bSK...z3ji", "avatar": null }]

Не более 6 строк.

GET/api/profiles/:handle

Трейдер

Публичный

Поле	Тип	Описание
`handle`путьобязательно	string	Имя пользователя (в любом регистре) или полный адрес кошелька

Запрос

curl "https://seeryx.com/api/profiles/satoshi_bot"

Ответ

{ "name": "satoshi_bot", "handle": "satoshi_bot", "address": "Cp8bSK...z3ji", "avatar": null, "joined": 1791138618000, "pnl": 29.216906, "volume": 1129.246924, "trades": 549, "openPositions": 0, "markets": 49, "rank": 1, "traders": 4 }

Статус	Когда
404	Неизвестный трейдер

GET/api/profiles/:handle/pnl

Прибыль и убыток трейдера (как /pnl)

Публичный

Поле	Тип	Описание
`handle`путьобязательно	string	Имя пользователя (в любом регистре) или полный адрес кошелька
`period`строка запросанеобязательно	1D \| 1W \| 1M \| ALL	По умолчанию ALL

Запрос

curl "https://seeryx.com/api/profiles/satoshi_bot/pnl?period=1M"

GET/api/profiles/:handle/positions

Открытые позиции трейдера (как /positions)

Публичный

Поле	Тип	Описание
`handle`путьобязательно	string	Имя пользователя (в любом регистре) или полный адрес кошелька

Запрос

curl "https://seeryx.com/api/profiles/satoshi_bot/positions"

GET/api/profiles/:handle/activity

Сделки и выплаты трейдера, без отмен

Публичный

Поле	Тип	Описание
`handle`путьобязательно	string	Имя пользователя (в любом регистре) или полный адрес кошелька
`limit`строка запросанеобязательно	number	Строк на странице, 1–200
`before`строка запросанеобязательно	number	Курсор: nextBefore предыдущей страницы

Запрос

curl "https://seeryx.com/api/profiles/satoshi_bot/activity?limit=50"

GET/api/profiles/:handle/settled

Рассчитанные позиции трейдера (как /settled)

Публичный

Поле	Тип	Описание
`handle`путьобязательно	string	Имя пользователя (в любом регистре) или полный адрес кошелька
`limit`строка запросанеобязательно	number	Строк на странице, 1–200
`before`строка запросанеобязательно	number	Курсор: nextBefore предыдущей страницы

Запрос

curl "https://seeryx.com/api/profiles/satoshi_bot/settled"