FINGER TRADER

ブローカー API ドキュメント

ブローカー API ドキュメント

Finger Admin の顧客、注文、リスク管理フローで使用する /mer-api/v1 インターフェースを整理しています。商用 BFF が提供し、利用可否と権限はブローカー口座および割り当てられた権限によります。

ドキュメント構成 · 概要

ブローカー API ドキュメント

Finger Admin の顧客、注文、リスク管理フローで使用する /mer-api/v1 インターフェースを整理しています。商用 BFF が提供し、利用可否と権限はブローカー口座および割り当てられた権限によります。

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

Merchant BFF の Base URL と認証

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

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

API 分類から選択

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

Market order pool

Queries the market order pool using MarketQueryDTO.

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

リクエスト例

{
  "marketType": 0
}

リクエスト項目

marketTypenumber

レスポンス例

値は説明用です。ID は権限付き口座の値に置き換えてください。レスポンス本文は 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 は現在のページセッション内のみで使用し、保存しません。共有端末では使用を避け、終了後に消去してください。

Customer open positions

Paged customer holdings query.

POST/mer-api/v1/order/get-user-order-holding-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/order/get-user-order-holding-list

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

レスポンス
—

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

User matching configuration

Reads the matching configuration for a market/user context.

POST/mer-api/v1/trade/user-match-config

リクエスト例

{
  "marketType": 0
}

リクエスト項目

marketTypenumber

レスポンス例

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

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

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

レスポンス
—

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