FINGER TRADER

brokerageDocsPage.riskControl

リスク管理 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

Broker-side risk workflows combine customer order and position queries with controls configured under Trading configuration.

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

Market ticker/order data

Paged market data list; TickerListQueryDTO filters by marketType.

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

リクエスト例

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

リクエスト項目

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

Close order

Closes the order identified by IDDTO.

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

リクエスト例

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

リクエスト項目

idstring

レスポンス例

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

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

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

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

レスポンス
—

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

Set user matching configuration

Updates the user matching configuration.

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

リクエスト例

{
  "marketType": 0,
  "userId": "demo-user-id",
  "value": {
    "status": 1,
    "orderSide": 0,
    "rate": 1,
    "followOrderFirst": false
  }
}

リクエスト項目

marketTypenumber
userIdstring
valueobject

レスポンス例

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

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

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

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

レスポンス
—

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