钱包 API
更新用户钱包

更新用户钱包#

更改某一用户钱包账户下绑定的地址。

注意
使用此 API 接口增加地址时,需要使用离线SDK,使用私钥对当前 UNIX 时间戳生成签名,并附加在 API 请求参数中。

请求路径#

POST https://www.okx.com/api/v5/waas/wallet/account/update-account

请求参数#

ParameterTypeRequiredDescription
accountIdStringYes钱包账户的唯一标识
updateTypeStringYesadd: 添加
delete: 删除
addressesArrayYes地址列表。(单次调用最多50个地址)
>chainIndexStringYes链唯一标识
>addressStringYes地址,对于某个特定 chainIndex 的 address,仅能在一个用户钱包账户下出现
>signatureStringYes签名,仅在 updateType 为 add 时需要

关于获取消息签名的具体方式,可以参考快速开始
其他链的签名方式可以在此查阅。
>publicKeyStringYes公钥,仅在 updateType 为 add 时需要
signMessageStringYes用于签名鉴权的消息字段,默认使用字符串化的 UNIX 时间戳(毫秒),仅在 updateType 为 add 时需要

响应参数#

请求示例#

shell
curl --location --request POST 'https://www.okx.com/api/v5/waas/wallet/account/update-account' \
--header 'Content-Type: application/json' \
--header 'OK-ACCESS-PROJECT: 86af********d1bc' \
--header 'OK-ACCESS-KEY: 37c541a1-****-****-****-10fe7a038418' \
--header 'OK-ACCESS-SIGN: leaV********3uw=' \
--header 'OK-ACCESS-PASSPHRASE: 1****6' \
--header 'OK-ACCESS-TIMESTAMP: 2023-10-18T12:21:41.274Z' \
--data-raw '{
    "accountId": "13886e05-1265-4b79-8ac3-b7ab46217655",
    "updateType": "add",
    "addresses": [
        {
            "chainIndex":"1",
            "address":"0x561815e02bac6128bbbbc551005ddfd92a5c24db",
            "publicKey":"02012db63bf0380294a6ecf87615fe869384b0510cb910a094254b6844af023ee2",
            "signature":"62acda5e471d9bf0099add50f4845256868d980821c161095651a918d3ef8a6b2286f512028172eabbe46ec2c9c2c20e5c40ff1fb23e1cdfdbed033ad924ce521b"
        },{
            "chainIndex":"0",
            "address":"bc1p939endmmt6pvz7ukeywpfsazz57cc4vdu3d0qerz6crhgrtmerfssls5wy",
            "publicKey":"02e42fd7d3c88bcf014386fa06b5c9eca62778e082b0c6289aac259f2f8b555823",
            "signature":"HxAvRe7XMzSNKN86fJ3F9W+fLiqaD7EENyEzZkInLu8gYZ+zZN/YPDse919/HSBhBEm83rzU6rOZkumhgouj+Z0="
        }
    ],
    "signMessage":"1717062864211"
}'

响应示例#

200
{
    "code": "0",
    "data": [],
    "msg": "success"
}