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 →

Was ist Raydium API v3?

Raydium API v3 bietet eine REST-Schnittstelle zum Abfragen von Liquiditätspools, Token-Metadaten, Farms und On-Chain-Statistiken über Raydiums Handelsplattformen auf Solana. Sie wird von Wallets, Aggregatoren, DEX-Routern und Händlern verwendet, um autoritative Pool-Daten, Preisfeeds und historische Analysen abzurufen. Die API ist auf hohen Durchsatz ausgelegt — Responses sind typischerweise 1–5 Minuten veraltet, je nach Empfindlichkeit des Endpoints. Alle Responses sind in einer konsistenten Hülle mit Metadaten verpackt.

Basis-URLs

UmgebungURL
Mainnethttps://api-v3.raydium.io
Devnethttps://api-v3-devnet.raydium.io

Response-Hülle

Alle Endpoints geben eine JSON-Hülle mit Anfrage-Metadaten und dem Response-Payload zurück:

Erfolgreiche Response

{
  "id": "abc123def456",
  "success": true,
  "data": {
    // Endpoint-spezifische Daten
  }
}

Fehler-Response

{
  "id": "abc123def456",
  "success": false,
  "msg": "query ids type error"
}
Das Feld id ist ein eindeutiger Anfrage-Identifikator (UUID). Prüfen Sie immer success, bevor Sie data verarbeiten.

Häufige Fallstricke

Mint-Paar-Reihenfolge bei /pools/info/mint

Wenn Sie /pools/info/mint?mint1=ABC&mint2=XYZ abfragen, normalisiert der Endpoint das Paar intern, indem er die Mints alphabetisch sortiert. Wenn Sie nach einem einzelnen Mint suchen möchten, lassen Sie mint2 ganz weg — die API findet dann alle Pools, die diesen Mint enthalten.

Pool-Typ-Filterwerte

Der Query-Parameter poolType akzeptiert spezifische Enum-Werte:
  • all — alle Pool-Typen
  • concentrated — nur CLMM-Pools
  • standard — nur AMM-(Konstanten-Produkt-)Pools
  • allFarm — Pools mit mindestens einer aktiven Farm
  • concentratedFarm — konzentrierte Pools mit Farms
  • standardFarm — Standard-Pools mit Farms
Tippfehler oder Groß-/Kleinschreibungsfehler werden abgelehnt.

Pool-Sortierungsfeld-Werte

Gültige poolSortField-Werte sind:
  • default (sortiert nach 24h-Volumen)
  • liquidity (TVL)
  • volume24h, volume7d, volume30d
  • fee24h, fee7d, fee30d
  • apr24h, apr7d, apr30d

Pagination bei /pools/info/list-v2

Der v2-Endpoint verwendet cursor-basierte Pagination über nextPageId. Das opake Token wird in der Response zurückgegeben und muss unverändert weitergeleitet werden. Versuchen Sie nicht, Ihren eigenen Cursor zu konstruieren — er kodiert den Elasticsearch-Status.

Seitengröße — Standards und Limits

  • /pools/info/list und /pools/info/mint limitieren pageSize auf 1000.
  • /farms/info/lp limitiert pageSize auf 100.
  • /pools/info/list-v2 limitiert size auf 1000.
Anfragen, die diese Limits überschreiten, werden mit einem Fehler abgelehnt.

CLMM dynamische-Gebühren und Limit-Order-Konfigurationen

Zwei neue Endpoints stellen Kalibrierungsdaten für den CLMM-CreateCustomizablePool-Fluss bereit:
  • GET /main/clmm-dynamic-config — Liste von DynamicFeeConfig-Tiers (Filter-Periode, Decay-Periode, Reduktionsfaktor, maximaler Zähler, Dynamische-Gebühren-Kontrolle). Übergeben Sie die id einer dieser Konfigurationen an createCustomizablePool, wenn enableDynamicFee=true.
  • GET /main/clmm-limit-order-config — Pro-Pool-Limit-Order-Konfiguration: ob Limit Orders aktiviert sind, der Mindesteinzahlungsbetrag und der Off-Chain-limit_order_admin-Keeper, der berechtigt ist, erfüllte Orders zu begleichen.
Wallet-spezifische Limit-Order-Daten (offen / erfüllt / geschlossen) befinden sich auf der Temp API; siehe api-reference/temp-api-v1/overview.

Verwandte Dokumentation

Beispielverwendung

Hauptstatistiken abrufen:
curl -s https://api-v3.raydium.io/main/info | jq .
Top 10 Pools nach TVL auflisten:
curl -s 'https://api-v3.raydium.io/pools/info/list?poolType=all&poolSortField=liquidity&sortType=desc&pageSize=10&page=1' | jq .
SOL-USDC-Pools abrufen:
curl -s 'https://api-v3.raydium.io/pools/info/mint?mint1=So11111111111111111111111111111111111111112&mint2=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v&poolType=all&poolSortField=liquidity&sortType=desc&pageSize=5&page=1' | jq .
Mint-Preise abrufen:
curl -s 'https://api-v3.raydium.io/mint/price?mints=So11111111111111111111111111111111111111112,EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v,4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R' | jq .
Farm-Pools für ein LP-Token abrufen:
curl -s 'https://api-v3.raydium.io/farms/info/lp?lp=<lp_mint>&pageSize=10&page=1' | jq .

Status und Verfügbarkeit

Die Raydium API v3 ist auf Mainnet live. Für Verfügbarkeit und Störungen folgen Sie @Raydium.