FINGER TRADER

tradingOrdersDocsPage.orders

訂單查詢 API

使用已驗證的交易 API 查詢持倉、交易歷史、已完成訂單及歷史統計。

文檔架構 · 概覽

訂單查詢端點

列表請求使用 page、pageSize 及巢狀 query 物件。回應包含 items 與分頁資訊。帳戶可查詢的篩選條件與資料取決於券商及服務設定。

用戶端 PageQuery 模型要求提供 page 與 pageSize;query 篩選欄位可為 null。伺服器頁面上限及游標行為由服務設定決定。

使用 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/get-holding-orders

POST

查詢帳戶持倉分頁。

請求範例

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

{
  "page": 1,
  "pageSize": 20,
  "query": {
    "walletType": 2,
    "marketType": 0,
    "orderType": 1,
    "coinType": 0,
    "orderSide": 1,
    "startTime": 1735689600000,
    "endTime": 1735776000000
  }
}
請求參數
參數型別用戶端 DTO 欄位參考
pageinteger用戶端模型必要—
pageSizeinteger用戶端模型必要—
queryobject用戶端模型必要—
query.nextCursorstring | null可為 Null—
query.brokerIdinteger | null可為 Null—
query.walletTypeinteger | null可為 Null交易枚舉值
query.marketTypeinteger | null可為 Null支援市場與 marketType 代碼
query.orderTypeinteger | null可為 Null交易枚舉值
query.coinTypeinteger | null可為 Null交易枚舉值
query.orderSideinteger | null可為 Null交易枚舉值
query.startTimeinteger | null可為 Null—
query.endTimeinteger | 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

POST

查詢帳戶交易歷史分頁。

請求範例

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

{
  "page": 1,
  "pageSize": 20,
  "query": {
    "walletType": 2,
    "marketType": 0,
    "orderType": 1,
    "coinType": 0,
    "orderSide": 1,
    "startTime": 1735689600000,
    "endTime": 1735776000000
  }
}
請求參數
參數型別用戶端 DTO 欄位參考
pageinteger用戶端模型必要—
pageSizeinteger用戶端模型必要—
queryobject用戶端模型必要—
query.nextCursorstring | null可為 Null—
query.brokerIdinteger | null可為 Null—
query.walletTypeinteger | null可為 Null交易枚舉值
query.marketTypeinteger | null可為 Null支援市場與 marketType 代碼
query.orderTypeinteger | null可為 Null交易枚舉值
query.coinTypeinteger | null可為 Null交易枚舉值
query.orderSideinteger | null可為 Null交易枚舉值
query.startTimeinteger | null可為 Null—
query.endTimeinteger | 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

POST

查詢帳戶已完成訂單分頁。

請求範例

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

{
  "page": 1,
  "pageSize": 20,
  "query": {
    "walletType": 2,
    "marketType": 0,
    "orderType": 1,
    "coinType": 0,
    "orderSide": 1,
    "startTime": 1735689600000,
    "endTime": 1735776000000
  }
}
請求參數
參數型別用戶端 DTO 欄位參考
pageinteger用戶端模型必要—
pageSizeinteger用戶端模型必要—
queryobject用戶端模型必要—
query.nextCursorstring | null可為 Null—
query.brokerIdinteger | null可為 Null—
query.walletTypeinteger | null可為 Null交易枚舉值
query.marketTypeinteger | null可為 Null支援市場與 marketType 代碼
query.orderTypeinteger | null可為 Null交易枚舉值
query.coinTypeinteger | null可為 Null交易枚舉值
query.orderSideinteger | null可為 Null交易枚舉值
query.startTimeinteger | null可為 Null—
query.endTimeinteger | 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

POST

回傳交易歷史統計物件。

請求範例

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

{
  "walletType": 2,
  "marketType": 0,
  "orderType": 1,
  "coinType": 0,
  "orderSide": 1,
  "startTime": 1735689600000,
  "endTime": 1735776000000
}
請求參數
參數型別用戶端 DTO 欄位參考
query.nextCursorstring | null可為 Null—
query.brokerIdinteger | null可為 Null—
query.walletTypeinteger | null可為 Null交易枚舉值
query.marketTypeinteger | null可為 Null支援市場與 marketType 代碼
query.orderTypeinteger | null可為 Null交易枚舉值
query.coinTypeinteger | null可為 Null交易枚舉值
query.orderSideinteger | null可為 Null交易枚舉值
query.startTimeinteger | null可為 Null—
query.endTimeinteger | 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 環境;完成後請清除。