API

Ринкові дані

Публічні ринкові дані Seeryx через REST: ринки, поточний раунд, історія раундів, книги ордерів, угоди, обсяг, подієві ринки та їхні питання.

Огляд

Усі ендпоінти ринкових даних публічні: без входу й без ключа. Відповіді — у JSON; ціни в центах, обсяги в частках.

Що вам потрібно	Виклик
Усі криптовалютні ринки з поточним раундом і найкращими цінами — одним запитом	`GET /api/markets/summary`
Поточний раунд одного ринку	`GET /api/markets/BTC/5m/current`
Раунд за slug — минулий, поточний або майбутній	`GET /api/rounds/:slug`
Повна книга ордерів одного ринку	`GET /api/orderbook/:slug?side=up`
Угоди в міру їх укладання	Підписка WebSocket на раунд; `GET /api/trades/:slug`, щоб надолужити пропущене
Подієві ринки та їхні питання	`GET /api/events`, `GET /api/event-groups`

Ринки й раунди

Криптовалютні ринки та їхні раунди. Раунди можна читати за ринком (поточний раунд, історія завершених) або за slug.

GET/api/markets

Усі криптовалютні ринки

Публічний

Запит

curl "https://seeryx.com/api/markets"

Відповідь

[{ "asset": "BTC", "tf": "5m", "symbol": "BTCUSDT", "duration": 300, "liquidityRewards": true },
 { "asset": "BTC", "tf": "1h", "symbol": "BTCUSDT", "duration": 3600, "liquidityRewards": false },
 { "asset": "BTC", "tf": "1d", "symbol": "BTCUSDT", "duration": 86400, "liquidityRewards": false }, ...]

duration — тривалість раунду в секундах; symbol — пара Binance, ціна якої визначає результати раундів. liquidityRewards: ордери в книзі на цьому ринку приносять бали за ліквідність (див. «Бот для маркетмейкінгу»).

GET/api/markets/upcoming

Анонсовані ринки, які ще не торгуються

Публічний

Запит

curl "https://seeryx.com/api/markets/upcoming"

Відповідь

[{ "asset": "BTC", "tf": "1d", "opensAt": 1791993600 }]

Ринок з’являється в GET /api/markets з першого свого раунду; до того він указаний тут із часом початку цього раунду. Зазвичай список порожній.

GET/api/markets/summary

Усі ринки одразу: поточний раунд, найкращі ціни, останні результати

Публічний

Запит

curl "https://seeryx.com/api/markets/summary"

Відповідь

{ "at": 1791915884702, "markets": [{ "asset": "BTC", "tf": "5m",
  "round": { "slug": "btc-updown-5m-1791915600", "asset": "BTC", "tf": "5m", "start": 1791915600, "end": 1791915900, "open": 83189.47, "close": null, "outcome": null, "status": "live" },
  "up": { "bid": [52, 120], "ask": [54, 80] }, "down": { "bid": [46, 80], "ask": [48, 120] },
  "last": [{ "start": 1791915300, "end": 1791915600, "outcome": "up" }, ...] }, ...] }

Найкращі ціни купівлі й продажу кожної сторони як [центи, частки] або null, якщо сторона порожня, і 5 останніх завершених раундів, найновіші першими. Оновлюється не частіше ніж раз на секунду: опитуйте цей ендпоінт замість книги кожного ринку окремо.

GET/api/markets/:asset/:tf/current

Поточний раунд ринку

Публічний

Поле	Тип	Опис
`asset`шляхобов’язкове	BTC \| ETH \| BNB	У будь-якому регістрі
`tf`шляхобов’язкове	5m \| 15m \| 1h \| 1d	Тривалість раунду

Запит

curl "https://seeryx.com/api/markets/BTC/5m/current"

Відповідь

{ "slug": "btc-updown-5m-1791916200", "asset": "BTC", "tf": "5m", "start": 1791916200, "end": 1791916500,
  "open": 83082.005, "close": null, "outcome": null, "status": "live" }

Раунд, що вже завершився, залишається "live" з outcome null, доки не збережено ціну закриття, — зазвичай кілька секунд: перевіряйте end і не вважайте, що він ще торгується.

Статус	Коли
404	Такого ринку немає

GET/api/markets/:asset/:tf/rounds

Завершені раунди ринку, найновіші першими

Публічний

Поле	Тип	Опис
`asset`шляхобов’язкове	BTC \| ETH \| BNB	У будь-якому регістрі
`tf`шляхобов’язкове	5m \| 15m \| 1h \| 1d	Тривалість раунду
`before`рядок запитунеобов’язкове	number	Раунди, що починаються раніше за цей момент, секунди Unix; за замовчуванням — зараз
`limit`рядок запитунеобов’язкове	number	1–100, за замовчуванням 24

Запит

curl "https://seeryx.com/api/markets/BTC/5m/rounds?limit=2"

Відповідь

[{ "slug": "btc-updown-5m-1791915600", "asset": "BTC", "tf": "5m", "start": 1791915600, "end": 1791915900, "open": 83189.465, "close": 83133.425, "outcome": "down", "status": "settled" }, ...]

Для наступної сторінки передайте початок останнього раунду як before. Не далі ніж на 7 днів назад.

Статус	Коли
429	Забагато запитів історії з вашої IP-адреси; Retry-After указує, коли спробувати знову

GET/api/rounds/:slug

Один раунд — минулий, поточний або майбутній

Публічний

Поле	Тип	Опис
`slug`шляхобов’язкове	string	Slug раунду, наприклад btc-updown-5m-1791916200, або slug подієвого ринку (ev-...)

Запит

curl "https://seeryx.com/api/rounds/btc-updown-5m-1791916500"

Відповідь

{ "slug": "btc-updown-5m-1791916500", "asset": "BTC", "tf": "5m", "start": 1791916500, "end": 1791916800, "open": null, "close": null, "outcome": null, "status": "upcoming" }

Відповідає для кожного раунду, що торгується: поточного й десяти наступних на ринку 5m або 15m (одного наступного для 1h і 1d). Slug події повертає відповідь у формі раунду (tf "event", end = closesAt).

Статус	Коли
400	"Round too far in future" або "Invalid round slug"
404	Минулий раунд, який не збережено

GET/api/rounds/:slug/holders

Найбільші власники «Вгору» і «Вниз»

Публічний

Поле	Тип	Опис
`slug`шляхобов’язкове	string	Slug раунду, наприклад btc-updown-5m-1791916200, або slug подієвого ринку (ev-...)

Запит

curl "https://seeryx.com/api/rounds/btc-updown-5m-1791916200/holders"

Відповідь

{ "up": { "count": 2, "holders": [{ "name": "alice", "handle": "alice", "address": "7xKXtg...gAsU", "avatar": null, "shares": 250.5 }] }, "down": { "count": 0, "holders": [] } }

count — усі акаунти, що мають цю сторону; holders — 50 найбільших за кількістю часток. Позиції публічні, як і в профілях. Кешується на 5 секунд.

GET/api/rounds/:slug/activity

Останні 100 угод ринку з тими, хто їх виконав

Публічний

Поле	Тип	Опис
`slug`шляхобов’язкове	string	Slug раунду, наприклад btc-updown-5m-1791916200, або slug подієвого ринку (ev-...)

Запит

curl "https://seeryx.com/api/rounds/btc-updown-5m-1791916200/activity"

Відповідь

[{ "id": 812, "side": "up", "action": "buy", "shares": 20, "price": 47, "time": 1791916330063, "trader": { "name": "alice", "handle": "alice", "address": "7xKXtg...gAsU", "avatar": null }, "tx": "5Kq3...", "txStatus": "confirmed" }]

Ті самі угоди, що й у /trades/:slug, найновіші першими, кожна з публічним профілем її тейкера. tx — транзакція угоди в мережі Solana, щойно вона з’являється, з txStatus pending, confirmed або failed.

Книга ордерів, угоди й комісії

Кожен ендпоінт цього розділу приймає slug раунду або slug подієвого ринку.

GET/api/orderbook/:slug

Книга ордерів однієї сторони

Публічний

Поле	Тип	Опис
`slug`шляхобов’язкове	string	Slug раунду, наприклад btc-updown-5m-1791916200, або slug подієвого ринку (ev-...)
`side`рядок запитунеобов’язкове	up \| down	За замовчуванням up (для подієвого ринку up — це YES, down — NO)

Запит

curl "https://seeryx.com/api/orderbook/btc-updown-5m-1791916200?side=up"

Відповідь

{ "bids": [[17, 5], [16, 5], [15, 5]], "asks": [[26, 5], [27, 5], [28, 5]] }

Рівні — це [ціна в центах, частки], від найкращого, усі рівні книги. Книги дзеркальні: купівля «Вгору» за p — це продаж «Вниз» за 100 - p, тож кожна з книг показує всі ордери.

GET/api/trades/:slug

Останні 100 угод, найновіші першими

Публічний

Поле	Тип	Опис
`slug`шляхобов’язкове	string	Slug раунду, наприклад btc-updown-5m-1791916200, або slug подієвого ринку (ev-...)

Запит

curl "https://seeryx.com/api/trades/btc-updown-5m-1791916200"

Відповідь

[{ "id": 13, "side": "down", "action": "buy", "shares": 10, "price": 53, "time": 1791916330063 }]

side, action і price (центи) належать ордеру тейкера; time — у мілісекундах Unix.

GET/api/volume/:slug

Обсяг і кількість угод

Публічний

Поле	Тип	Опис
`slug`шляхобов’язкове	string	Slug раунду, наприклад btc-updown-5m-1791916200, або slug подієвого ринку (ev-...)

Запит

curl "https://seeryx.com/api/volume/btc-updown-5m-1791916200"

Відповідь

{ "volume": 55.845724, "trades": 13 }

volume — у USDC.

GET/api/fees

Розмір комісії тейкера, повернення мейкеру й мінімальний ордер

Публічний

Запит

curl "https://seeryx.com/api/fees"

Відповідь

{ "rateBps": 700, "rebateBps": 2000, "minOrderShares": 5 }

Тейкер сплачує shares × rateBps/10000 × p × (1 − p), де p — ціна в доларах; мейкеру повертається rebateBps/10000 цієї суми. Див. «Комісії».

GET/api/notice

Оголошення для всіх трейдерів, якщо воно є

Публічний

Запит

curl "https://seeryx.com/api/notice"

Відповідь

{ "notice": null }

Інакше { "text": "...", "level": "info" | "warning", "at": <ms> }. Поки торгівлю зупинено, ордери, розділення й об’єднання відповідають 503 trading_halted; скасування й далі працюють.

GET/api/stats

Обсяг, угоди й трейдери за 24 години — за кожним ринком і загалом

Публічний

Запит

curl "https://seeryx.com/api/stats"

Відповідь

{ "volume24h": 41.493814, "trades24h": 16, "traders24h": 3,
  "markets": { "btc-5m": { "volume24h": 41.493814, "trades24h": 16, "traders24h": 3 } } }

Кешується на 5 секунд.

Питання «Так/Ні», результати яких визначає Optimistic Oracle протоколу UMA. Подієвий ринок торгується як один довгий раунд: його slug працює з книгою ордерів, угодами, обсягом, ордерами й WebSocket. Up — це YES, Down — NO.

GET/api/events

Усі подієві ринки

Публічний

Запит

curl "https://seeryx.com/api/events"

Відповідь

[{ "slug": "ev-mlb-ws26-brewers", "groupId": "mlb-world-series-2026", "group": "MLB World Series Champion 2026", "title": "Milwaukee Brewers",
  "question": "Will the Milwaukee Brewers win the 2026 World Series?", "rules": "...", "category": "sports",
  "closesAt": 1792796400, "createdAt": 1791840170963, "status": "open", "outcome": null, "oracle": { "kind": "uma-oov3", ... } }, ...]

status: open, closed (торги завершено, очікування UMA) або resolved; outcome "yes" або "no", щойно результат визначено. closesAt (секунди Unix) — момент, коли торги припиняються.

GET/api/events/:slug

Один подієвий ринок

Публічний

Поле	Тип	Опис
`slug`шляхобов’язкове	string	ev-...

Запит

curl "https://seeryx.com/api/events/ev-mlb-ws26-brewers"

Відповідь

{ "slug": "ev-mlb-ws26-brewers", "title": "Milwaukee Brewers", "closesAt": 1792796400, "status": "open", "outcome": null, ... }

Статус	Коли
404	Це не подієвий ринок

GET/api/event-groups

Питання з їхніми варіантами й цінами

Публічний

Поле	Тип	Опис
`category`рядок запитунеобов’язкове	finance \| politics \| sports \| esports \| weather	Необов’язково

Запит

curl "https://seeryx.com/api/event-groups?category=politics"

Відповідь

[{ "id": "us-aliens-2026", "category": "politics", "title": "Will the US confirm that aliens exist before 2027?", "status": "open",
  "outcomes": [{ "slug": "ev-us-aliens-dec31", "label": "Before 2027", "closesAt": 1798779540, "status": "open", "outcome": null,
    "yes": { "bid": 1, "ask": 5 }, "no": { "bid": 95, "ask": 99 }, "chance": 3, "change24h": null, "history": [[1791830000, 3]] }] }]

Питання об’єднує один або кілька подієвих ринків (свої варіанти). history — точки [секунди Unix, центи] за тиждень.

GET/api/event-groups/:id

Одне питання з його варіантами

Публічний

Поле	Тип	Опис
`id`шляхобов’язкове	string	Ідентифікатор питання або slug одного з його варіантів
`range`рядок запитунеобов’язкове	1h \| 1d \| 1w \| 1m \| max	Історія цін, за замовчуванням 1m

Запит

curl "https://seeryx.com/api/event-groups/us-aliens-2026?range=1w"

Відповідь

{ "id": "us-aliens-2026", "title": "Will the US confirm that aliens exist before 2027?", "outcomes": [...], "seriesGroups": [...] }

Статус	Коли
404	Невідоме питання

GET/api/event-groups/:id/holders

Найбільші власники кожного варіанта

Публічний

Поле	Тип	Опис
`id`шляхобов’язкове	string	Ідентифікатор питання

Запит

curl "https://seeryx.com/api/event-groups/us-aliens-2026/holders"

Відповідь

[{ "slug": "ev-us-aliens-dec31", "label": "Before 2027", "yes": [], "no": [] }]

Десять найбільших позицій YES і десять найбільших позицій NO кожного варіанта.

Огляд

Ринки й раунди

Книга ордерів, угоди й комісії

Подієві ринки