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 — ідентифікатори найновіших записів 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"