按用户+资产查账户
GET /v1/account/{user_id}/{asset}
按 user + asset 查询单条账户行。
仅开发环境。 这条按 user_id 的路由只在 gateway 以
DEV_TOOLS_ENABLED=true(或PERP_DEV_TOOLS_ENABLED=true)启动时可用;否则返回403user-scoped account routes are disabled; use exchange session routes。不需要鉴权。对应的会话版本是GET /v1/account/me/{asset},带Authorization: Bearer <session_token>(响应结构相同,且spot_free/spot_locked为真实值)。
请求
GET /v1/account/{user_id}/{asset}
user_id 为 UUID。asset 不区分大小写;CUSD、USDA、USDC-X 是资金资产 USDC 的别名,响应中统一显示为 CUSD。
响应 — 200
{
"user_id": "5cfb031b593644679533cd2df576dbb8",
"asset": "CUSD",
"available": "85.230000",
"locked": "14.770000",
"spot_free": "0",
"spot_locked": "0"
}
user_id 以 32 位 hex(无连字符)返回。本路由的 spot_free / spot_locked 恒为 "0"。ledger 侧错误一律以 500 返回。
内部工具用接口;Web 前端使用 FAPI 的 账户余额 替代。