FINGER TRADER

tradingOrdersDocsPage.orderManagement

発注・注文管理 API

認証済み Finger Trader 取引エンドポイントから注文の作成、決済、取消、変更を行います。

ドキュメント構成 · 概要

注文更新エンドポイント

実際の注文を送信または変更する場合があります。試す前に口座、市場、銘柄、数量、ブローカー固有のルールを確認してください。

Bearer Access Token と JSON 本文を付けた POST リクエストです。Flutter クライアントは認証済み Finger Trader App BFF を呼び出します。 はじめに:認証

本番 App BFF Base URLhttps://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

POST

新規注文リクエストを送信します。

リクエスト例

値は説明用です。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参照
tickerstringnull 可ブローカー対応 Ticker / Symbol
orderTypeintegernull 可取引 enum 値
orderSideintegernull 可取引 enum 値
qtydecimal stringnull 可—
coinTypeintegernull 可取引 enum 値
walletTypeintegernull 可取引 enum 値
pricedecimal stringnull 可—
marginRateintegernull 可—
stopLossdecimal stringnull 可—
takeProfitdecimal stringnull 可—
marketTypeintegernull 可対応市場と marketType コード
brokerIdintegernull 可—

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

POST

決済リクエストを送信します。

リクエスト例

値は説明用です。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参照
userIdstringnull 可—
orderIdstringnull 可—
qtydecimal stringnull 可—
marketTypeintegernull 可対応市場と marketType コード
brokerIdintegernull 可—
brokerPositionIdstringnull 可—
symbolstringnull 可ブローカー対応 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

POST

指値注文の取消リクエストを送信します。

リクエスト例

値は説明用です。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参照
userIdstringnull 可—
orderIdstringnull 可—
marketTypeintegernull 可対応市場と marketType コード
brokerIdintegernull 可—
brokerOrderIdstringnull 可—
clientOrderIdstringnull 可—

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

POST

損切りまたは利確の変更リクエストを送信します。

リクエスト例

値は説明用です。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参照
userIdstringnull 可—
orderIdstringnull 可—
qtydecimal stringnull 可—
pricedecimal stringnull 可—
stopLosedecimal stringnull 可—
stopProfitdecimal stringnull 可—
clearStopLossbooleannull 可—
clearTakeProfitbooleannull 可—

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 環境にのみ送信されます。