Referensi API

Katalog setiap HTTP API yang dijalankan Raydium: data pool, konstruksi transaksi, perps, layanan forum / mint / riwayat / autentikasi LaunchLab, gateway IPFS, owner-positions, dan API Python warisan. Endpoint yang tercantum di bawah membuka playground interaktif.

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

Lihat versi bahasa Inggris →

Setiap endpoint di situs ini memiliki panel Try it yang didukung oleh playground OpenAPI Mintlify. Playground berjalan di browser Anda dan menghubungi host produksi (atau devnet) langsung. Baca Autentikasi sebelum mengirim permintaan yang memerlukan signature dompet.

​

Katalog layanan

Raydium menjalankan sebelas layanan HTTP publik. Masing-masing didokumentasikan sebagai grup tersendiri di pohon navigasi di sebelah kiri.

Layanan	Host Mainnet	Host Devnet	Fungsinya
API v3	api-v3.raydium.io	api-v3-devnet.raydium.io	Pool / mint / config / chain-info — read API kanonik yang diandalkan UI dan SDK.
Transaction API	transaction-v1.raydium.io	transaction-v1-devnet.raydium.io	Konstruksi transaksi swap / liquidity sisi server. Titik masuk agregator.
Perps API	api-perp-v1.raydium.io	—	Pengaturan, metadata aset, pemilihan RPC untuk front end Raydium Perps.
LaunchLab Mint API	launch-mint-v1.raydium.io	launch-mint-v1-devnet.raydium.io	Pencarian token, indeks, papan peringkat, metadata per-mint untuk peluncuran LaunchLab.
LaunchLab History API	launch-history-v1.raydium.io	launch-history-v1-devnet.raydium.io	Riwayat perdagangan, agregat K-line untuk pool LaunchLab.
LaunchLab Forum API	launch-forum-v1.raydium.io	launch-forum-v1-devnet.raydium.io	Komentar, thread, unggahan IPFS terikat pada peluncuran LaunchLab. Signature dompet diperlukan.
LaunchLab Auth API	launch-auth-v1.raydium.io	launch-auth-v1-devnet.raydium.io	Mengeluarkan JWT ray-token berumur pendek dari pesan tertanda dompet. Diperlukan untuk memanggil forum API.
Dynamic IPFS API	dynamic-ipfs.raydium.io	dynamic-ipfs-devnet.raydium.io	Pembuat ulang gambar / metadata NFT. Mendorong seni posisi CLMM dan NFT on-chain lainnya yang tampilannya bergantung pada status dinamis.
Owner API	owner-v1.raydium.io	owner-v1-devnet.raydium.io	Posisi per-dompet, saldo, reward yang dapat diklaim.
API v1	api.raydium.io	—	Endpoint v1/v2 warisan, tetap aktif untuk klien yang belum bermigrasi ke API v3.
Temp API	temp-api-v1.raydium.io	temp-api-v1-devnet.raydium.io	Tempat penyimpanan untuk endpoint khusus berumur pendek. Saat ini menampilkan ringkasan biaya kreator CPMM. Dapat berubah tanpa pemberitahuan.

​

Autentikasi

Sebagian besar layanan hanya-baca dan menerima permintaan anonim. Dua pola muncul:

• Handshake tertanda dompet — diperlukan oleh launch-auth-v1 untuk mencetak ray-token, kemudian dibawa sebagai header ray-token oleh launch-forum-v1. Tandatangani pesan Solana ed25519 dengan bentuk time:<unix-seconds> menggunakan dompet Anda, kirim signature + alamat dompet ke /request-token launch-auth-v1, terima JWT sebagai balasan, dan teruskan sebagai header permintaan ray-token pada panggilan forum berikutnya.
• Tanpa auth — setiap layanan lainnya. Pemanggil terpercaya (UI Raydium, integrator) menghubungi endpoint langsung melalui HTTPS.

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

​

Batas kecepatan

Semua host berada di belakang Cloudflare dengan pembatasan laju progresif per IP sumber.

Integrator yang membutuhkan batas lebih tinggi harus menghubungi tim Raydium. Lonjakan di atas batas yang dipublikasikan dikembalikan sebagai HTTP 429 dengan header Retry-After.

​

Sampul respons

Sebagian besar layanan membungkus payload JSON mereka dalam sampul seragam:

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

Pada kegagalan:

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

api-v3 mengembalikan sampul sebagai { "id", "success", "data" }. Layanan pump-* menggunakan helper addBorderSuccess / addBorderErr yang menghasilkan bentuk yang sama dengan msg hanya diisi pada error. Periksa halaman pengantar setiap layanan untuk sampul yang tepat yang digunakannya.

​

Cara menggunakan bagian ini

Klik endpoint apa pun di navigasi sebelah kiri. Anda akan melihat:

• Metode HTTP, URL lengkap, dan host dasar.
• Parameter permintaan dengan tipe yang ditarik dari spek OpenAPI.
• Panel Try it yang memungkinkan Anda menetapkan parameter dan mengirim permintaan nyata ke mainnet (atau pilih server devnet dari dropdown jika tersedia).
• Bentuk respons, bersumber dari respons langsung perwakilan dan situs addBorderSuccess kode sumber.

Untuk akses level SDK — membangun transaksi sisi klien, transaksi swap batch, tipe TypeScript — lihat sdk-api/typescript-sdk.

​

Penunjuk

• sdk-api/rest-api — gambaran naratif permukaan REST, ditulis untuk integrator pertama kali.
• integration-guides/aggregator — cara menggunakan Transaction API bersama pool on-chain.
• reference/program-addresses — setiap ID program yang dikembalikan oleh api-v3 diselesaikan ke salah satu dari ini.