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

# Raydium API v3

> واجهة REST API للاستعلام عن حمامات السيولة وبيانات الرموز والمزارع والإحصائيات على Solana

<Info>
  **هذه الصفحة مُترجَمة آليًا بواسطة الذكاء الاصطناعي. النسخة الإنجليزية هي المرجع المعتمد.**

  [عرض النسخة الإنجليزية →](/api-reference/api-v3/overview)
</Info>

## ما هو Raydium API v3؟

يوفر Raydium API v3 واجهة REST للاستعلام عن حمامات السيولة وبيانات الرموز والمزارع والإحصائيات على منصات التداول التابعة لـ Raydium على Solana. يستخدمه المحافظ والمجمعات والموجهات الآلية والمتاجرون للحصول على بيانات حمامات موثوقة وتغذيات الأسعار والتحليلات التاريخية.

تم تصميم API لمعالجة إنتاجية عالية — عادة ما تكون الاستجابات بتأخير 1-5 دقائق حسب حساسية نقطة النهاية. يتم لف جميع الاستجابات في غلاف متسق يتضمن البيانات الوصفية.

## خوادم الأساس

| البيئة      | URL                                |
| ----------- | ---------------------------------- |
| **Mainnet** | `https://api-v3.raydium.io`        |
| **Devnet**  | `https://api-v3-devnet.raydium.io` |

## غلاف الاستجابة

تُرجع جميع نقاط النهاية غلافًا من JSON يتضمن بيانات وصفية للطلب والحمولة:

### استجابة ناجحة

```json theme={null}
{
  "id": "abc123def456",
  "success": true,
  "data": {
    // Endpoint-specific data
  }
}
```

### استجابة خطأ

```json theme={null}
{
  "id": "abc123def456",
  "success": false,
  "msg": "query ids type error"
}
```

حقل `id` هو معرّف طلب فريد (UUID). تحقق دائمًا من `success` قبل معالجة `data`.

## المشاكل الشائعة

### ترتيب زوج الرمز على `/pools/info/mint`

عند الاستعلام عن `/pools/info/mint?mint1=ABC&mint2=XYZ`، توحّد نقطة النهاية الزوج داخليًا بترتيب الرموز أبجديًا. إذا كنت بحاجة للبحث عن رمز واحد، فحذف `mint2` تمامًا — سيجد API جميع الحمامات التي تتضمن هذا الرمز.

### قيم مرشح نوع الحمام

تقبل معاملة الاستعلام `poolType` قيمًا محددة:

* `all` — جميع أنواع الحمامات
* `concentrated` — حمامات CLMM فقط
* `standard` — حمامات AMM (منتج ثابت) فقط
* `allFarm` — حمامات بها مزرعة واحدة على الأقل نشطة
* `concentratedFarm` — حمامات مركزة بها مزارع
* `standardFarm` — حمامات قياسية بها مزارع

سيتم رفض الأخطاء الإملائية أو عدم تطابق حالة الأحرف.

### قيم حقل ترتيب الحمام

قيم `poolSortField` الصحيحة هي:

* `default` (يرتب حسب حجم 24 ساعة)
* `liquidity` (TVL)
* `volume24h` و `volume7d` و `volume30d`
* `fee24h` و `fee7d` و `fee30d`
* `apr24h` و `apr7d` و `apr30d`

### الترقيم مع `/pools/info/list-v2`

يستخدم إصدار v2 الترقيم المستند إلى المؤشر عبر `nextPageId`. يتم إرجاع الرمز المعتم في الاستجابة ويجب تمريره حرفيًا. لا تحاول إنشاء مؤشر خاص بك — فهو يرمز حالة Elasticsearch.

### الحدود الافتراضية والحدود القصوى لحجم الصفحة

* `/pools/info/list` و `/pools/info/mint` يحددان `pageSize` بـ **1000** كحد أقصى.
* `/farms/info/lp` يحدد `pageSize` بـ **100** كحد أقصى.
* `/pools/info/list-v2` يحدد `size` بـ **1000** كحد أقصى.

يتم رفض الطلبات التي تتجاوز الحدود برسالة خطأ.

### تكوينات CLMM للرسوم الديناميكية وأوامر الحد

تكشف نقطتا نهاية جديدتان عن بيانات المعايرة لتدفق `CreateCustomizablePool` في CLMM:

* `GET /main/clmm-dynamic-config` — قائمة مستويات `DynamicFeeConfig` (فترة التصفية، فترة الانحطاط، عامل التقليل، الحد الأقصى للبسط، عنصر تحكم الرسم الديناميكي). مرّر `id` واحد من هذه عند إنشاء `createCustomizablePool` مع `enableDynamicFee=true`.
* `GET /main/clmm-limit-order-config` — تكوين أوامر الحد لكل حمام: ما إذا كانت أوامر الحد مفعلة والحد الأدنى من مبلغ الإدخال وحارس `limit_order_admin` خارج السلسلة المصرح به بتسوية الطلبات المملوءة.

بيانات أوامر الحد لكل محفظة (مفتوح / ممتلأ / مغلق) توجد على Temp API؛ انظر [`api-reference/temp-api-v1/overview`](/ar/api-reference/temp-api-v1/overview).

## الوثائق ذات الصلة

* [نظرة عامة على REST API](/ar/sdk-api/rest-api)
* [مرجع API](/ar/api-reference)
* [دليل التكامل للمجمعات](/ar/integration-guides/aggregator)

## مثال على الاستخدام

**الحصول على الإحصائيات الرئيسية:**

```bash theme={null}
curl -s https://api-v3.raydium.io/main/info | jq .
```

**عرض أفضل 10 حمامات حسب TVL:**

```bash theme={null}
curl -s 'https://api-v3.raydium.io/pools/info/list?poolType=all&poolSortField=liquidity&sortType=desc&pageSize=10&page=1' | jq .
```

**الحصول على حمامات SOL-USDC:**

```bash theme={null}
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 .
```

**الحصول على أسعار الرموز:**

```bash theme={null}
curl -s 'https://api-v3.raydium.io/mint/price?mints=So11111111111111111111111111111111111111112,EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v,4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R' | jq .
```

**الحصول على حمامات المزرعة لرمز LP:**

```bash theme={null}
curl -s 'https://api-v3.raydium.io/farms/info/lp?lp=<lp_mint>&pageSize=10&page=1' | jq .
```

## الحالة والتوفر

Raydium API v3 نشط على mainnet. لمراقبة التوفر والحوادث، تابع [@Raydium](https://x.com/Raydium).