تبدیل ارز (Convert)

تبدیل آنی ارز با نرخ لحظه‌ای — پیش‌نمایش، اجرا، تاریخچه و سقف معاملات.

POST/openapi/v1/convert/quoteپیش‌نمایش تبدیل

مبلغ نهایی تبدیل را بدون اجرای واقعی تراکنش برآورد می‌کند.

بدنه درخواست (Body)

نام	نوع	توضیح
symbol*	string	نماد جفت‌ارز
amount*	number	مقدار
side*	string	`"buy"` یا `"sell"`

نمونه پاسخ

{
  "code": "SUCCESS",
  "data": {
    "estimatedAmount": "5820000",
    "rate": "58200",
    "fee": "0.3%"
  }
}

خطاهای احتمالی

ADVANCED_KYC_NEEDEDINSUFFICIENT_PERMISSIONS

POST/openapi/v1/convertاجرای تبدیل

تبدیل را با نرخ لحظه‌ای اجرا می‌کند — دقیقاً همان منطق و کارمزد وب‌سایت.

بدنه درخواست (Body)

نام	نوع	توضیح
symbol*	string	نماد جفت‌ارز
amount*	number	مقدار
side*	string	`"buy"` یا `"sell"`

نمونه پاسخ

{
  "code": "SUCCESS",
  "data": {
    "trackingCode": "EXC-9F2A1C",
    "executedAmount": "5818400",
    "rate": "58184",
    "status": "DONE"
  }
}

خطاهای احتمالی

ADVANCED_KYC_NEEDEDINSUFFICIENT_PERMISSIONS

GET/openapi/v1/convert/historyتاریخچه تبدیل‌ها

فهرست صفحه‌بندی‌شده تبدیل‌های گذشته این حساب.

پارامتر Query

نام	نوع	توضیح
page	integer	پیش‌فرض ۱
limit	integer	حداکثر ۱۰۰، پیش‌فرض ۲۰
side	string	`"buy"` یا `"sell"`
symbol	string	فیلتر بر اساس جفت‌ارز

نمونه پاسخ

{
  "code": "SUCCESS",
  "data": {
    "exchanges": [
      {
        "id": 1,
        "symbol": "USDT-IRT",
        "value": 100,
        "side": "buy",
        "status": "DONE"
      }
    ],
    "totalCount": 1,
    "page": 1,
    "limit": 20
  }
}

خطاهای احتمالی

ADVANCED_KYC_NEEDEDINSUFFICIENT_PERMISSIONS

GET/openapi/v1/convert/limitsسقف معاملات

حداقل و حداکثر مقدار قابل‌معامله برای یک نماد یا ارز.

پارامتر Query

نام	نوع	توضیح
symbol	string	نماد جفت‌ارز
currency	string	کد ارز — جایگزین symbol

نمونه پاسخ

{
  "code": "SUCCESS",
  "data": {
    "symbol": "USDT-IRT",
    "minAmount": "10",
    "maxAmount": "50000"
  }
}

خطاهای احتمالی

ADVANCED_KYC_NEEDEDINSUFFICIENT_PERMISSIONS