API

Compte

Lire votre compte Seeryx par le code : liquidités, positions, ordres ouverts, activité, manches réglées, gains et pertes, profils publics et classement.

Vue d’ensemble

Une seule lecture pour l’état. GET /api/account renvoie les liquidités, les positions et les ordres ouverts à partir d’un instantané cohérent : le même objet que le WebSocket transmet à chaque changement.
L’historique est paginé. /api/activity, /api/settled et /api/feed sont triés du plus récent au plus ancien, avec un curseur. heads dans l’instantané du compte vous indique quand il y a du nouveau à lire.
Les frais dans votre historique. Chaque ligne d’activité a un champ fee : positif pour des frais taker payés, négatif pour une remise maker reçue. /api/pnl additionne les deux.
Profils publics. Tout le monde peut consulter les résultats, les positions et les transactions d’un trader ; les liquidités, les dépôts et les ordres ouverts restent privés.

Endpoints du compte

Uniquement le compte connecté. Montants en USDC, parts avec 4 décimales au plus, prix en cents, horodatages en millisecondes Unix.

GET/api/account

Liquidités, positions et ordres ouverts en une seule lecture

Connexion requise

Requête

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

Réponse

{ "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 instantané cohérent, le même objet que celui que transmet le WebSocket. heads contient les id les plus récents de l’activité et des positions réglées : quand l’un d’eux change, relisez /activity ou /settled.

GET/api/balance

Liquidités

Connexion requise

Requête

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

Réponse

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

Les ordres d’achat ouverts ne bloquent pas de liquidités ; locked vaut toujours 0. Voir Trading pour la règle des liquidités.

GET/api/positions

Positions ouvertes

Connexion requise

Requête

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

Réponse

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

cost est ce que les parts ont coûté en USDC, frais et remises compris.

GET/api/orders

Ordres ouverts, du plus récent au plus ancien

Connexion requise

Requête

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

Réponse

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

shares est ce qui reste ouvert ; limit en cents.

GET/api/activity

Transactions, scissions, fusions, versements et annulations, du plus récent au plus ancien

Connexion requise

Champ	Type	Description
`limit`requêtefacultatif	number	Lignes par page, de 1 à 200
`before`requêtefacultatif	number	Curseur : nextBefore de la page précédente
`paged`requêtefacultatif	1	Réponse { items, nextBefore } ; sans ce paramètre, un simple tableau des dernières lignes
`slug`requêtefacultatif	string	Une manche ou un marché événementiel
`prefix`requêtefacultatif	string	Un marché, p. ex. btc-updown-5m-

Requête

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

Réponse

{ "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 ou revert (une transaction refusée par le programme, annulée). nextBefore null signifie la dernière page.
amount est la variation des liquidités, frais compris ; fee correspond aux frais taker payés (positif) ou à la remise maker reçue (négatif), null s’il n’y en a pas. tx est la transaction Solana qui a réglé la ligne, avec txStatus pending, confirmed ou failed.

GET/api/settled

Positions réglées, de la plus récente à la plus ancienne

Connexion requise

Champ	Type	Description
`limit`requêtefacultatif	number	Lignes par page, de 1 à 200
`before`requêtefacultatif	number	Curseur : nextBefore de la page précédente
`paged`requêtefacultatif	1	Comme pour /activity
`slug`requêtefacultatif	string	Une manche
`prefix`requêtefacultatif	string	Un marché

Requête

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

Réponse

{ "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 élément correspond à une manche. Une manche détenue des deux côtés forme un seul élément : hedged true, side null, cost et payout des deux côtés réunis.

GET/api/feed

Transactions et dépôts ou retraits dans une seule liste, du plus récent au plus ancien

Connexion requise

Champ	Type	Description
`limit`requêtefacultatif	number	De 1 à 200, 100 par défaut
`before`requêtefacultatif	string	Curseur : next de la page précédente

Requête

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

Réponse

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

Gains et pertes réalisés, frais, taux de réussite et graphique

Connexion requise

Champ	Type	Description
`period`requêtefacultatif	1D \| 1W \| 1M \| ALL	ALL par défaut
`from`requêtefacultatif	number	À la place de period : début, en ms Unix
`to`requêtefacultatif	number	Fin, en ms Unix, maintenant par défaut
`buckets`requêtefacultatif	number	Points du graphique, de 1 à 200, 60 par défaut

Requête

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

Réponse

{ "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 correspond aux frais taker que vous avez payés, fees.rebates aux remises maker que vous avez reçues. Hausse et Baisse détenues ensemble dans une même manche comptent comme une seule position.

GET/api/transactions

Derniers dépôts et retraits

Connexion requise

Champ	Type	Description
`limit`requêtefacultatif	number	De 1 à 200, 50 par défaut

Requête

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

Réponse

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

Les horodatages sont ici du texte en UTC.

GET/api/rewards/liquidity

Vos points de liquidité et ce que rapportent actuellement vos ordres en attente

Connexion requise

Requête

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

Réponse

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

La notation est expliquée dans Bot de tenue de marché. Les jours sont en UTC.

Classement et profils

Publics et en lecture seule. Un profil montre les résultats, les positions et les transactions ; les liquidités, les dépôts et les ordres ouverts restent privés.

GET/api/leaderboard

Les 100 meilleurs traders par gains et pertes réalisés

Public

Champ	Type	Description
`period`requêtefacultatif	1D \| 1W \| 1M \| ALL	ALL par défaut

Requête

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

Réponse

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

Mis en cache pendant 15 secondes.

GET/api/profiles

Trouver des traders par début de nom ou par adresse complète du portefeuille

Public

Champ	Type	Description
`q`requêteobligatoire	string	sat, @sat ou une adresse de portefeuille

Requête

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

Réponse

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

6 lignes au plus.

GET/api/profiles/:handle

Un trader

Public

Champ	Type	Description
`handle`cheminobligatoire	string	Nom d’utilisateur (casse indifférente) ou adresse complète du portefeuille

Requête

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

Réponse

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

Statut	Cas
404	Trader inconnu

GET/api/profiles/:handle/pnl

Les gains et pertes d’un trader (comme /pnl)

Public

Champ	Type	Description
`handle`cheminobligatoire	string	Nom d’utilisateur (casse indifférente) ou adresse complète du portefeuille
`period`requêtefacultatif	1D \| 1W \| 1M \| ALL	ALL par défaut

Requête

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

GET/api/profiles/:handle/positions

Les positions ouvertes d’un trader (comme /positions)

Public

Champ	Type	Description
`handle`cheminobligatoire	string	Nom d’utilisateur (casse indifférente) ou adresse complète du portefeuille

Requête

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

GET/api/profiles/:handle/activity

Les transactions et versements d’un trader, sans les annulations

Public

Champ	Type	Description
`handle`cheminobligatoire	string	Nom d’utilisateur (casse indifférente) ou adresse complète du portefeuille
`limit`requêtefacultatif	number	Lignes par page, de 1 à 200
`before`requêtefacultatif	number	Curseur : nextBefore de la page précédente

Requête

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

GET/api/profiles/:handle/settled

Les positions réglées d’un trader (comme /settled)

Public

Champ	Type	Description
`handle`cheminobligatoire	string	Nom d’utilisateur (casse indifférente) ou adresse complète du portefeuille
`limit`requêtefacultatif	number	Lignes par page, de 1 à 200
`before`requêtefacultatif	number	Curseur : nextBefore de la page précédente

Requête

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