Primeros pasos
Seeryx API
Crea bots y aplicaciones de trading en Seeryx: una API REST y un WebSocket para rondas cripto de sube o baja y mercados de eventos en Solana, con pagos en USDC.
Qué puedes crear
Seeryx es un mercado de predicción en Solana. Todo lo que hace el sitio web pasa por una API REST pública y un WebSocket, y ambos están abiertos a tu código: bots de trading y creadores de mercado, paneles, alertas, analítica o tu propia interfaz. Los datos de mercado no requieren cuenta; para operar necesitas una billetera de Solana con USDC.
Mercados
| Cripto sube o baja | Mercados de eventos | |
|---|---|---|
| Pregunta | ¿Cerrará BTC, ETH o BNB la ronda por encima de su precio de apertura? | Una pregunta de Sí o No sobre el mundo: política, deportes, finanzas y más |
| Rondas | 5 minutos, 15 minutos, 1 hora y 1 día, una tras otra; las diez rondas siguientes de 5m y 15m ya se operan antes de empezar | Un mercado por resultado, abierto hasta su hora de cierre |
| Resolución | El precio spot de Binance (el punto medio entre la mejor compra y la mejor venta) en el segundo exacto de apertura o cierre; un precio sin cambios se resuelve como Baja | El Optimistic Oracle de UMA, con un plazo de disputa público |
| Acciones | Sube y Baja | Sí y No (en la API, up y down) |
Los precios están en centavos de dólar. Una acción ganadora paga 1,00 $ en USDC y una perdedora no paga nada, así que un precio de 37¢ se lee como una probabilidad del 37 %. Más detalles en Conceptos.
Cómo funcionan las operaciones
- Un libro de órdenes por mercado. Las órdenes límite quedan en el libro a su precio; las órdenes de mercado se ejecutan al instante contra ellas, primero al mejor precio y después contra la orden más antigua. Sube y Baja son un mismo libro visto desde dos lados.
- Tu dinero sigue siendo tuyo. Los depósitos son USDC en tu propia cuenta del programa de Seeryx en Solana. Cada ejecución se liquida en la cadena de bloques, normalmente en segundos, y solo un retiro firmado por tu billetera puede sacar tu efectivo.
- Una firma al día. Tu billetera aprueba una vez una clave de sesión de trading; después, la clave firma cada orden sin pedir confirmación. Puede operar dentro de sus límites y nunca puede retirar fondos.
- Comisiones. El taker paga una comisión que es máxima a 50¢ y casi nula cerca de 0¢ y 100¢; el maker recupera parte de ella. Consulta Comisiones. Las comisiones de red de Solana las paga Seeryx, así que tu billetera no necesita SOL.
URL base
- REST
https://seeryx.com/api- WebSocket
wss://seeryx.com/ws- Ahora mismo
- Leyendo GET /api/funds y GET /api/fees…
- Clientes
- Llama a la API desde un servidor, un script o un bot. Los navegadores en otros sitios web no pueden llamarla: no admite ningún otro origen.
Convenciones
| Magnitud | Unidad | Ejemplo |
|---|---|---|
| Dinero | USDC como número JSON, con hasta 6 decimales | 12.5 |
| Acciones | Hasta 4 decimales | 37.5 |
| Precios | Centavos de 1 $: centavos enteros de 1 a 99, décimas por debajo de 1¢ y por encima de 99¢ | 45 son 0,45 $ |
| Marcas de tiempo | Segundos Unix en rondas y slugs, milisegundos Unix en operaciones y datos de la cuenta | 1791916330063 |
| Rondas | {asset}-updown-{tf}-{start} | btc-updown-5m-1791916200 |
- JSON de entrada y de salida; envía
Content-Type: application/jsoncuando haya cuerpo. - Todo error es
{ "error": "..." }, con uncodecuando un programa debe actuar en consecuencia: consulta Límites de solicitudes y errores. - Toda solicitud que opera lleva una
Idempotency-Key, para que un reintento nunca coloque una orden dos veces.