Halaman ini diterjemahkan secara otomatis oleh AI. Versi bahasa Inggris adalah acuan resmi.Lihat versi bahasa Inggris →
Tugas agregator adalah memberikan pengguna harga terbaik yang mungkin di seluruh banyak pool, kemungkinan membagi satu input di beberapa rute pool, dan menjalankannya secara atomik. Halaman ini mendokumentasikan bagian spesifik Raydium dari tugas tersebut: penemuan, kutipan, dan perakitan transaksi.
Penemuan
Inventaris pool
Anda memerlukan daftar lengkap pool Raydium aktif untuk setiap produk. Tiga pilihan:- REST API (paling sederhana):
GET https://api-v3.raydium.io/pools/info/list?poolType=all&pageSize=1000&page=1mengembalikan pool dalam batch 1000. Paginate hingga Anda memiliki semuanya. Cache selama 1–5 menit. - Pemindaian on-chain:
getProgramAccountspada ID program CPMM, CLMM, dan AMM v4, disaring berdasarkan diskriminator akun status. Menghasilkan ~setiap pool aktif dengan ~10 detik waktu RPC. Berguna ketika API sedang down atau rate-limited. - Hibrida: gunakan API sebagai sumber utama; jalankan pemindaian on-chain harian sebagai pemeriksaan kewarasan. Tim berkomitmen untuk menjaga API tetap komprehensif, tetapi pool yang dibuat melalui CPI langsung (tanpa frontend) kadang-kadang dapat tertinggal.
Pencarian pasangan mint
Untuk pasangan(mintA, mintB) tertentu, gunakan GET /pools/info/mint?mint1=...&mint2=...&poolType=all&sort=liquidity. Mengembalikan setiap pool pada tingkat biaya dan jenis produk apa pun. Hingga ~10 hasil per pasangan adalah umum pada mint yang banyak lalu lintas; urutkan berdasarkan TVL dan ambil beberapa teratas untuk perutean.
Kutipan
Matematika kutipan berbeda per produk. Gunakan fungsi matematika murni SDK sehingga Anda tidak perlu mengimplementasikan ulang:amountOut (pre-slippage) dari masing-masing.
Kesegaran cache
Status pool menjadi usang dengan cepat. Target kesegaran yang direkomendasikan:
Untuk agregator yang mengambil kutipan pada latensi interaktif, berlangganan pembaruan akun WebSocket (
accountSubscribe) pada setiap status pool yang relevan. Itu membalik model dari polling ke push.
Penyesuaian Token-2022
Jika ada mint dalam rute yang memiliki biaya transfer Token-2022, matematika kutipan harus menyesuaikan input dan output peralgorithms/token-2022-transfer-fees. SDK menangani ini jika poolInfo.mintA.extensions.transferFeeConfig diisi. Konfirmasi dengan melihat bidang .extensions sebelum mempercayai kutipan.
Perutean
Rute pool tunggal
Sebagian besar rute adalah pool tunggal. Pilih pool yangamountOut tertinggi. Jika beberapa dekat, tie-break berdasarkan tingkat biaya (lebih rendah lebih baik), kemudian berdasarkan TVL (lebih banyak lebih aman).
Perutean terpisah
Untuk perdagangan besar di mana satu pool memiliki dampak harga >5%, pisahkan di seluruh pool. Algoritma greedy sederhana:[(pool_A, 0.6), (pool_B, 0.3), (pool_C, 0.1)] yang meminimalkan dampak agregat. Solusi optimasi cembung yang tepat (misalnya menyamakan harga marginal di seluruh pool) berada dalam ~1% dari hasil greedy dalam praktik.
Rute multi-hop
USDC → RAY → SOL melalui dua pool terpisah adalah umum ketika tidak ada pool USDC-SOL langsung yang memberikan kutipan yang baik (jarang). Terapkan batas slippage per-hop; setiap hop memberlakukan minAmountOut sendiri. Lihat algorithms/slippage-and-price-impact.
Multi-hop di seluruh pool yang sama (misalnya dua hop CLMM pada SOL-USDC) selalu suboptimal vs satu hop — jangan hasilkan rute seperti itu.
Perakitan transaksi
Single-hop, single-pool
Untuk satu pool, panggil builder swap jenis pool itu sendiri —raydium.liquidity.swap, raydium.cpmm.swap atau raydium.clmm.swap. raydium.tradeV2.swap adalah executor rute multi-hop dan mengambil bentuk yang sama sekali berbeda ({ swapInfo, swapPoolKeys, routeProgram, ownerInfo, txVersion }); tidak ada raydium.trade.
Terpisah dan multi-hop
Komposisi ATA + instruksi secara manual. Pola:Atomisitas
Agregator harus menjamin atomisitas: baik rute penuh mendarat atau tidak sama sekali. Instruksi swap Raydium revert padaExceededSlippage, jadi rute multi-pool di mana satu hop gagal menyebabkan seluruh transaksi revert. Gratis.
Satu-satunya pengecualian: jika rute Anda melewati Raydium + DEX pihak ketiga, pastikan DEX itu juga memiliki model revert-on-slippage. Beberapa program mengabaikan batas slippage (jarang).
Jebakan
1. Kutipan usang
Antara pengguna melihat “Anda menerima 125.43 RAY” dan transaksi mendarat, cadangan dapat bergeser. Re-fetch status pool segera sebelum pengiriman; re-quote; jika kutipan baru >1% lebih buruk, jeda dan re-konfirmasi dengan pengguna.2. Daftar hitam pool
Beberapa pool Raydium adalah token scam dengan biaya transfer yang ditetapkan ke 99% atau dengan ekstensi non-transferable. REST API menandai ini (lihat bidangtags); lewati pool apa pun yang ditandai scam atau honeypot. Menjalankan pemeriksaan keamanan Anda sendiri di atas tag Raydium adalah bijaksana.
3. Persyaratan status observasi pada CLMM
CLMMSwapV2 mengambil akun observation_state. SDK mengisinya untuk Anda; instruksi yang dibangun tangan sering lupa, yang menyebabkan program revert dengan AccountNotFound. Selalu sertakan.
4. Tabel pencarian alamat
Raydium memelihara tabel pencarian publik untuk akun yang paling sering digunakan (mint utama, ID program, AmmConfigs). Agregator harus mengonsumsi ini — menghemat ~100 byte per transaksi dan memungkinkan rute yang lebih besar untuk cocok di V0. Menarik alamat LUT:5. Menangani kemacetan
Selama jendela volume tinggi, transaksi dapat duduk di mempool selama beberapa blok. Retry agresif pada TX expiry (bukan pada revert — revert bersifat deterministik) direkomendasikan. OpsisendAndConfirm SDK melakukan retry dasar; agregator produksi melapisi logika mereka sendiri (bundle Jito, broadcast multi-RPC) di atas.
Daftar periksa
Sebelum go live, verifikasi:- Penemuan pool mencakup CPMM + CLMM + AMM v4 secara komprehensif.
- Kutipan cocok dengan kutipan UI Raydium sendiri dalam 1 basis poin pada beberapa perdagangan uji.
- Perutean terpisah dimulai untuk perdagangan >5% dampak pada pool tunggal apa pun.
- Biaya prioritas diukur terhadap biaya program pool terbaru (lihat
integration-guides/priority-fee-tuning). - Biaya transfer Token-2022 dihitung dan ditampilkan kepada pengguna.
- Transaksi revert dengan bersih ketika slippage terlampaui.
- Logika retry membedakan tx expiry (retry) dari revert (jangan retry).
Penunjuk
integration-guides/routing-and-mev— ketahanan sandwich, bundle.integration-guides/priority-fee-tuning— ukuran instruksi compute-budget.sdk-api/rest-api— endpoint daftar pool.

