Zum Hauptinhalt springen

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.

Diese Seite wurde mit KI automatisch übersetzt. Maßgeblich ist stets die englische Version.Englische Version ansehen →
Die Dokumentation auf Endpunkt-Ebene finden Sie im Tab API Reference. Jeder Endpunkt dort hat ein interaktives Try it-Panel, das von Mintlifys OpenAPI-Playground unterstützt wird — füllen Sie Parameter im Browser aus und greifen Sie direkt auf das Live-Mainnet (oder Devnet, falls verfügbar) zu. Diese Seite ist der narrative Begleiter: welche Services es gibt, wann Sie welchen nutzen und welche Konventionen alle Services gemeinsam haben. Wenn Sie nach „was akzeptiert GET /pools/info/ids” suchen, klicken Sie auf die API Reference; wenn Sie nach „welchen Service sollte ich integrieren” suchen, lesen Sie weiter.

​
Die elf Services im Überblick

Raydium betreibt elf öffentliche HTTP-Services. Jeder ist im Tab API Reference als eigene Gruppe dokumentiert und wird durch eine OpenAPI-Spezifikation unterstützt, die den interaktiven Playground ermöglicht.
ServiceMainnet-HostDevnet-HostWas er bereitstellt
API v3api-v3.raydium.ioapi-v3-devnet.raydium.ioKanonische Pool-/Mint-/Config-/Chain-Info-Lese-API. Die Standard-Eingangsschnittstelle für die UI und die meisten Integratoren.
Transaction APItransaction-v1.raydium.iotransaction-v1-devnet.raydium.ioServer-seitige Swap-Transaktionserstellung.
Perps APIapi-perp-v1.raydium.io—Einstellungen, Asset-Metadaten, RPC-Auswahl für die Raydium-Perps-Oberfläche.
LaunchLab Mint APIlaunch-mint-v1.raydium.iolaunch-mint-v1-devnet.raydium.ioTokensuche, Indizes, Leaderboards, Pro-Mint-Metadaten.
LaunchLab History APIlaunch-history-v1.raydium.iolaunch-history-v1-devnet.raydium.ioHandelshistorie und OHLC-K-Line-Aggregate für LaunchLab-Pools.
LaunchLab Forum APIlaunch-forum-v1.raydium.iolaunch-forum-v1-devnet.raydium.ioKommentar-Threads und IPFS-Uploads zu LaunchLab-Starts. Mit Wallet-Signatur.
LaunchLab Auth APIlaunch-auth-v1.raydium.iolaunch-auth-v1-devnet.raydium.ioErstellt kurzlebige ray-token JWTs aus einer mit Wallet signierten Nachricht. Erforderlich für Forum.
Dynamic IPFS APIdynamic-ipfs.raydium.iodynamic-ipfs-devnet.raydium.ioBild-/Metadaten-Regeneration für dynamische NFTs (CLMM-Positionen usw.).
Owner APIowner-v1.raydium.ioowner-v1-devnet.raydium.ioPro-Wallet-Positionen, Guthaben, einforderbare Belohnungen.
API v1 (veraltet)api.raydium.io—Veraltete /v1- und /v2-Pfade bleiben aktiv für Clients, die nicht zu API v3 migriert wurden.
Temp APItemp-api-v1.raydium.iotemp-api-v1-devnet.raydium.ioWartebereich für kurzlebige maßgeschneiderte Endpunkte. Die Oberfläche kann sich ohne Ankündigung ändern.
Die Versionierung befindet sich im Hostnamen für die v3/v1-Services — es gibt keine weitere Versionierung auf Pfadebene. Breaking Changes werden als neuer Host mit Überlappung ausgeliefert; das Team hat sich öffentlich zu mindestens 6 Monaten Überlappung bei jeder v3 → v4 Migration verpflichtet.

​
Service auswählen

Wenn Sie… möchtenVerwenden Sie
Pool-Metadaten, Preise, APRs, Fee-Konfigurationen lesenAPI v3
Mint-Metadaten lesen (Name, Symbol, Logo, Dezimalstellen, Risiko-Tags)API v3 /mint/list, /mint/price
Eine Swap-/Add-Liquidity-/Remove-Liquidity-Transaktion serverseitig erstellenTransaction API
Die Positionen eines Wallets anzeigen (LP-Token, CLMM-Positionen, Farm-Stakes)Owner API
LaunchLab-Token durchsuchen, Leaderboards durchstöbern, Pro-Mint-Metadaten abrufenLaunchLab Mint API
Ein K-Line-/Candlestick-Diagramm für einen LaunchLab-Pool rendernLaunchLab History API
Kommentare zu einem LaunchLab-Start posten oder lesenLaunchLab Auth API → ray-token → LaunchLab Forum API
Ein CLMM-Position-NFT-Bild rendernDynamic IPFS API
Futures-Markteinstellungen oder Asset-Listen für die Perps-UI anzeigenPerps API
Kompatibilität mit einem v1/v2-Pfad-Präfix-Client aufrechterhaltenAPI v1 (veraltet)

​
Übergreifende Konventionen

​
Response-Envelope

Jeder Service außer IPFS gibt dieselbe JSON-Envelope zurück: 
{
  "id":      "uuid-v4-per-request",
  "success": true,
  "data":    { ... }
}
Bei Fehler: 
{
  "id":      "uuid-v4-per-request",
  "success": false,
  "msg":     "human-readable error string",
  "data":    null
}
Einige Services enthalten zusätzlich einen error.code-Integer (API v3 nutzt dies für stabile Fehler-Identifikatoren über Minor-Versionen hinweg). Sehen Sie die Übersichtsseite jedes Services für die genaue Form.

​
Authentifizierung

Es gibt zwei Muster:
  • Keine Authentifizierung — jeder Service außer Forum. Greifen Sie anonym über HTTPS zu.
  • Wallet-signierter Handshake — erforderlich von LaunchLab Forum API. Signieren Sie eine Solana-ed25519-Nachricht der Form time:<unix-seconds> mit Ihrem Wallet, senden Sie die Signatur + Wallet-Adresse an LaunchLab Auth API /request-token, erhalten Sie ein JWT zurück und übergeben Sie es als ray-token-Request-Header bei nachfolgenden Forum-Aufrufen.
Der Mintlify-Playground akzeptiert ray-token im Auth-Panel vor dem Senden von Forum-Anfragen; der Wert wird nur in Ihrem Browser gespeichert.

​
Rate Limits

Alle Hosts sitzen hinter Cloudflare mit progressivem Rate Limiting pro Quell-IP. Veröffentlichte Anleitung für Integratoren: Bursts über den veröffentlichten Limits geben HTTP 429 mit einem Retry-After-Header zurück. Aggregatoren oder Bots, die höhere Limits benötigen, sollten das Raydium-Team kontaktieren, anstatt die öffentlichen Hosts zu bombardieren — das Ausführen Ihres eigenen Indexers gegen die On-Chain-Programm-IDs ist auch eine Option für read-intensive Arbeitslasten.

​
Caching und Konsistenz

  • Die meisten API-v3-Lese-Endpunkte werden am Edge für 5–60 Sekunden gepuffert; spezifische TTLs sind auf der API-Reference-Seite jedes Endpunkts vermerkt.
  • Der Cache wird vom Indexer bei Programm-Berührungsereignissen, die er beobachtet, ungültig gemacht.
  • Bei großen Reorgs oder Stau kann es eine 1–2-Slot-Divergenz zwischen der API-Ansicht und dem On-Chain-Status geben. Das SDK und direkte RPC-Lesevorgänge sind immer aktueller — wenn ein Client kurz davor ist, eine Transaktion zu signieren, rufen Sie die relevanten Konten über RPC neu ab, vertrauen Sie nie blind einem API-Wert.

​
Fehlerformat

Fehler kommen als HTTP 4xx/5xx mit derselben Envelope (success: false, gefülltem msg) zurück. API v3 enthält zusätzlich einen stabilen error.code: 
{
  "id":      "uuid-v4-per-request",
  "success": false,
  "msg":     "Pool not found",
  "error":   { "code": 40401, "message": "Pool not found" }
}
Der error.code ist stabil über Minor-API-Versionen; behandeln Sie ihn als primäres Signal in Client-Logik und msg als menschlich lesbare Oberfläche.

​
Mint-Paar-Argument-Konvention

Viele API-v3-Endpunkte akzeptieren mint1=…&mint2=… und erfordern mint1 < mint2 (aufsteigende Pubkey-Byte-Reihenfolge). Dies ermöglicht der API, denselben kanonischen Pool unabhängig von der bevorzugten Argument-Reihenfolge des Aufrufers zurückzugeben. Sortieren Sie die beiden Mints clientseitig, bevor Sie die URL erstellen — die Dokumentation auf Endpunkt-Ebene in der API Reference wiederholt diese Einschränkung, wo sie gilt.

​
Empfohlene Client-Muster

  1. Einmal füllen, träge aktualisieren. GET /main/info und GET /mint/list (beide auf API v3) beim App-Start abrufen und lokal mit einer 1-Stunden-TTL cachen. Beide sind stark Edge-gepuffert und ändern sich selten.
  2. Massenweise wo der Endpunkt dies zulässt. GET /pools/info/ids?ids=… akzeptiert eine komma-getrennte Liste — zehn Pools in einer Anfrage abrufen, nicht zehn Anfragen.
  3. Heiße Pfad-Preis-Abrufe vermeiden. GET /mint/price ist in Ordnung zum Rendern der UI; führen Sie es niemals in einem Bot aus. Für Trading-Bots führen Sie einen Indexer aus oder abonnieren Sie programSubscribe-Ereignisse direkt über RPC.
  4. Spiegeln oder Proxy für hohen Durchsatz. Alles über der veröffentlichten Rate-Limit-Grenze sollte von Ihrem eigenen Cache-Layer bedient werden, nicht direkt von den öffentlichen Hosts. Aggregatoren mit anhaltendem >120 req/min gegen transaction-v1 sollten ihre eigene Quote-/Route-Engine ausführen.
  5. Direkt vor dem Signieren neu abrufen. API-Responses können 5–60s alt sein. Für einen tatsächlich korrekten Pool-Snapshot zum Signierzeitpunkt lesen Sie die relevanten Konten über das SDK oder einen direkten RPC-getMultipleAccounts-Aufruf neu. Behandeln Sie API-Werte als Lookup-Hinweis, nicht als Abwicklungsquelle.
  6. Verwenden Sie die Transaction API für reibungslose Integration. Wenn Sie das SDK nicht in Ihrem Client bündeln möchten (mobil nativ, Bot in einer eingeschränkten Umgebung), gibt die Transaction API eine base64-codierte Versioned-Transaktion zurück, die der Benutzer signieren kann. Die swapResponse, die Sie zurückgibt, enthält ein Zitat — behandeln Sie es als ~30 Sekunden gültig.

​
Wohin Sie gehen sollten

  • Endpunkt-Referenz (interaktiv) — API Reference. Jeder Service hat seine eigene Gruppe; klicken Sie auf einen Endpunkt für Parameter, Response-Form, Code-Beispiele und ein Try-it-Panel.
  • TypeScript SDK — sdk-api/typescript-sdk. Das SDK verbraucht API v3 intern für mehrere Pfade; für Transaktionserstellung ruft es immer den Status von RPC erneut ab, vertraut der API niemals blind.
  • Trade-API-Integration — integration-guides/aggregator. Muster zum Verbinden von Raydium-Liquidität mit einem Multi-DEX-Aggregator.
  • KI-freundliche Docs — sdk-api/ai-integration. Zeiger für KI-Coding-Agenten, die diese APIs aufrufen müssen.