Μετάβαση στην πλοήγηση

Διαρκείς θέσεις

Διαρκείς θέσεις: Agent Java SDK Ενσωμάτωση v0.3.0, παραδείγματα, παράμετροι και σημασιολογία απόκρισης.

Προβολή ως Markdown

Αυτός ο οδηγός στοχεύει Agent Java SDK v0.3.0, Java 8+ και τη δημόσια σύμβαση με ετικέτα. Τα παραδείγματα εκτελούνται σε ένα backend συνεργάτη μετά την προετοιμασία του client στο Γρήγορη εκκίνηση.

Παράδειγμα προαπαιτούμενα

Τα αποσπάσματα Java μοιράζονται αυτές τις εισαγωγές. Αρχικοποιήστε το client χρησιμοποιώντας Γρήγορη εκκίνηση και αποκτήστε platformUserId από την αποθηκευμένη δέσμευση. Παραδείγματα αναγνωριστικών χρήστη/παραγγελιών πρέπει να αντικατασταθούν με τις δικές σας σταθερές τιμές.

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 μοναδικά δημόσια αναγνωριστικά. απαιτείται για γεμίσεις και παραγγελίες υπό όρους. Παράλειψη υποστηριζόμενων ερωτημάτων για εύρος απευθείας παίκτη. Το [] δεν είναι έγκυρο.
symbolStringΟχιΠροαιρετικό φίλτρο ζεύγους συναλλαγών.
limitIntegerΟχιΠροεπιλογή 500; 1–1000.
cursorStringΟχιΧρησιμοποιήστε το επιστρεφόμενο nextCursor με αμετάβλητα φίλτρα. σταματήστε όταν το hasMore είναι ψευδές.

Το παράδειγμα διαβάζει μια σελίδα. Για απαιτούμενα πεδία, εύρος προγράμματος αναπαραγωγής, σημασιολογία φίλτρου, όριο, δρομέα και περιορισμένες επαναλήψεις, ακολουθήστε Επισκόπηση ερωτήματος. Διατηρήστε όλα τα φίλτρα αμετάβλητα κατά τη σελιδοποίηση. μην ερμηνεύσετε ένα σφάλμα ως κενό αποτέλεσμα.

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 μοναδικά δημόσια αναγνωριστικά. απαιτείται για γεμίσεις και παραγγελίες υπό όρους. Παράλειψη υποστηριζόμενων ερωτημάτων για εύρος απευθείας παίκτη. Το [] δεν είναι έγκυρο.
symbolStringΟχιΠροαιρετικό φίλτρο ζεύγους συναλλαγών.
positionSideStringΟχιΦιλτράρετε χρησιμοποιώντας τον αριθμό θέσης πηγής.
startTimeLongΟχιΣυμπεριλαμβανόμενα χιλιοστά του δευτερολέπτου Unix. χρησιμοποιήστε ένα σταθερό παράθυρο ιστορικού UTC.
endTimeLongΟχιΑποκλειστικά Unix χιλιοστά του δευτερολέπτου.
limitIntegerΟχιΠροεπιλογή 500; 1–1000.
cursorStringΟχιΧρησιμοποιήστε το επιστρεφόμενο nextCursor με αμετάβλητα φίλτρα. σταματήστε όταν το hasMore είναι ψευδές.

Το παράδειγμα διαβάζει μια σελίδα. Για απαιτούμενα πεδία, εύρος προγράμματος αναπαραγωγής, σημασιολογία φίλτρου, όριο, δρομέα και περιορισμένες επαναλήψεις, ακολουθήστε Επισκόπηση ερωτήματος. Διατηρήστε όλα τα φίλτρα αμετάβλητα κατά τη σελιδοποίηση. μην ερμηνεύσετε ένα σφάλμα ως κενό αποτέλεσμα.

Θέσεις: Επίκαιρες και Ιστορικές

πεδίο dataτύποςΤρέχουσα θέσηΙστορικές θέσειςέννοια
positionIdstringπρομήθειαπρομήθειαΑναγνωριστικό θέσης, που αντιστοιχεί σε entityId
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) και η διεπαφή επιστρέφει απευθείας την αποθηκευμένη τιμή αναλογίας. Όταν εμφανίζετε το ποσοστό, χρησιμοποιήστε δεκαδική λειτουργία και πολλαπλασιάστε με το 100 και, στη συνέχεια, προσθέστε %. ο παρονομαστής χρησιμοποιεί το ονομαστικό περιθώριο της εγγραφής ιστορικής θέσης, όχι το υπόλοιπο του πορτοφολιού του λογαριασμού. Όταν η τιμή ανοίγματος ή η μέγιστη ποσότητα θέσης είναι 0, η μόχλευση είναι άκυρη κ.λπ. και δεν μπορεί να υπολογιστεί, η πηγή αποθηκεύεται ως 0. Επομένως, δεν μπορεί να συναχθεί ότι το κέρδος ή η ζημία είναι 0 μόνο με βάση το roe=0.

Η τρέχουσα θέση δεν έχει τιμή σήμανσης σε πραγματικό χρόνο, κυμαινόμενα κέρδη και ζημίες σε πραγματικό χρόνο, ROE σε πραγματικό χρόνο ή τιμή ρευστοποίησης σε πραγματικό χρόνο. Αντικατοπτρίζει την κατάσταση της αποθηκευμένης θέσης και δεν μπορεί να χρησιμοποιήσει τα πεδία χρόνου ενημέρωσης και περιθωρίου για να διεκδικήσει τα τρέχοντα αποτελέσματα ελέγχου κινδύνου σε πραγματικό χρόνο.

Παράδειγμα φακέλου απάντησης

Αυτή είναι μια ενδεικτική κενή σελίδα, όχι ένα δείγμα ολοκληρωμένης συναλλαγής. Οι παραπάνω πίνακες πεδίων για συγκεκριμένους πόρους περιγράφουν το συμπληρωμένο items[].data.

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

Πηγή και σχετικοί οδηγοί