brokerageDocsPage.orders
注文管理 API
顧客ポジション・注文履歴・市場注文プールの照会と、許可された注文操作の API。
認証とアクセス権
ブローカー/マーチャントスタッフの認証済みセッションと対応するバックエンド権限が必要です。一般の取引アプリ利用者 Token では認証できません。権限はブローカー管理者に確認してください。
選択した Merchant BFF 環境へ JSON POST リクエストを送信します。Finger Admin クライアントはログイン済みブローカースタッフの Access Token を Bearer 形式で Authorization ヘッダーに設定します。
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.
/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.
/mer-api/v1/order/market-data-listリクエスト例
{
"page": 1,
"pageSize": 20,
"query": {
"marketType": 0
}
}リクエスト項目
pagenumberpageSizenumberqueryobjectレスポンス例
値は説明用です。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.
/mer-api/v1/order/get-user-order-holding-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/order/get-user-order-holding-list
準備完了です。送信ボタンを押すまでリクエストは送信されません。
レスポンス—
Token は現在のページセッション内のみで使用し、保存しません。共有端末では使用を避け、終了後に消去してください。
Customer order history
Paged order history for a customer or broker query.
/mer-api/v1/order/get-user-order-history-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/order/get-user-order-history-list
準備完了です。送信ボタンを押すまでリクエストは送信されません。
レスポンス—
Token は現在のページセッション内のみで使用し、保存しません。共有端末では使用を避け、終了後に消去してください。
Grouped customer order history
Paged grouped history query.
/mer-api/v1/order/get-user-order-history-grouped-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/order/get-user-order-history-grouped-list
準備完了です。送信ボタンを押すまでリクエストは送信されません。
レスポンス—
Token は現在のページセッション内のみで使用し、保存しません。共有端末では使用を避け、終了後に消去してください。
Customer order history statistics
Aggregate history statistics using OrderListQueryWithUserDTO.
/mer-api/v1/order/get-user-order-history-statリクエスト例
{
"brokerNumber": "",
"userName": "",
"userNumber": "",
"timezone": "UTC",
"marketType": 0,
"orderType": 0,
"coinType": 0,
"orderSide": 0,
"startTime": "",
"endTime": ""
}リクエスト項目
brokerNumberstringuserNamestringuserNumberstringtimezonestringmarketTypenumberorderTypenumbercoinTypenumberorderSidenumberstartTimestringendTimestringレスポンス例
値は説明用です。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.
/mer-api/v1/order/get-broker-order-history-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/order/get-broker-order-history-list
準備完了です。送信ボタンを押すまでリクエストは送信されません。
レスポンス—
Token は現在のページセッション内のみで使用し、保存しません。共有端末では使用を避け、終了後に消去してください。
Close order
Closes the order identified by IDDTO.
/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 は現在のページセッション内のみで使用し、保存しません。共有端末では使用を避け、終了後に消去してください。