下單預估手續費

此端點可用於下單前查詢訂單的預估手續費。

---

HTTP 請求

POST /trade/v1/orders/charge

---

查詢參數

名稱	類型	是否必填	描述
market	enum	是	市場代碼，詳見 market 枚舉定義中支援的值
symbol	string	是	股票代碼
order_side	enum	是	買賣方向，詳見 order_side 枚舉定義中支援的值
price	decimal	是	價格，需大於 0
qty	decimal	是	數量，需大於 0

---

cURL 範例

curl --location --request POST '{$base_url}/trade/v1/orders/charge' \
--header 'X-API-Key: YOUR_API_KEY' \
--header 'X-API-Signature: YOUR_GENERATED_SIGNATURE' \
--header 'X-API-Timestamp: 1746774142003'
--data-raw '{
  "market": "usex",
  "symbol": "AAPL",
  "order_side": "Buy",
  "price": 150.25,
  "qty": 10
}'

---

成功回應格式

请求响应的数据字段描述。

名稱	類型	描述
charge	decimal	總手續費
charge_items	array<charge_item>	手續費明細列表,详见 charge_item

charge_item 結構說明

名稱	類型	描述
code	string	手續費項目編碼，例如 us_trading_commission
amount	decimal	該項手續費金額

手續費項目明細

代碼	收費項
us_trading_commission	佣金
us_platform_fee	平台使用費
us_settlement_and_delivery_cost	交收費
us_sec_membership_fee	证监会规费
us_external_agency_fee_and_trading_activity_fee	交易活動費
us_accounting_tracks_fund_fees	綜合審計追蹤資金費用
us_option_regulation_fees	監管費

---

成功回應範例

{
  "code": 0,
  "data": {
    "charge": 2.04,
    "charge_items": [
      {
        "code": "us_trading_commission",
        "amount": 1
      },
      {
        "code": "us_platform_fee",
        "amount": 1
      },
      {
        "code": "us_sec_membership_fee",
        "amount": 0
      },
      {
        "code": "us_external_agency_fee_and_trading_activity_fee",
        "amount": 0
      },
      {
        "code": "us_settlement_and_delivery_cost",
        "amount": 0.03
      },
      {
        "code": "us_option_regulation_fees",
        "amount": 0
      },
      {
        "code": "us_accounting_tracks_fund_fees",
        "amount": 0.01
      }
    ]
  }
}

---

錯誤回應範例

{
  "code": 500,
  "message": "Internal Service Error",
  "details": ""
}