API

Konto

Dein Seeryx-Konto per Code lesen: Guthaben, Positionen, offene Orders, Aktivität, abgerechnete Runden, G/V sowie öffentliche Profile und die Rangliste.

Überblick

Ein Aufruf für den Zustand. GET /api/account liefert Guthaben, Positionen und offene Orders aus einem konsistenten Snapshot: dasselbe Objekt, das der WebSocket bei jeder Änderung sendet.
Der Verlauf ist seitenweise. /api/activity, /api/settled und /api/feed liefern das Neueste zuerst, mit einem Cursor. heads im Konto-Snapshot zeigt dir, wann es etwas Neues zu lesen gibt.
Gebühren in deinem Verlauf. Jede Aktivitätszeile hat fee: positiv für eine gezahlte Taker-Gebühr, negativ für eine erhaltene Maker-Rückvergütung. /api/pnl summiert beides.
Öffentliche Profile. Jede Person kann die Ergebnisse, Positionen und Trades eines Traders lesen; Guthaben, Einzahlungen und offene Orders bleiben privat.

Konto-Endpunkte

Nur das angemeldete Konto. Geld in USDC, Anteile mit bis zu 4 Nachkommastellen, Preise in Cent, Zeiten in Unix-Millisekunden.

GET/api/account

Guthaben, Positionen und offene Orders in einem Aufruf

Angemeldet

Anfrage

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

Antwort

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

Ein konsistenter Snapshot, dasselbe Objekt, das der WebSocket sendet. heads sind die neuesten IDs von activity und settled: Wenn sich eine ändert, lies /activity oder /settled erneut.

GET/api/balance

Guthaben

Angemeldet

Anfrage

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

Antwort

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

Offene Kauforders blockieren kein Guthaben; locked ist immer 0. Die Guthabenregel steht unter „Handel“.

GET/api/positions

Offene Positionen

Angemeldet

Anfrage

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

Antwort

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

cost ist, was die Anteile in USDC gekostet haben, inklusive Gebühren und Rückvergütungen.

GET/api/orders

Offene Orders, die neuesten zuerst

Angemeldet

Anfrage

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

Antwort

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

shares ist, was noch offen ist; limit in Cent.

GET/api/activity

Trades, Aufteilungen, Zusammenlegungen, Auszahlungen und Stornierungen, die neuesten zuerst

Angemeldet

Feld	Typ	Beschreibung
`limit`Abfrageoptional	number	Zeilen pro Seite, 1–200
`before`Abfrageoptional	number	Cursor: nextBefore der vorherigen Seite
`paged`Abfrageoptional	1	Antwort { items, nextBefore }; ohne ihn ein einfaches Array der neuesten Zeilen
`slug`Abfrageoptional	string	Eine Runde oder ein Ereignismarkt
`prefix`Abfrageoptional	string	Ein Markt, z. B. btc-updown-5m-

Anfrage

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

Antwort

{ "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 oder revert (ein vom Programm abgelehnter, rückgängig gemachter Trade). nextBefore null bedeutet die letzte Seite.
amount ist die Änderung des Guthabens, inklusive Gebühren; fee ist die gezahlte Taker-Gebühr (positiv) oder die erhaltene Maker-Rückvergütung (negativ), null, wenn es keine gibt. tx ist die Solana-Transaktion, die die Zeile abgewickelt hat, mit txStatus pending, confirmed oder failed.

GET/api/settled

Abgerechnete Positionen, die neuesten zuerst

Angemeldet

Feld	Typ	Beschreibung
`limit`Abfrageoptional	number	Zeilen pro Seite, 1–200
`before`Abfrageoptional	number	Cursor: nextBefore der vorherigen Seite
`paged`Abfrageoptional	1	Wie bei /activity
`slug`Abfrageoptional	string	Eine Runde
`prefix`Abfrageoptional	string	Ein Markt

Anfrage

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

Antwort

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

Ein Eintrag ist eine Runde. Eine auf beiden Seiten gehaltene Runde ist ein Eintrag: hedged true, side null, cost und payout beider Seiten zusammen.

GET/api/feed

Trades und Einzahlungen oder Abhebungen in einer Liste, die neuesten zuerst

Angemeldet

Feld	Typ	Beschreibung
`limit`Abfrageoptional	number	1–200, Standard 100
`before`Abfrageoptional	string	Cursor: next der vorherigen Seite

Anfrage

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

Antwort

{ "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

Realisierter Gewinn und Verlust, Gebühren, Trefferquote und ein Chart

Angemeldet

Feld	Typ	Beschreibung
`period`Abfrageoptional	1D \| 1W \| 1M \| ALL	Standard ALL
`from`Abfrageoptional	number	Statt period: Beginn, Unix-ms
`to`Abfrageoptional	number	Ende, Unix-ms, Standard jetzt
`buckets`Abfrageoptional	number	Chartpunkte, 1–200, Standard 60

Anfrage

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

Antwort

{ "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 sind die von dir gezahlten Taker-Gebühren, fees.rebates die erhaltenen Maker-Rückvergütungen. Steigt und Fällt, die zusammen in einer Runde gehalten werden, zählen als eine Position.

GET/api/transactions

Letzte Einzahlungen und Abhebungen

Angemeldet

Feld	Typ	Beschreibung
`limit`Abfrageoptional	number	1–200, Standard 50

Anfrage

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

Antwort

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

Zeiten sind hier UTC-Text.

GET/api/rewards/liquidity

Deine Liquiditätspunkte und was deine Orders im Orderbuch jetzt sammeln

Angemeldet

Anfrage

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

Antwort

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

Die Wertung wird unter „Market-Making-Bot“ erklärt. Tage sind UTC-Tage.

Rangliste und Profile

Öffentlich und schreibgeschützt. Ein Profil zeigt Ergebnisse, Positionen und Trades; Guthaben, Einzahlungen und offene Orders bleiben privat.

GET/api/leaderboard

Die 100 besten Trader nach realisiertem Gewinn und Verlust

Öffentlich

Feld	Typ	Beschreibung
`period`Abfrageoptional	1D \| 1W \| 1M \| ALL	Standard ALL

Anfrage

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

Antwort

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

15 Sekunden zwischengespeichert.

GET/api/profiles

Trader nach Namensanfang oder vollständiger Wallet-Adresse finden

Öffentlich

Feld	Typ	Beschreibung
`q`Abfrageerforderlich	string	sat, @sat oder eine Wallet-Adresse

Anfrage

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

Antwort

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

Höchstens 6 Zeilen.

GET/api/profiles/:handle

Ein Trader

Öffentlich

Feld	Typ	Beschreibung
`handle`Pfaderforderlich	string	Benutzername (Groß-/Kleinschreibung egal) oder die vollständige Wallet-Adresse

Anfrage

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

Antwort

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

Status	Wann
404	Unbekannter Trader

GET/api/profiles/:handle/pnl

Gewinn und Verlust eines Traders (wie /pnl)

Öffentlich

Feld	Typ	Beschreibung
`handle`Pfaderforderlich	string	Benutzername (Groß-/Kleinschreibung egal) oder die vollständige Wallet-Adresse
`period`Abfrageoptional	1D \| 1W \| 1M \| ALL	Standard ALL

Anfrage

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

GET/api/profiles/:handle/positions

Offene Positionen eines Traders (wie /positions)

Öffentlich

Feld	Typ	Beschreibung
`handle`Pfaderforderlich	string	Benutzername (Groß-/Kleinschreibung egal) oder die vollständige Wallet-Adresse

Anfrage

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

GET/api/profiles/:handle/activity

Trades und Auszahlungen eines Traders, ohne Stornierungen

Öffentlich

Feld	Typ	Beschreibung
`handle`Pfaderforderlich	string	Benutzername (Groß-/Kleinschreibung egal) oder die vollständige Wallet-Adresse
`limit`Abfrageoptional	number	Zeilen pro Seite, 1–200
`before`Abfrageoptional	number	Cursor: nextBefore der vorherigen Seite

Anfrage

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

GET/api/profiles/:handle/settled

Abgerechnete Positionen eines Traders (wie /settled)

Öffentlich

Feld	Typ	Beschreibung
`handle`Pfaderforderlich	string	Benutzername (Groß-/Kleinschreibung egal) oder die vollständige Wallet-Adresse
`limit`Abfrageoptional	number	Zeilen pro Seite, 1–200
`before`Abfrageoptional	number	Cursor: nextBefore der vorherigen Seite

Anfrage

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