Per iniziare
Seeryx API
Crea bot e app di trading su Seeryx: un’API REST e un WebSocket per i round crypto Su/Giù e i mercati sugli eventi su Solana, con pagamenti in USDC.
Cosa puoi creare
Seeryx è un mercato predittivo su Solana. Tutto ciò che fa il sito passa per un’unica API REST pubblica e un unico WebSocket, ed entrambi sono aperti al tuo codice: bot di trading e market maker, dashboard, avvisi, analisi o un tuo front end. I dati di mercato non richiedono un conto; per fare trading serve un wallet Solana con USDC.
Mercati
| Crypto Su o Giù | Mercati sugli eventi | |
|---|---|---|
| Domanda | BTC, ETH o BNB chiuderanno il round sopra il prezzo di apertura? | Una domanda Sì/No su ciò che accade nel mondo: politica, sport, finanza e altro |
| Round | 5 minuti, 15 minuti, 1 ora e 1 giorno, uno dopo l’altro; i prossimi dieci round da 5m e da 15m sono già negoziabili prima di iniziare | Un mercato per esito, aperto fino all’ora di chiusura |
| Risoluzione | Il prezzo spot di Binance (il punto medio tra il miglior prezzo in acquisto e il miglior prezzo in vendita) nel secondo esatto di apertura o di chiusura; se il prezzo resta invariato, vince Giù | L’Optimistic Oracle di UMA, con una finestra di contestazione pubblica |
| Azioni | Su e Giù | Sì e No (up e down nell’API) |
I prezzi sono in centesimi di dollaro. Un’azione vincente paga 1,00 $ in USDC e una perdente nulla, quindi un prezzo di 37¢ si legge come una probabilità del 37%. Dettagli in Concetti.
Come funziona il trading
- Un libro ordini per mercato. Gli ordini limite restano in attesa al loro prezzo; gli ordini a mercato vengono eseguiti subito contro di essi, prima al prezzo migliore, poi contro l’ordine più vecchio. Su e Giù sono un unico libro ordini visto dai due lati.
- I tuoi fondi restano tuoi. I depositi sono USDC in un account tutto tuo del programma Seeryx su Solana. Ogni esecuzione viene regolata on-chain, di solito in pochi secondi, e solo un prelievo firmato dal tuo wallet può far uscire i tuoi fondi.
- Una firma al giorno. Il tuo wallet approva una sola volta una chiave di sessione di trading; poi la chiave firma ogni ordine senza richieste di conferma. Può fare trading entro i suoi limiti e non può mai prelevare.
- Commissioni. Il taker paga una commissione che è massima a 50¢ e quasi nulla vicino a 0¢ e 100¢; il maker ne riceve indietro una parte. Vedi Commissioni. Le commissioni di rete di Solana sono pagate da Seeryx, quindi al tuo wallet non servono SOL.
URL di base
- REST
https://seeryx.com/api- WebSocket
wss://seeryx.com/ws- In questo momento
- Lettura di GET /api/funds e GET /api/fees…
- Client
- Chiama l’API da un server, uno script o un bot. I browser su altri siti web non possono chiamarla: non accetta altre origini.
Convenzioni
| Grandezza | Unità | Esempio |
|---|---|---|
| Denaro | USDC come numero JSON, fino a 6 decimali | 12.5 |
| Azioni | Fino a 4 decimali | 37.5 |
| Prezzi | Centesimi di 1 $: centesimi interi da 1 a 99, decimi sotto 1¢ e sopra 99¢ | 45 equivale a 0,45 $ |
| Tempi | Secondi Unix nei round e negli slug, millisecondi Unix nelle operazioni e nei dati del conto | 1791916330063 |
| Round | {asset}-updown-{tf}-{start} | btc-updown-5m-1791916200 |
- JSON in ingresso e in uscita; invia
Content-Type: application/jsonquando c’è un corpo. - Ogni errore è
{ "error": "..." }, con uncodequando un programma deve reagire: vedi Limiti di richieste ed errori. - Ogni richiesta che fa trading include una
Idempotency-Key, così un nuovo tentativo non inserisce mai un ordine due volte.