> ## Documentation Index
> Fetch the complete documentation index at: https://docs.raydium.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

<Info>
  **Halaman ini diterjemahkan secara otomatis oleh AI. Versi bahasa Inggris adalah acuan resmi.**

  [Lihat versi bahasa Inggris →](/api-reference/index)
</Info>

<Info>
  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](#autentikasi) sebelum mengirim permintaan yang memerlukan signature dompet.
</Info>

## 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](/id/api-reference/api-v3/overview)                           | `api-v3.raydium.io`            | `api-v3-devnet.raydium.io`            | Pool / mint / config / chain-info — read API kanonik yang diandalkan UI dan SDK.                                                               |
| [Transaction API](/id/api-reference/route-api-v2/overview)            | `transaction-v1.raydium.io`    | `transaction-v1-devnet.raydium.io`    | Konstruksi transaksi swap / liquidity sisi server. Titik masuk agregator.                                                                      |
| [Perps API](/id/api-reference/perp-api-v1/overview)                   | `api-perp-v1.raydium.io`       | —                                     | Pengaturan, metadata aset, pemilihan RPC untuk front end Raydium Perps.                                                                        |
| [LaunchLab Mint API](/id/api-reference/launch-mint-v1/overview)       | `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](/id/api-reference/launch-history-v1/overview) | `launch-history-v1.raydium.io` | `launch-history-v1-devnet.raydium.io` | Riwayat perdagangan, agregat K-line untuk pool LaunchLab.                                                                                      |
| [LaunchLab Forum API](/id/api-reference/launch-forum-v1/overview)     | `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](/id/api-reference/launch-auth-v1/overview)       | `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](/id/api-reference/dynamic-ipfs-v1/overview)        | `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](/id/api-reference/owner-api-v1/overview)                  | `owner-v1.raydium.io`          | `owner-v1-devnet.raydium.io`          | Posisi per-dompet, saldo, reward yang dapat diklaim.                                                                                           |
| [API v1](/id/api-reference/api-v1/overview)                           | `api.raydium.io`               | —                                     | Endpoint v1/v2 warisan, tetap aktif untuk klien yang belum bermigrasi ke API v3.                                                               |
| [Temp API](/id/api-reference/temp-api-v1/overview)                    | `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:

```json theme={null}
{
  "id": "uuid-v4-per-request",
  "success": true,
  "data": { ... }
}
```

Pada kegagalan:

```json theme={null}
{
  "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`](/id/sdk-api/typescript-sdk).

## Penunjuk

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