跳到主要内容

账户信息

类型:USER_DATA · 权重:1

状态:已上线。 响应包含 settlement 块与实时的 canTrade 值。

GET /api/v3/account

该 key 所属账户的现货余额。对于钱包出资账户,这是你 Canton 钱包持仓的镜像(见 镜像余额);对于内部出资账户,这是账本余额。

请求

GET /api/v3/account?timestamp=1756600000000&signature=...

除 timestamp / recvWindow / signature 外无其他参数。

响应 — 200(值仅为示意)

{
"canTrade": true,
"canWithdraw": false,
"canDeposit": false,
"updateTime": 1756600000123,
"accountType": "SPOT",
"balances": [
{ "asset": "CUSD", "free": "0", "locked": "0" },
{ "asset": "CBTC", "free": "0.5231", "locked": "0.001" },
{ "asset": "cETH", "free": "0", "locked": "0" },
{ "asset": "CC", "free": "0", "locked": "0" },
{ "asset": "USX", "free": "0", "locked": "0" },
{ "asset": "aCC", "free": "0", "locked": "0" },
{ "asset": "USDC.B", "free": "12500.1234567891", "locked": "50" },
{ "asset": "USDCx", "free": "0", "locked": "0" }
],
"permissions": ["SPOT"],
"settlement": {
"segment": "wallet",
"enrolled": true,
"frozen": false,
"party": "mm-alpha::1220ca15423a1b049bf8e84132360f246057aa18f5e9e36a77db535b75bd287cceff"
}
}
字段说明
canTrade镜像对账将账户冻结期间为 false(下单返回 -2010),否则为 true。已绑定 party 但未完成注册的账户仍报告 true,在下单时以 -2012 拒绝;请检查 settlement.enrolled。
canWithdraw、canDeposit恒为 false:/api/v3 上没有充值/提现端点。钱包出资账户通过在自己的 Canton 钱包中转移资产来入金与出金。
updateTime本次响应的时间,Unix 毫秒(不是最近一次余额变动时间)。
balances[]始终是按此顺序排列的固定八种资产列表,包括零余额行。金额按该资产的链上精度截断(不是四舍五入),且序列化时去掉末尾零(是 "0.5231",不会是 "0.52310000")。locked 为你的挂单所保留的金额。
permissions恒为 ["SPOT"]。
settlementRocky 扩展。账户已注册且该 venue 已启用链上结算时 segment 为 wallet(余额镜像 party 的钱包,成交以零手续费 DvP 结算,内部划转与提现关闭),否则为 internal。enrolled 与之一致。frozen 是结算审查的 kill switch(见 被冻结的账户)。party 为绑定的 Canton party,未绑定时为 null。

错误

HTTPcode原因
429-1003权重桶耗尽。
500-1000数据库不可用。

与 Binance 的差异

  • 没有 makerCommission / takerCommission / commissionRates、brokered、requireSelfTradePrevention、preventSor、uid 字段。
  • balances 是固定的资产列表,而不是「余额非零的资产」;没有 omitZeroBalances。
  • 在本接口面上 canWithdraw / canDeposit 永远为 false。
  • settlement 为 Rocky 扩展。