FINGER TRADER

brokerageDocsPage.customers

顧客管理 API

ブローカー側の顧客一覧、口座申請、審査、担当設定、オンライン状態、顧客プロファイル API。

ドキュメント構成 · 概要

認証とアクセス権

ブローカー/マーチャントスタッフの認証済みセッションと対応するバックエンド権限が必要です。一般の取引アプリ利用者 Token では認証できません。権限はブローカー管理者に確認してください。

選択した Merchant BFF 環境へ JSON POST リクエストを送信します。Finger Admin クライアントはログイン済みブローカースタッフの Access Token を Bearer 形式で Authorization ヘッダーに設定します。

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

値は説明用です。ID は権限付き口座の値に置き換えてください。レスポンス本文は Finger Admin クライアントの利用方法から推定した例です。正確な仕様はブローカーに確認してください。設定・注文操作は実データを変更する場合があります。

この分類の API

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

リクエスト例

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

リクエスト項目

pagenumber
pageSizenumber
queryobject

レスポンス例

値は説明用です。ID は権限付き口座の値に置き換えてください。レスポンス本文は Finger Admin クライアントの利用方法から推定した例です。正確な仕様はブローカーに確認してください。設定・注文操作は実データを変更する場合があります。

{
  "code": 0,
  "data": {
    "total": 1,
    "items": [
      {
        "id": "sample-id",
        "userNumber": "U10001",
        "status": 1
      }
    ]
  },
  "msg": "success"
}
リクエストを試す · /mer-api/v1/customer/list

準備完了です。送信ボタンを押すまでリクエストは送信されません。

レスポンス
—

Token は現在のページセッション内のみで使用し、保存しません。共有端末では使用を避け、終了後に消去してください。

Open account applications

Paged account-opening application list.

POST/mer-api/v1/customer/open-account-list

リクエスト例

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

リクエスト項目

pagenumber
pageSizenumber
queryobject

レスポンス例

値は説明用です。ID は権限付き口座の値に置き換えてください。レスポンス本文は Finger Admin クライアントの利用方法から推定した例です。正確な仕様はブローカーに確認してください。設定・注文操作は実データを変更する場合があります。

{
  "code": 0,
  "data": {
    "total": 1,
    "items": [
      {
        "id": "sample-id",
        "userNumber": "U10001",
        "status": 1
      }
    ]
  },
  "msg": "success"
}
リクエストを試す · /mer-api/v1/customer/open-account-list

準備完了です。送信ボタンを押すまでリクエストは送信されません。

レスポンス
—

Token は現在のページセッション内のみで使用し、保存しません。共有端末では使用を避け、終了後に消去してください。

Customer detail

Loads a customer record using IDDTO.

POST/mer-api/v1/customer/detail

リクエスト例

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

リクエスト項目

idstring

レスポンス例

値は説明用です。ID は権限付き口座の値に置き換えてください。レスポンス本文は Finger Admin クライアントの利用方法から推定した例です。正確な仕様はブローカーに確認してください。設定・注文操作は実データを変更する場合があります。

{
  "code": 0,
  "data": {
    "id": "sample-id",
    "status": 1
  },
  "msg": "success"
}
リクエストを試す · /mer-api/v1/customer/detail

準備完了です。送信ボタンを押すまでリクエストは送信されません。

レスポンス
—

Token は現在のページセッション内のみで使用し、保存しません。共有端末では使用を避け、終了後に消去してください。

Open account detail

Loads account-opening application details.

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

リクエスト例

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

リクエスト項目

idstring

レスポンス例

値は説明用です。ID は権限付き口座の値に置き換えてください。レスポンス本文は Finger Admin クライアントの利用方法から推定した例です。正確な仕様はブローカーに確認してください。設定・注文操作は実データを変更する場合があります。

{
  "code": 0,
  "data": {
    "id": "sample-id",
    "status": 1
  },
  "msg": "success"
}
リクエストを試す · /mer-api/v1/customer/get-open-detail

準備完了です。送信ボタンを押すまでリクエストは送信されません。

レスポンス
—

Token は現在のページセッション内のみで使用し、保存しません。共有端末では使用を避け、終了後に消去してください。

Review account application

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

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

リクエスト例

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

リクエスト項目

idstring
approvedboolean
stageCodestring
proveImagestring
remarkstring
failFieldobject

レスポンス例

値は説明用です。ID は権限付き口座の値に置き換えてください。レスポンス本文は Finger Admin クライアントの利用方法から推定した例です。正確な仕様はブローカーに確認してください。設定・注文操作は実データを変更する場合があります。

{
  "code": 0,
  "data": true,
  "msg": "success"
}
リクエストを試す · /mer-api/v1/customer/submit-review

このエンドポイントはブローカーデータまたは注文状態を変更します。Try は実際のリクエストを送信し、シミュレーションではありません。承認済みのテスト口座と環境を使用してください。

準備完了です。送信ボタンを押すまでリクエストは送信されません。

レスポンス
—

Token は現在のページセッション内のみで使用し、保存しません。共有端末では使用を避け、終了後に消去してください。

Assign customer owner

Sets the customer owner/BC assignment.

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

リクエスト例

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

リクエスト項目

userIdstring
bcIdstring

レスポンス例

値は説明用です。ID は権限付き口座の値に置き換えてください。レスポンス本文は Finger Admin クライアントの利用方法から推定した例です。正確な仕様はブローカーに確認してください。設定・注文操作は実データを変更する場合があります。

{
  "code": 0,
  "data": true,
  "msg": "success"
}
リクエストを試す · /mer-api/v1/customer/set-owner

このエンドポイントはブローカーデータまたは注文状態を変更します。Try は実際のリクエストを送信し、シミュレーションではありません。承認済みのテスト口座と環境を使用してください。

準備完了です。送信ボタンを押すまでリクエストは送信されません。

レスポンス
—

Token は現在のページセッション内のみで使用し、保存しません。共有端末では使用を避け、終了後に消去してください。

Customer online status

Queries online status for a customer.

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

リクエスト例

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

リクエスト項目

idstring

レスポンス例

値は説明用です。ID は権限付き口座の値に置き換えてください。レスポンス本文は Finger Admin クライアントの利用方法から推定した例です。正確な仕様はブローカーに確認してください。設定・注文操作は実データを変更する場合があります。

{
  "code": 0,
  "data": {
    "id": "sample-id",
    "status": 1
  },
  "msg": "success"
}
リクエストを試す · /mer-api/v1/customer/online-status

準備完了です。送信ボタンを押すまでリクエストは送信されません。

レスポンス
—

Token は現在のページセッション内のみで使用し、保存しません。共有端末では使用を避け、終了後に消去してください。

Customer portrait overview

CustomerPortraitQueryDTO; available profile metrics depend on backend response data.

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

リクエスト例

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

リクエスト項目

idstring
startDatestring
endDatestring
marketTypenumber
favoriteTickerLimitnumber
performanceOrderLimitnumber

レスポンス例

値は説明用です。ID は権限付き口座の値に置き換えてください。レスポンス本文は Finger Admin クライアントの利用方法から推定した例です。正確な仕様はブローカーに確認してください。設定・注文操作は実データを変更する場合があります。

{
  "code": 0,
  "data": {
    "id": "sample-id",
    "status": 1
  },
  "msg": "success"
}
リクエストを試す · /mer-api/v1/customer/portrait/overview

準備完了です。送信ボタンを押すまでリクエストは送信されません。

レスポンス
—

Token は現在のページセッション内のみで使用し、保存しません。共有端末では使用を避け、終了後に消去してください。

Customer order performance portrait

Queries the customer order-performance portrait.

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

リクエスト例

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

リクエスト項目

idstring
startDatestring
endDatestring
marketTypenumber
favoriteTickerLimitnumber
performanceOrderLimitnumber

レスポンス例

値は説明用です。ID は権限付き口座の値に置き換えてください。レスポンス本文は Finger Admin クライアントの利用方法から推定した例です。正確な仕様はブローカーに確認してください。設定・注文操作は実データを変更する場合があります。

{
  "code": 0,
  "data": [
    {
      "date": "2026-01-01",
      "orderCount": 0,
      "pnl": "0"
    }
  ],
  "msg": "success"
}
リクエストを試す · /mer-api/v1/customer/portrait/order-performance

準備完了です。送信ボタンを押すまでリクエストは送信されません。

レスポンス
—

Token は現在のページセッション内のみで使用し、保存しません。共有端末では使用を避け、終了後に消去してください。