کیف پول (Wallet)

آدرس واریز، تاریخچه واریز و برداشت، و ثبت درخواست برداشت.

GET/openapi/v1/wallet/deposit-addressآدرس واریز

آدرس واریز ارز دیجیتال برای یک شبکه مشخص را برمی‌گرداند (در صورت نبود، می‌سازد).

پارامتر Query

نام	نوع	توضیح
network*	string	مثلاً TRON یا BSC

نمونه پاسخ

{
  "code": "SUCCESS",
  "data": {
    "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
    "network": "TRON"
  }
}

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

ADVANCED_KYC_NEEDEDINSUFFICIENT_PERMISSIONS

GET/openapi/v1/wallet/depositsتاریخچه واریز

فهرست صفحه‌بندی‌شده واریزهای این حساب.

پارامتر Query

نام	نوع	توضیح
page	integer	پیش‌فرض ۱
limit	integer	حداکثر ۱۰۰، پیش‌فرض ۲۰

نمونه پاسخ

{
  "code": "SUCCESS",
  "data": {
    "fullList": [],
    "result": [],
    "page": 1,
    "limit": 20
  }
}

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

ADVANCED_KYC_NEEDEDINSUFFICIENT_PERMISSIONS

GET/openapi/v1/wallet/withdrawalsتاریخچه برداشت

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

پارامتر Query

نام	نوع	توضیح
page	integer	پیش‌فرض ۱
limit	integer	حداکثر ۱۰۰، پیش‌فرض ۲۰

نمونه پاسخ

{
  "code": "SUCCESS",
  "data": {
    "fullList": [],
    "result": [],
    "page": 1,
    "limit": 20
  }
}

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

ADVANCED_KYC_NEEDEDINSUFFICIENT_PERMISSIONS

GET/openapi/v1/wallet/withdrawals/{id}وضعیت یک برداشت

وضعیت لحظه‌ای یک درخواست برداشت مشخص.

پارامتر مسیر

نام	نوع	توضیح
id*	integer	شناسه تراکنش

نمونه پاسخ

{
  "code": "SUCCESS",
  "data": {
    "id": 991,
    "status": "PENDING_APPROVAL",
    "amount": "50",
    "currency": "usdt",
    "network": "TRC20",
    "toAddress": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
    "txHash": null
  }
}

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

ADVANCED_KYC_NEEDEDWITHDRAWAL_NOT_FOUND

POST/openapi/v1/wallet/withdrawalsثبت درخواست برداشت

آدرس مقصد باید از پیش در فهرست آدرس‌های تأییدشده ثبت شده باشد؛ هر برداشت با وضعیت PENDING_APPROVAL ثبت و برای بررسی دستی نگه‌داشته می‌شود — هرگز به‌صورت خودکار تأیید نمی‌شود.

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

نام	نوع	توضیح
networkSymbol*	string	مثلاً TRC20
currencySlug*	string	مثلاً usdt
toAddress*	string	باید در فهرست آدرس‌های تأییدشده باشد
amount*	number	مقدار برداشت

نمونه پاسخ

{
  "code": "SUCCESS",
  "message": "Withdrawal request submitted and is pending manual approval",
  "data": {
    "transactionId": 991,
    "amount": 50,
    "currency": "usdt",
    "network": "TRC20",
    "status": "PENDING_APPROVAL"
  }
}

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

ADVANCED_KYC_NEEDEDTWO_FACTOR_REQUIREDADDRESS_NOT_VERIFIEDBELOW_MINIMUMINSUFFICIENT_BALANCEIP_WHITELIST_REQUIRED