FINGER TRADER

brokerageDocsPage.orders

注文管理 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

Order pool, customer positions and history, grouped history, export, and order action endpoints used by Finger Admin.

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

Customer order history

Paged order history for a customer or broker query.

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

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

レスポンス
—

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

Grouped customer order history

Paged grouped history query.

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

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

レスポンス
—

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

Customer order history statistics

Aggregate history statistics using OrderListQueryWithUserDTO.

POST/mer-api/v1/order/get-user-order-history-stat

リクエスト例

{
  "brokerNumber": "",
  "userName": "",
  "userNumber": "",
  "timezone": "UTC",
  "marketType": 0,
  "orderType": 0,
  "coinType": 0,
  "orderSide": 0,
  "startTime": "",
  "endTime": ""
}

リクエスト項目

brokerNumberstring
userNamestring
userNumberstring
timezonestring
marketTypenumber
orderTypenumber
coinTypenumber
orderSidenumber
startTimestring
endTimestring

レスポンス例

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

{
  "code": 0,
  "data": {
    "total": 0,
    "buyCount": 0,
    "sellCount": 0
  },
  "msg": "success"
}
リクエストを試す · /mer-api/v1/order/get-user-order-history-stat

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

レスポンス
—

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

Broker order history

Paged broker order history query.

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