API

Cuenta

Lee tu cuenta de Seeryx desde el código: efectivo, posiciones, órdenes abiertas, actividad, rondas liquidadas, G/P, perfiles públicos y clasificación.

Descripción general

Una sola lectura para el estado. GET /api/account devuelve el efectivo, las posiciones y las órdenes abiertas a partir de una instantánea coherente: el mismo objeto que envía el WebSocket con cada cambio.
El historial está paginado. /api/activity, /api/settled y /api/feed van de lo más reciente a lo más antiguo, con un cursor. heads en la instantánea de la cuenta te indica cuándo hay algo nuevo que leer.
Las comisiones en tu historial. Cada fila de actividad tiene fee: positivo para una comisión taker que pagaste, negativo para un reembolso maker que recibiste. /api/pnl suma ambos.
Perfiles públicos. Cualquiera puede leer los resultados, las posiciones y las operaciones de un trader; el efectivo, los depósitos y las órdenes abiertas son privados.

Endpoints de la cuenta

Solo la cuenta con sesión iniciada. El dinero, en USDC; las acciones, con hasta 4 decimales; los precios, en centavos; las marcas de tiempo, en milisegundos Unix.

GET/api/account

Efectivo, posiciones y órdenes abiertas en una sola lectura

Con sesión iniciada

Solicitud

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

Respuesta

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

Una instantánea coherente, el mismo objeto que envía el WebSocket. heads son los ids más recientes de activity y settled: cuando uno cambia, vuelve a leer /activity o /settled.

GET/api/balance

Efectivo

Con sesión iniciada

Solicitud

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

Respuesta

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

Las órdenes de compra abiertas no retienen efectivo; locked siempre es 0. La regla del efectivo está en Operar.

GET/api/positions

Posiciones abiertas

Con sesión iniciada

Solicitud

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

Respuesta

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

cost es lo que costaron las acciones en USDC, con comisiones y reembolsos incluidos.

GET/api/orders

Órdenes abiertas, de la más reciente a la más antigua

Con sesión iniciada

Solicitud

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

Respuesta

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

shares es lo que sigue abierto; limit, en centavos.

GET/api/activity

Operaciones, divisiones, combinaciones, pagos y cancelaciones, de lo más reciente a lo más antiguo

Con sesión iniciada

Campo	Tipo	Descripción
`limit`consultaopcional	number	Filas por página, de 1 a 200
`before`consultaopcional	number	Cursor: nextBefore de la página anterior
`paged`consultaopcional	1	Respuesta { items, nextBefore }; sin él, una lista simple de las últimas filas
`slug`consultaopcional	string	Una ronda o un mercado de eventos
`prefix`consultaopcional	string	Un mercado, por ejemplo btc-updown-5m-

Solicitud

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

Respuesta

{ "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 (una operación que el programa rechazó y se deshizo). nextBefore null indica la última página.
amount es el cambio del efectivo, comisiones incluidas; fee es la comisión taker pagada (positiva) o el reembolso maker recibido (negativo), null si no hay. tx es la transacción de Solana que liquidó la fila, con txStatus pending, confirmed o failed.

GET/api/settled

Posiciones liquidadas, de la más reciente a la más antigua

Con sesión iniciada

Campo	Tipo	Descripción
`limit`consultaopcional	number	Filas por página, de 1 a 200
`before`consultaopcional	number	Cursor: nextBefore de la página anterior
`paged`consultaopcional	1	Como en /activity
`slug`consultaopcional	string	Una ronda
`prefix`consultaopcional	string	Un mercado

Solicitud

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

Respuesta

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

Cada elemento es una ronda. Una ronda con posiciones en ambos lados es un solo elemento: hedged true, side null, y cost y payout de ambos lados juntos.

GET/api/feed

Operaciones y depósitos o retiros en una sola lista, de lo más reciente a lo más antiguo

Con sesión iniciada

Campo	Tipo	Descripción
`limit`consultaopcional	number	De 1 a 200, por defecto 100
`before`consultaopcional	string	Cursor: next de la página anterior

Solicitud

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

Respuesta

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

Ganancias y pérdidas realizadas, comisiones, tasa de acierto y un gráfico

Con sesión iniciada

Campo	Tipo	Descripción
`period`consultaopcional	1D \| 1W \| 1M \| ALL	Por defecto, ALL
`from`consultaopcional	number	En lugar de period: inicio, en ms Unix
`to`consultaopcional	number	Final, en ms Unix; por defecto, ahora
`buckets`consultaopcional	number	Puntos del gráfico, de 1 a 200, por defecto 60

Solicitud

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

Respuesta

{ "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 son las comisiones taker que pagaste; fees.rebates, los reembolsos maker que recibiste. Sube y Baja en una misma ronda cuentan como una sola posición.

GET/api/transactions

Últimos depósitos y retiros

Con sesión iniciada

Campo	Tipo	Descripción
`limit`consultaopcional	number	De 1 a 200, por defecto 50

Solicitud

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

Respuesta

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

Aquí las horas son texto en UTC.

GET/api/rewards/liquidity

Tus puntos de liquidez y lo que ganan ahora tus órdenes en el libro

Con sesión iniciada

Solicitud

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

Respuesta

{ "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 puntuación se explica en Bot de creación de mercado. Los días son UTC.

Clasificación y perfiles

Públicos y de solo lectura. Un perfil muestra resultados, posiciones y operaciones; el efectivo, los depósitos y las órdenes abiertas son privados.

GET/api/leaderboard

Los 100 mejores traders por ganancias y pérdidas realizadas

Público

Campo	Tipo	Descripción
`period`consultaopcional	1D \| 1W \| 1M \| ALL	Por defecto, ALL

Solicitud

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

Respuesta

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

En caché durante 15 segundos.

GET/api/profiles

Buscar traders por el inicio del nombre o por la dirección completa de la billetera

Público

Campo	Tipo	Descripción
`q`consultaobligatorio	string	sat, @sat o una dirección de billetera

Solicitud

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

Respuesta

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

Como máximo 6 filas.

GET/api/profiles/:handle

Un trader

Público

Campo	Tipo	Descripción
`handle`rutaobligatorio	string	Nombre de usuario (en mayúsculas o minúsculas) o la dirección completa de la billetera

Solicitud

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

Respuesta

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

Estado	Cuándo
404	Trader desconocido

GET/api/profiles/:handle/pnl

Las ganancias y pérdidas de un trader (como /pnl)

Público

Campo	Tipo	Descripción
`handle`rutaobligatorio	string	Nombre de usuario (en mayúsculas o minúsculas) o la dirección completa de la billetera
`period`consultaopcional	1D \| 1W \| 1M \| ALL	Por defecto, ALL

Solicitud

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

GET/api/profiles/:handle/positions

Las posiciones abiertas de un trader (como /positions)

Público

Campo	Tipo	Descripción
`handle`rutaobligatorio	string	Nombre de usuario (en mayúsculas o minúsculas) o la dirección completa de la billetera

Solicitud

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

GET/api/profiles/:handle/activity

Las operaciones y los pagos de un trader, sin cancelaciones

Público

Campo	Tipo	Descripción
`handle`rutaobligatorio	string	Nombre de usuario (en mayúsculas o minúsculas) o la dirección completa de la billetera
`limit`consultaopcional	number	Filas por página, de 1 a 200
`before`consultaopcional	number	Cursor: nextBefore de la página anterior

Solicitud

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

GET/api/profiles/:handle/settled

Las posiciones liquidadas de un trader (como /settled)

Público

Campo	Tipo	Descripción
`handle`rutaobligatorio	string	Nombre de usuario (en mayúsculas o minúsculas) o la dirección completa de la billetera
`limit`consultaopcional	number	Filas por página, de 1 a 200
`before`consultaopcional	number	Cursor: nextBefore de la página anterior

Solicitud

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