Skip to main content
Diese Seite wurde mit KI automatisch übersetzt. Maßgeblich ist stets die englische Version.Englische Version ansehen →
Raydium Perps ist ein White-Label-Deployment auf Orderly Network. Das Orderbuch, die Matching-Engine und der Kontostatus befinden sich alle auf Orderly. Das Raydium SDK v2 (@raydium-io/raydium-sdk-v2) deckt Perps nicht ab — für programmatischen Zugriff verwenden Sie direkt Orderlys REST- und WebSocket-API. Die folgenden Snippets zeigen die häufigsten Abläufe; die kanonische Referenz ist die Orderly API-Einführung, mit den REST-Endpunkten und WebSocket-Streams dokumentiert darunter.
Versionsbanner.
  • Backend: Orderly Network REST + WebSocket API
  • Snippet-Schema verifiziert gegen Orderlys API ab 2026-04
  • Solana-Cluster für On-Chain-Einzahlungen: mainnet-beta
  • Signierung: Solana ed25519 über die Orderly EIP-712-ähnliche Payload (Orderly verwendet ein EIP-712-Schema auch für Non-EVM-Chains; siehe Orderly-Dokumentation für die aktuelle Feldliste)
Orderlys API-Oberfläche entwickelt sich weiter; überprüfen Sie die Orderly API-Dokumentation, bevor Sie diese Snippets in die Produktion kopieren.

Was ist auf dieser Seite

Die folgenden Abläufe decken den für Integratoren relevanten Lebenszyklus ab:
  1. Kontoeinrichtung — USDC einzahlen und das Konto bei Orderly registrieren.
  2. Authentifizierte REST-Aufrufe — Signierung für Order-Platzierung, Stornierung und Kontoabfragen anfordern.
  3. Handel — Platzieren von Market-/Limit-Orders, Stornierung, Abrufen von Positionen und Fills.
  4. Marktdaten — Abonnement des Orderbuchs und Trade-WebSocket.
  5. Abhebung — Einleitung einer Abhebung zurück zur Wallet.
Diese Snippets zielen auf Node.js + TypeScript mit @solana/web3.js und tweetnacl für Ed25519-Signierung ab. Sie sind Ausgangspunkte — Orderlys API-Oberfläche ist breit und ändert sich schneller als diese Seite; überprüfen Sie immer Orderlys Live-Dokumentation, bevor Sie Produktionscode ausliefern.

Setup

Der Orderly-Handelsschlüssel ist nicht Ihr Wallet-Keypair. Es ist ein Schlüssel zur Anfragensignierung, den Sie bei der ersten Verwendung gegen Ihre Wallet registrieren; Sie können ihn rotieren, ohne Gelder zu berühren. Behandeln Sie ihn als Session-Anmeldedaten.

Kontoregistrierung

Bevor Sie Orders platzieren, registrieren Sie die Wallet bei Orderly:
Account-IDs sind deterministisch pro (broker_id, wallet_address)-Paar — die Registrierung ist idempotent. Wenn eine Wallet bereits bei Raydiums Broker registriert ist, gibt der Aufruf dieselbe Account-ID zurück, ohne ein neues zu erstellen.

USDC einzahlen

Einzahlungen verschieben USDC von der Wallet-ATA zum Settlement-Vault von Orderly. Sie sind On-Chain-Solana-Transaktionen:
Nach etwa 30 Sekunden indexiert Orderlys Relayer die Einzahlung und der Saldo wird unter der freien Marge des Kontos angezeigt. Fragen Sie /v1/client/holding ab, um zu bestätigen:
(orderlyAuthGet ist unten definiert — jeder authentifizierte Aufruf läuft durch ihn.)

Anfragensignatur-Hilfsfunktion

Jeder authentifizierte REST-Aufruf an Orderly trägt eine Ed25519-Signatur über (timestamp + method + path + body):
Replay-Schutz: Anfragen mit einem timestamp, der mehr als 5 Sekunden von der Serveruhr abweicht, werden abgelehnt. Synchronisieren Sie Ihre Uhr (NTP) und vermeiden Sie es, Anfragen im Voraus zu signieren.

Market-Order platzieren

Market-Orders werden sofort ausgeführt. Die Antwort gibt die resultierende order_id plus einen Status zurück. Fills kommen über den WebSocket (siehe unten); die REST-Antwort selbst blockiert nicht, bis sie vollständig gefüllt ist.

Limit-Order mit Post-Only platzieren

Für IOC / FOK setzen Sie time_in_force: "IOC" oder "FOK". Siehe products/perps/order-types für die Semantik jedes Flags.

Order stornieren

Eine Stornierung wird synchron bestätigt, aber die tatsächliche Stornierung kann mit einem Fill konkurrieren. Gleichen Sie immer ab, indem Sie /v1/orders abfragen oder den WebSocket beobachten — das Annehmen einer erfolgreichen Stornierung ohne Bestätigung kann zu doppelten oder unbeabsichtigten Positionen führen.

Offene Positionen abrufen

Eine negative position_qty ist ein Short, positiv ist ein Long. position_qty == 0 bedeutet, dass die Position geschlossen ist, aber die Zeile kann bis zur nächsten Bereinigung bestehen bleiben.

Fill-Verlauf abrufen

Zeitargumente sind Millisekunden-Unix-Zeitstempel. Die Standard-Seitengröße beträgt 25 Zeilen; verwenden Sie page- und size-Abfrageparameter zum Blättern.

WebSocket: Marktdaten

Für den privaten Stream (Ihre Fills, Positionsaktualisierungen, Saldoänderungen) muss der WebSocket authentifiziert werden. Senden Sie eine subscribe-Payload, die auf die gleiche Weise wie REST-Anfragen signiert ist, auf Ihre Account-ID beschränkt. Orderlys Dokumentation hat die genaue Payload-Form; sie ändert sich gelegentlich, daher codieren Sie hier kein bestimmtes Schema hart.

USDC abheben

Orderly leitet die Abhebung On-Chain an die Empfängeradresse weiter. Es gibt eine pauschale 1 USDC-Abhebungsgebühr (siehe products/perps/fees). Die On-Chain-Überweisung erfolgt unter normalen Bedingungen innerhalb von 1–2 Minuten; rechnen Sie mit längeren Zeiten bei Überlastung.

Fallstricke

  • Verwenden Sie den Handelsschlüssel nicht über Umgebungen hinweg erneut. Ein einzelner Orderly-Handelsschlüssel, der gegen Ihre Wallet registriert ist, ist mit einem Solana-Mainnet-Konto verknüpft. Wenn Sie auch Devnet oder Staging benötigen, generieren Sie einen separaten Schlüssel für jeden.
  • Zeitsynchronisation. Orderlys Toleranz für Uhrenabweichungen ist eng (±5s). Bei lange laufenden Services führt NTP-Drift schließlich zu Signierungsfehlern. Synchronisieren Sie regelmäßig neu.
  • WebSocket-Wiederverbindungen. Der öffentliche WS lässt Verbindungen gelegentlich während Orderly-Upgrades fallen. Implementieren Sie exponentielles Backoff und abonnieren Sie bei Wiederöffnung erneut.
  • Ratenlimits. REST-Aufrufe sind pro Konto Tier-Rate-limitiert. Verwenden Sie cancel_all für Massen-Stornierungen, anstatt cancel-by-id zu durchlaufen, wenn Sie >5 Orders stornieren müssen.
  • Positionsrichtung ist implizit. Eine BUY-Order auf PERP_SOL_USDC öffnet oder erweitert einen Long; eine SELL öffnet oder erweitert einen Short — aber wenn Sie bereits long sind, reduziert eine SELL (und kann umkehren) die Position, da Raydium Perps im One-Way-Modus ist. Überprüfen Sie immer die aktuelle Position, bevor Sie eine Order platzieren, wenn die Richtung wichtig ist.
  • Finanzierung und Liquidationen sind getrennt vom Order-Flow. Finanzierungszahlungen und Liquidationen erscheinen als separate Event-Streams; sie sind keine „Orders”. Abonnieren Sie die relevanten privaten WS-Themen, wenn Sie sie beobachten müssen.

Nächste Schritte

Quellen:
  • Orderly Network-Entwicklerdokumentation — kanonische Referenz für die oben verwendete API-Oberfläche. Raydium Perps konsumiert dies direkt.
  • Orderly unterstützte Chains — bestätigt Solanas Status und die Settlement-Vault-Adressen pro Chain.
  • OrderlyNetwork/orderly-sdk-js — ein öffentlich sichtbarer JS-Wrapper über die gleiche REST-Schicht. Es hat keine veröffentlichten Releases und keine angegebene Wartungsrichtlinie, daher behandeln Sie es als Referenzcode statt als Abhängigkeit; die Signierungsschicht oben ist klein genug, um sie selbst zu besitzen.