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.
Cette page est traduite automatiquement par IA. La version anglaise fait foi.Voir la version anglaise →
Raydium Perps est un déploiement white-label sur Orderly Network. Le carnet d’ordres, le moteur d’appariement et l’état du compte résident tous sur Orderly. Le SDK Raydium v2 (
@raydium-io/raydium-sdk-v2) ne couvre pas les perps — pour l’accès programmatique, utilisez directement l’API REST + WebSocket d’Orderly. Les extraits ci-dessous montrent les flux les plus courants ; la référence canonique se trouve à orderly.network/docs.Banneau de version.
- Backend : API REST + WebSocket d’Orderly Network
- Schéma des extraits vérifié par rapport à l’API d’Orderly à partir d’avril 2026
- Cluster Solana pour les dépôts en chaîne :
mainnet-beta - Signature : Ed25519 Solana sur la charge utile de style EIP-712 d’Orderly (Orderly utilise un schéma EIP-712 même pour les chaînes non-EVM ; consultez la documentation d’Orderly pour la liste des champs la plus récente)
Ce que contient cette page
Les flux ci-dessous couvrent le cycle de vie pertinent pour l’intégrateur :- Configuration du compte — déposer l’USDC et enregistrer le compte auprès d’Orderly.
- Appels REST authentifiés — demander la signature pour le placement, l’annulation et les requêtes de compte.
- Trading — placement d’ordres au marché / limités, annulation, récupération des positions et des remplissages.
- Données de marché — abonnement au carnet d’ordres et au WebSocket des transactions.
- Retrait — lancer un retrait vers le portefeuille.
@solana/web3.js et tweetnacl pour la signature Ed25519. Ce sont des points de départ — la surface de l’API d’Orderly est large et change plus vite que cette page ; consultez toujours la documentation en direct d’Orderly avant de déployer du code en production.
Configuration
Enregistrement du compte
Avant de placer un quelconque ordre, enregistrez le portefeuille auprès d’Orderly :(broker_id, wallet_address) — l’enregistrement est idempotent. Si un portefeuille a déjà été enregistré auprès du broker de Raydium, l’appel retourne le même identifiant de compte sans en créer un nouveau.
Déposer l’USDC
Les dépôts déplacent l’USDC du wallet ATA au coffre-fort de règlement d’Orderly. Ce sont des transactions Solana en chaîne :/v1/client/holding pour confirmer :
orderlyAuthGet est défini ci-dessous — chaque appel authentifié passe par lui.)
Aide à la signature des requêtes
Chaque appel REST authentifié à Orderly porte une signature Ed25519 sur(timestamp + method + path + body) :
timestamp déphasé de plus de 5 secondes par rapport à l’horloge du serveur sont rejetées. Synchronisez votre horloge (NTP) et évitez de signer les requêtes à l’avance.
Placer un ordre au marché
order_id résultant plus un statut. Les remplissages arrivent via le WebSocket (voir ci-dessous) ; la réponse REST elle-même ne bloque pas jusqu’à ce qu’elle soit complètement remplie.
Placer un ordre limité avec Post-Only
IOC / FOK, définissez time_in_force: "IOC" ou "FOK". Voir /fr/products/perps/order-types pour la sémantique de chaque drapeau.
Annuler un ordre
/v1/orders ou en observant le WebSocket — supposer qu’une annulation a réussi sans confirmation peut entraîner des positions dupliquées ou involontaires.
Récupérer les positions ouvertes
position_qty négative est un short, positive est un long. position_qty == 0 signifie que la position est fermée mais la ligne peut toujours être présente jusqu’au prochain nettoyage.
Récupérer l’historique des remplissages
page et size pour paginer.
WebSocket : données de marché
subscribe signée de la même manière que les requêtes REST, délimitée à votre identifiant de compte. La documentation d’Orderly contient la forme exacte de la charge utile ; elle change occasionnellement, donc ne codez pas en dur un schéma particulier ici.
Retirer l’USDC
/fr/products/perps/fees). Le transfert en chaîne se produit dans 1–2 minutes dans les conditions normales ; attendez-vous à plus long pendant la congestion.
Pièges
- Ne réutilisez pas la clé de trading dans les environnements. Une seule clé de trading Orderly enregistrée auprès de votre portefeuille est associée à un compte Solana mainnet. Si vous avez également besoin de devnet ou de staging, générez une clé séparée pour chacun.
- Synchronisation de l’horloge. La tolérance de déphasage horaire d’Orderly est serrée (±5s). Sur les services longue durée, la dérive NTP finira par casser la signature. Resynchronisez périodiquement.
- Reconnexions WebSocket. Le WS public abandonne occasionnellement les connexions pendant les mises à jour d’Orderly. Implémentez un backoff exponentiel et réabonnez-vous à la réouverture.
- Limites de débit. Les appels REST sont limités par taux par compte. Annulez en masse via
cancel_allplutôt que de bouclercancel-par-id quand vous avez plus de 5 ordres à annuler. - La direction de la position est implicite. Un ordre
BUYsurPERP_SOL_USDCouvre ou prolonge un long ; unSELLouvre ou prolonge un short — mais si vous êtes déjà long, unSELLréduit (et peut retourner) la position car Raydium Perps est en mode à sens unique. Vérifiez toujours la position actuelle avant de placer un ordre si la direction compte. - Le financement et les liquidations sont séparés du flux d’ordres. Les paiements de financement et les liquidations apparaissent comme des flux d’événements séparés ; ce ne sont pas des « ordres ». Abonnez-vous aux rubriques privées WS pertinentes si vous avez besoin de les observer.
Où aller ensuite
/fr/products/perps/trading-basics— l’amorce conceptuelle sur la mécanique des perpétuels./fr/products/perps/order-types— la sémantique de chaque type d’ordre et drapeau./fr/products/perps/collateral— les actifs de garantie supportés et les limites par chaîne./fr/products/perps/fees— les calendriers maker/taker et les frais de retrait.
- Documentation du développeur Orderly Network — référence canonique pour la surface de l’API utilisée ci-dessus. Raydium Perps la consomme directement.
- SDK TypeScript Orderly — enveloppe la même couche REST/WebSocket avec des aides typées ; utile si vous voulez ignorer l’écriture de la couche de signature vous-même.


