API

Conto

Leggi il tuo conto Seeryx dal codice: fondi, posizioni, ordini aperti, attività, round risolti, profitti e perdite, profili pubblici e classifica.

Panoramica

Una sola lettura per lo stato. GET /api/account restituisce fondi disponibili, posizioni e ordini aperti da un’unica istantanea coerente: lo stesso oggetto che il WebSocket invia a ogni modifica.
La cronologia è paginata. /api/activity, /api/settled e /api/feed partono dal più recente, con un cursore. heads nell’istantanea del conto ti dice quando c’è qualcosa di nuovo da leggere.
Commissioni nella cronologia. Ogni riga di attività ha fee: positivo per una commissione taker che hai pagato, negativo per un rimborso maker che hai ricevuto. /api/pnl li somma entrambi.
Profili pubblici. Chiunque può leggere i risultati, le posizioni e le operazioni di un trader; fondi disponibili, depositi e ordini aperti restano privati.

Endpoint del conto

Solo il conto con cui hai effettuato l’accesso. Denaro in USDC, azioni fino a 4 decimali, prezzi in centesimi, tempi in millisecondi Unix.

GET/api/account

Fondi disponibili, posizioni e ordini aperti in una sola lettura

Con accesso

Richiesta

curl "https://seeryx.com/api/account" \
  -H "X-Auth-Token: $TOKEN"

Risposta

{ "positions": [{ "slug": "btc-updown-5m-1791916200", "side": "down", "shares": 50.3462, "cost": 18.126554 }],
  "orders": [{ "id": 25538, "slug": "btc-updown-5m-1791916200", "side": "down", "action": "buy", "shares": 10, "limit": 48, "createdAt": 1791916330045 }],
  "balance": { "available": 474.097965, "locked": 0, "total": 474.097965, "currency": "USDC" },
  "heads": { "activity": 116, "settled": null } }

Un’unica istantanea coerente, lo stesso oggetto che invia il WebSocket. heads sono gli id più recenti di activity e settled: quando uno cambia, rileggi /activity o /settled.

GET/api/balance

Fondi disponibili

Con accesso

Richiesta

curl "https://seeryx.com/api/balance" \
  -H "X-Auth-Token: $TOKEN"

Risposta

{ "total": 474.097965, "available": 474.097965, "locked": 0, "currency": "USDC" }

Gli ordini di acquisto aperti non bloccano fondi; locked è sempre 0. Vedi Trading per la regola sui fondi disponibili.

GET/api/positions

Posizioni aperte

Con accesso

Richiesta

curl "https://seeryx.com/api/positions" \
  -H "X-Auth-Token: $TOKEN"

Risposta

[{ "slug": "btc-updown-5m-1791916200", "side": "up", "shares": 10, "cost": 4.665126 }]

cost è quanto sono costate le azioni in USDC, commissioni e rimborsi inclusi.

GET/api/orders

Ordini aperti, dal più recente

Con accesso

Richiesta

curl "https://seeryx.com/api/orders" \
  -H "X-Auth-Token: $TOKEN"

Risposta

[{ "id": 25538, "slug": "btc-updown-5m-1791916200", "side": "down", "action": "buy", "shares": 10, "limit": 48, "createdAt": 1791916330045 }]

shares è la parte ancora aperta; limit in centesimi.

GET/api/activity

Operazioni, divisioni, unioni, pagamenti e annullamenti, dal più recente

Con accesso

Campo	Tipo	Descrizione
`limit`query stringfacoltativo	number	Righe per pagina, da 1 a 200
`before`query stringfacoltativo	number	Cursore: nextBefore della pagina precedente
`paged`query stringfacoltativo	1	Risposta { items, nextBefore }; senza, un semplice array delle ultime righe
`slug`query stringfacoltativo	string	Un round o un mercato su un evento
`prefix`query stringfacoltativo	string	Un mercato, ad es. btc-updown-5m-

Richiesta

curl "https://seeryx.com/api/activity?paged=1&limit=50" \
  -H "X-Auth-Token: $TOKEN"

Risposta

{ "items": [{ "id": 116, "time": 1791916330063, "type": "buy", "slug": "btc-updown-5m-1791916200", "side": "up", "shares": 10, "price": 47, "amount": -4.665126, "pnl": null, "fee": -0.034874, "tx": "5Kq3...", "txStatus": "confirmed" }], "nextBefore": 116 }

type: buy, sell, split, merge, settle, void, cancel, expire o revert (un’operazione rifiutata dal programma e stornata). nextBefore null indica l’ultima pagina.
amount è la variazione dei fondi disponibili, commissioni incluse; fee è la commissione taker pagata (positiva) o il rimborso maker ricevuto (negativo), null se non c’è. tx è la transazione Solana che ha regolato la riga, con txStatus pending, confirmed o failed.

GET/api/settled

Posizioni risolte, dalla più recente

Con accesso

Campo	Tipo	Descrizione
`limit`query stringfacoltativo	number	Righe per pagina, da 1 a 200
`before`query stringfacoltativo	number	Cursore: nextBefore della pagina precedente
`paged`query stringfacoltativo	1	Come in /activity
`slug`query stringfacoltativo	string	Un round
`prefix`query stringfacoltativo	string	Un mercato

Richiesta

curl "https://seeryx.com/api/settled?paged=1" \
  -H "X-Auth-Token: $TOKEN"

Risposta

{ "items": [{ "id": 21, "slug": "btc-updown-5m-1791915600", "side": "up", "shares": 10, "cost": 4.7, "payout": 10, "outcome": "up", "settledAt": 1791915905877, "hedged": false }], "nextBefore": null }

Un elemento è un round. Un round detenuto su entrambi i lati è un solo elemento: hedged true, side null, cost e payout dei due lati insieme.

GET/api/feed

Operazioni e depositi o prelievi in un unico elenco, dal più recente

Con accesso

Campo	Tipo	Descrizione
`limit`query stringfacoltativo	number	Da 1 a 200, predefinito 100
`before`query stringfacoltativo	string	Cursore: next della pagina precedente

Richiesta

curl "https://seeryx.com/api/feed?limit=50" \
  -H "X-Auth-Token: $TOKEN"

Risposta

{ "items": [{ "kind": "trade", "id": 116, "time": 1791916330063, "type": "buy", ... }, { "kind": "transfer", "id": 2, "time": 1791916168000, "type": "deposit", "amount": 500, "status": "completed", ... }], "next": "1791916168000:0:2" }

GET/api/pnl

Profitti e perdite realizzati, commissioni, percentuale di successo e un grafico

Con accesso

Campo	Tipo	Descrizione
`period`query stringfacoltativo	1D \| 1W \| 1M \| ALL	Predefinito: ALL
`from`query stringfacoltativo	number	In alternativa a period: inizio, in ms Unix
`to`query stringfacoltativo	number	Fine, in ms Unix, predefinito adesso
`buckets`query stringfacoltativo	number	Punti del grafico, da 1 a 200, predefinito 60

Richiesta

curl "https://seeryx.com/api/pnl?period=1D" \
  -H "X-Auth-Token: $TOKEN"

Risposta

{ "from": 1791829989226, "to": 1791916389226, "realized": -3.110355, "breakdown": { "sell": 0, "merge": -3.110355, "settle": 0 },
  "events": 53, "trades": 13, "volume": 55.845724, "fees": { "paid": 0.354231, "rebates": 0.29792 },
  "closed": 3, "closedWins": 0, "winRate": 0, "series": [{ "t": 1791916330038, "value": -3.110355 }], "best": {...}, "worst": {...}, ... }

fees.paid sono le commissioni taker che hai pagato, fees.rebates i rimborsi maker che hai ricevuto. Su e Giù detenuti insieme in un round contano come una sola posizione.

GET/api/transactions

Ultimi depositi e prelievi

Con accesso

Campo	Tipo	Descrizione
`limit`query stringfacoltativo	number	Da 1 a 200, predefinito 50

Richiesta

curl "https://seeryx.com/api/transactions" \
  -H "X-Auth-Token: $TOKEN"

Risposta

{ "transactions": [{ "id": 2, "type": "deposit", "currency": "USDC", "amount": 500, "status": "completed", "tx_hash": "4eCe...", "created_at": "2026-10-13 18:29:28", "completed_at": "2026-10-13 18:29:28" }] }

Qui gli orari sono testo in UTC.

GET/api/rewards/liquidity

I tuoi punti di liquidità e quanto guadagnano ora i tuoi ordini in attesa

Con accesso

Richiesta

curl "https://seeryx.com/api/rewards/liquidity" \
  -H "X-Auth-Token: $TOKEN"

Risposta

{ "today": 3.25, "total": 41.8, "since": "2026-10-10", "last7": [{ "day": "2026-10-07", "points": 0 }, ...],
  "ratePerHour": 4.5, "scoringOrders": 3, "twoSidedMarkets": 1, "earns": true,
  "eligibleMarkets": [{ "label": "BTC 5 min", "market": "btc-5m" }, ..., { "label": "Event markets", "market": "events" }],
  "rules": { "maxSpreadCents": 3, "perDollarHour": 0.1, "twoSidedBonus": 0.5, "sampleSeconds": 60, "minRestSeconds": 60, "minValue": 5, "minShares": 5, "sideCap": 500 } }

Il calcolo del punteggio è spiegato in Bot di market making. I giorni sono in UTC.

Classifica e profili

Pubblici e in sola lettura. Un profilo mostra risultati, posizioni e operazioni; fondi disponibili, depositi e ordini aperti restano privati.

GET/api/leaderboard

I 100 migliori trader per profitti e perdite realizzati

Pubblico

Campo	Tipo	Descrizione
`period`query stringfacoltativo	1D \| 1W \| 1M \| ALL	Predefinito: ALL

Richiesta

curl "https://seeryx.com/api/leaderboard?period=1W"

Risposta

{ "period": "1W", "traders": [{ "rank": 1, "name": "satoshi_bot", "handle": "satoshi_bot", "address": "Cp8bSK...z3ji", "avatar": null, "pnl": 53.950184, "volume": 1084.342964, "trades": 542 }] }

In cache per 15 secondi.

GET/api/profiles

Cerca trader per prefisso del nome o indirizzo completo del wallet

Pubblico

Campo	Tipo	Descrizione
`q`query stringobbligatorio	string	sat, @sat o un indirizzo di wallet

Richiesta

curl "https://seeryx.com/api/profiles?q=sat"

Risposta

[{ "name": "satoshi_bot", "handle": "satoshi_bot", "address": "Cp8bSK...z3ji", "avatar": null }]

Al massimo 6 righe.

GET/api/profiles/:handle

Un trader

Pubblico

Campo	Tipo	Descrizione
`handle`percorsoobbligatorio	string	Nome utente (maiuscole o minuscole indifferenti) o l’indirizzo completo del wallet

Richiesta

curl "https://seeryx.com/api/profiles/satoshi_bot"

Risposta

{ "name": "satoshi_bot", "handle": "satoshi_bot", "address": "Cp8bSK...z3ji", "avatar": null, "joined": 1791138618000, "pnl": 29.216906, "volume": 1129.246924, "trades": 549, "openPositions": 0, "markets": 49, "rank": 1, "traders": 4 }

Stato	Quando
404	Trader sconosciuto

GET/api/profiles/:handle/pnl

Profitti e perdite di un trader (come /pnl)

Pubblico

Campo	Tipo	Descrizione
`handle`percorsoobbligatorio	string	Nome utente (maiuscole o minuscole indifferenti) o l’indirizzo completo del wallet
`period`query stringfacoltativo	1D \| 1W \| 1M \| ALL	Predefinito: ALL

Richiesta

curl "https://seeryx.com/api/profiles/satoshi_bot/pnl?period=1M"

GET/api/profiles/:handle/positions

Posizioni aperte di un trader (come /positions)

Pubblico

Campo	Tipo	Descrizione
`handle`percorsoobbligatorio	string	Nome utente (maiuscole o minuscole indifferenti) o l’indirizzo completo del wallet

Richiesta

curl "https://seeryx.com/api/profiles/satoshi_bot/positions"

GET/api/profiles/:handle/activity

Operazioni e pagamenti di un trader, senza annullamenti

Pubblico

Campo	Tipo	Descrizione
`handle`percorsoobbligatorio	string	Nome utente (maiuscole o minuscole indifferenti) o l’indirizzo completo del wallet
`limit`query stringfacoltativo	number	Righe per pagina, da 1 a 200
`before`query stringfacoltativo	number	Cursore: nextBefore della pagina precedente

Richiesta

curl "https://seeryx.com/api/profiles/satoshi_bot/activity?limit=50"

GET/api/profiles/:handle/settled

Posizioni risolte di un trader (come /settled)

Pubblico

Campo	Tipo	Descrizione
`handle`percorsoobbligatorio	string	Nome utente (maiuscole o minuscole indifferenti) o l’indirizzo completo del wallet
`limit`query stringfacoltativo	number	Righe per pagina, da 1 a 200
`before`query stringfacoltativo	number	Cursore: nextBefore della pagina precedente

Richiesta

curl "https://seeryx.com/api/profiles/satoshi_bot/settled"