Skip to main content

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.

Every endpoint on this site has a Try it panel powered by Mintlify’s OpenAPI playground. The playground runs in your browser and hits the live production (or devnet) hosts directly. Read Authentication before sending requests that require a wallet signature.

​
Service catalogue

Raydium runs eleven public HTTP services. Each one is documented as its own group in the navigation tree to the left.
ServiceMainnet hostDevnet hostWhat it does
API v3api-v3.raydium.ioapi-v3-devnet.raydium.ioPool / mint / config / chain-info — the canonical read API the UI and SDK rely on.
Transaction APItransaction-v1.raydium.iotransaction-v1-devnet.raydium.ioServer-side swap / liquidity transaction construction. The aggregator entry point.
Perps APIapi-perp-v1.raydium.io—Settings, asset metadata, RPC selection for the Raydium Perps front end.
LaunchLab Mint APIlaunch-mint-v1.raydium.iolaunch-mint-v1-devnet.raydium.ioToken search, indexes, leaderboards, per-mint metadata for LaunchLab launches.
LaunchLab History APIlaunch-history-v1.raydium.iolaunch-history-v1-devnet.raydium.ioTrade history, K-line aggregates for LaunchLab pools.
LaunchLab Forum APIlaunch-forum-v1.raydium.iolaunch-forum-v1-devnet.raydium.ioComments, threads, IPFS uploads tied to a LaunchLab launch. Wallet-signed.
LaunchLab Auth APIlaunch-auth-v1.raydium.iolaunch-auth-v1-devnet.raydium.ioIssues short-lived ray-token JWTs from a wallet-signed message. Required to call the forum API.
Dynamic IPFS APIdynamic-ipfs.raydium.iodynamic-ipfs-devnet.raydium.ioNFT image / metadata regenerator. Drives CLMM position art and other on-chain NFTs whose look depends on dynamic state.
Owner APIowner-v1.raydium.ioowner-v1-devnet.raydium.ioPer-wallet positions, balances, claimable rewards.
API v1api.raydium.io—Legacy v1/v2 endpoints, kept live for clients that have not migrated to API v3.
Temp APItemp-api-v1.raydium.iotemp-api-v1-devnet.raydium.ioHolding pen for short-lived bespoke endpoints. Currently exposes CPMM creator-fee summaries. Subject to change without notice.

​
Authentication

Most services are read-only and accept anonymous requests. Two patterns appear:
  • Wallet-signed handshake — required by launch-auth-v1 to mint a ray-token, then carried as the ray-token header by launch-forum-v1. Sign a Solana ed25519 message of the form time:<unix-seconds> with your wallet, send the signature + wallet address to launch-auth-v1 /request-token, receive a JWT back, and pass it as the ray-token request header on subsequent forum calls.
  • No auth — every other service. Trusted callers (the Raydium UI, integrators) hit the endpoints directly over HTTPS.
The Mintlify playground lets you paste a ray-token in the auth panel before sending forum requests; the value is held in your browser only.

​
Rate limits

All hosts are behind Cloudflare with progressive rate limiting per source IP. Integrators that need higher limits should contact the Raydium team. Bursts above the published limits are returned as HTTP 429 with a Retry-After header.

​
Response envelope

Most services wrap their JSON payloads in a uniform envelope: 
{
  "id": "uuid-v4-per-request",
  "success": true,
  "data": { ... }
}
On failure: 
{
  "id": "uuid-v4-per-request",
  "success": false,
  "msg": "human-readable error string",
  "data": null
}
api-v3 returns the envelope as { "id", "success", "data" }. The pump-* services use addBorderSuccess / addBorderErr helpers that produce the same shape with msg populated only on errors. Check each service’s intro page for the exact envelope it uses.

​
How to use this section

Click any endpoint in the left navigation. You will see:
  • The HTTP method, full URL, and base host.
  • Request parameters with types pulled from the OpenAPI spec.
  • A Try it panel that lets you set parameters and send a real request to mainnet (or pick a devnet server from the dropdown when available).
  • The response shape, sourced from a representative live response and the source code’s addBorderSuccess callsite.
For SDK-level access — building transactions client-side, batching swaps, the TypeScript types — see sdk-api/typescript-sdk.

​
Pointers