查询提现地址簿

描述

查询账户下已绑定的提现地址簿，获取地址标签、链类型、地址状态等信息。

HTTP请求

• GET /api/v3/account/withdraw-address
• 限频规则: 1次/秒/UID
• 需要钱包只读权限

请求示例

curl "https://api.bitget.com/api/v3/account/withdraw-address?coin=BTC&type=regular&limit=10" \
  -H "ACCESS-KEY:your apiKey" \
  -H "ACCESS-SIGN:*" \
  -H "ACCESS-PASSPHRASE:*" \
  -H "ACCESS-TIMESTAMP:1659076670000" \
  -H "locale:zh-CN" \
  -H "Content-Type: application/json"

请求参数

参数名	参数类型	是否必须	描述
coin	String	否	币种名称，如 BTC、ETH。不传则返回所有币种。仅支持普通地址查询，不支持EVM地址、通用地址及内部地址查询
type	String	否	地址簿类型：EVM EVM地址 / regular 普通地址 / universal 通用地址 / internal 内部地址
limit	String	否	每页条目数，默认为10，最大为10
cursor	String	否	游标ID，用于翻页

返回示例

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1740000000000,
  "data": {
    "addressList": [
      {
        "coin": "BTC",
        "chain": "BTC",
        "address": "1A1zP1eP5QGefi2DMPTfTL5SLmv7Divf",
        "countryCode": "",
        "label": "我的BTC钱包",
        "memo": "",
        "type": "regular",
        "internalType": "",
        "createdTime": "1740000000000"
      }
    ],
    "cursor": "1740000000000"
  }
}

返回参数

返回字段	参数类型	字段说明
addressList	Array	地址簿列表
>coin	String	币种名称
>chain	String	链名称
>address	String	提现地址。当 type=internal 时，该字段返回UID、手机号或邮箱
>countryCode	String	国家号，仅 internalType=mobile 时返回
>label	String	地址标签（用户自定义）
>memo	String	Memo，部分链需要（如 XRP、EOS），无则为空字符串
>type	String	地址簿类型：regular 普通地址 / EVM EVM地址 / universal 通用地址 / internal 内部地址
>internalType	String	内部转账类别：uid UID / mobile 手机号 / email 邮箱，仅 type=internal 时有值
>createdTime	String	创建时间（Unix毫秒时间戳）
cursor	String	下一页游标ID