> ## 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 Genel Bakış > Raydium Vadeli İşlemler Borsası için yapılandırma ve meta veri hizmeti. **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 →](/api-reference/perp-api-v1/overview) ## 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: 1. **Raydium Perp API (bu hizmet)** – Yapılandırmayı okur, arayüz verilerini sağlar, görüntü oluşturur 2. **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: 1. Arayüz, bu API'den pazar yapılandırmasını alır (havuzlar, RPC'ler, erişilebilirlik) 2. Arayüz, siparişi Orderly Network'ün API'sine gönderir 3. Orderly siparişi yürütür ve pozisyon durumunu tutar 4. 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**: ```json theme={null} { "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**: ```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` 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**: ```json theme={null} { "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**: ```json theme={null} { "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**: ```json theme={null} { "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): ```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` 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**: ```json theme={null} { "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. #### `POST /share/position` 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**: ```json theme={null} { "symbol": "BTC/USDC", "side": "long", "size": "0.5", "entryPrice": "45000", "markPrice": "46000", "pnl": "500", "leverage": "5x" } ``` **Yanıt**: ```json theme={null} { "id": "...", "success": true, "data": { "imgFileName": "abc123def456", "msg": "Position image generated" } } ``` #### `POST /share/history-position` 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**: ```json theme={null} { "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: ```json theme={null} { "id": "550e8400-e29b-41d4-a716-446655440000", "success": true, "data": { ... } } ``` Hata durumunda: ```json theme={null} { "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: 1. Meta verileri alıp kullanıcıya görüntülemek için `/campaign/user` veya `/main/info` çağırın 2. Siparişi **Orderly Network'ün API'sine** gönderin (bu API'ye değil) 3. Orderly bir işlem onayı ve pozisyon durumu döndürür 4. 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. ## Ayrıca Bkz. * [OpenAPI Belirtimi](/tr/api-reference/openapi/perp-api-v1.yaml) * [Raydium Vadeli İşlemler Borsası](/tr/products/perps) * [Orderly Network](https://orderly.network)