預估訂單手續費

接口信息

接口: POST /api/v1/orders/estimate_charge

描述: 預估訂單手續費，支持自動匯率轉換

鑑權: Authorization請求頭附加JWT令牌

請求參數

字段	類型	必填	說明
is_buy	bool	是	是否為買單
ticker	string	是	股票代碼
exchange	int	是	交易所代碼（0=美股）
quantity	string	是	數量（常規精度）
price	string	是	股票原生貨幣價格（常規精度，非wei） 美股為USD價格
asset	string	是	USDT合約地址
target_currency	string	否	目標穩定幣（USDT 或 USDC），默認為 USDT

響應參數

字段	類型	說明
base_currency	string	基礎貨幣（美股為USD）
charge_base	string	基礎貨幣手續費（常規精度）
target_currency	string	目標穩定幣（USDT 或 USDC）
charge_target	string	目標穩定幣手續費（wei精度，18位小數）
price_base	string	原幣種價格（常規精度，與請求參數中的 price 一致）
price_target	string	目標幣種價格（wei精度，18位小數）
exchange_rate	float	匯率（浮點數，基礎貨幣到目標貨幣的轉換率）

請求示例

curl -X POST "/api/v1/orders/estimate_charge" \
     -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." \
     -H "Content-Type: application/json" \
     -d '{
       "is_buy": true,
       "ticker": "AAPL",
       "exchange": 0,
       "quantity": "100",
       "price": "260",
       "asset": "0x09671802Cc9Bbf6402f2e7a07b220Aa7b43D8c91"
     }'

響應示例

{
    "code": 0,
    "data": {
        "base_currency": "USD",
        "charge_base": "3.36",
        "target_currency": "USDT",
        "charge_target": "3377745527638190000",
        "price_base": "260",
        "price_target": "261373165829145650000",
        "exchange_rate": 0.994746339683381
    }
}

說明

• 輸入參數精度：
  • quantity 使用常規精度（如 "100" 表示100股）
  • price 使用常規精度（如 "260" 表示260美元/股），注意：這是股票原生貨幣價格，不是wei精度
• 輸出參數精度：
  • charge_base 使用常規精度
  • charge_target 使用 wei 精度（18位小數）
  • price_target 使用 wei 精度（18位小數）
• 自動將股票原生貨幣（USD）轉換為目標穩定幣
• 支持 target_currency 參數指定輸出穩定幣（USDT 或 USDC），默認為 USDT
• 手續費預估僅供參考，實際手續費以交易時為準