Ana içeriğe atla

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.

Bu sayfa yapay zekâ tarafından otomatik olarak çevrilmiştir. İngilizce sürüm esas alınır.İngilizce sürümü görüntüle →
Endpoint-düzeyinde belgeler API Referansı sekmesinde bulunur. Her endpoint’in Mintlify’ın OpenAPI oyun alanı tarafından desteklenen etkileşimli bir Dene paneli vardır — tarayıcıda parametreleri doldurarak canlı mainnet’e (veya mevcut olduğu yerde devnet’e) doğrudan erişim sağlayabilirsiniz. Bu sayfa anlatı eşlikçisidir: hangi hizmetler var, hangisini ne zaman kullanacağınız ve tümünü kapsayan kurallar. GET /pools/info/ids neler kabul eder şeklinde sorularınız varsa, API Referansına tıklayın; “hangi hizmet ile entegre olmalıyım” sorusunun cevabını arıyorsanız, devam edin.

​
On bir hizmete hızlı bakış

Raydium on bir genel HTTP hizmetini çalıştırır. Her biri API Referansı sekmesinde kendi grubu olarak belgelenmiştir ve etkileşimli oyun alanını destekleyen bir OpenAPI spec’i vardır.
HizmetMainnet adresiDevnet adresiNe sunduğu
API v3api-v3.raydium.ioapi-v3-devnet.raydium.ioKanonik pool / mint / config / zincir-bilgi okuma API’si. Kullanıcı arayüzü ve çoğu entegratör için varsayılan giriş kapısı.
İşlem API’sitransaction-v1.raydium.iotransaction-v1-devnet.raydium.ioSunucu tarafında swap işlemi oluşturma.
Perps API’siapi-perp-v1.raydium.io—Raydium Perps ön yüzü için ayarlar, varlık metaveri, RPC seçimi.
LaunchLab Mint API’silaunch-mint-v1.raydium.iolaunch-mint-v1-devnet.raydium.ioToken arama, dizinler, lider tabloları, mint başına metaveri.
LaunchLab Geçmiş API’silaunch-history-v1.raydium.iolaunch-history-v1-devnet.raydium.ioLaunchLab pool’ları için işlem geçmişi ve OHLC k-line toplamaları.
LaunchLab Forum API’silaunch-forum-v1.raydium.iolaunch-forum-v1-devnet.raydium.ioLaunchLab başlatmalarında yorum dizileri ve IPFS yüklemeleri. Cüzdan imzalı.
LaunchLab Auth API’silaunch-auth-v1.raydium.iolaunch-auth-v1-devnet.raydium.ioCüzdan imzalı bir mesajdan kısa ömürlü ray-token JWT’leri çıkarır. Forum tarafından gereklidir.
Dinamik IPFS API’sidynamic-ipfs.raydium.iodynamic-ipfs-devnet.raydium.ioDinamik NFT’ler (CLMM pozisyonları vb.) için görüntü / metaveri yeniden oluşturma.
Sahibi API’siowner-v1.raydium.ioowner-v1-devnet.raydium.ioCüzdan başına pozisyonlar, bakiyeler, talep edilebilir ödüller.
API v1 (eski)api.raydium.io—API v3’e geçirmemiş istemciler için /v1 ve /v2 yolları canlı tutulur.
Geçici APItemp-api-v1.raydium.iotemp-api-v1-devnet.raydium.ioKısa ömürlü özel endpoint’lerin beklemesi için tutulan alan. Yüzey uyarı olmaksızın değişebilir.
Sürüm oluşturma v3 / v1 hizmetleri için ana bilgisayar adında yaşar — daha ileri yol düzeyinde sürüm oluşturma yoktur. Kırıcı değişiklikler çakışmayla birlikte yeni bir ana bilgisayar olarak gönderilir; takım herhangi bir v3 → v4 geçişinde en az 6 aylık çakışmaya kamuoyuna bağlı kalır.

​
Hizmet seçin

Şunu yapmak istiyorsanız…Kullanın
Pool metaverisi, fiyatları, APR’ler, ücret yapılandırmalarını okuyunAPI v3
Mint metaverisi (ad, sembol, logo, ondalıklar, risk etiketleri) okuyunAPI v3 /mint/list, /mint/price
Swap / likidite ekleme / likidite kaldırma işlemini sunucu tarafında oluşturunİşlem API’si
Cüzdanın pozisyonlarını gösterin (LP token’ları, CLMM pozisyonları, farm stake’leri)Sahibi API’si
LaunchLab token’larını arayın, lider tabloları göz atın, mint başına metaveri getirinLaunchLab Mint API’si
LaunchLab pool’u için k-line / mum grafik oluşturunLaunchLab Geçmiş API’si
LaunchLab başlatmasında yorum gönderin veya okuyunLaunchLab Auth API’si → ray-token → LaunchLab Forum API’si
CLMM pozisyon NFT görüntüsü oluşturunDinamik IPFS API’si
Perps kullanıcı arayüzü için vadeli işlem pazar ayarlarını veya varlık listelerini gösterinPerps API’si
v1/v2 yol ön ekli istemciyle uyumluluğu sürdürünAPI v1 (eski)

​
Kesişen kurallar

​
Yanıt zarfı

IPFS dışında her hizmet aynı JSON zarfını döndürür: 
{
  "id":      "uuid-v4-per-request",
  "success": true,
  "data":    { ... }
}
Başarısızlık durumunda: 
{
  "id":      "uuid-v4-per-request",
  "success": false,
  "msg":     "human-readable error string",
  "data":    null
}
Bazı hizmetler ek olarak bir error.code tamsayısı içerir (API v3 bunu küçük sürümler arasında sabit hata tanımlayıcıları için kullanır). Tam şekil için her hizmetin genel bakış sayfasına bakın.

​
Kimlik doğrulama

İki desen görünür:
  • Kimlik doğrulama yok — Forum dışındaki her hizmet. HTTPS üzerinden anonim olarak erişin.
  • Cüzdan imzalı el sıkışma — LaunchLab Forum API’si tarafından gereklidir. time:<unix-seconds> şeklinde bir Solana ed25519 mesajını cüzdan ile imzalayın, imzayı + cüzdan adresini LaunchLab Auth API’sine /request-token gönderin, bir JWT geri alın ve onu sonraki forum çağrılarında ray-token istek başlığı olarak geçirin.
Mintlify oyun alanı, forum istekleri göndermeden önce auth panelinde ray-token kabul eder; değer yalnızca tarayıcınızda tutulur.

​
Oran sınırları

Tüm ana bilgisayarlar, kaynak IP başına aşamalı oran sınırlaması olan Cloudflare’in arkasında bulunur. Entegratörler için yayınlanan rehberlik: Yayınlanan sınırları aşan patlamalar HTTP 429 ve bir Retry-After başlığı ile geri döner. Daha yüksek sınırlara ihtiyacı olan agregleyiciler veya botlar, genel ana bilgisayarları döverken değil, bunun yerine Raydium takımı ile iletişim kurmalıdır — zincir üzerindeki program kimliklerine karşı kendi dizinleyicinizi çalıştırmak da okuma ağır iş yükleri için bir seçenektir.

​
Önbellekleme ve tutarlılık

  • Çoğu API v3 okuma endpoint’i kenarında 5–60 saniye için önbelleğe alınır; belirli TTL’ler her endpoint’in API Referansı sayfasında belirtilmiştir.
  • Önbellek, dizinleyici tarafından gözlemlediği programa dokunma olaylarında geçersiz kılınır.
  • Büyük yeniden kuruluşlar veya tıkanıklık sırasında, API’nin görüşü ile zincir üzerindeki durum arasında 1–2 slot uyuşmazlığı olabilir. SDK ve doğrudan RPC okumalar her zaman daha günceldir — bir istemci bir işlemi imzalamak üzereyse, ilgili hesapları RPC aracılığıyla yeniden getirin, asla bir API değerine kör güvenmeyin.

​
Hata biçimi

Hatalar aynı zarfla HTTP 4xx/5xx olarak geri gelir (success: false, doldurulmuş msg). API v3 ek olarak sabit bir error.code içerir: 
{
  "id":      "uuid-v4-per-request",
  "success": false,
  "msg":     "Pool not found",
  "error":   { "code": 40401, "message": "Pool not found" }
}
error.code API küçük sürümleri arasında sabit olur; bunu istemci mantığında birincil sinyal olarak ve msg değerini insanlar tarafından okunabilir yüzey olarak ele alın.

​
Mint-çifti argüman kuralı

Birçok API v3 endpoint’i mint1=…&mint2=… kabul eder ve mint1 < mint2 gerektirir (artan pubkey bayt sırası). Bu, API’nin çağıranın tercih edilen argüman sırasından bağımsız olarak aynı kanonik pool’u döndürmesini sağlamaktır. Endpoint oluşturmadan önce iki mint’i istemci tarafında sıralayın — API Referansı sekmesindeki endpoint-düzeyinde belgeler bunu uygulandığı yerlerde tekrarlar.

​
Önerilen istemci desenleri

  1. Bir kez hidrate edin, tembel olarak yenileyin. GET /main/info ve GET /mint/list’i (her ikisi de API v3 üzerinde) uygulama yükleme sırasında çekin ve 1 saatlik TTL ile yerel olarak önbelleğe alın. Her ikisi de ağır bir şekilde kenar önbelleğine alınır ve nadiren değişir.
  2. Endpoint’in izin verdiği yerlerde toplu işlem yapın. GET /pools/info/ids?ids=… virgülle ayrılmış bir listeyi kabul eder — on pool’u on istek değil, bir istek içinde getirin.
  3. Sıcak yol fiyat getirişlerinden kaçının. GET /mint/price kullanıcı arayüzü oluşturma için uygundur; bir botta asla bunu döngüde çalıştırmayın. Ticaret botları için, bir dizinleyici çalıştırın veya RPC programSubscribe olaylarına doğrudan abone olun.
  4. Yüksek verim için ayna veya vekil kullanın. Yayınlanan oran sınırı tavanını aşan her şey, genel ana bilgisayarlardan doğrudan değil, kendi önbellek katmanınızdan sunulmalıdır. transaction-v1 karşısında >120 req/min üstün olan agregleyiciler, kendi teklif / rota motorlarını çalıştırmalıdır.
  5. İmzalamadan hemen önce yeniden getirin. API yanıtları 5–60 saniye eski olabilir. İmza zamanında gerçekten doğru bir pool anlık görüntüsü için, SDK aracılığıyla veya doğrudan RPC getMultipleAccounts çağrısı aracılığıyla ilgili hesapları yeniden okuyun. API değerlerini bir yerleşim kaynağı değil, bir arama ipucu olarak ele alın.
  6. Düşük sürtünmeli entegrasyon için İşlem API’sini kullanın. İstemcinizde SDK’yı paketlemek istemiyorsanız (mobil yerel, kısıtlı ortamda bot), İşlem API’si kullanıcının imzalaması için base64 kodlu sürümlendirilmiş bir işlemi döndürecektir. Döndürdüğü swapResponse bir teklif içerir — bunu ~30 saniye için geçerli olarak ele alın.

​
Sonra nereye gidilir

  • Endpoint referansı (etkileşimli) — API Referansı. Her hizmetin kendi grubu vardır; parametreler, yanıt şekli, kod örnekleri ve bir Dene paneli için herhangi bir endpoint’e tıklayın.
  • TypeScript SDK’sı — sdk-api/typescript-sdk. SDK birkaç yol için dahili olarak API v3 tüketir; işlem oluşturma için her zaman RPC’den durumu yeniden alır, asla API’ye kör güvenmez.
  • Ticaret API’si entegrasyonu — integration-guides/aggregator. Raydium likiditelini çok-DEX agregleyiciye bağlamaya yönelik desenler.
  • Yapay zeka dostu belgeler — sdk-api/ai-integration. Bu API’leri çağırması gereken yapay zeka kodlama ajanları için işaretçiler.