FINGER TRADER

brokerageDocsPage.customers

Customer Management APIs

Broker-side APIs for customer lists, account applications, review actions, ownership, online status, and customer profiles.

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

Customer records, account opening reviews, account ownership, status, and customer profile endpoints used by Finger Admin.

Customer list

Paged customer search; query keys are based on UserQueryDTO.

POST/mer-api/v1/customer/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/customer/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.

Open account applications

Paged account-opening application list.

POST/mer-api/v1/customer/open-account-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/customer/open-account-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 detail

Loads a customer record using IDDTO.

POST/mer-api/v1/customer/detail

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": {
    "id": "sample-id",
    "status": 1
  },
  "msg": "success"
}
Try this request · /mer-api/v1/customer/detail

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.

Open account detail

Loads account-opening application details.

POST/mer-api/v1/customer/get-open-detail

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": {
    "id": "sample-id",
    "status": 1
  },
  "msg": "success"
}
Try this request · /mer-api/v1/customer/get-open-detail

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.

Review account application

Submits the review decision, stage, remark, and optional failure fields.

POST/mer-api/v1/customer/submit-review

Request example

{
  "id": "demo-application-id",
  "approved": true,
  "stageCode": "ACCOUNT_OPENING",
  "proveImage": "",
  "remark": "Reviewed",
  "failField": {}
}

Request fields

idstring
approvedboolean
stageCodestring
proveImagestring
remarkstring
failFieldobject

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/customer/submit-review

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.

Assign customer owner

Sets the customer owner/BC assignment.

POST/mer-api/v1/customer/set-owner

Request example

{
  "userId": "demo-user-id",
  "bcId": "demo-owner-id"
}

Request fields

userIdstring
bcIdstring

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/customer/set-owner

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.

Customer online status

Queries online status for a customer.

POST/mer-api/v1/customer/online-status

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": {
    "id": "sample-id",
    "status": 1
  },
  "msg": "success"
}
Try this request · /mer-api/v1/customer/online-status

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 portrait overview

CustomerPortraitQueryDTO; available profile metrics depend on backend response data.

POST/mer-api/v1/customer/portrait/overview

Request example

{
  "id": "demo-user-id",
  "startDate": "2026-01-01",
  "endDate": "2026-01-31",
  "marketType": 0,
  "favoriteTickerLimit": 10,
  "performanceOrderLimit": 20
}

Request fields

idstring
startDatestring
endDatestring
marketTypenumber
favoriteTickerLimitnumber
performanceOrderLimitnumber

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": {
    "id": "sample-id",
    "status": 1
  },
  "msg": "success"
}
Try this request · /mer-api/v1/customer/portrait/overview

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 performance portrait

Queries the customer order-performance portrait.

POST/mer-api/v1/customer/portrait/order-performance

Request example

{
  "id": "demo-user-id",
  "startDate": "2026-01-01",
  "endDate": "2026-01-31",
  "marketType": 0,
  "favoriteTickerLimit": 10,
  "performanceOrderLimit": 20
}

Request fields

idstring
startDatestring
endDatestring
marketTypenumber
favoriteTickerLimitnumber
performanceOrderLimitnumber

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": [
    {
      "date": "2026-01-01",
      "orderCount": 0,
      "pnl": "0"
    }
  ],
  "msg": "success"
}
Try this request · /mer-api/v1/customer/portrait/order-performance

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.