tradingOrdersDocsPage.orderManagement
下單與訂單管理 API
透過 Finger Trader 已驗證的交易端點建立、平倉、取消及修改訂單。
訂單寫入端點
這些端點可能提交或修改實際訂單。試用前請確認帳戶、市場、商品、數量及券商規則。
使用 Bearer Access Token 與 JSON 請求本文發送 POST 請求。Flutter 用戶端呼叫已驗證的 Finger Trader App BFF。 開始使用:認證方式
https://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
提交新訂單請求。
請求範例
以下數值僅供示範。請將 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 欄位 | 參考 |
|---|---|---|---|
ticker | string | 可為 Null | 券商支援的 Ticker 與 Symbol |
orderType | integer | 可為 Null | 交易枚舉值 |
orderSide | integer | 可為 Null | 交易枚舉值 |
qty | decimal string | 可為 Null | — |
coinType | integer | 可為 Null | 交易枚舉值 |
walletType | integer | 可為 Null | 交易枚舉值 |
price | decimal string | 可為 Null | — |
marginRate | integer | 可為 Null | — |
stopLoss | decimal string | 可為 Null | — |
takeProfit | decimal string | 可為 Null | — |
marketType | integer | 可為 Null | 支援市場與 marketType 代碼 |
brokerId | integer | 可為 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
提交平倉請求。
請求範例
以下數值僅供示範。請將 ticker、市場、用戶/訂單識別碼及券商識別碼替換為自己帳戶實際取得的值,並在送出前向券商確認欄位要求。
{
"userId": "user_demo_12345",
"orderId": "order_demo_20250101_001",
"qty": "500",
"marketType": 0,
"brokerId": 10001,
"brokerPositionId": "position_demo_001",
"symbol": "EURUSD"
}| 參數 | 型別 | 用戶端 DTO 欄位 | 參考 |
|---|---|---|---|
userId | string | 可為 Null | — |
orderId | string | 可為 Null | — |
qty | decimal string | 可為 Null | — |
marketType | integer | 可為 Null | 支援市場與 marketType 代碼 |
brokerId | integer | 可為 Null | — |
brokerPositionId | string | 可為 Null | — |
symbol | string | 可為 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
提交限價單取消請求。
請求範例
以下數值僅供示範。請將 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 欄位 | 參考 |
|---|---|---|---|
userId | string | 可為 Null | — |
orderId | string | 可為 Null | — |
marketType | integer | 可為 Null | 支援市場與 marketType 代碼 |
brokerId | integer | 可為 Null | — |
brokerOrderId | string | 可為 Null | — |
clientOrderId | string | 可為 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
提交止損或止盈修改請求。
請求範例
以下數值僅供示範。請將 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 欄位 | 參考 |
|---|---|---|---|
userId | string | 可為 Null | — |
orderId | string | 可為 Null | — |
qty | decimal string | 可為 Null | — |
price | decimal string | 可為 Null | — |
stopLose | decimal string | 可為 Null | — |
stopProfit | decimal string | 可為 Null | — |
clearStopLoss | boolean | 可為 Null | — |
clearTakeProfit | boolean | 可為 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 環境;完成後請清除。