Query Estimated Order Fee

This endpoint can be used to query the estimated fees before placing an order.

---

HTTP Request

POST /trade/v1/orders/charge

---

Query Parameters

Name	Type	Required	Description
market	enum	Yes	Market code. See supported values in the market enum definition.
symbol	string	Yes	Stock symbol
order_side	enum	Yes	Order side. See supported values in the order_side enum definition.
price	decimal	Yes	Order price, must be greater than 0
qty	decimal	Yes	Order quantity, must be greater than 0

cURL Example

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
}'

Successful Response Format

Description of the response data fields.

Name	Type	Description
charge	decimal	Total fee
charge_items	array<charge_item>	Detailed fee items(refer to charge_item)

Structure of charge_item.

Name	Type	Description
code	string	Fee code, e.g., us_trading_commission
amount	decimal	Fee amount

Fee Details by Market

Code	Fee Item
us_trading_commission	Commission
us_platform_fee	Platform Usage Fee
us_settlement_and_delivery_cost	Settlement Fee
us_sec_membership_fee	Securities and Futures Commission (SFC) levy
us_external_agency_fee_and_trading_activity_fee	Transaction Activity Fee
us_accounting_tracks_fund_fees	Consolidated Audit Trail Fee
us_option_regulation_fees	Options regulatory fee

Sample Success Response

{
  "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
      }
    ]
  }
}

Sample Error Response

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