Perps API Genel Bakış

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 →

Perps API Nedir?

Raydium Perps API (V1), Raydium Vadeli İşlemler Borsası arayüzü ve entegrasyonları için yapılandırma ve meta veri hizmeti sağlayan bir servistir. Sunduğu özellikler şunlardır:

Arayüz yapılandırması – mevcut sürüm, minimum sürüm desteği
RPC uç noktaları – arayüz için beyaz listeye alınmış Solana RPC uç noktaları
Pazar istatistikleri – 24s/7g/30g işlem hacmi ve açık pozisyon
Bölgesel kısıtlamalar – ülkeye göre erişim kontrolleri
Pool meta verileri – aktif vadeli işlem piyasaları ve hacim verileri
Kampanya verileri – lider tablosu, kullanıcı istatistikleri ve ödüller
Kar-Zarar Paylaşımı – paylaşılabilir pozisyon ekran görüntüleri oluşturma

Önemli: Sipariş yerleştirme, Orderly Network’ün API’si tarafından yönetilir. Bu hizmet, ön uç desteği ve meta veriye odaklanır.

Mimariye Genel Bakış

Perps sistemi iki bağımsız bileşenden oluşur:

Raydium Perp API (bu hizmet) – Yapılandırmayı okur, arayüz verilerini sağlar, görüntü oluşturur
Orderly Network – Siparişleri yürütür, pozisyonları yönetir ve anlaşmayı gerçekleştirir

Bir kullanıcı Raydium arayüzü aracılığıyla bir vadeli işlem siparişi verdiğinde:

Arayüz, bu API’den pazar yapılandırmasını alır (havuzlar, RPC’ler, erişilebilirlik)
Arayüz, siparişi Orderly Network’ün API’sine gönderir
Orderly siparişi yürütür ve pozisyon durumunu tutar
Arayüz, pozisyon verilerini ve istatistikleri Orderly’nin API’sinden veya kampanya uç noktamızdan alır

Bu ayrım, Raydium’un meta veriler ve markalaşmayı yönetmesine, Orderly’nin ise siparişleri eşleştirme ve anlaşmanın ağır işlerini yönetmesine olanak tanır.

Kategoriye Göre API Uç Noktaları

Ana Uç Noktalar

Temel hizmet bilgileri ve erişilebilirlik kontrolleri.

`GET /main/version`

Mevcut kararlı arayüz sürümünü ve minimum desteklenen sürümü döndürür. Kullanım: İstemcinin arayüz sürümünün hala desteklenip desteklenmediğini kontrol edin. Yanıt:

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

`GET /main/rpcs`

Arayüzün kullanabileceği beyaz listeye alınmış Solana RPC uç noktalarını döndürür. Kullanım: Arayüzdeki RPC seçicisini doldurun; istemcilerin kararlı, Raydium tarafından onaylanmış uç noktalara bağlanmasını sağlayın.

`GET /main/info`

Pazara geniş istatistikleri döndürür. Kullanım: Panonun üzerinde 24s hacmi, 7g hacmi, 30g hacmi ve toplam/long/short açık pozisyonu gösterin. Yanıt:

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

`GET /main/availability-check`

Vadeli işlem ticaretinin kullanıcının bölgesinde mevcut olup olmadığını kontrol eder. Kullanım: Sınırlı bölgelerde (örn. ABD) erişimi uyar veya kısıtla. Nasıl çalışır:

Cloudflare’den cf-ipcountry başlığını okur (Cloudflare’nin arkasındaysa)
Başlık yoksa varsayılan yapılandırmaya döner
Bölge başına erişilebilirlik durumunu döndürür

Yanıt:

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

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

İlk kimlik doğrulama veya geçici imzalama için geçici bir Ed25519 anahtar çifti oluşturur. Kullanım: Belirli kimlik doğrulama akışları için saklama dışı geçici anahtar oluşturma. Yanıt:

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

Pool Uç Noktaları

Vadeli işlem piyasası yapılandırması.

`GET /pool/default-list`

24s/7g/30g hacmili varsayılan vadeli işlem piyasalarının listesini döndürür. Kullanım: Pazar seçicisini veya pano widget’ını mevcut vadeli işlem çiftleriyle doldurun. Yanıt:

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

Kampanya Uç Noktaları

Lider tablosu, kullanıcı istatistikleri ve ödül verisi.

`GET /campaign/configs`

Aktif kampanya parametrelerini ve kurallarını döndürür. Kullanım: Arayüzde kampanya şartlarını ve katılım gerekliliklerini gösterin.

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

Bir kullanıcının kampanya istatistiklerini döndürür (hacim, Kar-Zarar, puan, kazanılan ödüller). Kullanım: Kullanıcının profili veya hesap panosunda gösterin. Yanıt (geçmiş olmayan kullanıcı sıfırlanan verileri varsayılan alır):

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

`GET /campaign/list?index=0`

Belirli bir kampanya indeksi için lider tablosunu döndürür (sayfalandırılmış). Kullanım: En iyi tüccarları ve sıralamaları gösterin. Yanıt:

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

Paylaş Uç Noktaları

Paylaşılabilir pozisyon ekran görüntüleri oluşturun. Kullanıcının mevcut vadeli işlem pozisyonunun paylaşılabilir bir görüntüsünü oluşturur. Kullanım: Canlı pozisyonları sosyal ağlarda paylaşın (Twitter, Discord). İstek:

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

Yanıt:

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

Gerçekleşen Kar-Zararla kapalı bir pozisyonun paylaşılabilir bir görüntüsünü oluşturur. Kullanım: Kapalı işlemleri kâr/zarar detaylarıyla paylaşın. İstek:

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

Yanıt: /share/position ile aynı.

Yanıt Zarfı

Tüm uç noktalar standart bir zarfı döndürür:

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

Hata durumunda:

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

Önbellekleme

Çoğu uç nokta bir cache-control: max-age=60 başlığı döndürür; bu şu anlama gelir:

Sonuçlar sunucu tarafında önbelleğe alınır ve her 60 saniyede güncellenir
İstemciler yükü azaltmak için 60 saniyeye kadar önbelleğe alabilir
Gerçek zamanlı veri garantilenmez; 0–60 saniye eski veri bekleyin

Bölgesel Erişilebilirlik

Bölgesel kısıtlamalar cf-ipcountry başlığı aracılığıyla yönetilir (Cloudflare). Desteklenen bölgeler ve kısıtlamalar sunucu tarafında yapılandırılır ve periyodik olarak güncellenir.

Ağ Uç Noktaları

Ortam	Ana Bilgisayar
Üretim	`api-perp-v1.raydium.io`

Devnet sürümü yoktur; vadeli işlem ticareti yalnızca mainnet’te kullanılabilir.

Orderly Network ile Entegrasyon

Bir sipariş yerleştirmek için:

Meta verileri alıp kullanıcıya görüntülemek için /campaign/user veya /main/info çağırın
Siparişi Orderly Network’ün API’sine gönderin (bu API’ye değil)
Orderly bir işlem onayı ve pozisyon durumu döndürür
Güncellenmiş istatistikleri görmek için daha sonra /campaign/user yeniden çağırın

Raydium’un perp API’si sipariş yerleştirmeyi yönetmez; tamamen salt okunur meta veri ve yapılandırmadır.

Overview

API v3

Transaction API

Perps API

LaunchLab APIs

Dynamic IPFS API

Owner API

API v1

Temp API

Perps API Genel Bakış

Perps API Nedir?

Mimariye Genel Bakış

Kategoriye Göre API Uç Noktaları

Ana Uç Noktalar

`GET /main/version`

`GET /main/rpcs`

`GET /main/info`

`GET /main/availability-check`

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

Pool Uç Noktaları

`GET /pool/default-list`

Kampanya Uç Noktaları

`GET /campaign/configs`

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

`GET /campaign/list?index=0`

Paylaş Uç Noktaları

Yanıt Zarfı

Önbellekleme

Bölgesel Erişilebilirlik

Ağ Uç Noktaları

Orderly Network ile Entegrasyon

Ayrıca Bkz.

Overview

API v3

Transaction API

Perps API

LaunchLab APIs

Dynamic IPFS API

Owner API

API v1

Temp API

Documentation Index

​Perps API Nedir?

​Mimariye Genel Bakış

​Kategoriye Göre API Uç Noktaları

​Ana Uç Noktalar

​GET /main/version

​GET /main/rpcs

​GET /main/info

​GET /main/availability-check

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

​Pool Uç Noktaları

​GET /pool/default-list

​Kampanya Uç Noktaları

​GET /campaign/configs

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

​GET /campaign/list?index=0

​Paylaş Uç Noktaları

​POST /share/position

​POST /share/history-position

​Yanıt Zarfı

​Önbellekleme

​Bölgesel Erişilebilirlik

​Ağ Uç Noktaları

​Orderly Network ile Entegrasyon

​Ayrıca Bkz.

Perps API Nedir?

Mimariye Genel Bakış

Kategoriye Göre API Uç Noktaları

Ana Uç Noktalar

`GET /main/version`

`GET /main/rpcs`

`GET /main/info`

`GET /main/availability-check`

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

Pool Uç Noktaları

`GET /pool/default-list`

Kampanya Uç Noktaları

`GET /campaign/configs`

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

`GET /campaign/list?index=0`

Paylaş Uç Noktaları

`POST /share/position`

`POST /share/history-position`

Yanıt Zarfı

Önbellekleme

Bölgesel Erişilebilirlik

Ağ Uç Noktaları

Orderly Network ile Entegrasyon

Ayrıca Bkz.