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

Perpetual Trade Fills

Perpetual Trade Fills: 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.*;

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

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

Στοιχεία πλήρωσης συναλλαγών

Διεπαφή: trades. Απαιτεί ρητή platformUserIds.

πεδίο dataτύποςέννοια
fillIdstringΑναγνωριστικό στοιχείων συμπλήρωσης συναλλαγών, που αντιστοιχεί σε αυτήν την εγγραφή entityId
tradeIdstringΤο αντίστοιχο αναγνωριστικό συναλλαγής που σχετίζεται με τη συναλλαγή. δεν αντικαθιστά το αναλυτικό αναγνωριστικό
orderIdstringΤο γενικό αναγνωριστικό παραγγελίας στο οποίο ανήκει αυτό το στοιχείο
positionIdstringΑναγνωριστικό σχετιζόμενης θέσης
symbolstringζεύγος συναλλαγών
sidestringΚατεύθυνση αγοράς και πώλησης αυτού του παίκτη BUY / SELL
roleTypestringΟ χαρακτήρας συναλλαγής αυτού του παίκτη MAKER / TAKER
positionSidestringΚατεύθυνση θέσης, επεξηγημένη σύμφωνα με την πραγματική τιμή LONG / SHORT / BOTH κ.λπ.
pricestringΑυτή η τιμή συναλλαγής
quantitystringΗ ποσότητα αυτής της συναλλαγής δεν είναι η συνολική ποσότητα της αρχικής παραγγελίας.
tradeValuestringΗ ονομαστική αξία αυτής της συναλλαγής προέρχεται από την πλασματική συναλλαγή
handlingFeestringΗ χρέωση συναλλαγής για αυτήν τη συναλλαγή διατηρεί το σύμβολο πηγής και την ακρίβεια και δεν παίρνει την απόλυτη τιμή από μόνη της.
realizedPnlstringΤα πραγματοποιηθέντα κέρδη και ζημίες που αντιστοιχούν σε αυτή τη συναλλαγή. όχι τα κυμαινόμενα κέρδη και ζημίες σε πραγματικό χρόνο της τρέχουσας θέσης
tradedAtintegerΧρόνος συναλλαγής, χιλιοστά του δευτερολέπτου. χρησιμοποιήστε αυτό το πεδίο για φιλτράρισμα χρόνου

Μια παραγγελία μπορεί να έχει πολλαπλά συμπληρώματα, τα οποία θα πρέπει να αποθηκευτούν λεπτομερώς. Μην συγχωνεύετε εγγραφές διαφορετικών παικτών/συμπληρώστε ρόλους κατά tradeId και, στη συνέχεια, απορρίψτε τις ταυτότητες των αρχείων τους.

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

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

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

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