跳到主要內容

获取账户资金

该接口用于获取用户每个币种可用、可取、冻结、待结算金额、在途资金 (基金申购赎回) 信息。

SDK Links

Python
longport.openapi.TradeContext.account_balance
Rust
longport::trade::TradeContext#account_balance
Go
TradeContext.AccountBalance
Node.js
TradeContext#accountBalance

Request

HTTP MethodGET
HTTP URL/v1/asset/account

Parameters

Content-Type: application/json; charset=utf-8

NameTypeRequiredDescription
currencystringNO币种(HKD、USD、CNH)

Request Example

# 获取账户资金
# https://open.longportapp.com/docs/trade/asset/account
from longport.openapi import TradeContext, Config

config = Config.from_env()
ctx = TradeContext(config)
resp = ctx.account_balance()
print(resp)

Response

Response Headers

  • Content-Type: application/json

Response Example

{
"code": 0,
"data": {
"list": [
{
"total_cash": "1759070010.72",
"max_finance_amount": "977582000",
"remaining_finance_amount": "0",
"risk_level": "1",
"margin_call": "2598051051.50",
"currency": "HKD",
"net_assets": "24145.90",
"init_margin": "1540.09",
"maintenance_margin": "1540.09",
"buy_power": "1759070.12",
"cash_infos": [
{
"withdraw_cash": "97592.30",
"available_cash": "195902464.37",
"frozen_cash": "11579339.13",
"settling_cash": "207288537.81",
"currency": "HKD"
},
{
"withdraw_cash": "199893416.74",
"available_cash": "199893416.74",
"frozen_cash": "28723.76",
"settling_cash": "-276806.51",
"currency": "USD"
}
]
}
]
}
}

Response Status

StatusDescriptionSchema
200返回成功accountcash_rsp
400内部错误None

Schemas

accountcash_rsp

NameTypeRequiredDescription
listobject[]false账户资金信息
∟ total_cashstringtrue现金总额
∟ max_finance_amountstringtrue最大融资金额
∟ remaining_finance_amountstringtrue剩余融资金额
∟ risk_levelstringtrue风控等级

可选值:
0 - 安全
1 - 中风险
2 - 预警
3 - 危险
∟ margin_callstringtrue追缴保证金
∟ net_assetsstringtrue净资产
∟ init_marginstringtrue初始保证金
∟ maintenance_marginstringtrue维持保证金
∟ currencystringtrue币种
∟ marketstringfalse市场
∟ buy_powerstringtrue购买力
∟ cash_infosobject[]false现金详情
∟∟ withdraw_cashstringtrue可提现金
∟∟ available_cashstringtrue可用现金
∟∟ frozen_cashstringtrue冻结现金
∟∟ settling_cashstringtrue待结算现金
∟∟ currencystringtrue币种