Начало работы
Seeryx API
Создавайте торговых ботов и приложения на Seeryx: REST API и WebSocket для криптораундов «Вверх/Вниз» и событийных рынков на Solana с выплатами в USDC.
Что можно создать
Seeryx — рынок прогнозов на Solana. Всё, что делает сайт, проходит через один публичный REST API и один WebSocket, и оба открыты для вашего кода: торговых ботов и маркет-мейкеров, дашбордов, оповещений, аналитики или собственного фронтенда. Для рыночных данных аккаунт не нужен; для торговли нужен кошелёк Solana с USDC.
Рынки
| Крипто: Вверх или Вниз | Событийные рынки | |
|---|---|---|
| Вопрос | Закроет ли BTC, ETH или BNB раунд выше цены открытия? | Вопрос «Да/Нет» о событиях в мире: политика, спорт, финансы и не только |
| Раунды | 5 минут, 15 минут, 1 час и 1 день, один за другим; следующие десять 5- и 15-минутных раундов торгуются ещё до начала | Один рынок на исход, открыт до времени закрытия |
| Разрешение | Спотовая цена 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 с сервера, из скрипта или бота. Браузеры на других сайтах вызвать его не могут: API не разрешает запросы с других источников (origin).
Соглашения
| Величина | Единица | Пример |
|---|---|---|
| Деньги | USDC как число JSON, до 6 знаков после запятой | 12.5 |
| Доли | До 4 знаков после запятой | 37.5 |
| Цены | Центы от 1 $: целые центы 1–99, ниже 1¢ и выше 99¢ — с шагом 0,1¢ | 45 — это 0,45 $ |
| Время | Секунды Unix в раундах и slug, миллисекунды Unix в сделках и данных аккаунта | 1791916330063 |
| Раунды | {asset}-updown-{tf}-{start} | btc-updown-5m-1791916200 |
- JSON на входе и на выходе; в запросе с телом отправляйте
Content-Type: application/json. - Каждая ошибка имеет вид
{ "error": "..." }, а там, где программа должна на неё реагировать, — ещё иcode: см. Лимиты запросов и ошибки. - Каждый торговый запрос содержит
Idempotency-Key, поэтому повтор никогда не разместит ордер дважды.