Wallet API
Update Wallet Account

Update Wallet Account#

Change the addresses bound under a specific wallet account.

Note
When using this API to add addresses, you need to use the Signing 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#

ParameterTypeRequiredDescription
accountIdStringYesUnique identifier of the account
updateTypeStringYesadd: Add addresses
delete: Delete addresses
addressesArrayYesList of addresses. (Maximum 50 addresses per call)
>chainIndexStringYesUnique identifier of the chain
>addressStringYesAddress, for a specific chainIndex, the address can only appear under one wallet account
>signatureStringYesSignature, required only when updateType is add

Refer to Quickstart on how to obtain the signature
And for chains other than EVM-based, see here.
>publicKeyStringYesPublic key, required only when updateType is add
signMessageStringYesMessage field for signature verification, 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"
}