پرش به مطلب اصلی

فهرست آدرس‌های واریز

GET 
/users/wallets/deposit/address/list

آدرس‌های واریز کاربر را برای یک ارز و شبکه برمی‌گرداند.

محدودیت‌ها​

  • فراخوانی: ۱۰ درخواست در دقیقه
  • در صورت استفاده از API Key، دسترسی DEPOSIT روی کلید الزامی است.

نکات​

  • network و coin الزامی هستند و به بزرگی و کوچکی حروف حساس نیستند (eth و ETH یکسان‌اند).
  • لیست شبکه‌ها را می‌توانید از تنظیمات سیستم ببینید.
  • شبکه‌های مبتنی بر تگ/ممو مانند XRP و TON در این API پشتیبانی نمی‌شوند (NetworkNotSupported).
  • اگر واریز آن ارز روی آن شبکه بسته باشد، آدرس‌هایی که از قبل دارید همچنان در فهرست هستند.
  • اگر کاربر به واریز آن جفت دسترسی نداشته باشد، پاسخ موفق با لیست خالی برمی‌گردد (status: ok و addresses: []). ساخت آدرس جدید در این حالت همچنان رد می‌شود.
  • آدرس‌های ساخته‌شده پیش از ۱۸ ژوئن ۲۰۲۵ (۲۸ خرداد ۱۴۰۴، ساعت ۰۰:۰۰ به وقت تهران) در این فهرست نیستند.
  • is_disabled را اگر نفرستید، هم آدرس‌های فعال و هم غیرفعال برمی‌گردند. false فقط فعال‌ها و true فقط غیرفعال‌ها را برمی‌گرداند.
  • search زیررشته‌ای از عنوان است و به بزرگی و کوچکی حروف حساس نیست.
  • ترتیب پیش‌فرض جدیدترین آدرس است (-created_at).
  • صفحه‌بندی با page (پیش‌فرض 1) و pageSize (پیش‌فرض 50) است. اگر صفحه بعدی وجود داشته باشد hasNext برابر true است.
  • اگر چند فیلد نامعتبر باشد، فقط خطای اولین فیلد گزارش می‌شود.
  • فیلد addressType در پاسخ نیست.
  • در شبکه Harmony (ONE) آدرس به‌صورت bech32 با پیشوند one1 برمی‌گردد. اگر تبدیل آدرس ممکن نباشد، address برابر null است و status همچنان ok می‌ماند.

Request​

Responses​

فهرست آدرس‌ها، یا خطای کسب‌وکاری که با HTTP 200 برمی‌گردد