FINGER TRADER

tradingOrdersDocsPage.orderManagement

下單與訂單管理 API

透過 Finger Trader 已驗證的交易端點建立、平倉、取消及修改訂單。

文檔架構 · 概覽

訂單寫入端點

這些端點可能提交或修改實際訂單。試用前請確認帳戶、市場、商品、數量及券商規則。

使用 Bearer Access Token 與 JSON 請求本文發送 POST 請求。Flutter 用戶端呼叫已驗證的 Finger Trader App BFF。 開始使用:認證方式

正式環境 App BFF 基礎 URLhttps://prod-api.fingertrader.com/finger-bff-app認證請求標頭Authorization: Bearer <ACCESS_TOKEN>

需先開通 Finger Trader 帳號,並在 Finger 生態中的券商處開戶。請使用「開始使用」文件說明的 Bearer Access Token。

成功回應使用 Finger Trader 標準封裝:code、data、msg。各端點範例展示 Flutter 用戶端解析的 data 結構。

建立訂單

POST /app-api/v1/order/create-order

POST

提交新訂單請求。

請求範例

以下數值僅供示範。請將 ticker、市場、用戶/訂單識別碼及券商識別碼替換為自己帳戶實際取得的值,並在送出前向券商確認欄位要求。

{
  "ticker": "EURUSD",
  "orderType": 1,
  "orderSide": 1,
  "qty": "1000",
  "coinType": 0,
  "walletType": 2,
  "price": "1.08500",
  "marginRate": 10,
  "stopLoss": "1.07500",
  "takeProfit": "1.09500",
  "marketType": 0
}
請求參數
參數型別用戶端 DTO 欄位參考
tickerstring可為 Null券商支援的 Ticker 與 Symbol
orderTypeinteger可為 Null交易枚舉值
orderSideinteger可為 Null交易枚舉值
qtydecimal string可為 Null—
coinTypeinteger可為 Null交易枚舉值
walletTypeinteger可為 Null交易枚舉值
pricedecimal string可為 Null—
marginRateinteger可為 Null—
stopLossdecimal string可為 Null—
takeProfitdecimal string可為 Null—
marketTypeinteger可為 Null支援市場與 marketType 代碼
brokerIdinteger可為 Null—

Flutter DTO 中可為 null,代表用戶端允許傳 null 或省略部分選填 ID;這不代表伺服器驗證規則。必要欄位請向券商/服務方確認。

回應範例

{"code":0,"data":true,"msg":""}

用戶端預期 data 為布林結果。

Try 會向所選環境發送真實請求,可能建立、平倉、取消或修改訂單。請使用測試帳戶,並優先採用券商核準的測試環境。

試用 REST 請求 · /app-api/v1/order/create-order

輸入 Access Token 並編輯請求參數。送出後,瀏覽器會直接向所選的 Finger Trader 官方 BFF 環境發送此請求。

Try 會向所選環境發送真實請求,可能建立、平倉、取消或修改訂單。請使用測試帳戶,並優先採用券商核準的測試環境。

準備就緒。按下「送出請求」前不會傳送內容。

回應
回應會顯示在這裡。

Access Token 只保留在此頁面的記憶體中,不會寫入瀏覽器儲存空間,也不會傳送至 Finger Trader 官網伺服器。只有按下「送出請求」後,才會傳至你選擇的官方 API 環境;完成後請清除。

平倉

POST /app-api/v1/order/close-order

POST

提交平倉請求。

請求範例

以下數值僅供示範。請將 ticker、市場、用戶/訂單識別碼及券商識別碼替換為自己帳戶實際取得的值,並在送出前向券商確認欄位要求。

{
  "userId": "user_demo_12345",
  "orderId": "order_demo_20250101_001",
  "qty": "500",
  "marketType": 0,
  "brokerId": 10001,
  "brokerPositionId": "position_demo_001",
  "symbol": "EURUSD"
}
請求參數
參數型別用戶端 DTO 欄位參考
userIdstring可為 Null—
orderIdstring可為 Null—
qtydecimal string可為 Null—
marketTypeinteger可為 Null支援市場與 marketType 代碼
brokerIdinteger可為 Null—
brokerPositionIdstring可為 Null—
symbolstring可為 Null券商支援的 Ticker 與 Symbol

Flutter DTO 中可為 null,代表用戶端允許傳 null 或省略部分選填 ID;這不代表伺服器驗證規則。必要欄位請向券商/服務方確認。

回應範例

{"code":0,"data":true,"msg":""}

用戶端預期 data 為布林結果。

Try 會向所選環境發送真實請求,可能建立、平倉、取消或修改訂單。請使用測試帳戶,並優先採用券商核準的測試環境。

試用 REST 請求 · /app-api/v1/order/close-order

輸入 Access Token 並編輯請求參數。送出後,瀏覽器會直接向所選的 Finger Trader 官方 BFF 環境發送此請求。

Try 會向所選環境發送真實請求,可能建立、平倉、取消或修改訂單。請使用測試帳戶,並優先採用券商核準的測試環境。

準備就緒。按下「送出請求」前不會傳送內容。

回應
回應會顯示在這裡。

Access Token 只保留在此頁面的記憶體中,不會寫入瀏覽器儲存空間,也不會傳送至 Finger Trader 官網伺服器。只有按下「送出請求」後,才會傳至你選擇的官方 API 環境;完成後請清除。

取消限價單

POST /app-api/v1/order/cancel-order

POST

提交限價單取消請求。

請求範例

以下數值僅供示範。請將 ticker、市場、用戶/訂單識別碼及券商識別碼替換為自己帳戶實際取得的值,並在送出前向券商確認欄位要求。

{
  "userId": "user_demo_12345",
  "orderId": "order_demo_20250101_002",
  "marketType": 0,
  "brokerId": 10001,
  "brokerOrderId": "broker_order_demo_002",
  "clientOrderId": "client_order_demo_002"
}
請求參數
參數型別用戶端 DTO 欄位參考
userIdstring可為 Null—
orderIdstring可為 Null—
marketTypeinteger可為 Null支援市場與 marketType 代碼
brokerIdinteger可為 Null—
brokerOrderIdstring可為 Null—
clientOrderIdstring可為 Null—

Flutter DTO 中可為 null,代表用戶端允許傳 null 或省略部分選填 ID;這不代表伺服器驗證規則。必要欄位請向券商/服務方確認。

回應範例

{"code":0,"data":true,"msg":""}

用戶端預期 data 為布林結果。

Try 會向所選環境發送真實請求,可能建立、平倉、取消或修改訂單。請使用測試帳戶,並優先採用券商核準的測試環境。

試用 REST 請求 · /app-api/v1/order/cancel-order

輸入 Access Token 並編輯請求參數。送出後,瀏覽器會直接向所選的 Finger Trader 官方 BFF 環境發送此請求。

Try 會向所選環境發送真實請求,可能建立、平倉、取消或修改訂單。請使用測試帳戶,並優先採用券商核準的測試環境。

準備就緒。按下「送出請求」前不會傳送內容。

回應
回應會顯示在這裡。

Access Token 只保留在此頁面的記憶體中,不會寫入瀏覽器儲存空間,也不會傳送至 Finger Trader 官網伺服器。只有按下「送出請求」後,才會傳至你選擇的官方 API 環境;完成後請清除。

修改止損/止盈

POST /app-api/v1/order/modify-stop-profit-loss

POST

提交止損或止盈修改請求。

請求範例

以下數值僅供示範。請將 ticker、市場、用戶/訂單識別碼及券商識別碼替換為自己帳戶實際取得的值,並在送出前向券商確認欄位要求。

{
  "userId": "user_demo_12345",
  "orderId": "order_demo_20250101_003",
  "qty": "1000",
  "price": "1.08600",
  "stopLose": "1.07600",
  "stopProfit": "1.09600",
  "clearStopLoss": false,
  "clearTakeProfit": false
}
請求參數
參數型別用戶端 DTO 欄位參考
userIdstring可為 Null—
orderIdstring可為 Null—
qtydecimal string可為 Null—
pricedecimal string可為 Null—
stopLosedecimal string可為 Null—
stopProfitdecimal string可為 Null—
clearStopLossboolean可為 Null—
clearTakeProfitboolean可為 Null—

Flutter DTO 中可為 null,代表用戶端允許傳 null 或省略部分選填 ID;這不代表伺服器驗證規則。必要欄位請向券商/服務方確認。

回應範例

{"code":0,"data":true,"msg":""}

用戶端預期 data 為布林結果。

Try 會向所選環境發送真實請求,可能建立、平倉、取消或修改訂單。請使用測試帳戶,並優先採用券商核準的測試環境。

試用 REST 請求 · /app-api/v1/order/modify-stop-profit-loss

輸入 Access Token 並編輯請求參數。送出後,瀏覽器會直接向所選的 Finger Trader 官方 BFF 環境發送此請求。

Try 會向所選環境發送真實請求,可能建立、平倉、取消或修改訂單。請使用測試帳戶,並優先採用券商核準的測試環境。

準備就緒。按下「送出請求」前不會傳送內容。

回應
回應會顯示在這裡。

Access Token 只保留在此頁面的記憶體中,不會寫入瀏覽器儲存空間,也不會傳送至 Finger Trader 官網伺服器。只有按下「送出請求」後,才會傳至你選擇的官方 API 環境;完成後請清除。