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

تولید آدرس واریز جدید

POST 
/users/wallets/deposit/address/generate

یک آدرس واریز جدید برای ارز و شبکه درخواستی می‌سازد.

برخلاف POST /users/wallets/generate-address، این API آدرس فعلی را برنمی‌گرداند؛ هر فراخوانی موفق آدرس تازه‌ای می‌سازد و آدرس‌های قبلی فعال می‌مانند.

محدودیت‌ها​

  • فراخوانی: ۵ درخواست در دقیقه
  • در صورت استفاده از API Key، دسترسی DEPOSIT روی کلید الزامی است.
  • کاربر باید حداقل سطح ۱ باشد؛ در غیر این صورت CoinDepositLimitation با HTTP 200 برمی‌گردد.

نکات​

  • coin و network الزامی‌اند و به بزرگی و کوچکی حروف حساس نیستند.
  • title اختیاری است. اگر ارسال نشود، null باشد، خالی باشد یا فقط فاصله باشد، عنوان null ذخیره می‌شود. عنوان غیرخالی فاصله‌گیری می‌شود و حداکثر ۲۵۶ کاراکتر است.
  • اگر چند فیلد نامعتبر باشد، فقط خطای اولین فیلد گزارش می‌شود.
  • شبکه‌های مبتنی بر تگ/ممو مانند XRP و TON پشتیبانی نمی‌شوند (NetworkNotSupported).
  • شبکه لایتنینگ (BTCLN) پشتیبانی نمی‌شود؛ برای آن از POST /users/wallets/invoice/generate استفاده کنید.
  • اگر واریز آن ارز روی آن شبکه غیرفعال باشد، DepositNotSupported برمی‌گردد.
  • اگر جفت ارز-شبکه وجود نداشته باشد، NetworkCoinPairNotFound برمی‌گردد.
  • اگر کاربر به واریز آن جفت دسترسی محدود داشته باشد، DepositNotAvailable با HTTP 403 برمی‌گردد.
  • ارزهای آزمایشی یا شبکه‌های بتا بدون دسترسی لازم InvalidCurrency می‌شوند.
  • فیلد network در پاسخ همان شبکهٔ درخواست‌شده است (پس از تبدیل شبکه‌های شبه‌شبکه مثل WETH-ETH به شبکهٔ پایه).
  • در شبکه Harmony (ONE) آدرس پاسخ با پیشوند one1 است. اگر تبدیل ناموفق باشد، address برابر null است و status همچنان ok می‌ماند.
  • فیلد addressType در پاسخ نیست.

سقف آدرس بدون واریز​

سقف روی شبکهٔ مبدأ است، نه روی شبکهٔ درخواستی. تا وقتی تعداد مشخصی آدرس فعال روی همان کیف‌پول و شبکهٔ مبدأ داشته باشید که هنوز هیچ واریزی روی آن‌ها شناسایی نشده، ساخت آدرس جدید با HTTP 400 و کد NoConfirmedWalletDepositLimitation رد می‌شود.

  • شناسایی واریز کافی است؛ لازم نیست واریز حتماً در وضعیت تأیید نهایی باشد.
  • آدرس‌های غیرفعال (isDisabled: true) در این سقف شمرده نمی‌شوند.
  • واریز روی همان رشتهٔ آدرس، حتی اگر برای ارز دیگری روی همان زنجیره ثبت شده باشد، آن آدرس را از سقف خارج می‌کند.

Request​

Responses​

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