Початок роботи
Seeryx API
Створюйте торгових ботів і застосунки на Seeryx: REST API і WebSocket для криптораундів «Вгору/Вниз» і подієвих ринків на Solana з виплатами в USDC.
Що можна створити
Seeryx — ринок прогнозів на Solana. Усе, що робить сайт, проходить через один публічний REST API й один WebSocket, і обидва відкриті для вашого коду: торгових ботів і маркетмейкерів, дашбордів, сповіщень, аналітики чи власного фронтенду. Для ринкових даних акаунт не потрібен; для торгівлі потрібен гаманець Solana з USDC.
Ринки
| Криптовалютні «Вгору чи вниз» | Подієві ринки | |
|---|---|---|
| Питання | Чи закриється BTC, ETH або BNB вище за ціну відкриття раунду? | Питання «Так/Ні» про події у світі: політика, спорт, фінанси тощо |
| Раунди | 5 хвилин, 15 хвилин, 1 година й 1 день, один за одним; десять наступних раундів 5m і 15m торгуються ще до свого початку | Один ринок на кожен результат, відкритий до часу закриття |
| Визначення результату | Спотова ціна Binance (середина між найкращими цінами купівлі й продажу) у секунду межі раунду; якщо ціна не змінилася, виграє «Вниз» | Optimistic Oracle протоколу UMA з публічним періодом оскарження |
| Частки | «Вгору» і «Вниз» | «Так» і «Ні» (в API — up і down) |
Ціни вказано в центах долара. Виграшна частка приносить 1,00 $ у USDC, а програшна — нічого, тож ціну 37¢ можна читати як шанс 37%. Докладніше — у розділі «Основні поняття».
Як працює торгівля
- Окрема книга ордерів для кожного ринку. Лімітні ордери стоять у книзі за своєю ціною; ринкові ордери одразу виконуються проти них — спершу за найкращою ціною, потім найстаріші. «Вгору» і «Вниз» — це одна книга, яку видно з двох сторін.
- Ваші гроші залишаються вашими. Поповнення — це USDC на вашому власному рахунку в програмі Seeryx на Solana. Кожне виконання проходить розрахунок у блокчейні, зазвичай за лічені секунди, і вивести ваші кошти може лише виведення, яке підписав ваш гаманець.
- Один підпис на день. Ваш гаманець один раз підтверджує ключ торгової сесії; далі цей ключ підписує кожен ордер без запиту. Він може торгувати в межах своїх лімітів і ніколи не може виводити кошти.
- Комісії. Тейкер сплачує комісію, найбільшу за ціни 50¢ і майже нульову за цін, близьких до 0¢ і 100¢; мейкеру повертається її частина. Див. «Комісії». Комісії мережі Solana сплачує Seeryx, тож вашому гаманцю не потрібен SOL.
Базові URL
- REST
https://seeryx.com/api- WebSocket
wss://seeryx.com/ws- Зараз
- Читаємо GET /api/funds і GET /api/fees…
- Клієнти
- Викликайте API із сервера, скрипту чи бота. Браузери на інших сайтах не можуть його викликати: інші джерела (origin) не дозволено.
Загальні правила
| Величина | Одиниця | Приклад |
|---|---|---|
| Гроші | USDC як число JSON, до 6 знаків після коми | 12.5 |
| Частки | До 4 знаків після коми | 37.5 |
| Ціни | Центи від 1 $: цілі центи від 1 до 99, десяті частки цента нижче 1¢ і вище 99¢ | 45 — це 0,45 $ |
| Час | Секунди Unix у раундах і slug, мілісекунди Unix в угодах і даних акаунта | 1791916330063 |
| Раунди | {asset}-updown-{tf}-{start} | btc-updown-5m-1791916200 |
- JSON на вході й на виході; із тілом запиту надсилайте
Content-Type: application/json. - Кожна помилка має вигляд
{ "error": "..." }, а там, де програма має на неї реагувати, — ще йcode: див. «Ліміти запитів і помилки». - Кожен торговий запит містить
Idempotency-Key, тож повторна спроба ніколи не розмістить ордер двічі.