钱包 API
创建观察账户

创建观察账户#

绑定多个地址,创建观察账户,实现对资产和交易历史等信息的聚合查询。

注意
观察账户支持的聚合的地址数量有上限,以我们支持的链所对应的数量为准。

另外,对于资产查询功能,观察账户无法指定自定义代币,默认展示OKX平台收录的资产类别。

请求路径#

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

请求参数#

ParameterTypeRequiredDescription
addressesArrayYes地址列表。(单次调用最多50个地址,后续添加可使用更新账户
>chainIndexStringYes链唯一标识
>addressStringYes地址

响应参数#

ParameterTypeDescription
accountIdString账户的唯一标识

请求示例#

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",
        }
    ]
}'

响应示例#

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