提現

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

危險

• UTA沒有現貨帳戶
• 如何確定當前帳戶是否為UTA帳戶? 調用該接口, 若uta=1, 則表明該api key所屬的帳戶是UTA帳戶。

警告

• 確保您已經將提現地址加入到這裡
• 僅支持母帳號的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(默認): 若提現地址解析後發現是平台內部地址，則自動轉為走內部平台轉帳 1: 強制走鏈 2: 使用Bybit UID轉帳
accountType	false	string	設置出金帳戶. SPOT：走現貨錢包出金 (默認) FUND：走資金錢包出金
feeType	false	integer	手續費選項 0(默認): 輸入金額即實際收到的金額, 所以您需要額外考慮手續費 1: 輸入金額不是實際收到的金額, 系統將會自動計算所需的手續費
requestId	false	string	自定義ID, 全局唯一, 用於冪等校驗 字母(區分大小寫)數字組合, 可以是純字母或者純數字, 長度在1-32字符之間

響應參數

參數	類型	說明
id	string	提現Id

請求示例

HTTP

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

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

Python

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

響應示例

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