Permukaan REST API

Ringkasan tingkat tinggi dari sebelas layanan HTTP publik Raydium — apa yang setiap layanan lakukan, konvensi yang mereka bagikan (envelope respons, autentikasi, batas laju, cache), dan cara memilih layanan yang tepat untuk integrasi.

Halaman ini diterjemahkan secara otomatis oleh AI. Versi bahasa Inggris adalah acuan resmi.

Lihat versi bahasa Inggris →

Dokumentasi tingkat endpoint tersedia di tab API Reference. Setiap endpoint di sana memiliki panel interaktif Try it yang didukung oleh OpenAPI playground Mintlify — isi parameter di browser dan langsung akses mainnet live (atau devnet, jika tersedia). Halaman ini adalah pendamping naratif: layanan apa yang ada, kapan menggunakan mana, dan konvensi yang mencakup semuanya. Jika Anda mencari “apa yang diterima GET /pools/info/ids”, klik ke API Reference; jika Anda mencari “layanan mana yang harus saya integrasikan”, lanjutkan membaca.

​

Sebelas layanan sekilas

Raydium menjalankan sebelas layanan HTTP publik. Masing-masing didokumentasikan sebagai grup tersendiri di tab API Reference dan memiliki spesifikasi OpenAPI yang mendukung playground interaktif.

Layanan	Host Mainnet	Host Devnet	Apa yang dilayani
API v3	api-v3.raydium.io	api-v3-devnet.raydium.io	API baca pool / mint / config / chain-info kanonik. Pintu depan default untuk UI dan sebagian besar integrator.
Transaction API	transaction-v1.raydium.io	transaction-v1-devnet.raydium.io	Konstruksi transaksi swap sisi server.
Perps API	api-perp-v1.raydium.io	—	Pengaturan, metadata aset, pemilihan RPC untuk frontend Raydium Perps.
LaunchLab Mint API	launch-mint-v1.raydium.io	launch-mint-v1-devnet.raydium.io	Pencarian token, indeks, papan peringkat, metadata per-mint.
LaunchLab History API	launch-history-v1.raydium.io	launch-history-v1-devnet.raydium.io	Riwayat perdagangan dan agregat k-line OHLC untuk pool LaunchLab.
LaunchLab Forum API	launch-forum-v1.raydium.io	launch-forum-v1-devnet.raydium.io	Utas komentar dan unggahan IPFS pada peluncuran LaunchLab. Ditandatangani dompet.
LaunchLab Auth API	launch-auth-v1.raydium.io	launch-auth-v1-devnet.raydium.io	Mencetak JWT ray-token berumur pendek dari pesan bertanda tangan dompet. Diperlukan oleh Forum.
Dynamic IPFS API	dynamic-ipfs.raydium.io	dynamic-ipfs-devnet.raydium.io	Regenerasi gambar / metadata untuk NFT dinamis (posisi CLMM, dll).
Owner API	owner-v1.raydium.io	owner-v1-devnet.raydium.io	Posisi per-dompet, saldo, hadiah yang dapat diklaim.
API v1 (legacy)	api.raydium.io	—	Path /v1 dan /v2 legacy tetap aktif untuk klien yang belum bermigrasi ke API v3.
Temp API	temp-api-v1.raydium.io	temp-api-v1-devnet.raydium.io	Area penampungan untuk endpoint khusus berumur pendek. Permukaan dapat berubah tanpa pemberitahuan.

Versioning ada di hostname untuk layanan v3 / v1 — tidak ada versioning tingkat path lebih lanjut. Perubahan breaking dikirim sebagai host baru dengan tumpang tindih; tim telah berkomitmen secara publik untuk setidaknya 6 bulan tumpang tindih pada migrasi v3 → v4 apa pun.

​

Pilih layanan

Jika Anda ingin…	Gunakan
Baca metadata pool, harga, APR, konfigurasi biaya	API v3
Baca metadata mint (nama, simbol, logo, desimal, tag risiko)	API v3 /mint/list, /mint/price
Bangun transaksi swap / tambah-likuiditas / hapus-likuiditas sisi server	Transaction API
Tunjukkan posisi dompet (token LP, posisi CLMM, taruhan farm)	Owner API
Cari token LaunchLab, jelajahi papan peringkat, ambil metadata per-mint	LaunchLab Mint API
Render bagan k-line / candlestick untuk pool LaunchLab	LaunchLab History API
Posting atau baca komentar pada peluncuran LaunchLab	LaunchLab Auth API → ray-token → LaunchLab Forum API
Render gambar NFT posisi CLMM	Dynamic IPFS API
Tunjukkan pengaturan pasar futures atau daftar aset untuk UI Perps	Perps API
Pertahankan kompatibilitas dengan klien path-prefixed v1/v2	API v1 (legacy)

​

Konvensi lintas layanan

​

Envelope respons

Setiap layanan kecuali IPFS mengembalikan envelope JSON yang sama:

{
  "id":      "uuid-v4-per-request",
  "success": true,
  "data":    { ... }
}

Pada kegagalan:

{
  "id":      "uuid-v4-per-request",
  "success": false,
  "msg":     "human-readable error string",
  "data":    null
}

Beberapa layanan juga menyertakan integer error.code (API v3 menggunakannya untuk pengidentifikasi kesalahan stabil di seluruh versi minor). Lihat halaman ringkasan setiap layanan untuk bentuk pastinya.

​

Autentikasi

Dua pola muncul:

• Tanpa auth — setiap layanan kecuali Forum. Akses secara anonim melalui HTTPS.
• Handshake tertanda dompet — diperlukan oleh LaunchLab Forum API. Tandatangani pesan Solana ed25519 dalam bentuk time:<unix-seconds> dengan dompet Anda, kirim tanda tangan + alamat dompet ke LaunchLab Auth API /request-token, terima JWT kembali, dan teruskan sebagai header permintaan ray-token pada panggilan forum berikutnya.

Playground Mintlify menerima ray-token di panel auth sebelum mengirim permintaan forum; nilainya hanya disimpan di browser Anda.

​

Batas laju

Semua host duduk di belakang Cloudflare dengan pembatasan laju progresif per IP sumber. Panduan yang dipublikasikan untuk integrator:

Ledakan di atas batas yang dipublikasikan mengembalikan HTTP 429 dengan header Retry-After. Agregatior atau bot yang membutuhkan batas lebih tinggi harus menghubungi tim Raydium daripada menghantam host publik — menjalankan indexer Anda sendiri terhadap ID program on-chain juga merupakan pilihan untuk beban kerja berat baca.

​

Caching dan konsistensi

• Sebagian besar endpoint baca API v3 di-cache di edge selama 5–60 detik; TTL spesifik dicatat pada halaman API Reference setiap endpoint.
• Cache dibatalkan oleh indexer pada peristiwa sentuh-program yang diamatinya.
• Selama reorg besar atau kemacetan, dapat ada perbedaan slot 1–2 antara pandangan API dan state on-chain. SDK dan pembacaan RPC langsung selalu lebih terkini — jika klien akan menandatangani transaksi, ambil ulang akun yang relevan melalui RPC, jangan pernah mempercayai nilai API secara buta.

​

Format kesalahan

Kesalahan kembali sebagai HTTP 4xx/5xx dengan envelope yang sama (success: false, msg terisi). API v3 juga menyertakan error.code stabil:

{
  "id":      "uuid-v4-per-request",
  "success": false,
  "msg":     "Pool not found",
  "error":   { "code": 40401, "message": "Pool not found" }
}

error.code stabil di seluruh versi minor API; perlakukan sebagai sinyal utama dalam logika klien dan msg sebagai permukaan yang dapat dibaca manusia.

​

Konvensi argumen pasangan mint

Banyak endpoint API v3 menerima mint1=…&mint2=… dan memerlukan mint1 < mint2 (urutan byte pubkey ascending). Ini agar API dapat mengembalikan pool kanonik yang sama terlepas dari urutan argumen pilihan pemanggil. Urutkan dua mint sisi klien sebelum membangun URL — dokumentasi tingkat endpoint di API Reference mengulangi batasan ini di mana berlaku.

​

Pola klien yang direkomendasikan

1. Hidrat sekali, segarkan dengan malas. Tarik GET /main/info dan GET /mint/list (keduanya di API v3) saat pemuatan aplikasi dan cache secara lokal dengan TTL 1 jam. Keduanya di-cache edge dengan berat dan jarang berubah.
2. Massal di mana endpoint memungkinkannya. GET /pools/info/ids?ids=… menerima daftar terpisah koma — ambil sepuluh pool dalam satu permintaan, bukan sepuluh permintaan.
3. Hindari pengambilan harga jalur panas. GET /mint/price baik untuk rendering UI; jangan pernah loop dalam bot. Untuk bot perdagangan, jalankan indexer atau berlangganan peristiwa programSubscribe RPC secara langsung.
4. Cerminkan atau proxy untuk throughput tinggi. Apa pun di atas batas batas laju yang dipublikasikan harus dilayani dari lapisan cache Anda sendiri, bukan langsung dari host publik. Agregatior dengan >120 req/min berkelanjutan terhadap transaction-v1 harus menjalankan mesin quote / rute mereka sendiri.
5. Ambil ulang tepat sebelum menandatangani. Respons API dapat tertinggal 5–60 detik. Untuk snapshot pool yang benar-benar akurat pada waktu tanda tangan, baca ulang akun yang relevan melalui SDK atau panggilan RPC getMultipleAccounts langsung. Perlakukan nilai API sebagai petunjuk pencarian, bukan sumber penyelesaian.
6. Gunakan Transaction API untuk integrasi tanpa hambatan. Jika Anda tidak ingin menggabungkan SDK dalam klien Anda (native mobile, bot di lingkungan terbatas), Transaction API akan mengembalikan transaksi terversikan yang dikodekan base64 untuk pengguna tandatangani. swapResponse yang dikembalikannya menyematkan kutipan — perlakukan sebagai valid selama ~30 detik.

​

Ke mana selanjutnya

• Referensi endpoint (interaktif) — API Reference. Setiap layanan memiliki grup sendiri; klik endpoint apa pun untuk parameter, bentuk respons, sampel kode, dan panel Try-it.
• TypeScript SDK — sdk-api/typescript-sdk. SDK menggunakan API v3 secara internal untuk beberapa jalur; untuk pembuatan transaksi selalu mengambil ulang state dari RPC, tidak pernah mempercayai API secara buta.
• Integrasi Trade API — integration-guides/aggregator. Pola untuk memasang likuiditas Raydium ke dalam agregatior multi-DEX.
• Dokumen ramah AI — sdk-api/ai-integration. Penunjuk untuk agen pengodean AI yang perlu memanggil API ini.