API Documentation

ادمج قدرات التبادل عبر السلاسل الأصلية القوية لـ MakeSwap مباشرة في تطبيقك.

آمن وغير احتجازي

يتم تنفيذ جميع المبادلات عبر مدققي MPC.

تنفيذ سريع

توجيه محسن من خلال مزودي السيولة JIT.

الأصول المدعومة

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

قائمة الأصول المدعومة

تنسيق معرف الأصل

يتم تعريف الأصول بتنسيق سلسلة: CHAIN.TICKER أو CHAIN.TICKER-CONTRACT

Supported Asset List is intentionally curated to major assets only. Long-tail and scam-token candidates are excluded.

الأصول الأصلية: e.g., ETH.ETH (Ethereum), BTC.BTC (Bitcoin)
أصول الرموز: e.g., ETH.USDC-0xA0b8... (USDC on Ethereum)

المعرف	الاسم	الشبكة	الكسور العشرية
لم يتم العثور على أصول.

GETالحصول على الرموز

جلب القائمة الكاملة للأصول المدعومة برمجياً.

GEThttps://makeswap.io/api/v1/tokens

curl -X GET "https://makeswap.io/api/v1/tokens"

POSTالحصول على عرض

جلب مسارات المبادلة المتاحة وعروض الأسعار لزوج معين.

POSThttps://makeswap.io/api/v1/quote

curl -X POST "https://makeswap.io/api/v1/quote" \
-H "Content-Type: application/json" \
-d '{"sellAsset":"BTC.BTC", "buyAsset":"ETH.ETH", "sellAmount":"0.1"}'

ملعب تفاعلي - احصل على عرض

أصل البيع

أصل الشراء

المبلغ

المعلمات

الحقل	النوع	مطلوب	الوصف
sellAsset	string	Yes	معرف الأصل (مثال 'BTC.BTC')
buyAsset	string	Yes	معرف الأصل (مثال 'ETH.ETH')
sellAmount	string	Yes	المبلغ المراد مبادلته بالوحدات الأصلية

POSTSwap

Create swap transaction details from a previously selected route. This endpoint proxies SwapKit v3 /v3/swap.

POSThttps://makeswap.io/api/v1/swap

curl -X POST "https://makeswap.io/api/v1/swap" \
-H "Content-Type: application/json" \
-d '{ "routeId": "uuid", "sourceAddress": "bc1...", "destinationAddress": "0x123..." }'

الاستجابة:

{
  "routeId": "uuid",
  "targetAddress": "bc1...",
  "tx": "base64_or_hex",
  "swapId": "uuid"
}

POSTتتبع المبادلة

Track swap status using hash + chainId, depositChannelId, or depositAddress.

POSThttps://makeswap.io/api/v1/track

curl -X POST "https://makeswap.io/api/v1/track" \
-H "Content-Type: application/json" \
-d '{ "hash": "0x...", "chainId": "1" }'

الاستجابة:

{
  "id": "12345",
  "status": "deposit_received", // waiting_deposit, sending, complete
  "depositAddress": "...",
  "txHash": null,
  "outAmount": null
}

POSTIntegration Token

Issue short-lived tokens for iframe, SDK, or wallet integrations. You can authenticate with partner credentials or an internal signed request.

POSThttps://makeswap.io/api/v1/integrations/token

curl -X POST "https://makeswap.io/api/v1/integrations/token" \
-H "Content-Type: application/json" \
-d '{ \"origin\": \"https://partner.example\", \"affiliateFeeBps\": 100 }'

Partner mode headers

x-makeswap-key-id
x-makeswap-key-secret

Internal wallet mode headers

x-makeswap-internal-key-id
x-makeswap-internal-timestamp (unix seconds)
x-makeswap-internal-signature (HMAC-SHA256 hex of METHOD\\nPATH\\nTIMESTAMP\\nSHA256(BODY))
x-makeswap-internal-body-sha256 (optional integrity check)

Embed quickstart

<iframe
  src="https://makeswap.io/embed?token=INTEGRATION_TOKEN"
  style="width:100%;min-height:640px;border:0"
  title="MakeSwap Widget"
/>

No-SDK partner onboarding

<iframe
  src="https://makeswap.io/embed/PARTNER_ID?sellAsset=BTC.BTC&buyAsset=ETH.ETH"
  style="width:100%;height:760px;border:0"
  title="MakeSwap Widget"
/>

The partner route validates parent website origin against allowed origins configured in admin.