提現

若目標地址是Bybit平台內部地址, 您可以實現內部平台轉帳

提示

• 確保您已經將提現地址加入到這裡
• 僅支持母帳號的API key

公式

feeType=0:

• 若百分比手續費 != 0: 手續費 = 輸入金額 / (1 - 百分比手續費) * 百分比手續費 + 固定手續費
• 若百分比手續費 = 0: 手續費 = 固定手續費

feeType=1:

• 若百分比手續費 != 0: 手續費 = 固定手續費 + (輸入金額 - 固定手續費) * 百分比手續費
• 若百分比手續費 = 0: 手續費 = 固定手續費

HTTP 請求

POST /v5/asset/withdraw/create

請求參數

參數	是否必需	類型	說明
coin	true	string	幣種
chain	false	string	鏈名, 當forceChain=0 或者 1: 該字段必填 當forceChain=2: 該字段可忽略
address	true	string	錢包地址或者Bybit UID 當forceChain=0 或者 1: 請填寫錢包地址, 確保將地址添加到了網頁地址簿中, 注意大小寫，請使用和提幣地址簿中完全一樣的地址 當forceChain=2: 僅支持填寫目標Bybit母帳戶UID, 確保將目標UID添加到了網頁地址簿中
tag	false	string	標籤 若添加地址時有填寫tag，則該字段必傳. 注意: 如果鏈不支持tag/memo，請移除地址簿中的tag/memo，然後調用接口時，也不要傳tag字段
amount	true	string	提現金額
timestamp	true	integer	當前時間戳 (毫秒). 用於防止請求重放
forceChain	false	integer	是否強制走鏈 0(默認): 若提現地址解析後發現是平台內部地址，則自動轉為走內部平台轉帳(僅識別Bybit母帳戶錢包地址) 1: 強制走鏈 2: 使用Bybit UID轉帳
accountType	true	string	設置出金帳戶 FUND: 資金錢包出金 SPOT: 現貨錢包(僅限經典賬戶) UTA: 系統從Unified錢包劃轉到Funding錢包, 然後提現 FUND,UTA: 多帳戶組合出金, 優先從資金帳戶扣款, 若資金不足, 再從Unified錢包扣款
feeType	false	integer	手續費選項 0(默認): 輸入金額即實際收到的金額, 所以您需要額外考慮手續費 1: 輸入金額不是實際收到的金額, 系統將會自動計算所需的手續費
requestId	false	string	自定義ID, 全局唯一, 用於冪等校驗 字母(區分大小寫)數字組合, 可以是純字母或者純數字, 長度在1-32字符之間
beneficiary	false	Object	提現目標方基本信息, 僅kyc=KOR(韓國個人用戶)必須傳遞此字段
> vaspEntityId	true	string	接收方交易所id. 請調用該接口來查詢對應的id
> beneficiaryName	false	string	接收方交易所用戶kyc姓名, 比如John Wilson 或者 Wilson John 請依據目標交易所kyc姓名 僅當vaspEntityId="others"時, 該字段可不傳
> beneficiaryLegalType	false	string	受益人法律類型, individual(默認), company TR和KZ及kyc為印度用戶需要傳入參數 韓國用戶可忽略
> beneficiaryWalletType	false	string	受益人錢包類型, 0: 托管錢包 (默認), 1: 非托管錢包 TR和KZ及kyc為印度用戶需要傳入參數 韓國用戶可忽略
> beneficiaryUnhostedWalletType	false	string	受益人未托管錢包類型, 0: 私有錢包, 1: 其他類型錢包 TR和KZ及kyc為印度用戶需要傳入參數 韓國用戶可忽略
> beneficiaryPoiNumber	false	string	受益人POI號碼 TR和KZ用戶需要傳入參數 韓國用戶可忽略
> beneficiaryPoiType	false	string	受益人POI簽發類型 TR和KZ用戶需要傳入: ID card, Passport, driver license, residence permit, Business ID..... 韓國用戶可忽略
> beneficiaryPoiIssuingCountry	false	string	受益人POI簽發國家 TR和KZ用戶需要傳入: 請參考 Alpha-3 country code 韓國用戶可忽略
> beneficiaryPoiExpiredDate	false	string	受益人POI到期日 TR和KZ用戶需要傳入: yyyy-mm-dd 格式, e.g., "1990-02-15" 韓國用戶可忽略

響應參數

參數	類型	說明
id	string	提現Id

請求示例

HTTP

POST /v5/asset/withdraw/create HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-API-KEY: xxxxxxxxxxxxxxxxxx
X-BAPI-TIMESTAMP: 1672196570254
X-BAPI-RECV-WINDOW: 5000
X-BAPI-SIGN: XXXXX
Content-Type: application/json

{
    "coin": "USDT",
    "chain": "ETH",
    "address": "0x99ced129603abc771c0dabe935c326ff6c86645d",
    "amount": "24",
    "timestamp": 1672196561407,
    "forceChain": 0,
    "accountType": "FUND"
}

Python

from pybit.unified_trading import HTTP
session = HTTP(
    testnet=True,
    api_key="xxxxxxxxxxxxxxxxxx",
    api_secret="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
)
print(session.withdraw(
    coin="USDT",
    chain="ETH",
    address="0x99ced129603abc771c0dabe935c326ff6c86645d",
    amount="24",
    timestamp=1672196561407,
    forceChain=0,
    accountType="FUND",
))

Node.js

const { RestClientV5 } = require('bybit-api');

const client = new RestClientV5({
  testnet: true,
  key: 'xxxxxxxxxxxxxxxxxx',
  secret: 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
});

client
  .submitWithdrawal({
    coin: 'USDT',
    chain: 'ETH',
    address: '0x99ced129603abc771c0dabe935c326ff6c86645d',
    amount: '24',
    timestamp: 1672196561407,
    forceChain: 0,
    accountType: 'FUND',
  })
  .then((response) => {
    console.log(response);
  })
  .catch((error) => {
    console.error(error);
  });

響應示例

{
    "retCode": 0,
    "retMsg": "success",
    "result": {
        "id": "10195"
    },
    "retExtInfo": {},
    "time": 1672196571239
}