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

永久取引約定

永久取引約定: 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.*;

listPerpetualTrades

リクエストモデル: PerpetualTradesRequest。

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

リクエストフィールド

分野Java タイプ必須意味
platformUserIdsjava.util.List<String>はい現在のパートナーに属する 1 ~ 100 個の一意のパブリック プラットフォーム ユーザー ID を明示的に指定します。省略および空の配列は無効です。
symbolStringいいえオプションの取引ペアフィルター。
orderIdStringいいえ通常の注文ID。パートナー転送注文番号ではありません。
startTimeLongいいえUnix ミリ秒を含みます。固定の UTC 履歴ウィンドウを使用します。
endTimeLongいいえ排他的な Unix ミリ秒。
limitIntegerいいえデフォルトは 500。 1 ~ 1000。
cursorStringいいえ返された nextCursor をフィルターを変更せずに使用します。 hasMore が false の場合に停止します。

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

取引約定の詳細

インターフェース: trades。明示的な platformUserIds が必要です。

data フィールドタイプ意味
fillIdstringこのレコード entityId に対応する取引約定詳細 ID
tradeIdstringトランザクションに関連付けられた一致するトランザクション ID。詳細 ID に代わるものではありません
orderIdstringこの詳細が属する一般注文 ID
positionIdstring関連付けられた位置ID
symbolstring取引ペア
sidestringこのプレイヤーの売買方向 BUY / SELL
roleTypestringこのプレイヤーの取引キャラクター MAKER / TAKER
positionSidestring位置の方向。実際の値 LONG / SHORT / BOTH などに従って説明されます。
pricestring今回の取引価格は
quantitystringこのトランザクションの数量は、元の注文の合計数量ではありません。
tradeValuestringこの取引の名目価値は取引の想定元本から得られます。
handlingFeestringこの取引の取引手数料は、ソースシンボルと精度を保持し、それ自体で絶対値を取得しません。
realizedPnlstringこの取引に対応する実現損益。現在のポジションのリアルタイム変動損益ではありません
tradedAtintegerトランザクション時間、ミリ秒。このフィールドを時間フィルタリングに使用します

注文には複数の約定が含まれる場合があるため、詳細に保存する必要があります。 tradeId によって異なるプレーヤー/フィルロールのレコードをマージし、レコード ID を破棄しないでください。

応答エンベロープの例

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

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

ソースおよび関連ガイド