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)
Was ist auf dieser Seite
Die folgenden Abläufe decken den für Integratoren relevanten Lebenszyklus ab:- Kontoeinrichtung — USDC einzahlen und das Konto bei Orderly registrieren.
- Authentifizierte REST-Aufrufe — Signierung für Order-Platzierung, Stornierung und Kontoabfragen anfordern.
- Handel — Platzieren von Market-/Limit-Orders, Stornierung, Abrufen von Positionen und Fills.
- Marktdaten — Abonnement des Orderbuchs und Trade-WebSocket.
- Abhebung — Einleitung einer Abhebung zurück zur Wallet.
@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
Kontoregistrierung
Bevor Sie Orders platzieren, registrieren Sie die Wallet bei Orderly:(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:/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):
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
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
IOC / FOK setzen Sie time_in_force: "IOC" oder "FOK". Siehe products/perps/order-types für die Semantik jedes Flags.
Order stornieren
/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
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
page- und size-Abfrageparameter zum Blättern.
WebSocket: Marktdaten
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
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_allfür Massen-Stornierungen, anstattcancel-by-id zu durchlaufen, wenn Sie >5 Orders stornieren müssen. - Positionsrichtung ist implizit. Eine
BUY-Order aufPERP_SOL_USDCöffnet oder erweitert einen Long; eineSELLöffnet oder erweitert einen Short — aber wenn Sie bereits long sind, reduziert eineSELL(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
products/perps/trading-basics— die konzeptionelle Grundierung zur Perpetual-Mechanik.products/perps/order-types— die Semantik jedes Order-Typs und Flags.products/perps/collateral— unterstützte Sicherheitsmittel und Pro-Chain-Limits.products/perps/fees— Maker/Taker-Zeitpläne und die Abhebungsgebühr.
- 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.

