Aperçu de l'API Perps

Cette page est traduite automatiquement par IA. La version anglaise fait foi.Voir la version anglaise →

Qu’est-ce que l’API Perps ?

L’API Raydium Perps (V1) est un service de configuration et de métadonnées pour le frontend Raydium Perpetual Futures et les intégrations. Elle fournit :

Configuration de l’interface utilisateur – version actuelle, support des versions minimales
Points de terminaison RPC – points de terminaison Solana RPC approuvés pour l’interface utilisateur
Statistiques de marché – volume de trading et intérêt ouvert sur 24h/7j/30j
Restrictions régionales – vérifications de disponibilité par pays
Métadonnées des pools – marchés perp actifs et données de volume
Données de campagne – classements, statistiques utilisateur et récompenses
Partage P&L – générer des captures d’écran de positions partageables

Important : Le placement des ordres lui-même est géré par l’API d’Orderly Network. Ce service se concentre sur le support frontend et les métadonnées.

Aperçu de l’architecture

Le système Perps se compose de deux composants indépendants :

API Raydium Perp (ce service) – Lit la configuration, fournit les données de l’interface utilisateur, génère les images
Orderly Network – Exécute les ordres, gère les positions et le règlement

Lorsqu’un utilisateur place un ordre perp via l’interface Raydium :

L’interface récupère la configuration du marché depuis cette API (pools, RPC, disponibilité)
L’interface envoie l’ordre à l’API d’Orderly Network
Orderly exécute l’ordre et maintient l’état de la position
L’interface récupère les données de position et les statistiques depuis l’API d’Orderly ou notre point de terminaison de campagne

Cette séparation permet à Raydium de gérer les métadonnées et la marque, tandis qu’Orderly gère le travail lourd de l’appariement des ordres et du règlement.

Points de terminaison API par catégorie

Points de terminaison principaux

Informations sur le service principal et vérifications de disponibilité.

`GET /main/version`

Retourne la version stable actuelle de l’interface utilisateur et la version minimale supportée. Utilisation : Vérifier si la version de l’interface utilisateur du client est toujours supportée. Réponse :

{
  "id": "...",
  "success": true,
  "data": {
    "latest": "1.2.0",
    "least": "1.0.0"
  }
}

`GET /main/rpcs`

Retourne les points de terminaison Solana RPC approuvés pour l’interface utilisateur. Utilisation : Remplir le sélecteur RPC dans l’interface utilisateur ; garantit que les clients se connectent à des points de terminaison stables et approuvés par Raydium.

`GET /main/info`

Retourne les statistiques du marché global. Utilisation : Afficher le volume 24h, le volume 7d, le volume 30d et l’intérêt ouvert total/long/court sur le tableau de bord. Réponse :

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

`GET /main/availability-check`

Vérifie si le trading perp est disponible dans la région de l’utilisateur. Utilisation : Avertir ou restreindre l’accès dans les régions restreintes (par exemple, USA). Fonctionnement :

Lit l’en-tête cf-ipcountry depuis Cloudflare (si derrière Cloudflare)
Revient à une configuration par défaut si l’en-tête est absent
Retourne le statut de disponibilité par région

Réponse :

{
  "id": "...",
  "success": true,
  "data": {
    "available": true,
    "country": "US"
  }
}

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

Génère une paire de clés Ed25519 temporaire pour l’authentification initiale ou la signature temporaire. Utilisation : Génération de clé temporaire non-custodiale pour certains flux d’authentification. Réponse :

{
  "id": "...",
  "success": true,
  "data": {
    "key": "ed25519:AAAA..."
  }
}

Points de terminaison des pools

Configuration du marché perpétuel.

`GET /pool/default-list`

Retourne la liste des marchés perp par défaut avec le volume 24h/7d/30d. Utilisation : Remplir le sélecteur de marché ou le widget du tableau de bord avec les paires perp disponibles. Réponse :

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

Points de terminaison de campagne

Données de classement, statistiques utilisateur et récompenses.

`GET /campaign/configs`

Retourne les paramètres et règles de campagne actifs. Utilisation : Afficher les conditions de la campagne et les exigences de participation dans l’interface utilisateur.

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

Retourne les statistiques de campagne d’un utilisateur (volume, P&L, score, récompenses gagnées). Utilisation : Afficher dans le profil ou le tableau de bord du compte de l’utilisateur. Réponse (utilisateur sans historique par défaut avec les données à zéro) :

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

`GET /campaign/list?index=0`

Retourne le classement pour un index de campagne donné (paginé). Utilisation : Afficher les meilleurs traders et les classements. Réponse :

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

Points de terminaison de partage

Générer des captures d’écran de position partageables. Génère une image partageables de la position perp actuelle de l’utilisateur. Utilisation : Partage sur les réseaux sociaux (Twitter, Discord) des positions actives. Requête :

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

Réponse :

{
  "id": "...",
  "success": true,
  "data": {
    "imgFileName": "abc123def456",
    "msg": "Position image generated"
  }
}

Génère une image partageable d’une position fermée avec P&L réalisé. Utilisation : Partager les trades fermés avec les détails de profit/perte. Requête :

{
  "symbol": "ETH/USDC",
  "side": "short",
  "size": "10",
  "entryPrice": "2500",
  "exitPrice": "2450",
  "realizedPnl": "500"
}

Réponse : Identique à /share/position.

Enveloppe de réponse

Tous les points de terminaison retournent une enveloppe standard :

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "success": true,
  "data": { ... }
}

En cas d’erreur :

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

Mise en cache

La plupart des points de terminaison retournent un en-tête cache-control: max-age=60, ce qui signifie :

Les résultats sont mis en cache côté serveur et mis à jour toutes les 60 secondes
Les clients peuvent également mettre en cache pendant 60 secondes pour réduire la charge
Les données en temps réel ne sont pas garanties ; attendez-vous à une obsolescence de 0 à 60 secondes

Disponibilité régionale

Les restrictions régionales sont gérées via l’en-tête cf-ipcountry (Cloudflare). Les régions supportées et les restrictions sont configurées côté serveur et mises à jour régulièrement.

Points de terminaison réseau

Environnement	Hôte
Production	`api-perp-v1.raydium.io`

Aucune version devnet n’est disponible ; le trading perp est réservé à mainnet.

Intégration avec Orderly Network

Pour placer un ordre :

Appelez /campaign/user ou /main/info pour récupérer les métadonnées et les afficher à l’utilisateur
Envoyez l’ordre à l’API d’Orderly Network (pas à cette API)
Orderly retourne une confirmation de trade et l’état de la position
Appelez /campaign/user à nouveau plus tard pour voir les statistiques mises à jour

L’API perp de Raydium ne gère pas le placement des ordres ; elle est purement en lecture seule pour les métadonnées et la configuration.

Aperçu

API v3

Transaction API

Perps API

APIs LaunchLab

Dynamic IPFS API

Owner API

API v1

Temp API

Qu’est-ce que l’API Perps ?

Aperçu de l’architecture

Points de terminaison API par catégorie

Points de terminaison principaux

`GET /main/version`

`GET /main/rpcs`

`GET /main/info`

`GET /main/availability-check`

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

Points de terminaison des pools

`GET /pool/default-list`

Points de terminaison de campagne

`GET /campaign/configs`

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

`GET /campaign/list?index=0`

Points de terminaison de partage

Enveloppe de réponse

Mise en cache

Disponibilité régionale

Points de terminaison réseau

Intégration avec Orderly Network

Voir aussi

Aperçu

API v3

Transaction API

Perps API

APIs LaunchLab

Dynamic IPFS API

Owner API

API v1

Temp API

Documentation Index

​Qu’est-ce que l’API Perps ?

​Aperçu de l’architecture

​Points de terminaison API par catégorie

​Points de terminaison principaux

​GET /main/version

​GET /main/rpcs

​GET /main/info

​GET /main/availability-check

​GET /main/temp-key?wallet=...

​Points de terminaison des pools

​GET /pool/default-list

​Points de terminaison de campagne

​GET /campaign/configs

​GET /campaign/user?wallet=...&index=0

​GET /campaign/list?index=0

​Points de terminaison de partage

​POST /share/position

​POST /share/history-position

​Enveloppe de réponse

​Mise en cache

​Disponibilité régionale

​Points de terminaison réseau

​Intégration avec Orderly Network

​Voir aussi

Qu’est-ce que l’API Perps ?

Aperçu de l’architecture

Points de terminaison API par catégorie

Points de terminaison principaux

`GET /main/version`

`GET /main/rpcs`

`GET /main/info`

`GET /main/availability-check`

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

Points de terminaison des pools

`GET /pool/default-list`

Points de terminaison de campagne

`GET /campaign/configs`

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

`GET /campaign/list?index=0`

Points de terminaison de partage

`POST /share/position`

`POST /share/history-position`

Enveloppe de réponse

Mise en cache

Disponibilité régionale

Points de terminaison réseau

Intégration avec Orderly Network

Voir aussi