跳转到主要内容
POST
Create Address Book

授权

x-auth-token
string
header
必填

UQPay 提供的用于登录的 API Token。

请求头

x-on-behalf-of
string

指定代表哪个子账户发起请求。应设置为 account_id,可通过 List Connected Accounts 接口获取。若省略或为空,则请求以主账户身份执行。 更多信息参见 Connected Accounts。

x-idempotency-key
string<uuid>

用于保持操作幂等性的唯一标识符(UUID),确保同一操作的重复执行不会产生非预期的影响或重复。在网络错误、重试或失败的情况下,它有助于保持数据一致性。

请求体

application/json
address_label
string
必填

地址标签/名称

示例:

"My USDT Wallet"

network
string
必填

网络代码

示例:

"ETH"

currency
string
必填

币种代码

示例:

"USDT"

address_type
integer
必填

地址类型(1000:交易所,2000:个人钱包)

示例:

2000

wallet_address
string
必填

钱包地址

示例:

"0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb"

address_type=1000:I_CERTIFY_BENEFICIAL_OWNERSHIP_OF_EXCHANGE_ACCOUNT;address_type=2000:I_CERTIFY_THIS_ADDRESS_IS_MINE

可用选项:
I_CERTIFY_BENEFICIAL_OWNERSHIP_OF_EXCHANGE_ACCOUNT,
I_CERTIFY_THIS_ADDRESS_IS_MINE
address_source
string

地址来源(当 address_type=1000 时必填)

示例:

"manual"

is_whitelist
integer

是否将该地址加入白名单(0:否,1:是)

示例:

0

meta_data
object

目的地址的 Travel Rule 数据。当地址属于第三方、为托管(交易所)钱包,或将作为 Binance 提现目的地址时需提供。一旦提供,下列字段将被校验并存储。

响应

200 - application/json

成功创建地址簿条目

code
integer
必填
示例:

200

message
string
必填
示例:

"success"

data
object
必填