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

Καθολικό Συμβάσεων

Καθολικό Συμβάσεων: 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.*;

listPerpetualLedger

Αίτημα μοντέλου: PerpetualLedgerRequest.

import com.sixmm.agent.model.PerpetualLedgerRequest;
import com.sixmm.agent.model.PerpetualResponse;
import java.util.Collections;
PerpetualLedgerRequest request = new PerpetualLedgerRequest();
request.platformUserIds = Collections.singletonList("1188041528");
request.limit = 100;
request.endTime = System.currentTimeMillis();
request.startTime = request.endTime - 3_600_000L;
PerpetualResponse response = client.listPerpetualLedger(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 μοναδικά δημόσια αναγνωριστικά. απαιτείται για γεμίσεις και παραγγελίες υπό όρους. Παράλειψη υποστηριζόμενων ερωτημάτων για εύρος απευθείας παίκτη. Το [] δεν είναι έγκυρο.
assetTypeStringΟχιΤαξινόμηση περιουσιακών στοιχείων όπως επιστρέφεται από το καθολικό. μην υποθέσετε USDT.
changeTypeStringΟχιLedger τύπος αλλαγής επιχείρησης, διατηρώντας τις τιμές πηγής.
startTimeLongΟχιΣυμπεριλαμβανόμενα χιλιοστά του δευτερολέπτου Unix. χρησιμοποιήστε ένα σταθερό παράθυρο ιστορικού UTC.
endTimeLongΟχιΑποκλειστικά Unix χιλιοστά του δευτερολέπτου.
limitIntegerΟχιΠροεπιλογή 500; 1–1000.
cursorStringΟχιΧρησιμοποιήστε το επιστρεφόμενο nextCursor με αμετάβλητα φίλτρα. σταματήστε όταν το hasMore είναι ψευδές.

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

Αρχεία λογιστικού συμβολαίου

Διεπαφή: account/ledger. Τα επιστρεφόμενα δεδομένα περιέχουν μόνο τα ακόλουθα 11 επιχειρηματικά πεδία και δεν φέρουν τις δυαδικές σημαίες παραγγελίας.

πεδίο dataτύποςέννοια
ledgerIdstringΤο βιβλίο προέλευσης καταγράφει στο αναγνωριστικό συναλλαγής. η ίδια συναλλαγή μπορεί να χωριστεί σε πολλές λεπτομέρειες
symbolstringΣχετικό ζεύγος συναλλαγών, μπορεί να παραλειφθεί εάν δεν σχετίζεται
assetTypestringΤύπος στοιχείου, αποθηκευμένο με βάση την τιμή πηγής. χρησιμοποιείται για την ταξινόμηση περιουσιακών στοιχείων, δεν συνάγεται από προεπιλογή USDT
changeTypestringΑλλαγή λογαριασμού τύπου επιχείρησης, αποθηκευμένη σύμφωνα με την αξία πηγής, όπως αμοιβή χειρισμού, κέρδη και ζημίες, μεταφορά. μπορεί να φιλτραριστεί από το ίδιο πεδίο
amountstringΤο ποσό αλλαγής αυτής της λεπτομέρειας, ένας θετικός αριθμός υποδηλώνει αύξηση, ένας αρνητικός αριθμός υποδηλώνει μείωση. η ακρίβεια διατηρείται
walletBalanceBeforestringΤο υπόλοιπο του πορτοφολιού πριν από την αλλαγή λογαριασμού καταγράφεται με αυτήν τη λεπτομέρεια
walletBalanceAfterstringΤο υπόλοιπο του πορτοφολιού μετά την αλλαγή λογαριασμού καταγράφεται με αυτήν τη λεπτομέρεια
frozenBalanceBeforestringΤο δεσμευμένο υπόλοιπο που καταγράφηκε πριν από την αλλαγή λογαριασμού καταγράφεται με αυτή τη λεπτομέρεια
frozenBalanceAfterstringΤο δεσμευμένο υπόλοιπο καταγράφηκε με αυτή τη λεπτομέρεια μετά την αλλαγή λογαριασμού
referenceIdstringΣχετικός αριθμός επιχείρησης. ερμηνεύεται ως changeType και δεν μπορεί να θεωρηθεί ομοιόμορφα ως τάξη orderId. Το “0” υποδηλώνει ότι η πηγή δεν έχει έγκυρο συσχετισμένο αριθμό
createdAtintegerΧρόνος δημιουργίας στοιχείων αλλαγής λογαριασμού, χιλιοστά του δευτερολέπτου. αυτό το πεδίο χρησιμοποιείται για φιλτράρισμα χρόνου σε αυτήν τη διεπαφή

Χρησιμοποιήστε το υπόλοιπο πριν και μετά την αλλαγή λογαριασμού που επιστρέφεται από τη διεπαφή. Διαφορετικά changeType έχουν διαφορετική σημασιολογία και δεν μπορεί να θεωρηθεί ότι κάθε ποσό είναι ίσο με walletBalanceAfter − walletBalanceBefore. Η εμφάνιση/περίληψη των εγγραφών του καθολικού πρέπει να διατηρεί τον τύπο και την ταυτότητα των λεπτομερειών.

Ακολουθεί ένα παράδειγμα της μορφής, χρησιμοποιώντας ένα εικονικό αναγνωριστικό και ένα ποσό:

{
  "code": 0,
  "message": "success",
  "data": {
    "items": [
      {
        "platformUserId": "1188041528",
        "entityType": "ACCOUNT_LEDGER",
        "entityId": "900001",
        "data": {
          "ledgerId": "ledger-example-001",
          "symbol": "BTCUSDT",
          "assetType": "USDT",
          "changeType": "HANDLING_FEE",
          "amount": "-0.10000000",
          "walletBalanceBefore": "100.00000000",
          "walletBalanceAfter": "99.90000000",
          "frozenBalanceBefore": "0.00000000",
          "frozenBalanceAfter": "0.00000000",
          "referenceId": "800001",
          "createdAt": 1791590400000
        }
      }
    ],
    "nextCursor": "",
    "hasMore": false
  }
}

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

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

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

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