brokerageDocsPage.orders
訂單管理 API
經紀商端查詢客戶持倉與歷史訂單、市場訂單池及授權訂單操作的 API。
認證與存取權限
這些介面需要已授權的經紀商/商戶員工會話及相應後端權限;一般終端客戶交易 App Token 無法用於此處。請向券商管理員確認權限。
向所選商戶 BFF 環境發送 JSON POST 請求。Finger Admin 用戶端會在 Authorization 請求標頭中傳送已登入的經紀商員工 Access Token,格式為 Bearer Token。
Authorization: Bearer <BROKER_STAFF_ACCESS_TOKEN>
範例值僅供說明,請替換為授權帳戶取得的識別碼。回應本文結構是依 Finger Admin 用戶端使用方式模擬,確切規格請向券商確認。配置及訂單操作可能變更實際資料。
本分類介面
Order pool, customer positions and history, grouped history, export, and order action endpoints used by Finger Admin.
Market order pool
Queries the market order pool using MarketQueryDTO.
/mer-api/v1/order/market-order-list請求範例
{
"marketType": 0
}請求欄位
marketTypenumber回應範例
範例值僅供說明,請替換為授權帳戶取得的識別碼。回應本文結構是依 Finger Admin 用戶端使用方式模擬,確切規格請向券商確認。配置及訂單操作可能變更實際資料。
{
"code": 0,
"data": {
"total": 1,
"items": [
{
"id": "sample-id",
"userNumber": "U10001",
"status": 1
}
]
},
"msg": "success"
}試用此請求 · /mer-api/v1/order/market-order-list
就緒。按下「發送請求」前不會送出請求。
回應—
本頁只在目前頁面工作階段暫存 Token,不會保存。請勿在共用裝置上使用,完成後清除 Token。
Market ticker/order data
Paged market data list; TickerListQueryDTO filters by marketType.
/mer-api/v1/order/market-data-list請求範例
{
"page": 1,
"pageSize": 20,
"query": {
"marketType": 0
}
}請求欄位
pagenumberpageSizenumberqueryobject回應範例
範例值僅供說明,請替換為授權帳戶取得的識別碼。回應本文結構是依 Finger Admin 用戶端使用方式模擬,確切規格請向券商確認。配置及訂單操作可能變更實際資料。
{
"code": 0,
"data": {
"total": 1,
"items": [
{
"id": "sample-id",
"userNumber": "U10001",
"status": 1
}
]
},
"msg": "success"
}試用此請求 · /mer-api/v1/order/market-data-list
就緒。按下「發送請求」前不會送出請求。
回應—
本頁只在目前頁面工作階段暫存 Token,不會保存。請勿在共用裝置上使用,完成後清除 Token。
Customer open positions
Paged customer holdings query.
/mer-api/v1/order/get-user-order-holding-list請求範例
{
"page": 1,
"pageSize": 20,
"query": {
"userNumber": "",
"brokerNumber": "",
"marketType": 0,
"startTime": "",
"endTime": ""
}
}請求欄位
pagenumberpageSizenumberqueryobject回應範例
範例值僅供說明,請替換為授權帳戶取得的識別碼。回應本文結構是依 Finger Admin 用戶端使用方式模擬,確切規格請向券商確認。配置及訂單操作可能變更實際資料。
{
"code": 0,
"data": {
"total": 1,
"items": [
{
"id": "sample-id",
"userNumber": "U10001",
"status": 1
}
]
},
"msg": "success"
}試用此請求 · /mer-api/v1/order/get-user-order-holding-list
就緒。按下「發送請求」前不會送出請求。
回應—
本頁只在目前頁面工作階段暫存 Token,不會保存。請勿在共用裝置上使用,完成後清除 Token。
Customer order history
Paged order history for a customer or broker query.
/mer-api/v1/order/get-user-order-history-list請求範例
{
"page": 1,
"pageSize": 20,
"query": {
"userNumber": "",
"brokerNumber": "",
"marketType": 0,
"startTime": "",
"endTime": ""
}
}請求欄位
pagenumberpageSizenumberqueryobject回應範例
範例值僅供說明,請替換為授權帳戶取得的識別碼。回應本文結構是依 Finger Admin 用戶端使用方式模擬,確切規格請向券商確認。配置及訂單操作可能變更實際資料。
{
"code": 0,
"data": {
"total": 1,
"items": [
{
"id": "sample-id",
"userNumber": "U10001",
"status": 1
}
]
},
"msg": "success"
}試用此請求 · /mer-api/v1/order/get-user-order-history-list
就緒。按下「發送請求」前不會送出請求。
回應—
本頁只在目前頁面工作階段暫存 Token,不會保存。請勿在共用裝置上使用,完成後清除 Token。
Grouped customer order history
Paged grouped history query.
/mer-api/v1/order/get-user-order-history-grouped-list請求範例
{
"page": 1,
"pageSize": 20,
"query": {
"userNumber": "",
"brokerNumber": "",
"marketType": 0,
"startTime": "",
"endTime": ""
}
}請求欄位
pagenumberpageSizenumberqueryobject回應範例
範例值僅供說明,請替換為授權帳戶取得的識別碼。回應本文結構是依 Finger Admin 用戶端使用方式模擬,確切規格請向券商確認。配置及訂單操作可能變更實際資料。
{
"code": 0,
"data": {
"total": 1,
"items": [
{
"id": "sample-id",
"userNumber": "U10001",
"status": 1
}
]
},
"msg": "success"
}試用此請求 · /mer-api/v1/order/get-user-order-history-grouped-list
就緒。按下「發送請求」前不會送出請求。
回應—
本頁只在目前頁面工作階段暫存 Token,不會保存。請勿在共用裝置上使用,完成後清除 Token。
Customer order history statistics
Aggregate history statistics using OrderListQueryWithUserDTO.
/mer-api/v1/order/get-user-order-history-stat請求範例
{
"brokerNumber": "",
"userName": "",
"userNumber": "",
"timezone": "UTC",
"marketType": 0,
"orderType": 0,
"coinType": 0,
"orderSide": 0,
"startTime": "",
"endTime": ""
}請求欄位
brokerNumberstringuserNamestringuserNumberstringtimezonestringmarketTypenumberorderTypenumbercoinTypenumberorderSidenumberstartTimestringendTimestring回應範例
範例值僅供說明,請替換為授權帳戶取得的識別碼。回應本文結構是依 Finger Admin 用戶端使用方式模擬,確切規格請向券商確認。配置及訂單操作可能變更實際資料。
{
"code": 0,
"data": {
"total": 0,
"buyCount": 0,
"sellCount": 0
},
"msg": "success"
}試用此請求 · /mer-api/v1/order/get-user-order-history-stat
就緒。按下「發送請求」前不會送出請求。
回應—
本頁只在目前頁面工作階段暫存 Token,不會保存。請勿在共用裝置上使用,完成後清除 Token。
Broker order history
Paged broker order history query.
/mer-api/v1/order/get-broker-order-history-list請求範例
{
"page": 1,
"pageSize": 20,
"query": {
"userNumber": "",
"brokerNumber": "",
"marketType": 0,
"startTime": "",
"endTime": ""
}
}請求欄位
pagenumberpageSizenumberqueryobject回應範例
範例值僅供說明,請替換為授權帳戶取得的識別碼。回應本文結構是依 Finger Admin 用戶端使用方式模擬,確切規格請向券商確認。配置及訂單操作可能變更實際資料。
{
"code": 0,
"data": {
"total": 1,
"items": [
{
"id": "sample-id",
"userNumber": "U10001",
"status": 1
}
]
},
"msg": "success"
}試用此請求 · /mer-api/v1/order/get-broker-order-history-list
就緒。按下「發送請求」前不會送出請求。
回應—
本頁只在目前頁面工作階段暫存 Token,不會保存。請勿在共用裝置上使用,完成後清除 Token。
Close order
Closes the order identified by IDDTO.
/mer-api/v1/order/close-order請求範例
{
"id": "demo-record-id"
}請求欄位
idstring回應範例
範例值僅供說明,請替換為授權帳戶取得的識別碼。回應本文結構是依 Finger Admin 用戶端使用方式模擬,確切規格請向券商確認。配置及訂單操作可能變更實際資料。
{
"code": 0,
"data": true,
"msg": "success"
}試用此請求 · /mer-api/v1/order/close-order
此介面會修改經紀商資料或訂單狀態。Try 會發送真實請求,並非模擬;請使用核準的測試帳戶及環境。
就緒。按下「發送請求」前不會送出請求。
回應—
本頁只在目前頁面工作階段暫存 Token,不會保存。請勿在共用裝置上使用,完成後清除 Token。