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

永久ポジション

永久ポジション: 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.*;

listCurrentPerpetualPositions

リクエストモデル: CurrentPerpetualPositionsRequest。

import com.sixmm.agent.model.CurrentPerpetualPositionsRequest;
import com.sixmm.agent.model.PerpetualResponse;
import java.util.Collections;
CurrentPerpetualPositionsRequest request = new CurrentPerpetualPositionsRequest();
request.platformUserIds = Collections.singletonList("1188041528");
request.limit = 100;
request.symbol = "BTCUSDT";
PerpetualResponse response = client.listCurrentPerpetualPositions(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いいえオプションの取引ペアフィルター。
limitIntegerいいえデフォルトは 500。 1 ～ 1000。
cursorStringいいえ返された nextCursor をフィルターを変更せずに使用します。 hasMore が false の場合に停止します。

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

listPerpetualPositionHistory

リクエストモデル: PerpetualPositionHistoryRequest。

import com.sixmm.agent.model.PerpetualPositionHistoryRequest;
import com.sixmm.agent.model.PerpetualResponse;
import java.util.Collections;
PerpetualPositionHistoryRequest request = new PerpetualPositionHistoryRequest();
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.listPerpetualPositionHistory(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いいえオプションの取引ペアフィルター。
positionSideStringいいえソース位置側の列挙型を使用してフィルターします。
startTimeLongいいえUnix ミリ秒を含みます。固定の UTC 履歴ウィンドウを使用します。
endTimeLongいいえ排他的な Unix ミリ秒。
limitIntegerいいえデフォルトは 500。 1 ～ 1000。
cursorStringいいえ返された nextCursor をフィルターを変更せずに使用します。 hasMore が false の場合に停止します。

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

役職: 現在および過去の役職

data フィールドタイプ現在位置歴史的地位意味
positionIdstring供給供給entityId に対応する位置 ID
symbolstring供給供給取引ペア
positionSidestring供給供給LONG / SHORT / BOTH およびその他の位置方向
statusstring供給供給位置の数値ステータスを含む文字列。クエリの概要を参照してください。
leverageinteger供給供給複数を活用する
marginModestring供給供給数値列挙文字列 “1” は完全な位置、“2” は独立した位置の場合
quantitystring供給利用不可現在位置数量
entryPricestring供給供給保存されたポジションの平均始値
marginstring供給利用不可ユーザーの契約ウォレット残高全体ではなく、現在のポジション証拠金の額
maxQuantitystring利用不可供給この履歴ポジションに記録されたポジションの最大数
closeQuantitystring利用不可供給過去のポジションのライフサイクル中にクローズされたポジションの累積数
closePricestring利用不可供給保存された平均終値
pnlstring利用不可供給過去のポジション損益。単に繰り返して蓄積するためにトランザクション realizedPnl と組み合わせないでください。
roestring利用不可供給過去のポジションリターンの比例値（100 倍ではない）。たとえば、"0.043" は 4.3% を表し、"-0.05" は -5% を表します
fundingFeeAccumstring供給供給累積資金調達手数料、ソースシンボルと精度の保持
openedAtinteger供給供給ポジションオープン時間、ミリ秒
updatedAtinteger供給利用不可現在位置更新時間、ミリ秒
closedAtinteger利用不可供給終了時間、ミリ秒。このフィールドを使用して履歴位置時間をフィルタリングします

履歴 roe の計算口径は pnl / (entryPrice × maxQuantity / leverage) であり、インターフェイスは保存された比率値を直接返します。パーセンテージを表示する場合は、10 進数演算を使用して 100 を掛け、% を加算します。分母には​​口座ウォレット残高ではなく、履歴ポジション記録の名目証拠金が使用されます。始値や最大ポジション数量が0、レバレッジが無効などで計算できない場合、ソースは0として保存されます。そのため、roe=0だけから損益が0であると推測することはできません。

現在のポジションには、リアルタイムのマーク価格、リアルタイムの変動損益、リアルタイム ROE、またはリアルタイムの清算価格がありません。これは保存されたポジションのステータスを反映しており、更新時間フィールドと証拠金フィールドを使用して現在のリアルタイムのリスク管理結果を主張することはできません。

応答エンベロープの例

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

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

ソースおよび関連ガイド