Documentation Index
Fetch the complete documentation index at: https://docs.raydium.io/llms.txt
Use this file to discover all available pages before exploring further.
Diese Seite wurde mit KI automatisch übersetzt. Maßgeblich ist stets die englische Version.Englische Version ansehen →
Raydium Perps ist eine White-Label-Implementierung 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 programmgesteuerten Zugriff verwenden Sie direkt Orderlys REST- und WebSocket-API. Die folgenden Code-Beispiele zeigen die gängigsten Abläufe; die kanonische Referenz ist unter orderly.network/docs zu finden.Versionsbanner.
- Backend: Orderly Network REST + WebSocket API
- Snippet-Schema verifiziert gegen Orderlys API Stand 2026-04
- Solana-Cluster für On-Chain-Einzahlungen:
mainnet-beta - Signieren: Solana ed25519 über das Orderly-EIP-712-ähnliche Payload (Orderly nutzt 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 relevanten Integrator-Lebenszyklus ab:- Kontoeinrichtung – USDC einzahlen und Konto bei Orderly registrieren.
- Authentifizierte REST-Aufrufe – Signierung für Order-Platzierung, Stornierung und Kontoabfragen anfordern.
- Handel – Market-/Limit-Orders platzieren, stornieren, Positionen und Fills abrufen.
- Marktdaten – Orderbuch- und Trade-WebSocket abonnieren.
- Auszahlung – Auszahlung zurück zur Wallet initiieren.
@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 stets Orderlys aktuelle Dokumentation, bevor Sie Production-Code entwickeln.
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 Call dieselbe Account ID zurück, ohne ein neues Konto zu erstellen.
USDC einzahlen
Einzahlungen bewegen USDC von der Wallet-ATA zu Orderlys Settlement-Vault. Sie sind On-Chain-Solana-Transaktionen:/v1/client/holding ab, um zu bestätigen:
orderlyAuthGet ist unten definiert – jeder authentifizierte Aufruf durchläuft diese Funktion.)
Request-Signierung-Helfer
Jeder authentifizierte REST-Aufruf zu Orderly trägt eine Ed25519-Signatur über(timestamp + method + path + body):
timestamp von mehr als 5 Sekunden Abweichung zur Server-Uhr werden abgelehnt. Synchronisieren Sie Ihre Uhr (NTP) und vermeiden Sie, Anfragen im Voraus zu signieren.
Platzieren Sie eine Market Order
order_id sowie einen Status zurück. Fills kommen über den WebSocket (siehe unten); die REST-Response selbst blockiert nicht, bis sie vollständig gefüllt ist.
Platzieren Sie eine Limit Order mit Post-Only
IOC / FOK setzen Sie time_in_force: "IOC" oder "FOK". Siehe /de/products/perps/order-types für die Semantik jedes Flags.
Stornieren Sie eine Order
/v1/orders oder Beobachtung des WebSocket – es ist ein Fehler, anzunehmen, dass eine Stornierung ohne Bestätigung erfolgreich war, kann zu doppelten oder unbeabsichtigten Positionen führen.
Abrufen offener Positionen
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 zum Blättern.
WebSocket: Marktdaten
subscribe-Payload, das genauso signiert ist wie REST-Anfragen, mit Gültigkeitsbereich für Ihre Account-ID. Orderlys Dokumentation hat die genaue Payload-Form; diese ändert sich gelegentlich, daher codieren Sie hier keine bestimmte Schema hart.
USDC abheben
/de/products/perps/fees). Die On-Chain-Überweisung erfolgt unter normalen Bedingungen innerhalb von 1–2 Minuten; unter Stau ist mit längeren Verzögerungen zu rechnen.
Fallstricke
- Verwenden Sie den Handelsschlüssel nicht umgebungsübergreifend. 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 für jedes einen separaten Schlüssel.
- Zeitsynchronisation. Orderlys Toleranz für Zeitabweichung ist eng (±5s). Bei langzeitlaufenden Services wird NTP-Drift schließlich das Signieren unterbrechen. Synchronisieren Sie regelmäßig neu.
- WebSocket-Neuvorbindungen. Der öffentliche WS bricht Verbindungen gelegentlich während Orderly-Upgrades ab. Implementieren Sie exponentielles Backoff und melden Sie sich bei Wiedereröffnung erneut an.
- Rate Limits. REST-Aufrufe sind per-Konto-rate-limitiert. Verwenden Sie
cancel_allfür Massen-Stornierung statt Schleifen-cancel-by-id, wenn Sie >5 Orders stornieren möchten. - Positionsrichtung ist implizit. Eine
BUY-Order aufPERP_SOL_USDCöffnet oder verlängert ein Long; eineSELLöffnet oder verlängert ein Short – aber wenn Sie bereits long sind, reduziert eineSELLdie Position (und kann sie umkehren), weil Raydium Perps im One-Way-Modus ist. Überprüfen Sie immer die aktuelle Position vor dem Platzieren einer Order, wenn die Richtung wichtig ist. - Funding und Liquidationen sind getrennt vom Order-Fluss. Funding-Zahlungen und Liquidationen erscheinen als separate Event-Streams; es sind keine „Orders”. Abonnieren Sie die relevanten privaten WS-Topics, falls Sie diese beobachten müssen.
Nächste Schritte
/de/products/perps/trading-basics– die konzeptionelle Einführung in Perpetual-Mechaniken./de/products/perps/order-types– die Semantik jedes Order-Typs und Flags./de/products/perps/collateral– unterstützte Collateral-Assets und Pro-Chain-Limits./de/products/perps/fees– Maker-/Taker-Gebührenplan und Auszahlungsgebühr.
- Orderly Network-Entwicklerdokumentation – kanonische Referenz für die oben genutzte API-Oberfläche. Raydium Perps konsumiert diese direkt.
- Orderly TypeScript SDK – umhüllt dieselbe REST-/WebSocket-Schicht mit typisierten Helfern; nützlich, wenn Sie die Signierungsschicht selbst schreiben möchten.


