Update User Wallet#
Change the addresses bound under a specific user wallet account.
Note
When using this API to add addresses, you need to use the offline SDK to generate a signature with the private key based on the current UNIX timestamp and attach it to the API request parameters.
Request Path#
POST https://www.okx.com/api/v5/waas/wallet/account/update-account
Request Parameters#
| Parameter | Type | Required | Description |
|---|---|---|---|
| accountId | String | Yes | Unique identifier of the wallet account |
| updateType | String | Yes | add: Add addresses delete: Delete addresses |
| addresses | Array | Yes | List of addresses. (Maximum 50 addresses per call) |
| >chainIndex | String | Yes | Unique identifier of the chain |
| >address | String | Yes | Address, for a specific chainIndex, the address can only appear under one user wallet account |
| >signature | String | Yes | Signature, required only when updateType is add Refer to Quick Start on how to obtain the signature And for chains other than EVM-based, see here. |
| >publicKey | String | Yes | Public key, required only when updateType is add |
| signMessage | String | Yes | Message field for signature authentication, default is the stringified UNIX timestamp (milliseconds), required only when updateType is add |
Response Parameters#
None
Request Example#
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"
}'
Response Example#
200
{
"code": "0",
"data": [],
"msg": "success"
}