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.
Halaman ini diterjemahkan secara otomatis oleh AI. Versi bahasa Inggris adalah acuan resmi.Lihat versi bahasa Inggris →
Raydium Perps adalah deployment white-labeled di Orderly Network. Order book, matching engine, dan account state semuanya berada di Orderly. Raydium SDK v2 (
@raydium-io/raydium-sdk-v2) tidak mencakup perps — untuk akses terprogram, gunakan REST + WebSocket API Orderly secara langsung. Cuplikan di bawah menunjukkan alur yang paling umum; referensi resmi ada di orderly.network/docs.Banner versi.
- Backend: Orderly Network REST + WebSocket API
- Skema cuplikan diverifikasi terhadap API Orderly per 2026-04
- Cluster Solana untuk deposit on-chain:
mainnet-beta - Penandatanganan: Solana ed25519 melalui payload gaya EIP-712 Orderly (Orderly menggunakan skema EIP-712 bahkan untuk chain non-EVM; lihat dokumen Orderly untuk daftar field terbaru)
Yang ada di halaman ini
Alur di bawah mencakup siklus hidup yang relevan bagi integrator:- Penyiapan akun — simpan USDC dan daftarkan akun dengan Orderly.
- Panggilan REST yang diautentikasi — permintaan penandatanganan untuk penempatan order, pembatalan, dan kueri akun.
- Perdagangan — menempatkan order pasar / limit, pembatalan, pengambilan posisi dan fill.
- Data pasar — berlangganan orderbook dan WebSocket perdagangan.
- Penarikan — memulai penarikan kembali ke dompet.
@solana/web3.js dan tweetnacl untuk penandatanganan Ed25519. Ini adalah titik awal — permukaan API Orderly luas dan berubah lebih cepat dari halaman ini; selalu periksa dokumen live Orderly sebelum mengirim kode produksi.
Penyiapan
Pendaftaran akun
Sebelum menempatkan order apa pun, daftarkan dompet dengan Orderly:(broker_id, wallet_address) — pendaftaran adalah idempoten. Jika dompet telah terdaftar dengan broker Raydium, panggilan mengembalikan ID akun yang sama tanpa membuat yang baru.
Simpan USDC
Deposit memindahkan USDC dari ATA dompet ke vault settlement Orderly. Ini adalah transaksi Solana on-chain:/v1/client/holding untuk memastikan:
orderlyAuthGet didefinisikan di bawah — setiap panggilan yang diautentikasi melaluinya.)
Helper penandatanganan permintaan
Setiap panggilan REST yang diautentikasi ke Orderly membawa tanda tangan Ed25519 di atas(timestamp + method + path + body):
timestamp lebih dari 5 detik dari jam server ditolak. Sinkronkan jam Anda (NTP) dan hindari penandatanganan permintaan sebelumnya.
Tempatkan order pasar
order_id yang dihasilkan plus status. Fill datang melalui WebSocket (lihat di bawah); respons REST itu sendiri tidak memblokir sampai sepenuhnya terisi.
Tempatkan order limit dengan Post-Only
IOC / FOK, atur time_in_force: "IOC" atau "FOK". Lihat products/perps/order-types untuk semantik setiap flag.
Batalkan order
/v1/orders atau menonton WebSocket — mengasumsikan pembatalan berhasil tanpa konfirmasi dapat menyebabkan posisi duplikat atau tidak disengaja.
Ambil posisi terbuka
position_qty negatif adalah short, positif adalah long. position_qty == 0 berarti posisi ditutup tetapi baris masih mungkin muncul sampai pembersihan berikutnya.
Ambil riwayat fill
page dan size untuk paginasi.
WebSocket: data pasar
subscribe yang ditandatangani dengan cara yang sama seperti permintaan REST, terlingkup ke ID akun Anda. Dokumen Orderly memiliki bentuk payload yang tepat; itu berubah sesekali, jadi jangan hard-code skema tertentu di sini.
Tarik USDC
products/perps/fees). Transfer on-chain terjadi dalam 1–2 menit dalam kondisi normal; harapkan lebih lama selama kemacetan.
Jebakan
- Jangan gunakan kembali kunci perdagangan di seluruh lingkungan. Satu kunci perdagangan Orderly terdaftar terhadap dompet Anda terkait dengan satu akun mainnet Solana. Jika Anda juga membutuhkan devnet atau staging, hasilkan kunci terpisah untuk masing-masing.
- Sinkronisasi waktu. Toleransi skew jam Orderly ketat (±5s). Pada layanan yang berjalan lama, drift NTP pada akhirnya akan mengganggu penandatanganan. Sinkronkan ulang secara berkala.
- Reconnect WebSocket. WS publik sesekali menghentikan koneksi selama upgrade Orderly. Implementasikan backoff eksponensial dan relanggani saat membuka kembali.
- Batasan laju. Panggilan REST dibatasi laju per-tier per akun. Bulk-cancel melalui
cancel_alldaripada loopcancel-by-id ketika Anda memiliki >5 order untuk dibatalkan. - Arah posisi implisit. Order
BUYdiPERP_SOL_USDCmembuka atau memperpanjang long;SELLmembuka atau memperpanjang short — tetapi jika Anda sudah long,SELLmengurangi (dan mungkin membalik) posisi karena Raydium Perps adalah mode one-way. Selalu periksa posisi saat ini sebelum menempatkan order jika arahnya penting. - Pendanaan dan likuidasi terpisah dari alur order. Pembayaran pendanaan dan likuidasi muncul sebagai alur peristiwa terpisah; mereka bukan “order”. Berlangganan topik WS privat yang relevan jika Anda perlu mengamatinya.
Ke mana selanjutnya
products/perps/trading-basics— primer konseptual tentang mekanik perpetual.products/perps/order-types— semantik setiap tipe order dan flag.products/perps/collateral— aset collateral yang didukung dan batasan per-chain.products/perps/fees— jadwal maker/taker dan biaya penarikan.
- Dokumentasi pengembang Orderly Network — referensi resmi untuk permukaan API yang digunakan di atas. Raydium Perps mengonsumsi ini secara langsung.
- SDK TypeScript Orderly — membungkus layer REST/WebSocket yang sama dengan helper yang diketik; berguna jika Anda ingin melewati penulisan layer penandatanganan sendiri.


