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

# REST-API-Oberfläche

> Überblick über Raydiums elf öffentliche HTTP-Services — was jeder leistet, die gemeinsamen Konventionen (Response-Envelope, Authentifizierung, Rate Limits, Caching) und wie Sie den richtigen Service für eine Integration wählen.

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

  [Englische Version ansehen →](/sdk-api/rest-api)
</Info>

<Info>
  **Die Dokumentation auf Endpunkt-Ebene finden Sie im Tab [API Reference](/de/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.
</Info>

## Die elf Services im Überblick

Raydium betreibt elf öffentliche HTTP-Services. Jeder ist im Tab [API Reference](/de/api-reference) als eigene Gruppe dokumentiert und wird durch eine OpenAPI-Spezifikation unterstützt, die den interaktiven Playground ermöglicht.

| Service                                                               | Mainnet-Host                   | Devnet-Host                           | Was er bereitstellt                                                                                                             |
| --------------------------------------------------------------------- | ------------------------------ | ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| [API v3](/de/api-reference/api-v3/overview)                           | `api-v3.raydium.io`            | `api-v3-devnet.raydium.io`            | Kanonische Pool-/Mint-/Config-/Chain-Info-Lese-API. Die Standard-Eingangsschnittstelle für die UI und die meisten Integratoren. |
| [Transaction API](/de/api-reference/route-api-v2/overview)            | `transaction-v1.raydium.io`    | `transaction-v1-devnet.raydium.io`    | Server-seitige Swap-Transaktionserstellung.                                                                                     |
| [Perps API](/de/api-reference/perp-api-v1/overview)                   | `api-perp-v1.raydium.io`       | —                                     | Einstellungen, Asset-Metadaten, RPC-Auswahl für die Raydium-Perps-Oberfläche.                                                   |
| [LaunchLab Mint API](/de/api-reference/launch-mint-v1/overview)       | `launch-mint-v1.raydium.io`    | `launch-mint-v1-devnet.raydium.io`    | Tokensuche, Indizes, Leaderboards, Pro-Mint-Metadaten.                                                                          |
| [LaunchLab History API](/de/api-reference/launch-history-v1/overview) | `launch-history-v1.raydium.io` | `launch-history-v1-devnet.raydium.io` | Handelshistorie und OHLC-K-Line-Aggregate für LaunchLab-Pools.                                                                  |
| [LaunchLab Forum API](/de/api-reference/launch-forum-v1/overview)     | `launch-forum-v1.raydium.io`   | `launch-forum-v1-devnet.raydium.io`   | Kommentar-Threads und IPFS-Uploads zu LaunchLab-Starts. **Mit Wallet-Signatur.**                                                |
| [LaunchLab Auth API](/de/api-reference/launch-auth-v1/overview)       | `launch-auth-v1.raydium.io`    | `launch-auth-v1-devnet.raydium.io`    | Erstellt kurzlebige `ray-token` JWTs aus einer mit Wallet signierten Nachricht. Erforderlich für Forum.                         |
| [Dynamic IPFS API](/de/api-reference/dynamic-ipfs-v1/overview)        | `dynamic-ipfs.raydium.io`      | `dynamic-ipfs-devnet.raydium.io`      | Bild-/Metadaten-Regeneration für dynamische NFTs (CLMM-Positionen usw.).                                                        |
| [Owner API](/de/api-reference/owner-api-v1/overview)                  | `owner-v1.raydium.io`          | `owner-v1-devnet.raydium.io`          | Pro-Wallet-Positionen, Guthaben, einforderbare Belohnungen.                                                                     |
| [API v1 (veraltet)](/de/api-reference/api-v1/overview)                | `api.raydium.io`               | —                                     | Veraltete `/v1`- und `/v2`-Pfade bleiben aktiv für Clients, die nicht zu API v3 migriert wurden.                                |
| [Temp API](/de/api-reference/temp-api-v1/overview)                    | `temp-api-v1.raydium.io`       | `temp-api-v1-devnet.raydium.io`       | Wartebereich 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öchten                                                                  | Verwenden Sie                                                  |
| ---------------------------------------------------------------------------------- | -------------------------------------------------------------- |
| Pool-Metadaten, Preise, APRs, Fee-Konfigurationen lesen                            | **API v3**                                                     |
| Mint-Metadaten lesen (Name, Symbol, Logo, Dezimalstellen, Risiko-Tags)             | **API v3** `/mint/list`, `/mint/price`                         |
| Eine Swap-/Add-Liquidity-/Remove-Liquidity-Transaktion serverseitig erstellen      | **Transaction API**                                            |
| Die Positionen eines Wallets anzeigen (LP-Token, CLMM-Positionen, Farm-Stakes)     | **Owner API**                                                  |
| LaunchLab-Token durchsuchen, Leaderboards durchstöbern, Pro-Mint-Metadaten abrufen | **LaunchLab Mint API**                                         |
| Ein K-Line-/Candlestick-Diagramm für einen LaunchLab-Pool rendern                  | **LaunchLab History API**                                      |
| Kommentare zu einem LaunchLab-Start posten oder lesen                              | **LaunchLab Auth API** → `ray-token` → **LaunchLab Forum API** |
| Ein CLMM-Position-NFT-Bild rendern                                                 | **Dynamic IPFS API**                                           |
| Futures-Markteinstellungen oder Asset-Listen für die Perps-UI anzeigen             | **Perps API**                                                  |
| Kompatibilität mit einem v1/v2-Pfad-Präfix-Client aufrechterhalten                 | **API v1 (veraltet)**                                          |

## Übergreifende Konventionen

### Response-Envelope

Jeder Service außer IPFS gibt dieselbe JSON-Envelope zurück:

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

Bei Fehler:

```json theme={null}
{
  "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`:

```json theme={null}
{
  "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](/de/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](/de/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`](/de/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`](/de/integration-guides/aggregator). Muster zum Verbinden von Raydium-Liquidität mit einem Multi-DEX-Aggregator.
* **KI-freundliche Docs** — [`sdk-api/ai-integration`](/de/sdk-api/ai-integration). Zeiger für KI-Coding-Agenten, die diese APIs aufrufen müssen.