持倉列表

GET /api/v1.0/sim-trade/{acc_id}/positions

獲取持倉列表（代碼、方向、數量、成本、市值、盈虧）。

請求參數

參數	類型	位置	必填	說明
acc_id	string	path	是	業務賬戶 ID
market	int	query	否	市場過濾

請求示例

curl -s "https://webapi.moomoo.com/api/v1.0/sim-trade/80303779/positions" -H "Authorization: Bearer <AccessToken>" | jq

響應欄位

返回 data.positions[]。

欄位	類型	說明
pstn_id	int64	持倉 ID
pstn_type	string	JSON 返回枚舉名稱（數值 0=多倉、1=空倉）
market	string	市場
symbol	string	代碼
stock_name	string	名稱
qty	int64	數量
qty_avbl	int64	可用數量
cost_price	number	成本價
buy_avg_price	number	均買價
cur_price	number	現價
mv	string	市值
profit	string	盈虧額
profit_ratio	number	盈虧比
unrealized_profit	string	未實現盈虧
realized_profit	string	已實現盈虧
today_turnover	number	今日成交額
today_buy_qty	int64	今日買入數量
today_sell_qty	int64	今日賣出數量
today_buy_turnover	number	今日買入成交額
today_buy_avg_price	number	今日買入均價
today_sell_turnover	number	今日賣出成交額
today_sell_avg_price	number	今日賣出均價
today_profit	string	今日盈虧

響應示例

{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "positions": [
      {
        "pstn_id": 133969,
        "pstn_type": "LONG",
        "market": "HK_STOCK",
        "symbol": "00700",
        "stock_name": "騰訊控股",
        "qty": 100,
        "qty_avbl": 100,
        "cost_price": 448.2,
        "cur_price": 448,
        "mv": "44800",
        "profit": "-20",
        "profit_ratio": -0.0446
      }
    ]
  }
}

錯誤響應

HTTP 狀態仍為 200。請求失敗時返回非 0 的 ret_code 和 error 物件。

{
  "ret_code": -3,
  "ret_msg": "invalid request",
  "error": {"code": "invalid_parameter", "message": "invalid request"}
}