tradingOrdersDocsPage.orderManagement
発注・注文管理 API
認証済み Finger Trader 取引エンドポイントから注文の作成、決済、取消、変更を行います。
注文更新エンドポイント
実際の注文を送信または変更する場合があります。試す前に口座、市場、銘柄、数量、ブローカー固有のルールを確認してください。
Bearer Access Token と JSON 本文を付けた POST リクエストです。Flutter クライアントは認証済み Finger Trader App BFF を呼び出します。 はじめに:認証
https://prod-api.fingertrader.com/finger-bff-app認証リクエストヘッダーAuthorization: Bearer <ACCESS_TOKEN>Finger Trader アカウントを有効化し、Finger エコシステム内のブローカーで口座を開設してください。Getting Started の Bearer Access Token を使用します。
成功レスポンスは Finger Trader 標準形式の code、data、msg を使用します。各エンドポイントの例に Flutter クライアントが解析する data の形を示します。
注文作成
POST /app-api/v1/order/create-order
新規注文リクエストを送信します。
リクエスト例
値は説明用です。ticker、市場、口座/注文 ID、ブローカー ID はご自身の口座で取得した値に置き換え、送信前に必要項目をブローカーへ確認してください。
{
"ticker": "EURUSD",
"orderType": 1,
"orderSide": 1,
"qty": "1000",
"coinType": 0,
"walletType": 2,
"price": "1.08500",
"marginRate": 10,
"stopLoss": "1.07500",
"takeProfit": "1.09500",
"marketType": 0
}| パラメーター | 型 | クライアント DTO | 参照 |
|---|---|---|---|
ticker | string | null 可 | ブローカー対応 Ticker / Symbol |
orderType | integer | null 可 | 取引 enum 値 |
orderSide | integer | null 可 | 取引 enum 値 |
qty | decimal string | null 可 | — |
coinType | integer | null 可 | 取引 enum 値 |
walletType | integer | null 可 | 取引 enum 値 |
price | decimal string | null 可 | — |
marginRate | integer | null 可 | — |
stopLoss | decimal string | null 可 | — |
takeProfit | decimal string | null 可 | — |
marketType | integer | null 可 | 対応市場と marketType コード |
brokerId | integer | null 可 | — |
Flutter DTO で null 可または一部 ID を省略可能であることを示します。サーバー側の検証条件を示すものではありません。必須項目はブローカー/サービスに確認してください。
レスポンス例
{"code":0,"data":true,"msg":""}クライアントは data が真偽値であることを想定します。
Try は選択した環境へ実リクエストを送信し、注文の作成、決済、取消、変更を実行する可能性があります。テスト口座とブローカー承認済みのテスト環境を使用してください。
REST リクエストを試す · /app-api/v1/order/create-order
Access Token を入力し、リクエスト項目を編集します。送信すると、ブラウザーから選択した Finger Trader 公式 BFF 環境へ直接リクエストします。
Try は選択した環境へ実リクエストを送信し、注文の作成、決済、取消、変更を実行する可能性があります。テスト口座とブローカー承認済みのテスト環境を使用してください。
準備完了です。送信ボタンを押すまで送信されません。
応答がここに表示されます。
Access Token はページのメモリ内にのみ保持され、ブラウザーストレージや Finger Trader ウェブサイトサーバーには送信されません。送信ボタンを押した後、選択した公式 API 環境にのみ送信されます。
決済
POST /app-api/v1/order/close-order
決済リクエストを送信します。
リクエスト例
値は説明用です。ticker、市場、口座/注文 ID、ブローカー ID はご自身の口座で取得した値に置き換え、送信前に必要項目をブローカーへ確認してください。
{
"userId": "user_demo_12345",
"orderId": "order_demo_20250101_001",
"qty": "500",
"marketType": 0,
"brokerId": 10001,
"brokerPositionId": "position_demo_001",
"symbol": "EURUSD"
}| パラメーター | 型 | クライアント DTO | 参照 |
|---|---|---|---|
userId | string | null 可 | — |
orderId | string | null 可 | — |
qty | decimal string | null 可 | — |
marketType | integer | null 可 | 対応市場と marketType コード |
brokerId | integer | null 可 | — |
brokerPositionId | string | null 可 | — |
symbol | string | null 可 | ブローカー対応 Ticker / Symbol |
Flutter DTO で null 可または一部 ID を省略可能であることを示します。サーバー側の検証条件を示すものではありません。必須項目はブローカー/サービスに確認してください。
レスポンス例
{"code":0,"data":true,"msg":""}クライアントは data が真偽値であることを想定します。
Try は選択した環境へ実リクエストを送信し、注文の作成、決済、取消、変更を実行する可能性があります。テスト口座とブローカー承認済みのテスト環境を使用してください。
REST リクエストを試す · /app-api/v1/order/close-order
Access Token を入力し、リクエスト項目を編集します。送信すると、ブラウザーから選択した Finger Trader 公式 BFF 環境へ直接リクエストします。
Try は選択した環境へ実リクエストを送信し、注文の作成、決済、取消、変更を実行する可能性があります。テスト口座とブローカー承認済みのテスト環境を使用してください。
準備完了です。送信ボタンを押すまで送信されません。
応答がここに表示されます。
Access Token はページのメモリ内にのみ保持され、ブラウザーストレージや Finger Trader ウェブサイトサーバーには送信されません。送信ボタンを押した後、選択した公式 API 環境にのみ送信されます。
指値注文の取消
POST /app-api/v1/order/cancel-order
指値注文の取消リクエストを送信します。
リクエスト例
値は説明用です。ticker、市場、口座/注文 ID、ブローカー ID はご自身の口座で取得した値に置き換え、送信前に必要項目をブローカーへ確認してください。
{
"userId": "user_demo_12345",
"orderId": "order_demo_20250101_002",
"marketType": 0,
"brokerId": 10001,
"brokerOrderId": "broker_order_demo_002",
"clientOrderId": "client_order_demo_002"
}| パラメーター | 型 | クライアント DTO | 参照 |
|---|---|---|---|
userId | string | null 可 | — |
orderId | string | null 可 | — |
marketType | integer | null 可 | 対応市場と marketType コード |
brokerId | integer | null 可 | — |
brokerOrderId | string | null 可 | — |
clientOrderId | string | null 可 | — |
Flutter DTO で null 可または一部 ID を省略可能であることを示します。サーバー側の検証条件を示すものではありません。必須項目はブローカー/サービスに確認してください。
レスポンス例
{"code":0,"data":true,"msg":""}クライアントは data が真偽値であることを想定します。
Try は選択した環境へ実リクエストを送信し、注文の作成、決済、取消、変更を実行する可能性があります。テスト口座とブローカー承認済みのテスト環境を使用してください。
REST リクエストを試す · /app-api/v1/order/cancel-order
Access Token を入力し、リクエスト項目を編集します。送信すると、ブラウザーから選択した Finger Trader 公式 BFF 環境へ直接リクエストします。
Try は選択した環境へ実リクエストを送信し、注文の作成、決済、取消、変更を実行する可能性があります。テスト口座とブローカー承認済みのテスト環境を使用してください。
準備完了です。送信ボタンを押すまで送信されません。
応答がここに表示されます。
Access Token はページのメモリ内にのみ保持され、ブラウザーストレージや Finger Trader ウェブサイトサーバーには送信されません。送信ボタンを押した後、選択した公式 API 環境にのみ送信されます。
損切り/利確の変更
POST /app-api/v1/order/modify-stop-profit-loss
損切りまたは利確の変更リクエストを送信します。
リクエスト例
値は説明用です。ticker、市場、口座/注文 ID、ブローカー ID はご自身の口座で取得した値に置き換え、送信前に必要項目をブローカーへ確認してください。
{
"userId": "user_demo_12345",
"orderId": "order_demo_20250101_003",
"qty": "1000",
"price": "1.08600",
"stopLose": "1.07600",
"stopProfit": "1.09600",
"clearStopLoss": false,
"clearTakeProfit": false
}| パラメーター | 型 | クライアント DTO | 参照 |
|---|---|---|---|
userId | string | null 可 | — |
orderId | string | null 可 | — |
qty | decimal string | null 可 | — |
price | decimal string | null 可 | — |
stopLose | decimal string | null 可 | — |
stopProfit | decimal string | null 可 | — |
clearStopLoss | boolean | null 可 | — |
clearTakeProfit | boolean | null 可 | — |
Flutter DTO で null 可または一部 ID を省略可能であることを示します。サーバー側の検証条件を示すものではありません。必須項目はブローカー/サービスに確認してください。
レスポンス例
{"code":0,"data":true,"msg":""}クライアントは data が真偽値であることを想定します。
Try は選択した環境へ実リクエストを送信し、注文の作成、決済、取消、変更を実行する可能性があります。テスト口座とブローカー承認済みのテスト環境を使用してください。
REST リクエストを試す · /app-api/v1/order/modify-stop-profit-loss
Access Token を入力し、リクエスト項目を編集します。送信すると、ブラウザーから選択した Finger Trader 公式 BFF 環境へ直接リクエストします。
Try は選択した環境へ実リクエストを送信し、注文の作成、決済、取消、変更を実行する可能性があります。テスト口座とブローカー承認済みのテスト環境を使用してください。
準備完了です。送信ボタンを押すまで送信されません。
応答がここに表示されます。
Access Token はページのメモリ内にのみ保持され、ブラウザーストレージや Finger Trader ウェブサイトサーバーには送信されません。送信ボタンを押した後、選択した公式 API 環境にのみ送信されます。