Create Watch-Only Wallet#

Bind multiple addresses to create a watch-only wallet account, enabling aggregated queries of assets and transaction history.

Note

The number of addresses supported for aggregation in a watch-only wallet is capped based on the number of our supported networks.

Additionally, for asset query functions, the watch-only wallet cannot specify custom tokens and defaults to displaying asset categories included on the OKX platform.

Request Path#

POST https://www.okx.com/api/v5/waas/wallet/account/create-watch-only-account

Request Parameters#

Parameter	Type	Required	Description
addresses	Array	Yes	List of addresses. (Maximum 50 addresses per call, for subsequent additions, use Update Account)
>chainIndex	String	Yes	Unique identifier of the chain
>address	String	Yes	Address

Response Parameters#

Parameter	Type	Description
accountId	String	Unique identifier of the wallet account

Request Example#

shell

curl --location --request POST 'https://www.okx.com/api/v5/waas/wallet/account/create-watch-only-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 '{
    "addresses": [
        {
            "chainIndex":"1",
            "address":"0x561815e02bac6128bbbbc551005ddfd92a5c24db"
        },{
            "chainIndex":"0",
            "address":"bc1p939endmmt6pvz7ukeywpfsazz57cc4vdu3d0qerz6crhgrtmerfssls5wy"
        }
    ]
}'

Response Example#

200

{
    "code": "0",
    "data": [
        {
            "accountId": "13886e05-1265-4b79-8ac3-b7ab46217655"
        }
    ],
    "msg": "success"
}