brokerageDocsPage.customers
顧客管理 API
ブローカー側の顧客一覧、口座申請、審査、担当設定、オンライン状態、顧客プロファイル API。
認証とアクセス権
ブローカー/マーチャントスタッフの認証済みセッションと対応するバックエンド権限が必要です。一般の取引アプリ利用者 Token では認証できません。権限はブローカー管理者に確認してください。
選択した Merchant BFF 環境へ JSON POST リクエストを送信します。Finger Admin クライアントはログイン済みブローカースタッフの Access Token を Bearer 形式で Authorization ヘッダーに設定します。
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.
/mer-api/v1/customer/listリクエスト例
{
"page": 1,
"pageSize": 20,
"query": {
"userNumber": "",
"brokerNumber": "",
"marketType": 0,
"startTime": "",
"endTime": ""
}
}リクエスト項目
pagenumberpageSizenumberqueryobjectレスポンス例
値は説明用です。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.
/mer-api/v1/customer/open-account-listリクエスト例
{
"page": 1,
"pageSize": 20,
"query": {
"userNumber": "",
"brokerNumber": "",
"marketType": 0,
"startTime": "",
"endTime": ""
}
}リクエスト項目
pagenumberpageSizenumberqueryobjectレスポンス例
値は説明用です。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.
/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.
/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.
/mer-api/v1/customer/submit-reviewリクエスト例
{
"id": "demo-application-id",
"approved": true,
"stageCode": "ACCOUNT_OPENING",
"proveImage": "",
"remark": "Reviewed",
"failField": {}
}リクエスト項目
idstringapprovedbooleanstageCodestringproveImagestringremarkstringfailFieldobjectレスポンス例
値は説明用です。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.
/mer-api/v1/customer/set-ownerリクエスト例
{
"userId": "demo-user-id",
"bcId": "demo-owner-id"
}リクエスト項目
userIdstringbcIdstringレスポンス例
値は説明用です。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.
/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.
/mer-api/v1/customer/portrait/overviewリクエスト例
{
"id": "demo-user-id",
"startDate": "2026-01-01",
"endDate": "2026-01-31",
"marketType": 0,
"favoriteTickerLimit": 10,
"performanceOrderLimit": 20
}リクエスト項目
idstringstartDatestringendDatestringmarketTypenumberfavoriteTickerLimitnumberperformanceOrderLimitnumberレスポンス例
値は説明用です。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.
/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
}リクエスト項目
idstringstartDatestringendDatestringmarketTypenumberfavoriteTickerLimitnumberperformanceOrderLimitnumberレスポンス例
値は説明用です。ID は権限付き口座の値に置き換えてください。レスポンス本文は Finger Admin クライアントの利用方法から推定した例です。正確な仕様はブローカーに確認してください。設定・注文操作は実データを変更する場合があります。
{
"code": 0,
"data": [
{
"date": "2026-01-01",
"orderCount": 0,
"pnl": "0"
}
],
"msg": "success"
}リクエストを試す · /mer-api/v1/customer/portrait/order-performance
準備完了です。送信ボタンを押すまでリクエストは送信されません。
レスポンス—
Token は現在のページセッション内のみで使用し、保存しません。共有端末では使用を避け、終了後に消去してください。