FINGER TRADER

brokerageDocsPage.orders

Order Management APIs

Broker-side APIs for customer positions and history, market order pools, and authorized order actions.

Documentation framework · Overview

Authentication and access

These interfaces require an authorized broker or merchant staff session and the relevant backend permissions. They are not authenticated by an ordinary end-customer trading-app token. Confirm access with the broker administrator.

Send JSON POST requests to the selected merchant BFF environment. The Finger Admin client sends its signed-in broker-staff access token in the Authorization header as a Bearer token.

https://dev-api.fingertrading.com/finger-bff-merchant
Authorization: Bearer <BROKER_STAFF_ACCESS_TOKEN>

Examples are illustrative. Replace identifiers with values from your authorized account. Response payload shapes are examples inferred from Finger Admin client usage; confirm the exact contract with your broker. Configuration and order-action requests can change live data.

Endpoints in this section

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.

POST/mer-api/v1/order/market-order-list

Request example

{
  "marketType": 0
}

Request fields

marketTypenumber

Response example

Examples are illustrative. Replace identifiers with values from your authorized account. Response payload shapes are examples inferred from Finger Admin client usage; confirm the exact contract with your broker. Configuration and order-action requests can change live data.

{
  "code": 0,
  "data": {
    "total": 1,
    "items": [
      {
        "id": "sample-id",
        "userNumber": "U10001",
        "status": 1
      }
    ]
  },
  "msg": "success"
}
Try this request · /mer-api/v1/order/market-order-list

Ready. The request is not sent until you press Send.

Response
—

The token is held only in this page session and is not saved by this documentation page. Avoid shared devices and clear the token when finished.

Market ticker/order data

Paged market data list; TickerListQueryDTO filters by marketType.

POST/mer-api/v1/order/market-data-list

Request example

{
  "page": 1,
  "pageSize": 20,
  "query": {
    "marketType": 0
  }
}

Request fields

pagenumber
pageSizenumber
queryobject

Response example

Examples are illustrative. Replace identifiers with values from your authorized account. Response payload shapes are examples inferred from Finger Admin client usage; confirm the exact contract with your broker. Configuration and order-action requests can change live data.

{
  "code": 0,
  "data": {
    "total": 1,
    "items": [
      {
        "id": "sample-id",
        "userNumber": "U10001",
        "status": 1
      }
    ]
  },
  "msg": "success"
}
Try this request · /mer-api/v1/order/market-data-list

Ready. The request is not sent until you press Send.

Response
—

The token is held only in this page session and is not saved by this documentation page. Avoid shared devices and clear the token when finished.

Customer open positions

Paged customer holdings query.

POST/mer-api/v1/order/get-user-order-holding-list

Request example

{
  "page": 1,
  "pageSize": 20,
  "query": {
    "userNumber": "",
    "brokerNumber": "",
    "marketType": 0,
    "startTime": "",
    "endTime": ""
  }
}

Request fields

pagenumber
pageSizenumber
queryobject

Response example

Examples are illustrative. Replace identifiers with values from your authorized account. Response payload shapes are examples inferred from Finger Admin client usage; confirm the exact contract with your broker. Configuration and order-action requests can change live data.

{
  "code": 0,
  "data": {
    "total": 1,
    "items": [
      {
        "id": "sample-id",
        "userNumber": "U10001",
        "status": 1
      }
    ]
  },
  "msg": "success"
}
Try this request · /mer-api/v1/order/get-user-order-holding-list

Ready. The request is not sent until you press Send.

Response
—

The token is held only in this page session and is not saved by this documentation page. Avoid shared devices and clear the token when finished.

Customer order history

Paged order history for a customer or broker query.

POST/mer-api/v1/order/get-user-order-history-list

Request example

{
  "page": 1,
  "pageSize": 20,
  "query": {
    "userNumber": "",
    "brokerNumber": "",
    "marketType": 0,
    "startTime": "",
    "endTime": ""
  }
}

Request fields

pagenumber
pageSizenumber
queryobject

Response example

Examples are illustrative. Replace identifiers with values from your authorized account. Response payload shapes are examples inferred from Finger Admin client usage; confirm the exact contract with your broker. Configuration and order-action requests can change live data.

{
  "code": 0,
  "data": {
    "total": 1,
    "items": [
      {
        "id": "sample-id",
        "userNumber": "U10001",
        "status": 1
      }
    ]
  },
  "msg": "success"
}
Try this request · /mer-api/v1/order/get-user-order-history-list

Ready. The request is not sent until you press Send.

Response
—

The token is held only in this page session and is not saved by this documentation page. Avoid shared devices and clear the token when finished.

Grouped customer order history

Paged grouped history query.

POST/mer-api/v1/order/get-user-order-history-grouped-list

Request example

{
  "page": 1,
  "pageSize": 20,
  "query": {
    "userNumber": "",
    "brokerNumber": "",
    "marketType": 0,
    "startTime": "",
    "endTime": ""
  }
}

Request fields

pagenumber
pageSizenumber
queryobject

Response example

Examples are illustrative. Replace identifiers with values from your authorized account. Response payload shapes are examples inferred from Finger Admin client usage; confirm the exact contract with your broker. Configuration and order-action requests can change live data.

{
  "code": 0,
  "data": {
    "total": 1,
    "items": [
      {
        "id": "sample-id",
        "userNumber": "U10001",
        "status": 1
      }
    ]
  },
  "msg": "success"
}
Try this request · /mer-api/v1/order/get-user-order-history-grouped-list

Ready. The request is not sent until you press Send.

Response
—

The token is held only in this page session and is not saved by this documentation page. Avoid shared devices and clear the token when finished.

Customer order history statistics

Aggregate history statistics using OrderListQueryWithUserDTO.

POST/mer-api/v1/order/get-user-order-history-stat

Request example

{
  "brokerNumber": "",
  "userName": "",
  "userNumber": "",
  "timezone": "UTC",
  "marketType": 0,
  "orderType": 0,
  "coinType": 0,
  "orderSide": 0,
  "startTime": "",
  "endTime": ""
}

Request fields

brokerNumberstring
userNamestring
userNumberstring
timezonestring
marketTypenumber
orderTypenumber
coinTypenumber
orderSidenumber
startTimestring
endTimestring

Response example

Examples are illustrative. Replace identifiers with values from your authorized account. Response payload shapes are examples inferred from Finger Admin client usage; confirm the exact contract with your broker. Configuration and order-action requests can change live data.

{
  "code": 0,
  "data": {
    "total": 0,
    "buyCount": 0,
    "sellCount": 0
  },
  "msg": "success"
}
Try this request · /mer-api/v1/order/get-user-order-history-stat

Ready. The request is not sent until you press Send.

Response
—

The token is held only in this page session and is not saved by this documentation page. Avoid shared devices and clear the token when finished.

Broker order history

Paged broker order history query.

POST/mer-api/v1/order/get-broker-order-history-list

Request example

{
  "page": 1,
  "pageSize": 20,
  "query": {
    "userNumber": "",
    "brokerNumber": "",
    "marketType": 0,
    "startTime": "",
    "endTime": ""
  }
}

Request fields

pagenumber
pageSizenumber
queryobject

Response example

Examples are illustrative. Replace identifiers with values from your authorized account. Response payload shapes are examples inferred from Finger Admin client usage; confirm the exact contract with your broker. Configuration and order-action requests can change live data.

{
  "code": 0,
  "data": {
    "total": 1,
    "items": [
      {
        "id": "sample-id",
        "userNumber": "U10001",
        "status": 1
      }
    ]
  },
  "msg": "success"
}
Try this request · /mer-api/v1/order/get-broker-order-history-list

Ready. The request is not sent until you press Send.

Response
—

The token is held only in this page session and is not saved by this documentation page. Avoid shared devices and clear the token when finished.

Close order

Closes the order identified by IDDTO.

POST/mer-api/v1/order/close-order

Request example

{
  "id": "demo-record-id"
}

Request fields

idstring

Response example

Examples are illustrative. Replace identifiers with values from your authorized account. Response payload shapes are examples inferred from Finger Admin client usage; confirm the exact contract with your broker. Configuration and order-action requests can change live data.

{
  "code": 0,
  "data": true,
  "msg": "success"
}
Try this request · /mer-api/v1/order/close-order

This endpoint changes broker data or order state. Try sends a real request; it is not a simulation. Use an approved test account and environment.

Ready. The request is not sent until you press Send.

Response
—

The token is held only in this page session and is not saved by this documentation page. Avoid shared devices and clear the token when finished.