查询账户余额

/sapi/v1/account/balance

请求类型: GET

是否验签: 是

接口权限: 读取

限频: 每个UID 3秒最多 144 次请求(交易接口3秒最多 72 次请求，查询接口3秒最多 72 次请求) (该UID的所有币种和不同到期日的合约的所有私有接口共享该限制) 。

接口描述: 此接口用于联合保证金用户，查询合约账户信息。

请求地址

环境	地址
线上环境	https://api.sunx.io
线上环境（aws客户首选）	https://api.sunx.io

请求参数

参数	数据类型	是否必填	描述	取值范围	默认值
无数据

响应参数

参数	数据类型	是否必填	描述	取值范围
state	String	true	账户状态	1(normal):正常（交易，划转）、2(locked):-暂时未用到、3(bankruptcy)：强平中，不允许交易、划转、收取资金费、4(BANKRUPTCY):暂时未用到 5(adl):adl中，不允许交易、收取资金费、划转、6(open_limit):风控撤单中，合约交易只允许下减仓单，可以转入，不允许转出
equity	String	true	账户权益
initial_margin	String	true	初始保证金
maintenance_margin	String	true	维持保证金
maintenance_margin_rate	String	true	维持保证金率
profit_unreal	String	true	未实现盈亏
available_margin	String	true	可用保证金
voucher_value	String	true	体验金(usdt)
created_time	String	true	账户创建时间
updated_time	String	true	账户更新时间
details	list	true
currency	String	true	币种
equity	String	true	该币种资产权益
available	String	true	该币种可用
withdraw_available	String	true	该币种可转
profit_unreal	String	true	未实现盈亏
initial_margin	String	true	该币种初始保证金
maintenance_margin	String	true	该币种维持保证金
maintenance_margin_rate	String	true	该币种维持保证金率
initial_margin_rate	String	true	该币种初始保证金率
voucher	String	true	体验金
voucher_value	String	true	体验金(usdt)
created_time	String	true	创建时间
updated_time	String	true	更新时间

请求示例

GET https://api.sunx.io/sapi/v1/account/balance?SignatureVersion=2&AccessKeyId=<your key>&Signature=<your signature>&SignatureMethod=HmacSHA256&Timestamp=2025-09-16T07%3A16%3A15

响应示例

{
    "code": 200,
    "message": "Success",
    "data": {
        "state": "normal",
        "equity": "18.800687270666649522",
        "details": [
            {
                "currency": "USDT",
                "equity": "18.800687270666649522",
                "available": "18.799987270666649522",
                "profit_unreal": "0.0007",
                "initial_margin": "0.01616",
                "maintenance_margin": "0.000002424",
                "maintenance_margin_rate": "0.000000128931456871",
                "initial_margin_rate": "0.000859543045812653",
                "voucher": "0",
                "voucher_value": "0",
                "withdraw_available": "18.784527270666649522",
                "created_time": 1757935751532,
                "updated_time": 1758006976344
            }
        ],
        "initial_margin": "0.01616",
        "maintenance_margin": "0.000002424",
        "maintenance_margin_rate": "0.000000128931456871",
        "profit_unreal": "0.0007",
        "available_margin": "18.784527270666649522",
        "voucher_value": "0",
        "created_time": 1757472792969,
        "updated_time": 1758006976344
    },
    "ts": 1758006977098
}