واجهة برمجة تطبيقات الصفقات

مقدمة

الصفقات هي الجانب الفيات من محرك التبادل. نفس نقاط النهاية، نفس التدفق — فقط مع عملة تقليدية على أحد الجانبين (دخول نقدي أو خروج نقدي) بدلاً من أصلين رقميين. استخدمها للسماح للمستخدمين بشراء العملات الرقمية بـ USD/EUR/AED أو صرف العملات الرقمية إلى حساب بنكي.

تتطلب جميع نقاط النهاية أدناه رأس مطور api-key. تواصل معنا للحصول على واحد.

api-key: YOUR_P3P_API_KEY

كيف تعمل العملات التقليدية

الصفقة هي ببساطة تبادل حيث يكون أحد الجانبين أصلاً تقليدياً بدلاً من رمز سلسلة. عيّن asset_from (أو asset_to) إلى مفتاح فيات مثل "usd" أو "eur" أو "aed" — وتجاوز حقلي chain_* / token_* المطابقين على ذلك الجانب. يتم تبديل نوع الطلب تلقائياً إلى "cash".

نقاط النهاية

1. جلب العملات التقليدية2. جلب الأسعار3. الحصول على عرض سعر الصفقة4. إنشاء صفقة

---

1. جلب العملات التقليدية

GET /fiats api-key مطلوب

يعيد كل عملة تقليدية مدعومة حالياً.

curl https://api.p3p.xyz/fiats \
  -H "api-key: YOUR_P3P_API_KEY"

{
  "usd": { "key": "usd", "name": "US Dollar", "enabled": true },
  "eur": { "key": "eur", "name": "Euro", "enabled": true },
  "aed": { "key": "aed", "name": "UAE Dirham", "enabled": true }
}

---

2. جلب الأسعار

GET /rates api-key مطلوب

نفس نقطة نهاية /rates كما في التبادلات — تعيد الأسعار المرجعية لكل من الأصول الرقمية والتقليدية.

curl https://api.p3p.xyz/rates \
  -H "api-key: YOUR_P3P_API_KEY"

---

3. الحصول على عرض سعر الصفقة

POST /exchange/rate api-key مطلوب

نفس نقطة النهاية كتبادلات العملات الرقمية. ضع مفتاح فيات في asset_from أو asset_to للتبديل إلى وضع الصفقة.

من تقليدية → إلى رقمية

يريد المستخدم شراء عملات رقمية بالنقد.

curl -X POST https://api.p3p.xyz/exchange/rate \
  -H "Content-Type: application/json" \
  -H "api-key: YOUR_P3P_API_KEY" \
  -d '{
    "asset_from": "usd",
    "amount_from": "100",
    "chain_to": "eth",
    "token_to": "usdt"
  }'

من رقمية → إلى تقليدية

يريد المستخدم صرف عملات رقمية.

curl -X POST https://api.p3p.xyz/exchange/rate \
  -H "Content-Type: application/json" \
  -H "api-key: YOUR_P3P_API_KEY" \
  -d '{
    "chain_from": "eth",
    "token_from": "usdt",
    "amount_from": "100",
    "asset_to": "aed"
  }'

---

4. إنشاء صفقة

POST /exchange/create api-key مطلوب

نفس نقطة النهاية كتبادلات العملات الرقمية. اقفل سعر الصفقة واستلم تعليمات الدفع للجانب النقدي، أو عنوان إيداع للجانب الرقمي.

من تقليدية → إلى رقمية

curl -X POST https://api.p3p.xyz/exchange/create \
  -H "Content-Type: application/json" \
  -H "api-key: YOUR_P3P_API_KEY" \
  -d '{
    "asset_from": "usd",
    "amount_from": "100",
    "chain_to": "eth", "token_to": "usdt",
    "wallet_to": "0xRecipient...address"
  }'

من رقمية → إلى تقليدية

curl -X POST https://api.p3p.xyz/exchange/create \
  -H "Content-Type: application/json" \
  -H "api-key: YOUR_P3P_API_KEY" \
  -d '{
    "chain_from": "eth", "token_from": "usdt", "amount_from": "100",
    "asset_to": "aed",
    "wallet_to": "iban:AE07..."
  }'

تتبع الصفقة باستخدام نفس نقطة نهاية التحقق من حالة التبادل.