Premiers pas
Seeryx API
Créez des bots et des applications de trading sur Seeryx : API REST et WebSocket pour les manches crypto Hausse/Baisse et les marchés événementiels.
Ce que vous pouvez créer
Seeryx est un marché prédictif sur Solana. Tout ce que fait le site passe par une API REST publique et un WebSocket, tous deux ouverts à votre code : bots de trading et teneurs de marché, tableaux de bord, alertes, analyses ou votre propre interface. Les données de marché ne nécessitent aucun compte ; le trading nécessite un portefeuille Solana approvisionné en USDC.
Marchés
| Crypto Hausse ou Baisse | Marchés événementiels | |
|---|---|---|
| Question | Le BTC, l’ETH ou le BNB clôturera-t-il la manche au-dessus de son prix d’ouverture ? | Une question Oui/Non sur l’actualité du monde : politique, sport, finance et bien plus |
| Manches | 5 minutes, 15 minutes, 1 heure et 1 jour, les unes après les autres ; les dix prochaines manches de 5 min et de 15 min se négocient déjà avant leur début | Un marché par issue, ouvert jusqu’à son heure de clôture |
| Résolution | Le prix spot de Binance (le milieu entre le meilleur prix acheteur et le meilleur prix vendeur) à la seconde exacte d’ouverture ou de clôture ; un prix inchangé se résout en Baisse | L’Optimistic Oracle d’UMA, avec une période de contestation publique |
| Parts | Hausse et Baisse | Oui et Non (up et down dans l’API) |
Les prix sont exprimés en cents de dollar. Une part gagnante rapporte 1,00 $ en USDC et une part perdante ne rapporte rien : un prix de 37¢ se lit donc comme 37 % de chances. Détails dans Concepts.
Comment fonctionne le trading
- Un carnet d’ordres par marché. Les ordres à cours limité restent dans le carnet à leur prix ; les ordres au marché s’exécutent aussitôt contre eux, au meilleur prix d’abord, puis par ancienneté. Hausse et Baisse sont un même carnet vu des deux côtés.
- Votre argent reste le vôtre. Les dépôts sont des USDC sur votre propre compte dans le programme Seeryx sur Solana. Chaque exécution est réglée sur la blockchain, généralement en quelques secondes, et seul un retrait signé par votre portefeuille peut sortir vos liquidités.
- Une signature par jour. Votre portefeuille approuve une seule fois une clé de session de trading ; la clé signe ensuite chaque ordre sans demande de confirmation. Elle peut négocier dans ses limites et ne peut jamais retirer de fonds.
- Frais. Le taker paie des frais maximaux à 50¢ et proches de zéro près de 0¢ et de 100¢ ; le maker en récupère une partie. Voir Frais. Les frais de réseau de Solana sont payés par Seeryx : votre portefeuille n’a pas besoin de SOL.
URL de base
- REST
https://seeryx.com/api- WebSocket
wss://seeryx.com/ws- En ce moment
- Lecture de GET /api/funds et de GET /api/fees…
- Clients
- Appelez l’API depuis un serveur, un script ou un bot. Les navigateurs sur d’autres sites web ne peuvent pas l’appeler : elle n’autorise aucune autre origine.
Conventions
| Grandeur | Unité | Exemple |
|---|---|---|
| Montants | USDC sous forme de nombre JSON, jusqu’à 6 décimales | 12.5 |
| Parts | Jusqu’à 4 décimales | 37.5 |
| Prix | Cents de 1 $ : cents entiers de 1 à 99, dixièmes en dessous de 1¢ et au-dessus de 99¢ | 45 correspond à 0,45 $ |
| Horodatages | Secondes Unix dans les manches et les slugs, millisecondes Unix dans les transactions et les données de compte | 1791916330063 |
| Manches | {asset}-updown-{tf}-{start} | btc-updown-5m-1791916200 |
- JSON en entrée et en sortie ; envoyez
Content-Type: application/jsonavec un corps. - Chaque erreur a la forme
{ "error": "..." }, avec uncodelorsqu’un programme doit réagir : voir Limites de requêtes et erreurs. - Chaque requête de trading porte un en-tête
Idempotency-Key: une nouvelle tentative ne passe donc jamais un ordre deux fois.