> ## 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.

# REST API yüzeyi

> Raydium'un on bir genel HTTP hizmetine ilişkin yüksek düzey genel bakış — her birinin yaptığı iş, paylaştıkları kurallar (yanıt zarfı, kimlik doğrulama, oran sınırları, önbellekleme) ve bir entegrasyon için doğru hizmetin seçilmesi.

<Info>
  **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 →](/sdk-api/rest-api)
</Info>

<Info>
  **Endpoint-düzeyinde belgeler [API Referansı](/tr/api-reference) 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.
</Info>

## On bir hizmete hızlı bakış

Raydium on bir genel HTTP hizmetini çalıştırır. Her biri [API Referansı](/tr/api-reference) sekmesinde kendi grubu olarak belgelenmiştir ve etkileşimli oyun alanını destekleyen bir OpenAPI spec'i vardır.

| Hizmet                                                                  | Mainnet adresi                 | Devnet adresi                         | Ne sunduğu                                                                                                                   |
| ----------------------------------------------------------------------- | ------------------------------ | ------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| [API v3](/tr/api-reference/api-v3/overview)                             | `api-v3.raydium.io`            | `api-v3-devnet.raydium.io`            | Kanonik 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'si](/tr/api-reference/route-api-v2/overview)                 | `transaction-v1.raydium.io`    | `transaction-v1-devnet.raydium.io`    | Sunucu tarafında swap işlemi oluşturma.                                                                                      |
| [Perps API'si](/tr/api-reference/perp-api-v1/overview)                  | `api-perp-v1.raydium.io`       | —                                     | Raydium Perps ön yüzü için ayarlar, varlık metaveri, RPC seçimi.                                                             |
| [LaunchLab Mint API'si](/tr/api-reference/launch-mint-v1/overview)      | `launch-mint-v1.raydium.io`    | `launch-mint-v1-devnet.raydium.io`    | Token arama, dizinler, lider tabloları, mint başına metaveri.                                                                |
| [LaunchLab Geçmiş API'si](/tr/api-reference/launch-history-v1/overview) | `launch-history-v1.raydium.io` | `launch-history-v1-devnet.raydium.io` | LaunchLab pool'ları için işlem geçmişi ve OHLC k-line toplamaları.                                                           |
| [LaunchLab Forum API'si](/tr/api-reference/launch-forum-v1/overview)    | `launch-forum-v1.raydium.io`   | `launch-forum-v1-devnet.raydium.io`   | LaunchLab başlatmalarında yorum dizileri ve IPFS yüklemeleri. **Cüzdan imzalı.**                                             |
| [LaunchLab Auth API'si](/tr/api-reference/launch-auth-v1/overview)      | `launch-auth-v1.raydium.io`    | `launch-auth-v1-devnet.raydium.io`    | Cüzdan imzalı bir mesajdan kısa ömürlü `ray-token` JWT'leri çıkarır. Forum tarafından gereklidir.                            |
| [Dinamik IPFS API'si](/tr/api-reference/dynamic-ipfs-v1/overview)       | `dynamic-ipfs.raydium.io`      | `dynamic-ipfs-devnet.raydium.io`      | Dinamik NFT'ler (CLMM pozisyonları vb.) için görüntü / metaveri yeniden oluşturma.                                           |
| [Sahibi API'si](/tr/api-reference/owner-api-v1/overview)                | `owner-v1.raydium.io`          | `owner-v1-devnet.raydium.io`          | Cüzdan başına pozisyonlar, bakiyeler, talep edilebilir ödüller.                                                              |
| [API v1 (eski)](/tr/api-reference/api-v1/overview)                      | `api.raydium.io`               | —                                     | API v3'e geçirmemiş istemciler için `/v1` ve `/v2` yolları canlı tutulur.                                                    |
| [Geçici API](/tr/api-reference/temp-api-v1/overview)                    | `temp-api-v1.raydium.io`       | `temp-api-v1-devnet.raydium.io`       | Kı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ı okuyun                        | **API v3**                                                           |
| Mint metaverisi (ad, sembol, logo, ondalıklar, risk etiketleri) okuyun                      | **API 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 getirin       | **LaunchLab Mint API'si**                                            |
| LaunchLab pool'u için k-line / mum grafik oluşturun                                         | **LaunchLab Geçmiş API'si**                                          |
| LaunchLab başlatmasında yorum gönderin veya okuyun                                          | **LaunchLab Auth API'si** → `ray-token` → **LaunchLab Forum API'si** |
| CLMM pozisyon NFT görüntüsü oluşturun                                                       | **Dinamik IPFS API'si**                                              |
| Perps kullanıcı arayüzü için vadeli işlem pazar ayarlarını veya varlık listelerini gösterin | **Perps API'si**                                                     |
| v1/v2 yol ön ekli istemciyle uyumluluğu sürdürün                                            | **API v1 (eski)**                                                    |

## Kesişen kurallar

### Yanıt zarfı

IPFS dışında her hizmet aynı JSON zarfını döndürür:

```json theme={null}
{
  "id":      "uuid-v4-per-request",
  "success": true,
  "data":    { ... }
}
```

Başarısızlık durumunda:

```json theme={null}
{
  "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:

```json theme={null}
{
  "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ı](/tr/api-reference) 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ı](/tr/api-reference). 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`](/tr/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`](/tr/integration-guides/aggregator). Raydium likiditelini çok-DEX agregleyiciye bağlamaya yönelik desenler.
* **Yapay zeka dostu belgeler** — [`sdk-api/ai-integration`](/tr/sdk-api/ai-integration). Bu API'leri çağırması gereken yapay zeka kodlama ajanları için işaretçiler.