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

# Perps API Übersicht

> Konfigurations- und Metadaten-Service für Raydium Perpetual Futures.

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

  [Englische Version ansehen →](/api-reference/perp-api-v1/overview)
</Info>

## Was ist die Perps API?

Die Raydium Perps API (V1) ist ein Konfigurations- und Metadaten-Service für das Raydium Perpetual Futures Frontend und Integrationen. Sie stellt folgende Funktionen zur Verfügung:

* **UI-Konfiguration** – aktuelle Version, minimale Unterstützungsversion
* **RPC-Endpunkte** – Whitelist von Solana-RPC-Endpunkten für die UI
* **Marktstatistiken** – 24h/7d/30d Handelsvolumen und offene Positionen
* **Regionale Beschränkungen** – Verfügbarkeitsprüfung pro Land
* **Pool-Metadaten** – aktive Perp-Märkte und Volumendaten
* **Kampagnendaten** – Leaderboards, Benutzerstatistiken und Belohnungen
* **P\&L-Freigabe** – Erstellung von teilbaren Position-Screenshots

**Wichtig**: Die Orderaufgabe selbst wird von der Orderly Network API verwaltet. Dieser Service konzentriert sich auf Frontend-Unterstützung und Metadaten.

## Architektur-Übersicht

Das Perps-System besteht aus zwei unabhängigen Komponenten:

1. **Raydium Perp API (dieser Service)** – Liest Konfiguration, stellt UI-Daten bereit, generiert Bilder
2. **Orderly Network** – Führt Orders aus, verwaltet Positionen und Abrechnung

Wenn ein Benutzer eine Perp-Order über die Raydium UI aufgibt:

1. Die UI ruft Marktkonfiguration von dieser API ab (Pools, RPCs, Verfügbarkeit)
2. Die UI sendet die Order an die Orderly Network API
3. Orderly führt die Order aus und verwaltet den Positionszustand
4. Die UI ruft Positionsdaten und Statistiken von Orderly's API oder unserem Campaign-Endpunkt ab

Diese Trennung ermöglicht es Raydium, Metadaten und Branding zu verwalten, während Orderly sich um Order-Matching und Abrechnung kümmert.

## API-Endpunkte nach Kategorie

### Hauptendpunkte

Kernservice-Informationen und Verfügbarkeitsprüfungen.

#### `GET /main/version`

Gibt die aktuelle stabile UI-Version und die minimal unterstützte Version zurück.

**Verwendung**: Prüfen Sie, ob die UI-Version des Clients noch unterstützt wird.

**Antwort**:

```json theme={null}
{
  "id": "...",
  "success": true,
  "data": {
    "latest": "1.2.0",
    "least": "1.0.0"
  }
}
```

#### `GET /main/rpcs`

Gibt Whitelist von Solana-RPC-Endpunkten für die UI zurück.

**Verwendung**: Füllen Sie den RPC-Auswahlbereich in der UI; stellt sicher, dass Clients sich mit stabilen, von Raydium genehmigten Endpunkten verbinden.

#### `GET /main/info`

Gibt marktweite Statistiken zurück.

**Verwendung**: Zeigen Sie 24h-Volumen, 7d-Volumen, 30d-Volumen und Gesamt-/Long-/Short-Open-Interest im Dashboard an.

**Antwort**:

```json theme={null}
{
  "id": "...",
  "success": true,
  "data": {
    "volume": {
      "24h": 1234567,
      "7d": 9876543,
      "30d": 50000000
    },
    "openInterest": {
      "long": 5000000,
      "short": 3000000,
      "all": 8000000
    }
  }
}
```

#### `GET /main/availability-check`

Prüft, ob Perp-Trading in der Region des Benutzers verfügbar ist.

**Verwendung**: Warnen oder Beschränkung des Zugriffs in eingeschränkten Regionen (z. B. USA).

**Funktionsweise**:

* Liest den `cf-ipcountry` Header von Cloudflare (falls hinter Cloudflare)
* Fällt auf eine Standardkonfiguration zurück, wenn der Header fehlt
* Gibt Verfügbarkeitsstatus pro Region zurück

**Antwort**:

```json theme={null}
{
  "id": "...",
  "success": true,
  "data": {
    "available": true,
    "country": "US"
  }
}
```

#### `GET /main/temp-key?wallet=...`

Generiert ein temporäres Ed25519-Keypair für initiale Authentifizierung oder temporäres Signieren.

**Verwendung**: Non-custodiale Generierung temporärer Keys für bestimmte Auth-Flows.

**Antwort**:

```json theme={null}
{
  "id": "...",
  "success": true,
  "data": {
    "key": "ed25519:AAAA..."
  }
}
```

### Pool-Endpunkte

Konfiguration von Perpetual-Märkten.

#### `GET /pool/default-list`

Gibt eine Liste der Standard-Perp-Märkte mit 24h/7d/30d-Volumen zurück.

**Verwendung**: Füllen Sie den Marktauswahlbereich oder ein Dashboard-Widget mit verfügbaren Perp-Paaren.

**Antwort**:

```json theme={null}
{
  "id": "...",
  "success": true,
  "data": [
    {
      "symbol": "BTC/USDC",
      "volume24h": "1000000",
      "volume7d": "7000000",
      "volume30d": "30000000"
    }
  ]
}
```

### Campaign-Endpunkte

Leaderboards, Benutzerstatistiken und Belohnungsdaten.

#### `GET /campaign/configs`

Gibt aktive Kampagnenparameter und Regeln zurück.

**Verwendung**: Zeigen Sie Kampagnenbedingungen und Partizipationsanforderungen in der UI an.

#### `GET /campaign/user?wallet=...&index=0`

Gibt die Kampagnenstatistiken eines Benutzers zurück (Volumen, P\&L, Score, verdiente Belohnungen).

**Verwendung**: Zeigen Sie im Benutzerprofil oder im Konto-Dashboard an.

**Antwort** (Benutzer ohne Historie setzt Daten auf Null):

```json theme={null}
{
  "id": "...",
  "success": true,
  "data": {
    "userInfo": {
      "index": "42",
      "walletAddress": "11111...1111",
      "volume": 500000,
      "pnl": 25000,
      "pnlW": 22500,
      "score": 850,
      "rewards": [...]
    }
  }
}
```

#### `GET /campaign/list?index=0`

Gibt das Leaderboard für einen bestimmten Kampagnenindex zurück (paginiert).

**Verwendung**: Zeigen Sie Top-Trader und Rankings an.

**Antwort**:

```json theme={null}
{
  "id": "...",
  "success": true,
  "data": {
    "updateTime": 1699999999000,
    "rows": [
      {
        "rank": 1,
        "wallet": "11111...1111",
        "volume": 5000000,
        "pnl": 250000,
        "score": 9500
      }
    ]
  }
}
```

### Share-Endpunkte

Generieren Sie teilbare Position-Screenshots.

#### `POST /share/position`

Generiert ein teilbares Bild der aktuellen Perp-Position des Benutzers.

**Verwendung**: Soziale Weitergabe (Twitter, Discord) von aktiven Positionen.

**Anfrage**:

```json theme={null}
{
  "symbol": "BTC/USDC",
  "side": "long",
  "size": "0.5",
  "entryPrice": "45000",
  "markPrice": "46000",
  "pnl": "500",
  "leverage": "5x"
}
```

**Antwort**:

```json theme={null}
{
  "id": "...",
  "success": true,
  "data": {
    "imgFileName": "abc123def456",
    "msg": "Position image generated"
  }
}
```

#### `POST /share/history-position`

Generiert ein teilbares Bild einer geschlossenen Position mit realisiertem P\&L.

**Verwendung**: Teilen Sie geschlossene Trades mit Gewinn-/Verlustdetails.

**Anfrage**:

```json theme={null}
{
  "symbol": "ETH/USDC",
  "side": "short",
  "size": "10",
  "entryPrice": "2500",
  "exitPrice": "2450",
  "realizedPnl": "500"
}
```

**Antwort**: Wie `/share/position`.

## Response-Envelope

Alle Endpunkte geben einen Standard-Envelope zurück:

```json theme={null}
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "success": true,
  "data": { ... }
}
```

Bei Fehler:

```json theme={null}
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "success": false,
  "msg": "Error message or code"
}
```

## Caching

Die meisten Endpunkte geben einen `cache-control: max-age=60` Header zurück, was bedeutet:

* Die Ergebnisse werden auf dem Server gecacht und alle 60 Sekunden aktualisiert
* Clients können ebenfalls für 60 Sekunden cachen, um die Last zu reduzieren
* Echtzeitdaten sind nicht garantiert; erwartet 0–60 Sekunden Veraltung

## Regionale Verfügbarkeit

Regionale Beschränkungen werden über den `cf-ipcountry` Header (Cloudflare) verwaltet. Unterstützte Regionen und Beschränkungen werden serverseitig konfiguriert und regelmäßig aktualisiert.

## Netzwerk-Endpunkte

| Umgebung   | Host                     |
| ---------- | ------------------------ |
| Production | `api-perp-v1.raydium.io` |

Es gibt keine Devnet-Version; Perp-Trading ist nur auf Mainnet verfügbar.

## Integration mit Orderly Network

Um eine Order aufzugeben:

1. Rufen Sie `/campaign/user` oder `/main/info` auf, um Metadaten zu holen und dem Benutzer anzuzeigen
2. Senden Sie die Order an die **Orderly Network API** (nicht diese API)
3. Orderly gibt eine Handelsbestätigung und den Positionszustand zurück
4. Rufen Sie `/campaign/user` später erneut auf, um aktualisierte Statistiken zu sehen

Die Raydium Perp API verwaltet keine Orderaufgabe; sie ist rein ein Read-Only-Service für Metadaten und Konfiguration.

## Siehe auch

* [OpenAPI Specification](/de/api-reference/openapi/perp-api-v1.yaml)
* [Raydium Perpetual Futures](/de/products/perps)
* [Orderly Network](https://orderly.network)