ナビゲーションにスキップ

永久注文

永久注文: Agent Java SDK v0.3.0 の統合、例、パラメーター、および応答セマンティクス。

Markdownとして表示

このガイドは、Agent Java SDK v0.3.0、Java 8 以降、およびタグ付けされたパブリック コントラクトを対象としています。例は client を初期化した後にパートナー バックエンドで実行されます。 クイックスタート.

前提条件の例

Java スニペットはこれらのインポートを共有します。クイック スタートを使用して client を初期化し、保存されたバインディングから platformUserId を取得します。ユーザー/オーダー ID の例は、独自の永続化された値に置き換える必要があります。

import com.sixmm.agent.*;
import com.sixmm.agent.model.*;
import java.util.*;

listCurrentPerpetualOrders

リクエストモデル: CurrentPerpetualOrdersRequest。

import com.sixmm.agent.model.CurrentPerpetualOrdersRequest;
import com.sixmm.agent.model.PerpetualResponse;
import java.util.Collections;
CurrentPerpetualOrdersRequest request = new CurrentPerpetualOrdersRequest();
request.platformUserIds = Collections.singletonList("1188041528");
request.limit = 100;
request.orderCategory = "NORMAL";
request.symbol = "BTCUSDT";
PerpetualResponse response = client.listCurrentPerpetualOrders(request);
System.out.println(response.data.items.size());
System.out.println(response.data.hasMore);
System.out.println(response.data.nextCursor);

リクエストフィールド

分野Java タイプ必須意味
orderCategoryStringはいNORMAL または CONDITIONAL;条件付きクエリには明示的なユーザーが必要です。
platformUserIdsjava.util.List<String>条件付き1 ~ 100 個の一意のパブリック ID。約定および条件付き注文に必要です。ダイレクトプレイヤースコープでサポートされているクエリを省略します。 []は無効です。
symbolStringいいえオプションの取引ペアフィルター。
limitIntegerいいえデフォルトは 500。 1 ~ 1000。
cursorStringいいえ返された nextCursor をフィルターを変更せずに使用します。 hasMore が false の場合に停止します。

この例では 1 ページを読み取ります。必須フィールド、プレーヤーのスコープ、フィルター セマンティクス、制限、カーソル、制限された再試行については、次のとおりです。 クエリの概要。ページング中はすべてのフィルターを変更しないでください。エラーを空の結果として解釈しないでください。

listPerpetualOrderHistory

リクエストモデル: PerpetualOrderHistoryRequest。

import com.sixmm.agent.model.PerpetualOrderHistoryRequest;
import com.sixmm.agent.model.PerpetualResponse;
import java.util.Collections;
PerpetualOrderHistoryRequest request = new PerpetualOrderHistoryRequest();
request.platformUserIds = Collections.singletonList("1188041528");
request.limit = 100;
request.orderCategory = "NORMAL";
request.symbol = "BTCUSDT";
request.endTime = System.currentTimeMillis();
request.startTime = request.endTime - 3_600_000L;
PerpetualResponse response = client.listPerpetualOrderHistory(request);
System.out.println(response.data.items.size());
System.out.println(response.data.hasMore);
System.out.println(response.data.nextCursor);

リクエストフィールド

分野Java タイプ必須意味
orderCategoryStringはいNORMAL または CONDITIONAL;条件付きクエリには明示的なユーザーが必要です。
platformUserIdsjava.util.List<String>条件付き1 ~ 100 個の一意のパブリック ID。約定および条件付き注文に必要です。ダイレクトプレイヤースコープでサポートされているクエリを省略します。 []は無効です。
symbolStringいいえオプションの取引ペアフィルター。
orderIdStringいいえ通常の注文ID。パートナー転送注文番号ではありません。
conditionIdStringいいえ条件付き注文 ID。 orderId と混合しないでください。
clientOrderIdStringいいえagentOrderNo ではなく、取引クライアントの注文参照。
sideStringいいえBUY / SELL フィルター。
statusStringいいえリソース固有のステータス。ステータスリファレンスを参照してください。
startTimeLongいいえUnix ミリ秒を含みます。固定の UTC 履歴ウィンドウを使用します。
endTimeLongいいえ排他的な Unix ミリ秒。
limitIntegerいいえデフォルトは 500。 1 ~ 1000。
cursorStringいいえ返された nextCursor をフィルターを変更せずに使用します。 hasMore が false の場合に停止します。

この例では 1 ページを読み取ります。必須フィールド、プレーヤーのスコープ、フィルター セマンティクス、制限、カーソル、制限された再試行については、次のとおりです。 クエリの概要。ページング中はすべてのフィルターを変更しないでください。エラーを空の結果として解釈しないでください。

通常の注文:現在と履歴

現在: orders/current + orderCategory=NORMAL;履歴: orders/history + orderCategory=NORMAL。

data フィールドタイプ意味と適用範囲
symbolstringBTCUSDT などの取引ペア
orderIdstringプラットフォーム通常注文ID
orderCategorystringNORMALを修正しました
clientOrderIdstringトランザクション注文ソースによって提供されるクライアント注文番号。販売者の資金移動 agentOrderNo と同じフィールドではありません
orderTypestringデリゲートの種類 (LIMIT、MARKET など)。実際の列挙値が優先されます
sidestring売買方向 BUY / SELL
statusstring通常の注文ステータス。クエリの概要を参照してください。
timeInForcestring有効期間/取引実行戦略。GTC、IOC、FOK など。実際の値に従って解釈される
pricestring委託価格;価格の提示がない場合は省略することができ、市場取引価格を自ら補充することはありません。
quantitystring元の注文数量
filledQuantitystring取引数量
remainingQuantitystring未取引数量。現在のクエリは数量 − filledQuantity を受け取り、履歴クエリは履歴レコードの値を受け取ります。
avgFilledPricestring完成した部品の平均取引価格。未完成だと価値がないかもしれない
reduceOnlybooleanポジションだけを減らすかどうか
closeOnlybooleanポジションを決済するためだけに使用されるかどうか
makerOnlybooleanMakerとしてのみ実行するかどうか
leverageinteger複数を活用する。 過去の通常順序にはソースがあり、現在の通常順序はこの値を作成しません。
marginModestringマージンモード。 歴史的通常順序 は現在、「1」、「2」などの数値列挙文字列を返します。現在の通常の注文は提供されません
createdAtinteger注文作成時間 (ミリ秒)。このフィールドを使用して過去の注文時間をフィルタリングします
updatedAtintegerデリゲート レコードの更新時間 (ミリ秒)

注文履歴には終了した通常注文も含まれます。インターフェイス名だけでは、各レコードが完全に完了していると見なすことはできません。現在の注文ページは現在のステータスのクエリであり、注文イベント ストリームではありません。

条件付き注文: 現在および履歴

現在: orders/current + orderCategory=CONDITIONAL;履歴: orders/history + orderCategory=CONDITIONAL。どちらも明示的な platformUserIds を必要とします。

data フィールドタイプ意味
symbolstring取引ペア
conditionIdstring通常の orderId とは独立した条件付き注文 ID
orderCategorystringCONDITIONALを修正しました
generatedOrderIdstringトリガー後に生成される通常の注文 ID。生成されない場合は省略できます
clientOrderIdstring条件付き注文のクライアント注文数。存在する場合は出力されます。
sidestringBUY / SELL
orderTypestring実際の値に従って解釈されるポストトリガー注文タイプ
triggerTypestring実際のソース列挙によって説明されるトリガー ルール タイプ
workingTypestring実際の列挙として解釈される、価格をトリガーするジョブ タイプ/価格ソース
timeInForcestringトリガー後の注文の有効期間/約定戦略
pricestringトリガー後の注文価格、ソースに価値がある場合に出力されます
quantitystring条件付き注文数量
triggerPricestringトリガー価格
reduceOnlybooleanポジションだけを減らすかどうか
closePositionboolean完全なポジションクローズセマンティクスを使用するかどうか。同じフィールドとして closeOnly と混同することはできません
leverageinteger複数のレバレッジ、ゼロ以外の場合の出力
marginModestringこのクラスは CROSS / ISOLATED を返します。これは、通常の過去の注文/ポジションとは異なる数値文字列です。
statusstring条件付き単一トリガー状態。クエリの概要を参照してください。
triggerStatusstring現在の実装では、ステータスと同じ条件付きステータス値を使用します。
createdAtinteger条件付き注文の作成時間 (ミリ秒)。履歴条件はこの時間によってフィルタリングされます
updatedAtinteger更新時間、値がある場合に出力、ミリ秒
deletedAtinteger削除マーク時間、値がある場合に出力、ミリ秒。統一されたトランザクション/キャンセル時間フィールドではありません

条件付き注文では、通常の注文の filledQuantity、remainingQuantity、avgFilledPrice は提供されません。トリガー後に通常の注文の取引ステータスが必要な場合は、generatedOrderId を通じて通常の注文/トランザクションをクエリし、条件付き注文ステータスから取引量を推測しないでください。

応答エンベロープの例

これは空のページの例であり、完了した取引のサンプルではありません。上記のリソース固有のフィールド テーブルは、設定された items[].data について説明しています。

{"code":0,"message":"success","data":{"items":[],"nextCursor":"","hasMore":false}}

ソースおよび関連ガイド