tradingOrdersDocsPage.orders
訂單查詢 API
使用已驗證的交易 API 查詢持倉、交易歷史、已完成訂單及歷史統計。
訂單查詢端點
列表請求使用 page、pageSize 及巢狀 query 物件。回應包含 items 與分頁資訊。帳戶可查詢的篩選條件與資料取決於券商及服務設定。
用戶端 PageQuery 模型要求提供 page 與 pageSize;query 篩選欄位可為 null。伺服器頁面上限及游標行為由服務設定決定。
使用 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/get-holding-orders
查詢帳戶持倉分頁。
請求範例
以下數值僅供示範。請將 ticker、市場、用戶/訂單識別碼及券商識別碼替換為自己帳戶實際取得的值,並在送出前向券商確認欄位要求。
{
"page": 1,
"pageSize": 20,
"query": {
"walletType": 2,
"marketType": 0,
"orderType": 1,
"coinType": 0,
"orderSide": 1,
"startTime": 1735689600000,
"endTime": 1735776000000
}
}| 參數 | 型別 | 用戶端 DTO 欄位 | 參考 |
|---|---|---|---|
page | integer | 用戶端模型必要 | — |
pageSize | integer | 用戶端模型必要 | — |
query | object | 用戶端模型必要 | — |
query.nextCursor | string | null | 可為 Null | — |
query.brokerId | integer | null | 可為 Null | — |
query.walletType | integer | null | 可為 Null | 交易枚舉值 |
query.marketType | integer | null | 可為 Null | 支援市場與 marketType 代碼 |
query.orderType | integer | null | 可為 Null | 交易枚舉值 |
query.coinType | integer | null | 可為 Null | 交易枚舉值 |
query.orderSide | integer | null | 可為 Null | 交易枚舉值 |
query.startTime | integer | null | 可為 Null | — |
query.endTime | integer | null | 可為 Null | — |
Flutter DTO 中可為 null,代表用戶端允許傳 null 或省略部分選填 ID;這不代表伺服器驗證規則。必要欄位請向券商/服務方確認。
回應範例
{"code":0,"data":{"total":1,"items":[{
"ticker": "<broker-supported ticker>",
"orderId": "<order id>",
"marketType": 0,
"orderType": 0,
"orderSide": 1,
"qty": "<decimal>",
"price": "<decimal>",
"status": "<broker response status>",
"filledQuantity": "<decimal>",
"averagePrice": "<decimal>",
"createTime": 0
}],"page":1,"pageSize":20,"nextCursor":null},"msg":""}data 是包含 total、items、page、pageSize、nextCursor 的分頁結果;每筆訂單可包含空值及券商欄位。
試用 REST 請求 · /app-api/v1/order/get-holding-orders
輸入 Access Token 並編輯請求參數。送出後,瀏覽器會直接向所選的 Finger Trader 官方 BFF 環境發送此請求。
準備就緒。按下「送出請求」前不會傳送內容。
回應會顯示在這裡。
Access Token 只保留在此頁面的記憶體中,不會寫入瀏覽器儲存空間,也不會傳送至 Finger Trader 官網伺服器。只有按下「送出請求」後,才會傳至你選擇的官方 API 環境;完成後請清除。
交易歷史
POST /app-api/v1/order/trade-history
查詢帳戶交易歷史分頁。
請求範例
以下數值僅供示範。請將 ticker、市場、用戶/訂單識別碼及券商識別碼替換為自己帳戶實際取得的值,並在送出前向券商確認欄位要求。
{
"page": 1,
"pageSize": 20,
"query": {
"walletType": 2,
"marketType": 0,
"orderType": 1,
"coinType": 0,
"orderSide": 1,
"startTime": 1735689600000,
"endTime": 1735776000000
}
}| 參數 | 型別 | 用戶端 DTO 欄位 | 參考 |
|---|---|---|---|
page | integer | 用戶端模型必要 | — |
pageSize | integer | 用戶端模型必要 | — |
query | object | 用戶端模型必要 | — |
query.nextCursor | string | null | 可為 Null | — |
query.brokerId | integer | null | 可為 Null | — |
query.walletType | integer | null | 可為 Null | 交易枚舉值 |
query.marketType | integer | null | 可為 Null | 支援市場與 marketType 代碼 |
query.orderType | integer | null | 可為 Null | 交易枚舉值 |
query.coinType | integer | null | 可為 Null | 交易枚舉值 |
query.orderSide | integer | null | 可為 Null | 交易枚舉值 |
query.startTime | integer | null | 可為 Null | — |
query.endTime | integer | null | 可為 Null | — |
Flutter DTO 中可為 null,代表用戶端允許傳 null 或省略部分選填 ID;這不代表伺服器驗證規則。必要欄位請向券商/服務方確認。
回應範例
{"code":0,"data":{"total":1,"items":[{
"ticker": "<broker-supported ticker>",
"orderId": "<order id>",
"marketType": 0,
"orderType": 0,
"orderSide": 1,
"qty": "<decimal>",
"price": "<decimal>",
"status": "<broker response status>",
"filledQuantity": "<decimal>",
"averagePrice": "<decimal>",
"createTime": 0
}],"page":1,"pageSize":20,"nextCursor":null},"msg":""}data 是包含 total、items、page、pageSize、nextCursor 的分頁結果;每筆訂單可包含空值及券商欄位。
試用 REST 請求 · /app-api/v1/order/trade-history
輸入 Access Token 並編輯請求參數。送出後,瀏覽器會直接向所選的 Finger Trader 官方 BFF 環境發送此請求。
準備就緒。按下「送出請求」前不會傳送內容。
回應會顯示在這裡。
Access Token 只保留在此頁面的記憶體中,不會寫入瀏覽器儲存空間,也不會傳送至 Finger Trader 官網伺服器。只有按下「送出請求」後,才會傳至你選擇的官方 API 環境;完成後請清除。
已完成訂單
POST /app-api/v1/order/completed-orders
查詢帳戶已完成訂單分頁。
請求範例
以下數值僅供示範。請將 ticker、市場、用戶/訂單識別碼及券商識別碼替換為自己帳戶實際取得的值,並在送出前向券商確認欄位要求。
{
"page": 1,
"pageSize": 20,
"query": {
"walletType": 2,
"marketType": 0,
"orderType": 1,
"coinType": 0,
"orderSide": 1,
"startTime": 1735689600000,
"endTime": 1735776000000
}
}| 參數 | 型別 | 用戶端 DTO 欄位 | 參考 |
|---|---|---|---|
page | integer | 用戶端模型必要 | — |
pageSize | integer | 用戶端模型必要 | — |
query | object | 用戶端模型必要 | — |
query.nextCursor | string | null | 可為 Null | — |
query.brokerId | integer | null | 可為 Null | — |
query.walletType | integer | null | 可為 Null | 交易枚舉值 |
query.marketType | integer | null | 可為 Null | 支援市場與 marketType 代碼 |
query.orderType | integer | null | 可為 Null | 交易枚舉值 |
query.coinType | integer | null | 可為 Null | 交易枚舉值 |
query.orderSide | integer | null | 可為 Null | 交易枚舉值 |
query.startTime | integer | null | 可為 Null | — |
query.endTime | integer | null | 可為 Null | — |
Flutter DTO 中可為 null,代表用戶端允許傳 null 或省略部分選填 ID;這不代表伺服器驗證規則。必要欄位請向券商/服務方確認。
回應範例
{"code":0,"data":{"total":1,"items":[{
"ticker": "<broker-supported ticker>",
"orderId": "<order id>",
"marketType": 0,
"orderType": 0,
"orderSide": 1,
"qty": "<decimal>",
"price": "<decimal>",
"status": "<broker response status>",
"filledQuantity": "<decimal>",
"averagePrice": "<decimal>",
"createTime": 0
}],"page":1,"pageSize":20,"nextCursor":null},"msg":""}data 是包含 total、items、page、pageSize、nextCursor 的分頁結果;每筆訂單可包含空值及券商欄位。
試用 REST 請求 · /app-api/v1/order/completed-orders
輸入 Access Token 並編輯請求參數。送出後,瀏覽器會直接向所選的 Finger Trader 官方 BFF 環境發送此請求。
準備就緒。按下「送出請求」前不會傳送內容。
回應會顯示在這裡。
Access Token 只保留在此頁面的記憶體中,不會寫入瀏覽器儲存空間,也不會傳送至 Finger Trader 官網伺服器。只有按下「送出請求」後,才會傳至你選擇的官方 API 環境;完成後請清除。
交易歷史統計
POST /app-api/v1/order/trade-history-stat
回傳交易歷史統計物件。
請求範例
以下數值僅供示範。請將 ticker、市場、用戶/訂單識別碼及券商識別碼替換為自己帳戶實際取得的值,並在送出前向券商確認欄位要求。
{
"walletType": 2,
"marketType": 0,
"orderType": 1,
"coinType": 0,
"orderSide": 1,
"startTime": 1735689600000,
"endTime": 1735776000000
}| 參數 | 型別 | 用戶端 DTO 欄位 | 參考 |
|---|---|---|---|
query.nextCursor | string | null | 可為 Null | — |
query.brokerId | integer | null | 可為 Null | — |
query.walletType | integer | null | 可為 Null | 交易枚舉值 |
query.marketType | integer | null | 可為 Null | 支援市場與 marketType 代碼 |
query.orderType | integer | null | 可為 Null | 交易枚舉值 |
query.coinType | integer | null | 可為 Null | 交易枚舉值 |
query.orderSide | integer | null | 可為 Null | 交易枚舉值 |
query.startTime | integer | null | 可為 Null | — |
query.endTime | integer | null | 可為 Null | — |
Flutter 用戶端序列化時,startTime 與 endTime 使用 UTC Unix 毫秒時間戳。
Flutter DTO 中可為 null,代表用戶端允許傳 null 或省略部分選填 ID;這不代表伺服器驗證規則。必要欄位請向券商/服務方確認。
回應範例
{"code":0,"data":{"totalProfile":"<decimal>"},"msg":""}服務回傳時,data 物件包含 totalProfile。
試用 REST 請求 · /app-api/v1/order/trade-history-stat
輸入 Access Token 並編輯請求參數。送出後,瀏覽器會直接向所選的 Finger Trader 官方 BFF 環境發送此請求。
準備就緒。按下「送出請求」前不會傳送內容。
回應會顯示在這裡。
Access Token 只保留在此頁面的記憶體中,不會寫入瀏覽器儲存空間,也不會傳送至 Finger Trader 官網伺服器。只有按下「送出請求」後,才會傳至你選擇的官方 API 環境;完成後請清除。