API

Dati di mercato

Dati di mercato pubblici di Seeryx via REST: mercati, round in corso, cronologia dei round, libri ordini, operazioni, volume, mercati sugli eventi e domande.

Panoramica

Ogni endpoint dei dati di mercato è pubblico: nessun accesso, nessuna chiave. Le risposte sono in JSON; i prezzi sono in centesimi, le quantità in azioni.

Ti serve	Chiamata
Ogni mercato crypto con il suo round in corso e i migliori prezzi, in una sola richiesta	`GET /api/markets/summary`
Il round in corso di un mercato	`GET /api/markets/BTC/5m/current`
Un round per slug, passato, in corso o futuro	`GET /api/rounds/:slug`
Il libro ordini completo di un mercato	`GET /api/orderbook/:slug?side=up`
Le operazioni in tempo reale	Iscrizione a un round tramite WebSocket; `GET /api/trades/:slug` per recuperare quelle perse
I mercati sugli eventi e le loro domande	`GET /api/events`, `GET /api/event-groups`

Mercati e round

I mercati crypto e i loro round. I round si leggono per mercato (quello in corso, la cronologia dei round risolti) o per slug.

GET/api/markets

Tutti i mercati crypto

Pubblico

Richiesta

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

Risposta

[{ "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 è la durata del round in secondi; symbol la coppia di Binance il cui prezzo decide i round. liquidityRewards: gli ordini in attesa in questo mercato guadagnano punti di liquidità (vedi Bot di market making).

GET/api/markets/upcoming

Mercati annunciati ma non ancora negoziabili

Pubblico

Richiesta

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

Risposta

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

Un mercato compare in GET /api/markets dal suo primo round; fino ad allora è elencato qui con l’inizio di quel round. Di solito l’elenco è vuoto.

GET/api/markets/summary

Tutti i mercati insieme: round in corso, migliori prezzi, ultimi risultati

Pubblico

Richiesta

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

Risposta

{ "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" }, ...] }, ...] }

Il miglior prezzo in acquisto e in vendita di ogni lato come [centesimi, azioni], null quando quel lato è vuoto, e gli ultimi 5 round risolti, dal più recente. Aggiornato al massimo una volta al secondo: interroga questo endpoint invece di un libro ordini per mercato.

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

Il round in corso di un mercato

Pubblico

Campo	Tipo	Descrizione
`asset`percorsoobbligatorio	BTC \| ETH \| BNB	Maiuscole o minuscole indifferenti
`tf`percorsoobbligatorio	5m \| 15m \| 1h \| 1d	Durata del round

Richiesta

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

Risposta

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

Un round oltre la sua fine resta "live" con outcome null finché il suo prezzo di chiusura non viene registrato, di solito entro pochi secondi: controlla end, non dare per scontato che sia ancora negoziabile.

Stato	Quando
404	Mercato inesistente

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

Round risolti di un mercato, dal più recente

Pubblico

Campo	Tipo	Descrizione
`asset`percorsoobbligatorio	BTC \| ETH \| BNB	Maiuscole o minuscole indifferenti
`tf`percorsoobbligatorio	5m \| 15m \| 1h \| 1d	Durata del round
`before`query stringfacoltativo	number	Round che iniziano prima di questo valore, in secondi Unix; predefinito: adesso
`limit`query stringfacoltativo	number	Da 1 a 100, predefinito 24

Richiesta

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

Risposta

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

Passa l’inizio dell’ultimo round come before per la pagina successiva. Al massimo 7 giorni indietro.

Stato	Quando
429	Troppe letture della cronologia dal tuo indirizzo IP; Retry-After indica quando riprovare

GET/api/rounds/:slug

Un round, passato, in corso o futuro

Pubblico

Campo	Tipo	Descrizione
`slug`percorsoobbligatorio	string	Uno slug di round come btc-updown-5m-1791916200, o lo slug di un mercato su un evento (ev-...)

Richiesta

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

Risposta

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

Risponde per ogni round negoziabile: quello in corso e i dieci successivi di un mercato da 5m o da 15m (il successivo per 1h e 1d). Uno slug di evento risponde nel formato di un round (tf "event", end = closesAt).

Stato	Quando
400	"Round too far in future" o "Invalid round slug"
404	Un round passato che non è registrato

GET/api/rounds/:slug/holders

I maggiori detentori di Su e Giù

Pubblico

Campo	Tipo	Descrizione
`slug`percorsoobbligatorio	string	Uno slug di round come btc-updown-5m-1791916200, o lo slug di un mercato su un evento (ev-...)

Richiesta

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

Risposta

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

count è il numero di tutti i conti che detengono quel lato; holders i 50 maggiori per numero di azioni. Le posizioni sono pubbliche, come nei profili. In cache per 5 secondi.

GET/api/rounds/:slug/activity

Le ultime 100 operazioni di un mercato, con chi le ha eseguite

Pubblico

Campo	Tipo	Descrizione
`slug`percorsoobbligatorio	string	Uno slug di round come btc-updown-5m-1791916200, o lo slug di un mercato su un evento (ev-...)

Richiesta

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

Risposta

[{ "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" }]

Le stesse operazioni di /trades/:slug, dalla più recente, ciascuna con il profilo pubblico del suo taker. tx è la transazione Solana dell’operazione quando esiste, con txStatus pending, confirmed o failed.

Libro ordini, operazioni e commissioni

Ogni endpoint di questa sezione accetta uno slug di round o di mercato su un evento.

GET/api/orderbook/:slug

Il libro ordini di un lato

Pubblico

Campo	Tipo	Descrizione
`slug`percorsoobbligatorio	string	Uno slug di round come btc-updown-5m-1791916200, o lo slug di un mercato su un evento (ev-...)
`side`query stringfacoltativo	up \| down	Predefinito up (per un mercato su un evento: up è YES, down è NO)

Richiesta

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

Risposta

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

I livelli sono [prezzo in centesimi, azioni], dal migliore, tutti i livelli del libro ordini. I due libri ordini sono speculari: una proposta in acquisto di Su a p è una proposta in vendita di Giù a 100 - p, quindi ciascuno dei due mostra tutti gli ordini.

GET/api/trades/:slug

Le ultime 100 operazioni, dalla più recente

Pubblico

Campo	Tipo	Descrizione
`slug`percorsoobbligatorio	string	Uno slug di round come btc-updown-5m-1791916200, o lo slug di un mercato su un evento (ev-...)

Richiesta

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

Risposta

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

side, action e price (centesimi) sono quelli dell’ordine del taker; time è in millisecondi Unix.

GET/api/volume/:slug

Volume e numero di operazioni

Pubblico

Campo	Tipo	Descrizione
`slug`percorsoobbligatorio	string	Uno slug di round come btc-updown-5m-1791916200, o lo slug di un mercato su un evento (ev-...)

Richiesta

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

Risposta

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

volume è in USDC.

GET/api/fees

Aliquota della commissione taker, rimborso maker e ordine minimo

Pubblico

Richiesta

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

Risposta

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

Il taker paga azioni × rateBps/10000 × p × (1 − p), con p il prezzo in dollari; il maker ne riceve indietro rebateBps/10000. Vedi Commissioni.

GET/api/notice

Un avviso a tutti i trader, se presente

Pubblico

Richiesta

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

Risposta

{ "notice": null }

Altrimenti { "text": "...", "level": "info" | "warning", "at": <ms> }. Mentre il trading è sospeso, ordini, divisioni e unioni rispondono 503 trading_halted; gli annullamenti continuano a funzionare.

GET/api/stats

Volume, operazioni e trader delle ultime 24 ore, per mercato e in totale

Pubblico

Richiesta

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

Risposta

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

In cache per 5 secondi.

Domande Sì/No risolte tramite l’Optimistic Oracle di UMA. Un mercato su un evento si negozia come un unico round lungo: il suo slug funziona con libro ordini, operazioni, volume, ordini e WebSocket. up è YES, down è NO.

GET/api/events

Tutti i mercati sugli eventi

Pubblico

Richiesta

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

Risposta

[{ "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 (trading terminato, in attesa di UMA) o resolved; outcome "yes" o "no" una volta risolto. closesAt (secondi Unix) è il momento in cui il trading si ferma.

GET/api/events/:slug

Un mercato su un evento

Pubblico

Campo	Tipo	Descrizione
`slug`percorsoobbligatorio	string	ev-...

Richiesta

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

Risposta

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

Stato	Quando
404	Non è un mercato su un evento

GET/api/event-groups

Domande con i loro esiti e prezzi

Pubblico

Campo	Tipo	Descrizione
`category`query stringfacoltativo	finance \| politics \| sports \| esports \| weather	Facoltativo

Richiesta

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

Risposta

[{ "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]] }] }]

Una domanda raggruppa uno o più mercati sugli eventi (i suoi esiti). history è una settimana di punti [secondi Unix, centesimi].

GET/api/event-groups/:id

Una domanda con i suoi esiti

Pubblico

Campo	Tipo	Descrizione
`id`percorsoobbligatorio	string	L’id della domanda, o lo slug di uno dei suoi esiti
`range`query stringfacoltativo	1h \| 1d \| 1w \| 1m \| max	Cronologia dei prezzi, predefinito 1m

Richiesta

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

Risposta

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

Stato	Quando
404	Domanda sconosciuta

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

I maggiori detentori di ogni esito

Pubblico

Campo	Tipo	Descrizione
`id`percorsoobbligatorio	string	L’id della domanda

Richiesta

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

Risposta

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

Le dieci maggiori posizioni YES e le dieci maggiori NO di ogni esito.

Panoramica

Mercati e round

Libro ordini, operazioni e commissioni

Mercati sugli eventi