API-Referenz

Katalog aller von Raydium betriebenen HTTP-APIs: Pool-Daten, Transaktionserstellung, Perps, LaunchLab-Forum/Mint/Verlauf/Auth-Services, IPFS-Gateway, Owner-Positionen und die ältere Python-API. Die unten aufgelisteten Endpunkte öffnen sich in einem interaktiven Playground.

Diese Seite wurde mit KI automatisch übersetzt. Maßgeblich ist stets die englische Version.

Englische Version ansehen →

Jeder Endpunkt auf dieser Website hat ein Try it-Panel, das durch Mintlifies OpenAPI-Playground bereitgestellt wird. Der Playground läuft in Ihrem Browser und greift direkt auf die Live-Production- (oder Devnet-)Server zu. Lesen Sie Authentication, bevor Sie Anfragen versenden, die eine Wallet-Signatur erfordern.

​

Service-Katalog

Raydium betreibt elf öffentliche HTTP-Services. Jeder ist als eigene Gruppe im Navigationsbaum auf der linken Seite dokumentiert.

Service	Mainnet-Host	Devnet-Host	Funktionalität
API v3	api-v3.raydium.io	api-v3-devnet.raydium.io	Pool / Mint / Config / Chain-Info — die kanonische Read-API, auf die die UI und das SDK angewiesen sind.
Transaction API	transaction-v1.raydium.io	transaction-v1-devnet.raydium.io	Serverseitige Swap- / Liquiditäts-Transaktionserstellung. Der Aggregator-Einstiegspunkt.
Perps API	api-perp-v1.raydium.io	—	Einstellungen, Asset-Metadaten, RPC-Auswahl für das Raydium Perps Frontend.
LaunchLab Mint API	launch-mint-v1.raydium.io	launch-mint-v1-devnet.raydium.io	Token-Suche, Indizes, Leaderboards, Pro-Mint-Metadaten für LaunchLab-Launches.
LaunchLab History API	launch-history-v1.raydium.io	launch-history-v1-devnet.raydium.io	Handelshistorie, K-Line-Aggregate für LaunchLab Pools.
LaunchLab Forum API	launch-forum-v1.raydium.io	launch-forum-v1-devnet.raydium.io	Kommentare, Threads, IPFS-Uploads gebunden an einen LaunchLab-Launch. Wallet-signiert.
LaunchLab Auth API	launch-auth-v1.raydium.io	launch-auth-v1-devnet.raydium.io	Stellt kurzlebige ray-token JWTs aus einer wallet-signierten Nachricht aus. Erforderlich zum Aufrufen der Forum-API.
Dynamic IPFS API	dynamic-ipfs.raydium.io	dynamic-ipfs-devnet.raydium.io	NFT-Bild / Metadaten-Regenerator. Treibt CLMM-Positions-Art und andere On-Chain-NFTs an, deren Erscheinung vom dynamischen Zustand abhängt.
Owner API	owner-v1.raydium.io	owner-v1-devnet.raydium.io	Pro-Wallet-Positionen, Guthaben, einlösbare Belohnungen.
API v1	api.raydium.io	—	Ältere v1/v2-Endpunkte, am Leben erhalten für Clients, die nicht zu API v3 migriert haben.
Temp API	temp-api-v1.raydium.io	temp-api-v1-devnet.raydium.io	Holding-Bereich für kurzlebige, maßgeschneiderte Endpunkte. Derzeit CPMM-Creator-Fee-Zusammenfassungen verfügbar. Kann ohne Ankündigung geändert werden.

​

Authentication

Die meisten Services sind schreibgeschützt und akzeptieren anonyme Anfragen. Es gibt zwei Muster:

• Wallet-signierter Handshake — erforderlich von launch-auth-v1 zum Prägen eines ray-token, dann getragen als ray-token Header von launch-forum-v1. Signieren Sie eine Solana ed25519-Nachricht der Form time:<unix-seconds> mit Ihrer Wallet, senden Sie die Signatur + Wallet-Adresse an launch-auth-v1 /request-token, erhalten Sie ein JWT zurück und übergeben Sie es als ray-token Request-Header bei nachfolgenden Forum-Aufrufen.
• Keine Authentifizierung — alle anderen Services. Vertrauenswürdige Aufrufer (die Raydium-UI, Integratoren) greifen direkt über HTTPS auf die Endpunkte zu.

Der Mintlify-Playground ermöglicht es Ihnen, ein ray-token im Auth-Panel einzufügen, bevor Sie Forum-Anfragen versenden. Der Wert wird nur in Ihrem Browser gespeichert.

​

Rate Limits

Alle Hosts befinden sich hinter Cloudflare mit progressivem Rate Limiting pro Quell-IP.

Integratoren, die höhere Limits benötigen, sollten das Raydium-Team kontaktieren. Bursts über den veröffentlichten Limits werden als HTTP 429 mit einem Retry-After Header zurückgegeben.

​

Response-Envelope

Die meisten Services wrappen ihre JSON-Payloads in eine einheitliche Envelope:

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

Im Fehlerfall:

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

api-v3 gibt die Envelope als { "id", "success", "data" } zurück. Die pump-* Services verwenden addBorderSuccess / addBorderErr Helper, die die gleiche Form mit msg nur bei Fehlern gefüllt erzeugen. Überprüfen Sie die Intro-Seite jedes Services für die genaue Envelope, die er verwendet.

​

Wie Sie diesen Bereich nutzen

Klicken Sie auf einen Endpunkt in der linken Navigation. Sie sehen:

• Die HTTP-Methode, vollständige URL und Basis-Host.
• Request-Parameter mit Typen aus der OpenAPI-Spezifikation.
• Ein Try it-Panel, mit dem Sie Parameter setzen und eine echte Anfrage an Mainnet senden können (oder einen Devnet-Server aus der Dropdown-Liste auswählen, falls verfügbar).
• Die Response-Form, aus einer repräsentativen Live-Response und der addBorderSuccess Aufrufstelle des Quellcodes.

Für SDK-Zugriff — Transaktionen auf der Client-Seite erstellen, Swaps batchen, die TypeScript-Typen — siehe sdk-api/typescript-sdk.

​

Verweise

• sdk-api/rest-api — narrative Übersicht der REST-Oberfläche, geschrieben für Erstintegratoren.
• integration-guides/aggregator — wie Sie die Transaction API neben On-Chain-Pools verwenden.
• reference/program-addresses — jede von api-v3 zurückgegebene Programm-ID entspricht einer dieser.