Gebühren und Limits

Ratenlimits und Fehler

Limits und Fehler der Seeryx-API: das JSON-Fehlerformat, Codes wie below_minimum und rate_limited, HTTP-Status, Anfragelimits und Wiederholungen.

Fehlerformat

Jeder Fehler ist JSON mit einem Satz für Menschen in error; wo ein Programm darauf reagieren sollte, mit einem stabilen code und manchmal weiteren Feldern.

Fehler

{ "error": "Invalid limit" }
{ "error": "Minimum order is 5 shares", "code": "below_minimum", "minimum": 5 }
{ "error": "Post only: this order would trade at once at 16¢; lower the price or turn Post only off", "code": "would_take" }
{ "error": "Too many open orders ...", "code": "open_orders_limit", "limit": { "account": 200, "round": 100 } }
{ "error": "Too many orders", "code": "rate_limited", "retryAfter": 4 }

Fehlercodes

code	Status	Bedeutung	Was tun
`below_minimum`	400	Weniger Anteile als das Minimum; `minimum` sagt, wie viele	Größe erhöhen
`would_take`	400	Eine Post-Only-Order würde sofort ausgeführt	Preis von der Gegenseite wegbewegen
`open_orders_limit`	400	Zu viele Orders im Orderbuch; `limit` enthält die Obergrenzen für Konto und Markt	Erst einige stornieren
`trading_paused`	400	Der Sitzungsschlüssel, der sie signiert hat, wurde geschlossen	Neue Sitzung öffnen und erneut signieren
`rate_limited`	429	Zu viele Order-Anfragen; `retryAfter` in Sekunden	Warten, dann dieselbe Anfrage senden
`trading_halted`	503	Der Handel ist für alle angehalten; GET /api/notice nennt vielleicht den Grund	Warten; Stornierungen funktionieren weiterhin

Orderantworten können auch einen reason enthalten, der kein Fehler ist: no_liquidity, beyond_limit und share_limit (siehe Handel).

HTTP-Status

Status	Wann
400	Ungültige Eingabe, nicht genug Guthaben oder freie Anteile, eine Runde, die nicht gehandelt wird oder gerade endet, eine Order unter dem Minimum, eine Post-Only-Order, die ausgeführt würde, eine signierte Order, die nicht übereinstimmt, ein fehlender oder wiederverwendeter Idempotency-Key
401	Ein fehlendes, ungültiges oder abgelaufenes Anmelde-Token (seeryx.com antwortet darauf mit 403)
403	Ein fehlendes, ungültiges oder abgelaufenes Anmelde-Token auf seeryx.com („Authentication required“, „Invalid or expired token“) oder ein gesperrtes Konto
404	Unbekannte Runde, unbekannter Markt oder unbekanntes Profil
408	Die Anfrage hat länger als 30 Sekunden gedauert
409	Gerade nicht möglich: noch kein Konto, ein Trade wird noch abgewickelt, eine Abhebung ist nicht bereit
413	Body zu groß: eine Order, Aufteilung oder Zusammenlegung 16 KB, eine Sammelorder das 15-Fache davon, alles andere 100 KB
429	Ein Ratenlimit: Warte so viele Sekunden, wie Retry-After angibt
502	Solana oder die Bridge hat nicht geantwortet
503	Handel angehalten (Code trading_halted), die Börsenzeit von Binance ist nicht verfügbar oder der Server ist ausgelastet (Retry-After)

Ratenlimits

Was	Limit	Gezählt pro
Orders (jede Order einer Sammelorder zählt), Stornierungen, Aufteilungen, Zusammenlegungen	250 pro 10 Sekunden	Konto
Orders im Orderbuch	200 insgesamt, 100 in einem Markt	Konto
Dein Konto, Orders, Positionen, Guthaben, /auth/me	12.000 pro Minute zusammen	Konto
Deine Aktivität, settled, feed, G/V	300 pro Minute zusammen	Konto
Märkte und Runden (/markets..., /rounds/:slug)	1.200 pro Minute	IP-Adresse
Orderbuch, Trades, Volumen, Marktübersicht, Rundenaktivität	3.000 pro Minute	IP-Adresse
Statistiken, Rangliste, Profile, Inhaber	300 pro Minute	IP-Adresse
/auth/nonce, /auth/verify	30 pro Minute jeweils	IP-Adresse
/deposit/recover	2 pro Minute	Konto
WebSocket	Siehe WebSocket	Verbindung, IP-Adresse

Bei Überschreitung eines Limits lautet die Antwort 429 mit Retry-After in Sekunden. Ein ausgelasteter Server antwortet mit 503 und Retry-After. Antworten zu Statistiken, Rangliste und Inhabern können einige Sekunden alt sein. GET https://seeryx.com/health antwortet für Uptime-Checks mit { "status": "ok" }.

Sicher wiederholen

429 und 503: Warte so lange, wie Retry-After angibt, und sende dann dieselbe Anfrage erneut.
Ein Netzwerkfehler oder ein 5xx bei einem Schreibzugriff: Sende denselben Body mit demselben Idempotency-Key erneut; ist der erste Versuch durchgegangen, erhältst du seine Antwort, und nichts wird doppelt platziert.
400: Wiederhole die Anfrage nicht unverändert; korrigiere sie und sende sie dann mit einem neuen Schlüssel (und einer neuen signierten id).
401 oder 403: Melde dich erneut an.