Halaman ini diterjemahkan secara otomatis oleh AI. Versi bahasa Inggris adalah acuan resmi.Lihat versi bahasa Inggris →
Raydium Perps adalah deployment bermerek putih di Orderly Network. Order book, matching engine, dan state akun semuanya berada di Orderly. Raydium SDK v2 (
@raydium-io/raydium-sdk-v2) tidak mencakup perps — untuk akses programatik, gunakan REST + WebSocket API Orderly secara langsung. Cuplikan di bawah menunjukkan alur paling umum; referensi kanonik adalah pengenalan API Orderly, dengan endpoint REST dan stream WebSocket terdokumentasi di bawahnya.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 atas payload gaya EIP-712 Orderly (Orderly menggunakan skema EIP-712 bahkan untuk chain non-EVM; lihat dokumentasi Orderly untuk daftar field terbaru)
Apa yang ada di halaman ini
Alur di bawah mencakup siklus hidup yang relevan bagi integrator:- Penyiapan akun — setor USDC dan daftarkan akun dengan Orderly.
- Panggilan REST terautentikasi — minta penandatanganan untuk penempatan pesanan, pembatalan, dan kueri akun.
- Perdagangan — menempatkan pesanan pasar/limit, pembatalan, pengambilan posisi dan pengisian.
- 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 dokumentasi live Orderly sebelum mengirim kode produksi.
Penyiapan
Pendaftaran akun
Sebelum menempatkan pesanan apa pun, daftarkan dompet dengan Orderly:(broker_id, wallet_address) — pendaftaran bersifat idempoten. Jika dompet telah terdaftar dengan broker Raydium, panggilan mengembalikan ID akun yang sama tanpa membuat yang baru.
Setor USDC
Deposit memindahkan USDC dari ATA dompet ke vault penyelesaian Orderly. Ini adalah transaksi Solana on-chain:/v1/client/holding untuk mengonfirmasi:
orderlyAuthGet didefinisikan di bawah — setiap panggilan terautentikasi melewatinya.)
Pembantu penandatanganan permintaan
Setiap panggilan REST terautentikasi ke Orderly membawa tanda tangan Ed25519 atas(timestamp + method + path + body):
timestamp lebih dari 5 detik dari jam server ditolak. Sinkronkan jam Anda (NTP) dan hindari penandatanganan permintaan sebelumnya.
Tempatkan pesanan pasar
order_id yang dihasilkan plus status. Pengisian datang melalui WebSocket (lihat di bawah); respons REST itu sendiri tidak memblokir sampai sepenuhnya terisi.
Tempatkan pesanan limit dengan Post-Only
IOC / FOK, atur time_in_force: "IOC" atau "FOK". Lihat products/perps/order-types untuk semantik setiap flag.
Batalkan pesanan
/v1/orders atau menonton WebSocket — mengasumsikan pembatalan berhasil tanpa konfirmasi dapat menyebabkan posisi duplikat atau tidak diinginkan.
Ambil posisi terbuka
position_qty negatif adalah short, positif adalah long. position_qty == 0 berarti posisi ditutup tetapi baris mungkin masih muncul sampai pembersihan berikutnya.
Ambil riwayat pengisian
page dan size untuk paginate.
WebSocket: data pasar
subscribe yang ditandatangani dengan cara yang sama seperti permintaan REST, dibatasi pada ID akun Anda. Dokumentasi 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 memerlukan devnet atau staging, buat kunci terpisah untuk masing-masing.
- Sinkronisasi waktu. Toleransi skew jam Orderly ketat (±5s). Pada layanan berjalan lama, drift NTP pada akhirnya akan memecahkan penandatanganan. Sinkronkan ulang secara berkala.
- Reconnect WebSocket. WS publik sesekali menjatuhkan koneksi selama upgrade Orderly. Implementasikan backoff eksponensial dan berlangganan ulang saat dibuka kembali.
- Batas laju. Panggilan REST dibatasi laju tier per akun. Pembatalan massal melalui
cancel_alldaripada loopcancel-by-id ketika Anda memiliki >5 pesanan untuk dibatalkan. - Arah posisi bersifat implisit. Pesanan
BUYpadaPERP_SOL_USDCmembuka atau memperpanjang long;SELLmembuka atau memperpanjang short — tetapi jika Anda sudah long,SELLmengurangi (dan mungkin membalik) posisi karena Raydium Perps adalah mode satu arah. Selalu periksa posisi saat ini sebelum menempatkan pesanan jika arah penting. - Pendanaan dan likuidasi terpisah dari alur pesanan. Pembayaran pendanaan dan likuidasi muncul sebagai stream acara terpisah; mereka bukan “pesanan”. 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 pesanan dan flag.products/perps/collateral— aset jaminan yang didukung dan batas per rantai.products/perps/fees— jadwal maker/taker dan biaya penarikan.
- Dokumentasi pengembang Orderly Network — referensi kanonik untuk permukaan API yang digunakan di atas. Raydium Perps mengonsumsi ini secara langsung.
- Rantai yang didukung Orderly — mengonfirmasi status Solana dan alamat vault penyelesaian per rantai.
OrderlyNetwork/orderly-sdk-js— pembungkus JS yang terlihat komunitas atas lapisan REST yang sama. Ini tidak memiliki rilis yang dipublikasikan dan tidak ada kebijakan pemeliharaan yang dinyatakan, jadi perlakukan sebagai kode referensi daripada dependensi; lapisan penandatanganan di atas cukup kecil untuk dimiliki.

