跳到主要内容

按用户+Symbol 查持仓

GET /v1/positions/{user_id}/{symbol}

按 user + symbol 查询单条持仓行。

仅开发环境。 这条按 user_id 的路由只在 gateway 以 DEV_TOOLS_ENABLED=true(或 PERP_DEV_TOOLS_ENABLED=true)启动时可用;否则返回 403 user-scoped account routes are disabled; use exchange session routes。不需要鉴权。对应的会话版本是 GET /v1/positions/me/{symbol},带 Authorization: Bearer <session_token>(响应结构相同)。

请求

GET /v1/positions/{user_id}/{symbol}

user_id 为 UUID。

响应 — 200

{
"user_id": "5cfb031b593644679533cd2df576dbb8",
"symbol": "BTC-PERP",
"qty": "0.001",
"avg_price": "76500.00",
"realized_pnl": "0.5234"
}

user_id 以 32 位 hex(无连字符)返回。无持仓时所有数值字段为 "0"。ledger 侧错误一律以 500 返回。