查询账户计算余额

接口概述

该接口用于查询系统中已有账户的计算余额数据。单次最多查询 20 个账户的余额数据。每个账户最多返回 100 个币种的余额数据。

• 请求方式：POST

• 请求 URL：https://openapi.elven.com//open/v3/entityAccount/treasuryBalances

请求头参数

参数名	类型	必填	说明
elven-api-key	String	是	分配给您的API密钥
elven-api-sign	String	是	请求签名，用于验证请求合法性
elven-api-timestamp	String	是	请求时间戳，毫秒级

查看详细说明

请求参数

Body 参数

参数名	类型	必填	说明
entityAccountNameList	array	是	要查询的账户名称数组

请求示例

{
    "entityAccountNameList": [
        "B2C2",
        "Co bo",
        "BCB"
    ]
}

响应参数

参数名	类型	说明
status	String	请求状态，值为 “success” 或 “failed”
data	Object	返回的主要数据
requestId	String	请求的唯一标识符

data

参数名	类型	说明
entityAccountname	String	账户名称
entityAccountId	String	账户 id
currencyList	Array	账户余额信息

currencyList 数组元素

参数名	类型	说明
currency	String	币种名称
currencyId	String	币种AssetID
balance	String	原始币种数量
balanceFC	String	报告币种金额

响应示例

{
    "status": "success",
    "data": [
        {
            "entityAccountId": "yBKdI5FKAhz3Q9GPIVcXgWln8opYRDvx",
            "currencyList": [
                {
                    "currency": "BTC",
                    "currencyId": "BTC",
                    "balanceFC": 43568.076457664,
                    "balance": "0.4"
                },
                {
                    "currency": "ETH",
                    "currencyId": "ETH",
                    "balanceFC": 31319.96663412,
                    "balance": "12"
                },
                {
                    "currency": "USDT",
                    "currencyId": "USDT",
                    "balanceFC": 5000.63065,
                    "balance": "5000"
                },
                {
                    "currency": "TRX",
                    "currencyId": "TRX",
                    "balanceFC": 0,
                    "balance": "0"
                },
                {
                    "currency": "EUR",
                    "currencyId": "EUR",
                    "balanceFC": 3657.471606279999,
                    "balance": "3120.199999999999"
                },
                {
                    "currency": "USD",
                    "currencyId": "USD",
                    "balanceFC": -50000,
                    "balance": "-50000"
                }
            ],
            "entityAccountname": "B2C2"
        },
        {
            "entityAccountId": "Wufv1hsNsXviCQE81o7HhR2yZpwdnrjB",
            "currencyList": [
                {
                    "currency": "USD",
                    "currencyId": "USD",
                    "balanceFC": 200,
                    "balance": "200"
                },
                {
                    "currency": "EUR",
                    "currencyId": "EUR",
                    "balanceFC": 11721.914,
                    "balance": "10000"
                },
                {
                    "currency": "JPY",
                    "currencyId": "JPY",
                    "balanceFC": 20427.42,
                    "balance": "3000000"
                },
                {
                    "currency": "SGD",
                    "currencyId": "SGD",
                    "balanceFC": -156.257934,
                    "balance": "-200"
                },
                {
                    "currency": "CHF",
                    "currencyId": "CHF",
                    "balanceFC": 68791.6468766974,
                    "balance": "54785.53"
                }
            ],
            "entityAccountname": "BCB"
        },
        {
            "entityAccountId": "s3AEVolAlLGeum4yrNVUQvt58oxsbc0E",
            "currencyList": [
                {
                    "currency": "BTC",
                    "currencyId": "BTC",
                    "balanceFC": 21653.33399945901,
                    "balance": "0.1988"
                },
                {
                    "currency": "ETH",
                    "currencyId": "ETH",
                    "balanceFC": 13045.288102554881,
                    "balance": "4.9982"
                },
                {
                    "currency": "TRX",
                    "currencyId": "TRX",
                    "balanceFC": 0,
                    "balance": "0"
                },
                {
                    "currency": "USDT",
                    "currencyId": "USDT",
                    "balanceFC": 1005.12676065,
                    "balance": "1005"
                }
            ],
            "entityAccountname": "Co bo"
        }
    ],
    "requestId": "5faff672-8a38-4c56-a6e7-04c5dc693a01"
}

注意事项

• 请求头中的 elven-api-key、elven-api-sign 和 elven-api-timestamp 为必填参数，用于验证请求的合法性和安全性。

• 单次最多支持 20 个账户名称，超出将返回错误。

• entityAccountNameList 不能为空，不能包含重复项。

• 若有一个或多个账户未匹配到，接口调用失败，并返回未识别的账户名称。