Skip to main content
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)
Permukaan API Orderly berkembang; periksa dokumentasi API Orderly sebelum menyalin cuplikan ini ke produksi.

Apa yang ada di halaman ini

Alur di bawah mencakup siklus hidup yang relevan bagi integrator:
  1. Penyiapan akun — setor USDC dan daftarkan akun dengan Orderly.
  2. Panggilan REST terautentikasi — minta penandatanganan untuk penempatan pesanan, pembatalan, dan kueri akun.
  3. Perdagangan — menempatkan pesanan pasar/limit, pembatalan, pengambilan posisi dan pengisian.
  4. Data pasar — berlangganan orderbook dan WebSocket perdagangan.
  5. Penarikan — memulai penarikan kembali ke dompet.
Cuplikan ini menargetkan Node.js + TypeScript dengan @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

Kunci perdagangan Orderly bukan keypair dompet Anda. Ini adalah kunci penandatanganan permintaan yang Anda daftarkan terhadap dompet Anda pada penggunaan pertama; Anda dapat merotasinya tanpa menyentuh dana. Perlakukan sebagai kredensial sesi.

Pendaftaran akun

Sebelum menempatkan pesanan apa pun, daftarkan dompet dengan Orderly:
ID akun bersifat deterministik per pasangan (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:
Setelah ~30 detik, relayer Orderly mengindeks deposit dan saldo muncul di bawah margin bebas akun. Kueri /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):
Perlindungan replay: permintaan dengan timestamp lebih dari 5 detik dari jam server ditolak. Sinkronkan jam Anda (NTP) dan hindari penandatanganan permintaan sebelumnya.

Tempatkan pesanan pasar

Pesanan pasar dieksekusi segera. Respons mengembalikan 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

Untuk IOC / FOK, atur time_in_force: "IOC" atau "FOK". Lihat products/perps/order-types untuk semantik setiap flag.

Batalkan pesanan

Pembatalan diakui secara sinkron tetapi pembatalan aktual mungkin bersaing dengan pengisian. Selalu rekonsiliasi dengan polling /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

Argumen waktu adalah timestamp Unix milidetik. Ukuran halaman default adalah 25 baris; gunakan parameter kueri page dan size untuk paginate.

WebSocket: data pasar

Untuk stream privat (pengisian Anda, pembaruan posisi, perubahan saldo), WebSocket harus terautentikasi. Kirim payload 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

Orderly menyampaikan penarikan on-chain ke alamat penerima. Ada biaya penarikan datar 1 USDC (lihat 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_all daripada loop cancel-by-id ketika Anda memiliki >5 pesanan untuk dibatalkan.
  • Arah posisi bersifat implisit. Pesanan BUY pada PERP_SOL_USDC membuka atau memperpanjang long; SELL membuka atau memperpanjang short — tetapi jika Anda sudah long, SELL mengurangi (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

Sumber:
  • 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.