投資組合

此端點用於查詢指定投資組合的持倉明細。回傳該組合內所有證券的詳細資訊，包括數量、市場資料及待處理劃撥狀態。

---

📨 HTTP 請求

GET /account/v1/portfolios/{id}

---

📥 查詢參數

名稱	類型	必填	說明	範例值
id	string	是	投資組合 ID（用戶自訂外部 ID）	最長 50 字元，如：d59c4577-d450-2cbb-43c9-ef06e40f1fde

---

✅ 成功回應

回應欄位

欄位	類型	說明
market	enum	市場類型，見 market 枚舉定義
product_code	string	產品代碼（如股票代號）
product_name	string	產品名稱
qty	decimal	持倉總數量
os_sell_qty	decimal	已凍結待賣出數量
avail_qty	decimal	可買入數量（部分市場為 T+1）
avail_sell_qty	decimal	可賣出數量
uncleared_qty	decimal	已持有但不可交易數量
base_currency	string	持倉幣種
avg_cost	decimal	平均成本（含手續費）
avg_price	decimal	平均成交價（不含手續費）
prev_price	decimal	前一日收盤價
prev_market_value	decimal	以前一日收盤價計算的市值
pending_deposit_qty	decimal	待入庫數量
pending_withdrawal_qty	decimal	待出庫數量
approved_deposit_qty	decimal	審批中入庫數量
approved_withdrawal_qty	decimal	審批中出庫數量
security_type	enum	證券類型，見 security_type 枚舉定義
contract_time	long	合約日期（Unix 時間戳，秒）
portfolio_id	string	投資組合 ID（用戶自訂外部 ID）

---

❌ 錯誤回應

欄位	類型	說明
code	int	錯誤代碼
message	string	錯誤訊息
details	string	其他補充說明

---

💡 cURL 範例

curl -X GET "https://{{base_url}}/account/v1/portfolios/d59c4577-d450-2cbb-43c9-ef06e40f1fde" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "X-API-Timestamp: 1746777861334" \
  -H "X-API-Signature: YOUR_GENERATED_SIGNATURE" \
  -H "Content-Type: application/json"

---

✅ 成功回應範例

{
  "code": 0,
  "data": {
    "portfolio_id": "d59c4577-d450-2cbb-43c9-ef06e40f1fde",
    "positions": [
      {
        "market": "usex",
        "product_code": "AAPL",
        "product_name": "Apple Inc.",
        "qty": 100,
        "os_sell_qty": 10,
        "avail_qty": 90,
        "avail_sell_qty": 85,
        "uncleared_qty": 5,
        "base_currency": "USD",
        "avg_cost": 140.5,
        "avg_price": 139.0,
        "prev_price": 142.3,
        "prev_market_value": 14230,
        "pending_deposit_qty": 0,
        "pending_withdrawal_qty": 0,
        "approved_deposit_qty": 0,
        "approved_withdrawal_qty": 0,
        "security_type": "stock",
        "contract_time": 1746775257,
        "portfolio_id": "d59c4577-d450-2cbb-43c9-ef06e40f1fde"
      }
    ]
  }
}

---

❌ 錯誤回應範例

{
  "code": 12010012,
  "message": "Internal server error"
}