Erste Schritte
Seeryx API
Baue Trading-Bots und Apps auf Seeryx: eine REST-API und ein WebSocket für Krypto-Runden „Steigt oder fällt“ und Ereignismärkte auf Solana, mit USDC-Auszahlung.
Was du bauen kannst
Seeryx ist ein Prognosemarkt auf Solana. Alles, was die Website tut, läuft über eine öffentliche REST-API und einen WebSocket, und beide stehen deinem Code offen: Trading-Bots und Market-Maker, Dashboards, Benachrichtigungen, Analysen oder ein eigenes Frontend. Marktdaten brauchen kein Konto; zum Handeln brauchst du eine Solana-Wallet mit USDC.
Märkte
| Krypto „Steigt oder fällt“ | Ereignismärkte | |
|---|---|---|
| Frage | Schließt BTC, ETH oder BNB die Runde über ihrem Eröffnungskurs? | Eine Ja/Nein-Frage über das Weltgeschehen: Politik, Sport, Finanzen und mehr |
| Runden | 5 Minuten, 15 Minuten, 1 Stunde und 1 Tag, eine nach der anderen; die nächsten zehn 5m- und 15m-Runden werden schon vor ihrem Beginn gehandelt | Ein Markt pro Ausgang, offen bis zu seinem Handelsschluss |
| Entscheidung | Der Binance-Spotkurs (Mittelkurs aus bestem Kaufgebot und bestem Verkaufsangebot) in der Sekunde des Rundenwechsels; bei unverändertem Kurs gewinnt „Fällt“ | Das Optimistic Oracle von UMA, mit öffentlicher Anfechtungsfrist |
| Anteile | Steigt und Fällt | Ja und Nein (in der API up und down) |
Preise werden in Dollarcent angegeben. Ein gewinnender Anteil zahlt 1,00 $ in USDC aus und ein verlierender nichts; ein Preis von 37¢ entspricht also einer Chance von 37 %. Details unter Konzepte.
So funktioniert der Handel
- Ein Orderbuch pro Markt. Limit-Orders liegen zu ihrem Preis im Orderbuch; Market-Orders werden sofort gegen sie ausgeführt, zuerst zum besten Preis, bei gleichem Preis gegen die älteste Order. Steigt und Fällt sind ein einziges Orderbuch, von zwei Seiten betrachtet.
- Dein Geld bleibt deins. Einzahlungen sind USDC auf deinem eigenen Konto im Seeryx-Programm auf Solana. Jede Ausführung wird auf der Blockchain abgewickelt, meist innerhalb von Sekunden, und nur eine Abhebung, die deine Wallet signiert, kann dein Guthaben abziehen.
- Eine Signatur am Tag. Deine Wallet bestätigt einmal einen Sitzungsschlüssel; danach signiert der Schlüssel jede Order ohne Rückfrage. Er kann innerhalb seiner Limits handeln und niemals abheben.
- Gebühren. Der Taker zahlt eine Gebühr, die bei 50¢ am höchsten und bei 0¢ und 100¢ nahe null ist; der Maker erhält einen Teil davon zurück. Siehe Gebühren. Die Netzwerkgebühren von Solana zahlt Seeryx, deine Wallet braucht also kein SOL.
Basis-URLs
- REST
https://seeryx.com/api- WebSocket
wss://seeryx.com/ws- Aktuell
- GET /api/funds und GET /api/fees werden gelesen …
- Clients
- Rufe die API von einem Server, einem Skript oder einem Bot auf. Browser auf anderen Websites können sie nicht aufrufen: Sie erlaubt keinen anderen Origin.
Konventionen
| Größe | Einheit | Beispiel |
|---|---|---|
| Geld | USDC als JSON-Zahl, bis zu 6 Nachkommastellen | 12.5 |
| Anteile | Bis zu 4 Nachkommastellen | 37.5 |
| Preise | Cent von 1 $: ganze Cent 1–99, Zehntelcent unter 1¢ und über 99¢ | 45 sind 0,45 $ |
| Zeiten | Unix-Sekunden in Runden und Slugs, Unix-Millisekunden in Trades und Kontodaten | 1791916330063 |
| Runden | {asset}-updown-{tf}-{start} | btc-updown-5m-1791916200 |
- JSON rein und raus; sende mit einem Body
Content-Type: application/json. - Jeder Fehler ist
{ "error": "..." }, mit einemcode, wo ein Programm darauf reagieren sollte: siehe Ratenlimits und Fehler. - Jede Anfrage, die handelt, trägt einen
Idempotency-Key, damit eine Wiederholung nie eine Order doppelt platziert.