Smart Money API
Μια επαγγελματική API ευφυΐας που συγκεντρώνει δεδομένα παραγώγων, μετρήσεις αλυσίδας και δραστηριότητα πορτοφολιών φαλαινών σε ένα ενιαίο σκορ εμπιστοσύνης για το trading bot σας.
https://api.smartmoneyapi.com/v1Αρχές σχεδιασμού
Τέσσερις ιδέες διαμορφώνουν κάθε σημείο τερματισμού και κάθε σκορ που επιστρέφει αυτή η API. Είναι επίσης οι ειλικρινείς όρια του τι υπόσχεται — και τι όχι.
Πρώτα στρατηγική, όχι πρώτα σήμα. Αυτό δεν είναι μια ροή σημάτων αγοράς/πώλησης. Φέρνετε τη στρατηγική και την είσοδο· η API σας λέει αν η γύρω δομή της αγοράς — θέση παραγώγων, χρηματοδότηση, ανοιχτό ενδιαφέρον, ρευστοποιήσεις, ροή αλυσίδας και συναίνεση φαλαινών — συμφωνεί με την συναλλαγή που ήδη θέλετε να κάνετε.
Σκορ εμπιστοσύνης, όχι δυαδική πρόβλεψη. Κάθε απάντηση φέρει ένα βαθμολογημένο confidence (ΥΨΗΛΟ / ΜΕΣΑΙΟ / ΧΑΜΗΛΟ) και ένα composite από -1.0 έως +1.0. Δεν υπάρχουν εγγυήσεις και δεν υπάρχουν κλήσεις μαντείου — παίρνετε μια βαθμονομημένη ανάγνωση συμφωνίας, με τους λόγους πίσω από αυτή, ώστε να μπορείτε να προσαρμόσετε το μέγεθος ανάλογα με την πεποίθηση.
Υποστήριξη απόφασης, όχι συμβουλή εκτέλεσης. Η API επιστρέφει μια σύσταση CONFIRM / REDUCE / SKIP και έναν πολλαπλασιαστή μεγέθους για τη λογική σας να ενεργήσει. Δεν τοποθετεί ποτέ εντολές και τίποτα εδώ δεν είναι οικονομική συμβουλή. Εσείς παραμένετε υπεύθυνοι για τον κίνδυνο, το μέγεθος και την εκτέλεση.
Ζωντανές μετρήσεις, όχι σταθερές εγγυήσεις. Ποσοστά νίκης, στατιστικά καθεστώτος και αριθμοί ακρίβειας υπολογίζονται από ένα κινούμενο δείγμα και μετακινούνται καθώς κινούνται οι αγορές. Τα δημοσιεύουμε ειλικρινά, συμπεριλαμβανομένων όταν είναι μέτρια. Θεωρήστε κάθε μετρικό ως μια τρέχουσα παρατήρηση, όχι μια υπόσχεση για το μέλλον.
Για ποιον είναι αυτή η API
Αυτή η API είναι φτιαγμένη για προγραμματιστές crypto bot, algo και AI-agent που ήδη έχουν ένα σήμα αγοράς/πώλησης — από μια TA στρατηγική, ένα ML μοντέλο, μια αγωγό Freqtrade, μια ειδοποίηση TradingView ή έναν πράκτορα LLM — και θέλουν μια γρήγορη, προ-συναλλαγής CONFIRM / REDUCE / SKIP απόφαση πριν δεσμεύσουν κεφάλαιο.
Ένας τυπικός βρόχος: η στρατηγική σας εκπέμπει "go long BTC" → καλείτε GET /v1/confirm?symbol=BTC&direction=long → επιβεβαιώνετε, μειώνετε ή παραλείπετε την είσοδο και κλιμακώνετε το μέγεθος κατά size_mult. Μία κλήση, μία απάντηση JSON χαμηλής καθυστέρησης, χωρίς επιπλέον υποδομή.
Είναι όχι ένας αυτόνομος γεννήτριας σημάτων, ένα προϊόν γραφημάτων ή ένας χώρος εκτέλεσης. Αν δεν έχετε δικό σας σήμα για φιλτράρισμα, ξεκινήστε με τη σελίδα απόδοσης για να δείτε πώς έχει συμπεριφερθεί το σκορ πριν το συνδέσετε σε ένα ζωντανό bot.
Λήψη πρόσβασης
1 — Εγγραφείτε. Δημιουργήστε έναν δωρεάν λογαριασμό στο signup (email/κωδικός ή Google). Δεν απαιτείται πιστωτική κάρτα για το δωρεάν επίπεδο.
2 — Ανοίξτε τον πίνακα ελέγχου σας. Ο πίνακας ελέγχου σας δείχνει το κλειδί API, το τρέχον σχέδιο και τη ζωντανή χρήση έναντι του ημερήσιου ορίου σας.
3 — Αντιγράψτε το κλειδί API σας. Τα κλειδιά έχουν πρόθεμα sm_. Περάστε το ως την X-API-Key κεφαλίδα σε κάθε αίτηση (δείτε Πιστοποίηση). Αναβαθμίστε ανά πάσα στιγμή στον σελίδα τιμολόγησης για να αυξήσετε τα όρια και να ξεκλειδώσετε περισσότερα σύμβολα και τελικά σημεία.
Spec, SDK & Βιβλίο Μαγειρικής
Όλα όσα χρειάζεστε για να ενσωματώσετε γρήγορα, είτε γράφετε τον κώδικα μόνοι σας είτε τον αναθέσετε σε έναν πράκτορα κωδικοποίησης.
| Πόρος | Τι είναι |
|---|---|
| Βιβλίο Μαγειρικής | Αντιγραφή-επικόλληση συνταγών για τις πιο κοινές ενσωματώσεις — επιβεβαίωση πριν από την είσοδο, πύλη για ένα σήμα Freqtrade, μέγεθος με πολλαπλασιαστή, διαχείριση 402/429 και σύνδεση με έναν πράκτορα κωδικοποίησης. |
| OpenAPI spec | Μηχανικά αναγνώσιμος ορισμός OpenAPI κάθε τελικού σημείου. Εισαγωγή στο Postman/Insomnia, δημιουργία πελατών ή τροφοδοσία σε ένα LLM. Στο github.com/tashiardit/smartmoneyapi-docs. |
| Πελάτης Python | Επίσημη βιβλιοθήκη πελάτη Python στο github.com/tashiardit/smartmoneyapi-python. |
| /llms.txt | Μια σύνοψη API σε απλό κείμενο φιλική προς τα LLM. Στοχεύστε το Claude, Codex ή Cursor σε αυτό (δείτε Πράκτορες Κωδικοποίησης). |
Γρήγορη εκκίνηση σε 2 λεπτά
Βήμα 1 — Βασική διεύθυνση URL. Κάθε τελικό σημείο βρίσκεται κάτω από:
Βήμα 2 — Λάβετε το κλειδί API σας. Εγγραφείτε δωρεάν (χωρίς απαίτηση πιστωτικής κάρτας) και αντιγράψτε το κλειδί σας από τον πίνακα ελέγχου. Περάστε το ως το X-API-Key κεφαλίδα σε κάθε αίτηση.
Βήμα 3 — Η πρώτη σας κλήση. Επικολλήστε αυτό στο τερματικό σας και αντικαταστήστε sm_your_key με το κλειδί από τον πίνακα ελέγχου σας:
Αναμενόμενη απάντηση:
"ts": 1710940821,
"symbol": "BTC",
"direction": "long",
"composite": 0.74,
"confidence": "HIGH",
"action": "CONFIRM",
"size_mult": 1.5,
"deriv_score": 0.81,
"onchain_score": 0.68,
"whale_score": 0.73,
"reasons": ["Το ποσοστό χρηματοδότησης είναι θετικό σε όλες τις πλατφόρμες", "Φάλαινες: 67% μακροπρόθεσμη συναίνεση"]
}
Όταν confidence είναι HIGH ή MEDIUM και action είναι CONFIRM, κλιμακώστε το μέγεθος της θέσης σας κατά size_mult. Αυτή είναι ολόκληρη η διαδικασία ενσωμάτωσης. Δείτε Πεδία Απάντησης για την πλήρη αναφορά πεδίων.
Πιστοποίηση
Όλες οι αιτήσεις απαιτούν ένα κλειδί API που περνάει ως η X-API-Key κεφαλίδα HTTP.
Το κλειδί API σας είναι διαθέσιμο από τον πίνακα ελέγχου μετά την εγγραφή. Κρατήστε το κλειδί σας μυστικό — μην το εκθέτετε σε κώδικα πελάτη ή δημόσια αποθετήρια.
/v1/ws/ticket με την X-API-Key κεφαλίδα, στη συνέχεια συνδεθείτε με το επιστραφέν εισιτήριο. Δείτε Πιστοποίηση WebSocket (εισιτήρια).Σύνδεση Google (Firebase Auth)
Οι χρήστες μπορούν να πιστοποιηθούν χρησιμοποιώντας τον λογαριασμό Google τους μέσω της Firebase Authentication. Μετά από μια επιτυχημένη σύνδεση Google στον πελάτη, ανταλλάξτε το αναγνωριστικό Firebase για μια συνδεδεμένη συνεδρία API. Το σύστημα συγχρονίζει αυτόματα την ταυτότητά σας Google με το σύστημα κλειδιών API.
Σώμα Αίτησης
| Πεδίο | Τύπος | Περιγραφή |
|---|---|---|
| id_tokenαπαιτείται | συμβολοσειρά | Αναγνωριστικό Firebase που λαμβάνεται μετά τη σύνδεση Google στον πελάτη |
Παράδειγμα Απάντησης
"api_key": "sm_your_linked_key",
"uid": "firebase_uid_abc123",
"email": "[email protected]",
"plan": "trader",
"synced": true
}
Όρια Ρυθμού
| Πρόγραμμα | Κλήσεις/Ημέρα | Όριο Έκρηξης | Καθυστέρηση Δεδομένων |
|---|---|---|---|
| Δωρεάν | 50 | 2/λεπτό | 60 δευτερόλεπτα |
| Συναλλαγματικός | 1,000 | 20/λεπτό | Πραγματικός χρόνος |
| Pro | 5,000 | 60/λεπτό | Σε πραγματικό χρόνο |
| Enterprise | 100,000 | 400/λεπτό | Σε πραγματικό χρόνο |
Τα όρια ρυθμού περιλαμβάνονται σε κάθε απάντηση: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.
Βασική URL
Όλα τα σημεία τέλους που ακολουθούν είναι σχετικά με αυτή τη βασική URL. Όλες οι απαντήσεις είναι JSON με Content-Type: application/json.
Σφάλματα
Τα σφάλματα χρησιμοποιούν τυπικούς κωδικούς κατάστασης HTTP και ένα συνεπές σώμα JSON. Πάντα να κάνετε διακλάδωση βάσει του κωδικού κατάστασης, όχι του κειμένου απάντησης. Τα τρία που θα συναντήσετε πιο συχνά:
| Κατάσταση | Κωδικός | Σημασία & τι να κάνετε |
|---|---|---|
| 401 | unauthorized | Λείπει ή είναι άκυρο το κλειδί API. Ελέγξτε ότι η X-API-Key κεφαλίδα είναι παρόντα και σωστή. |
| 402 | payment_required | Το σημείο τέλους ή το σύμβολο απαιτεί υψηλότερο πλάνο από αυτό που έχει το κλειδί σας (π.χ. δωρεάν κλειδί που καλεί το WebSocket firehose). Αναβάθμιση ή επιστροφή σε δημόσιο σημείο τέλους. |
| 429 | rate_limit_exceeded | Έχετε φτάσει το ημερήσιο όριο ή το όριο έκρηξης. Ελαφρύτερα και δοκιμάστε ξανά μετά X-RateLimit-Reset; μην επιμένει. |
Κάθε σφάλμα επιστρέφει την ίδια δομή:
"error": "rate_limit_exceeded",
"message": "Έχετε φτάσει το ημερήσιο όριο των 50 κλήσεων. Επαναφέρεται στις 00:00 UTC.",
"status": 429
}
Για την πλήρη λίστα των κωδικών κατάστασης (400 / 403 / 500 / 503 και άλλα), δείτε Κωδικοί Σφαλμάτων. Μια ανθεκτική ενσωμάτωση θεωρεί τα 5xx και 429 ως προσωρινά (επανάληψη με ελαφρύτερα) και τα 401/402/403 ως οριστικά (διορθώστε το κλειδί ή το πλάνο).
Βέλτιστες πρακτικές ασφαλείας
Στείλτε το κλειδί στην κεφαλίδα, ποτέ στην URL. Πάντα να περνάτε X-API-Key ως κεφαλίδα HTTP. Τα κλειδιά σε συμβολοσειρές ερωτημάτων (?key=) καταγράφονται από διαμεσολαβητές, ισοστάτες φόρτου και ιστορικό προγραμμάτων περιήγησης — η παλαιά ?key= auth δεν γίνεται πλέον αποδεκτή στα σημεία τέλους WebSocket για αυτόν ακριβώς το λόγο.
Κρατήστε τα κλειδιά από την πλευρά του διακομιστή. Ποτέ μην ενσωματώνετε ένα κλειδί API σε JavaScript από την πλευρά του πελάτη, σε ένα πακέτο εφαρμογής για κινητά ή σε δημόσιο αποθετήριο. Φορτώστε το από μια μεταβλητή περιβάλλοντος ή από ένα διαχειριστή μυστικών. Αν ένα κλειδί διαρρεύσει, αλλάξτε το.
Περιστροφή κλειδιών περιοδικά. Αναδημιουργήστε το κλειδί σας από τον πίνακα ελέγχου σύμφωνα με ένα πρόγραμμα και αμέσως αν υποψιάζεστε έκθεση. Το παλιό κλειδί σταματά να λειτουργεί τη στιγμή που εκδίδεται ένα νέο.
Χρησιμοποιήστε εισιτήρια για sockets προγραμμάτων περιήγησης. Για ροές σε πραγματικό χρόνο από το πρόγραμμα περιήγησης, ανταλλάξτε το κλειδί σας με ένα εισιτήριο μίας χρήσης αντί να συνδεθείτε με το ακατέργαστο κλειδί — δείτε Εξουσιοδότηση WebSocket (εισιτήρια).
Χρήση με πράκτορες κωδικοποίησης / LLMs
Χτίζετε με Claude Code, Codex, Cursor ή οποιονδήποτε πράκτορα κωδικοποίησης LLM; Μπορείτε να δώσετε στον πράκτορα όλα όσα χρειάζεται για να συνδέσει σωστά αυτό το API με μια κίνηση. Δύο μηχανικά αναγνώσιμες αναφορές δημοσιεύονται:
| Πόρος | URL |
|---|---|
| Σύνοψη LLM | https://smartmoneyapi.com/llms.txt |
| Προδιαγραφή OpenAPI | github.com/tashiardit/smartmoneyapi-docs |
Στρέψτε τον πράκτορά σας στο /llms.txt αρχείο (η συμβατική llms.txt) για μια συνοπτική επισκόπηση, στη συνέχεια στην προδιαγραφή OpenAPI για ακριβείς μορφές αιτήματος/απάντησης. Μια γραμμή εντολής που λειτουργεί καλά:
Διαβάστε https://smartmoneyapi.com/llms.txt και την προδιαγραφή OpenAPI στο
github.com/tashiardit/smartmoneyapi-docs, στη συνέχεια προσθέστε έναν έλεγχο πριν από τη συναλλαγή
στο bot μου που καλεί GET /v1/confirm και παρακάμπτει εισόδους
εκτός εάν η ενέργεια είναι CONFIRM.
Δείτε το Βιβλίο Μαγειρικής για μια συνταγή που έχει εργαστεί με πράκτορα κωδικοποίησης.
Σημεία Τέλους
GET /confirm
Το βασικό σημείο τέλους. Επιστρέφει ένα σύνθετο σκορ εμπιστοσύνης και μια σύσταση ενέργειας για μια δεδομένη κατεύθυνση συναλλαγής. Καλέστε το πριν από την είσοδο σε οποιαδήποτε θέση.
Κάλυψη, με απλούς όρους. /confirm σκοράρει επί του παρόντος BTC, ETH και SOL — τα σύμβολα με αρκετή ιστορία που έχει επιλυθεί για ειλικρινή επιβεβαίωση. Ο έλεγχος παραγώγων ξεχωριστά παρακολουθεί ~519 αγορές παραγώγων για χρηματοδότηση, OI και δεδομένα εκκαθάρισης, και η παρακολούθηση φαλαινών καλύπτει 600+ πορτοφόλια. Το Pro ξεκλειδώνει τον πλήρη έλεγχο, εξαγωγές και ευρύτερη κάλυψη αγοράς· /confirm η υποστήριξη συμβόλων επεκτείνεται καθώς κάθε αγορά συσσωρεύει μια αξιόπιστη ιστορικό.
Παράμετροι
| Παράμετρος | Τύπος | Περιγραφή |
|---|---|---|
| symbolαπαιτείται | string | Σύμβολο περιουσιακού στοιχείου. Ένα από: BTC, ETH, SOL (Trader+) |
| directionαπαιτείται | string | Κατεύθυνση συναλλαγής: long or short |
| sourceπροαιρετικό | string | Ετικέτα για την πηγή του σήματός σας (καταγράφεται για αναλυτικά). Μέγιστο 32 χαρακτήρες. |
Παράδειγμα Αίτησης
"https://api.smartmoneyapi.com/v1/confirm?symbol=BTC&direction=long"
Παράδειγμα Απάντησης
"ts": 1710940821,
"symbol": "BTC",
"direction": "long",
"composite": 0.74,
"confidence": "HIGH",
"action": "CONFIRM_FULL",
"size_mult": 1.5,
deriv_score: 0.81,
onchain_score: 0.68,
whale_score: 0.73,
x_score: 0.0,
παράγοντες: {
παράγωγα: { βαθμολογία: 0.81, βάρος: 0.40, σταθμισμένο: 0.324 },
onchain: { βαθμολογία: 0.68, βάρος: 0.35, σταθμισμένο: 0.238, πηγή: coinmetrics, διαθέσιμο: True },
whale: { βαθμολογία: 0.73, βάρος: 0.25, παράγοντας αχρηστίας: 1.0, σταθμισμένο: 0.183 }
},
προσαρμογές: { συμφωνία: 0.0, τάση: 0.0, news_macro: 0.0 },
βάρη: { παράγωγα: 0.40, onchain: 0.35, whale_intel: 0.25 },
κάλυψη: { παράγωγα: True, whale: True, onchain: True },
αιτίες: [
Θετικό ποσοστό χρηματοδότησης σε όλες τις πλατφόρμες,
LSR ευνοεί τα long: 1.42,
Whales: 67% long consensus,
MVRV πάνω από 1.0 — on-chain bullish
]
}
Διαφανές από σχεδίαση. Κάθε απάντηση περιλαμβάνει ένα factors αντικείμενο που δείχνει το score × weight = σταθμισμένη συνεισφορά, ένα adjustments αντικείμενο για μεταγενέστερες ρυθμίσεις, τα weights που χρησιμοποιήθηκαν, και ένα coverage χάρτη. Το on-chain τμήμα χρησιμοποιεί πραγματικά δωρεάν δεδομένα Coin Metrics (MVRV / exchange-flow / active-address) όταν δεν έχει οριστεί κλειδί Glassnode. Αυτό είναι ένας πολυπαραγοντικός συνδυασμός βαθμολογίας — υποστήριξη αποφάσεων, όχι εγγυημένο ποσοστό νίκης.
Τα μη παρακολουθούμενα σύμβολα είναι ειλικρινή. Ένα σύμβολο εκτός του παρακολουθούμενου σύμπαντος παραγώγων/whale επιστρέφει ένα σαφές "confidence":"NO_DATA" / "action":"NO_DATA_SKIP" με "unsupported":true — ποτέ μια κατασκευασμένη LOW.
Πεδία Απάντησης
| Πεδίο | Τύπος | Περιγραφή |
|---|---|---|
| ts | ακέραιος | Χρονική σήμανση Unix του υπολογισμού |
| symbol | συμβολοσειρά | Σύμβολο περιουσιακού στοιχείου (BTC/ETH/SOL) |
| direction | συμβολοσειρά | Ζητούμενη κατεύθυνση (long/short) |
| composite | float | Σύνθετη βαθμολογία σύμπτωσης από -1.0 (ακραία αντίθετη) έως +1.0 (ισχυρή επιβεβαίωση). Δεν είναι ποσοστό νίκης. |
| base_composite | float | Σύνθετη βαθμολογία πριν εφαρμοστούν οι μεταγενέστερες προσαρμογές |
| confidence | συμβολοσειρά | HIGH / MEDIUM / LOW / VETO / NO_DATA |
| action | συμβολοσειρά | CONFIRM_FULL / CONFIRM_REDUCED / CONFIRM_MINIMAL / VETO_SKIP / NO_DATA_SKIP |
| size_mult | float | Προτεινόμενος πολλαπλασιαστής μεγέθους θέσης (π.χ. 0.0 – 1.5) |
| unsupported | bool | true όταν το σύμβολο είναι εκτός κάλυψης (σε συνδυασμό με NO_DATA) |
| deriv_score | float | Υπο-βαθμολογία παραγώγων (-1 έως 1) |
| onchain_score | float | Υπο-βαθμολογία on-chain (-1 έως 1) |
| whale_score | float | Υπο-βαθμολογία συναίνεσης whale (-1 έως 1) |
| x_score | float | Υπο-βαθμολογία X/social-sentiment (-1 έως 1); 0 όταν δεν χρησιμοποιείται |
| factors | αντικείμενο | Ανάλυση ανά τμήμα: score × weight = weighted για παράγωγα / onchain / whale / x_sentiment (το onchain περιλαμβάνει source) |
| adjustments | αντικείμενο | Επισημασμένες μεταγενέστερες προσαρμογές (συμφωνία, τάση, rsi_1h, news_macro, ορμή, time_of_day, streak_decay) |
| weights | αντικείμενο | Το σύνολο βαρών που χρησιμοποιήθηκε για αυτήν την αξιολόγηση |
| coverage | αντικείμενο | {derivatives, whale, onchain} — ποια τμήματα είχαν πραγματικά δεδομένα |
| reasons | πίνακας | Ανθρώπινης κατανόησης συμβολοσειρές εξήγησης για τη βαθμολογία |
GET /snapshot
Επιστρέφει ένα πλήρες στιγμιότυπο αγοράς που περιλαμβάνει όλες τις υπο-βαθμολογίες, ακατέργαστες μετρήσεις και τιμές δεικτών για ένα δεδομένο σύμβολο. Χρήσιμο για πίνακες ελέγχου και καταγραφή.
GET /onchain
Επιστρέφει ακατέργαστα δεδομένα από την αλυσίδα: MVRV, SOPR, ροή ανταλλαγών, αναλογία πραγματοποιημένης κεφαλαιοποίησης και ταξινόμηση θέσης κύκλου.
GET /v1/derivatives/*
Συγκριτικός οθόνη παραγώγων σε πολλαπλές ανταλλαγές για πάνω από 500 σύμβολα: χάρτης θερμότητας επιτοκίου χρηματοδότησης, κατάταξη ανοιχτού ενδιαφέροντος και ανίχνευση σημάτων αναλογίας μακράς/σύντομης θέσης. Οι πρώτες 10 σειρές είναι δημόσιες· η πλήρης οθόνη απαιτεί Trader ή Pro. Σημεία τερματισμού: /v1/derivatives/screener, /v1/derivatives/funding, /v1/derivatives/oi, /v1/derivatives/signals.
GET /v1/options/*
Αναλυτικά δεδομένα για επιλογές BTC & ETH από την Deribit (δημόσια, χωρίς πιστοποίηση): αναλογία put/call, μέγιστη οδύνη και ανοιχτό ενδιαφέρον ανά strike. Σημεία τερματισμού: /v1/options/summary, /v1/options/pcr, /v1/options/oi.
GET /v1/etf/*
Καθημερινές καθαρές ροές και ανάλυση ανά ταμείο για ETFs BTC & ETH (δημόσια). Σημεία τερματισμού: /v1/etf/flows, /v1/etf/funds.
GET /v1/historical/*
Ιστορικά δεδομένα χρηματοδότησης, ανοιχτού ενδιαφέροντος, αναλογίας μακράς/σύντομης θέσης (Binance) και OHLCV (CoinGecko) για backtesting. Σημεία τερματισμού: /v1/historical/funding, /v1/historical/oi, /v1/historical/lsr, /v1/historical/ohlcv.
GET /v1/dex/*
Τα ζεύγη που τρέχουν, αναζήτηση token και λεπτομέρειες ζεύγους με την ισχύ του DexScreener (δημόσια, χωρίς πιστοποίηση). Σημεία τερματισμού: /v1/dex/trending, /v1/dex/search, /v1/dex/token, /v1/dex/pair.
GET /v1/news/*
Ευφυΐα ειδήσεων: ειδήσεις πολιτικής/γεωπολιτικής/κρυπτονομισμάτων ταξινομημένες σε κατηγορίες επίδρασης, συν τον δείκτη Φόβου & Απληστίας (δημόσια, χωρίς πιστοποίηση). Σημεία τερματισμού: /v1/news/trump, /v1/news/general, /v1/news/impact, /v1/news/fear-greed.
GET /whales
Επιστρέφει δεδομένα συναίνεσης πορτοφολιών φαλαινών: διαχωρισμός μακράς/σύντομης θέσης, συνολική ονομαστική έκθεση, κορυφαίες 10 θέσεις (μόνο Pro) και αριθμός πορτοφολιών.
GET /signals
Επιστρέφει μια ροή των πιο πρόσφατων σημάτων HIGH/MEDIUM σε όλα τα παρακολουθούμενα περιουσιακά στοιχεία. Χρήσιμο για σάρωση ευκαιριών.
GET /v1/strategies/*
Διαφανές, μόνο για ανάγνωση ιστορικό για τις αυτοματοποιημένες στρατηγικές συναλλαγών που εκτελούνται πάνω από τα σήματα Smart Money — συμπεριλαμβανομένης της deriv40 SmartMoney Copytrade strategy (account=9). Όλα τα σημεία τερματισμού λαμβάνουν μια ?account=<id> παράμετρο ερωτήματος και επιστρέφουν JSON. Δεν απαιτείται πιστοποίηση (δημόσιο ιστορικό).
Σημεία τερματισμού
GET /v1/strategies/stats?account=9— βασικά μεγέθη:total_trades,win_rate,profit_factor,total_pnl_usdt,account_growth_percent,initial_equity,current_equity,max_drawdown_portfolio,max_drawdown_trade.GET /v1/strategies/equity?account=9— καμπύλη ισότητας για γραφική παράσταση:{ initial_equity, curve: [{ time, equity }] }.GET /v1/strategies/trades?account=9&limit=500— αρχείο κλειστών συναλλαγών: πίνακας (ή{trades:[…]}) απόsymbol,direction,entry_price,exit_price,pnl_usdt,pnl_percent,pnl_percent_net.GET /v1/strategies/active?account=9— τρέχουσες ανοιχτές θέσεις: πίνακας (ή{positions:[…]}) απόsymbol,side/direction,entry_price,unrealized_pnl.GET /v1/strategies/signals— ανάλυση τύπου σήματος που τροφοδοτεί τις στρατηγικές (αριθμός / νίκες / ποσοστό νίκης / μέσο pnl ανά τύπο σήματος).
Η προηγούμενη απόδοση δεν είναι ενδεικτική μελλοντικών αποτελεσμάτων. Τα στοιχεία συμπληρώνονται πάνω από ένα μόνο καθεστώς ~3 μηνών συν ζωντανές συναλλαγές και εμφανίζονται προ-τέλους όπου σημειώνεται.
GET /export
Κατεβάστε ιστορικά δεδομένα σημάτων ως CSV για backtesting. Παράμετροι: symbol, from (unix ts), to (unix ts).
GET /health
Έλεγχος υγείας συστήματος. Επιστρέφει την φρεσκάδα δεδομένων για κάθε πηγή και την συνολική κατάσταση του API. Δεν απαιτείται πιστοποίηση.
"status": "ok",
"uptime_s": 1209600,
"sources": {
"bybit": { "lag_s": 42, "ok": true },
"binance": { "lag_s": 38, "ok": true },
"hyperliquid": { "lag_s": 61, "ok": true },
"onchain": { "lag_s": 290, "ok": true }
}
}
GET /usage
Επιστρέφει τις τρέχουσες στατιστικές χρήσης του API: κλήσεις σήμερα, μηνιαία σύνολα, όρια ποσόστωσης και χρόνοι επαναφοράς.
POST /webhooks
Καταχωρήστε μια διεύθυνση URL HTTPS για να λαμβάνετε πιέσεις συμβάντων με πραγματικό χρόνο όταν ενεργοποιείται ένα σήμα στα παρακολουθούμενα σας περιουσιακά στοιχεία. Οι παραδόσεις περιλαμβάνουν μια X-SmartMoney-Event κεφαλίδα και μια υπογραφή HMAC-SHA256 στο X-SmartMoney-Signature, και επαναλαμβάνονται έως 3 φορές με backoff.
Σώμα Αίτησης
| Πεδίο | Τύπος | Περιγραφή |
|---|---|---|
| urlαπαιτείται | string | Τελικό σημείο HTTPS για την αποστολή συμβάντων (πρέπει να ξεκινά με https://) |
| eventsαπαιτείται | array | Ονόματα συμβάντων, π.χ. ["HIGH","MEDIUM","VETO"] ή ["*"] |
| symbolsαπαιτείται | array | Σύμβολα για φιλτράρισμα, π.χ. ["BTC","ETH"] ή ["*"] |
| secretαπαιτείται | string | Το μυστικό σας για υπογραφή, ≥ 16 χαρακτήρες (αποθηκεύεται ως hash) |
Επαλήθευση της υπογραφής
Το κλειδί HMAC είναι το SHA-256 hex digest του καταχωρημένου σας μυστικού. Υπολογίστε το HMAC-SHA256 του ακατέργαστου σώματος της αίτησης με αυτό το κλειδί και συγκρίνετε (σταθερό χρόνο) με X-SmartMoney-Signature. Δείτε το Οδηγός Υλοποίησης Webhook.
Ευφυΐα
GET /analysis
Επιστρέφει ταξινόμηση καθεστώτος αγοράς με τεχνητή νοημοσύνη και ανίχνευση σύγκρουσης σημάτων. Αναλύει τη συμφωνία διασταυρούμενων σημάτων, εντοπίζει αποκλίσεις μεταξύ παραγώγων, αλυσιδωτών δεδομένων και δεδομένων φαλαινών, και παράγει μια περίληψη σε φυσική γλώσσα με προοπτικούς παράγοντες κινδύνου και μια σύσταση με χρονικό ορίζοντα.
Παράμετροι
| Παράμετρος | Τύπος | Περιγραφή |
|---|---|---|
| symbolrequired | string | Σύμβολο περιουσιακού στοιχείου: BTC, ETH, ή SOL |
Παράδειγμα Απάντησης
"ts": 1710940821,
"symbol": "BTC",
"regime": "late_cycle_divergence",
"regime_label": "Ύστερη Φάση Κύκλου — Απόκλιση Σήματος",
"summary": "Το BTC βρίσκεται σε ύστερη φάση bull κύκλου με ισχύ αλυσίδας να έρχεται σε σύγκρουση με υπερβολική επέκταση παραγώγων. Οι φάλαινες μειώνουν την έκθεση ενώ η λιανή LSR αυξάνεται.",
"signal_conflicts": [
"Η βαθμολογία φαλαινών bearish ενώ η βαθμολογία αλυσίδας bullish",
"Το funding rate σε υψηλό 3 μηνών — πιθανός κίνδυνος squeeze"
],
"risk_factors": ["Υψηλό funding", "Απόκλιση OI", "Μείωση φαλαινών"],
"recommendation": "Μειώστε την long έκθεση, σφίξτε τα stops. Αποφύγετε νέα longs πάνω από την τρέχουσα τιμή.",
"time_horizon": "4h–12h"
}
GET /liquidations
Επιστρέφει δυο συμπληρωματικές προβολές: (1) leverage-projected levels — μια εκτίμηση του όπου βρίσκονται οι συστάδες ρευστοποιήσεων· και (2) ένα realized_heatmap — η ΠΡΑΓΜΑΤΙΚΗ εκτελεσμένη ένταση αναγκαστικής ρευστοποίησης (τιμή × χρόνος), συγκεντρωμένη ζωντανά από δημόσια WebSocket feeds ανταλλαγών: Binance, OKX, Bybit, Bitget, BitMEX. Ο χάρτης θερμότητας εμφανίζεται όταν η ροή έχει δεδομένα για το σύμβολο (απουσιάζει σε μια πολύ ήρεμη αγορά ή αμέσως μετά την εκκίνηση).
Παράμετροι
| Παράμετρος | Τύπος | Περιγραφή |
|---|---|---|
| symboloptional | string | Σύμβολο περιουσιακού στοιχείου (προεπιλογή BTC). Ο πραγματικός χάρτης θερμότητας καλύπτει ενεργά συμβόλαια perp. |
Παράδειγμα Απάντησης
"symbol": "BTC",
"cascade_risk": "HIGH",
"nearest_long_liq_pct": -3.2,
"nearest_short_liq_pct": 4.1,
// ΠΡΑΓΜΑΤΙΚΕΣ εκτελεσμένες ρευστοποιήσεις — ζωντανά από 5 ανταλλαγές
"realized_heatmap": {
"window_minutes": 240, "price_min": 91000.0, "price_max": 99000.0,
"clusters": [ { "price": 93250.0, "notional": 4820000.0, "count": 37, "dominant_side": "long" } ],
"by_side": { "long": 6100000.0, "short": 2400000.0 },
"totals": { "total_notional": 8500000.0, "count": 214 },
"exchanges": { "binance": 120, "okx": 40, "bybit": 34, "bitget": 12, "bitmex": 8 }
}
}
cascade_risk, πλησιέστερες αποστάσεις και πραγματοποιημένα σύνολα/ανά πλευρά. Πρόγραμμα Pro: πλήρης προβλεπόμενη levels συν τον πλήρη realized_heatmap (πίνακες, συστάδες ανά τιμή, μετρητές ανά ανταλλαγή). Η προβλεπόμενη εκτίμηση απαντά "πού είναι τα stops"· ο πραγματικός χάρτης θερμότητας δείχνει "τι πραγματικά ρευστοποιήθηκε."GET /liquidations/heatmap
Public χάρτης θερμότητας ρευστοποιήσεων ανά επίπεδο τιμής. Επιστρέφει έναν πίνακα τύπου Coinglass τιμή × χρόνος με ΠΡΑΓΜΑΤΙΚΕΣ εκτελεσμένες αναγκαστικές ρευστοποιήσεις, ομαδοποιημένες ανά την τιμή στην οποία κάθε ρευστοποίηση εκτυπώθηκε — συγκεντρωμένες ζωντανά από δημόσια WebSocket feeds ανταλλαγών: Binance, OKX, Bybit, Bitget, BitMEX. Ο clusters πίνακας είναι το πρακτικό αποτέλεσμα: κάδοι τιμών καταταγμένοι ανά ρευστοποιημένο notional, κάθε ένας με την κυρίαρχη πλευρά του. Τα δεδομένα εξαρτώνται από τη ζωντανή ροή — ένα πολύ ήσυχο σύμβολο ή μια μόλις επανεκκινημένη πύλη επιστρέφει την καλά διαμορφωμένη κενή δομή συν μια ειλικρινή note. Τα επίπεδα που εμφανίζονται είναι πάντα πραγματικές ρευστοποιήσεις, ποτέ εκτιμώμενα.
Παράμετροι
| Παράμετρος | Τύπος | Περιγραφή |
|---|---|---|
| symboloptional | string | Σύμβολο περιουσιακού στοιχείου (προεπιλογή BTC). |
| window_minutesoptional | int | Παράθυρο αναζήτησης σε λεπτά (προεπιλογή 240, περιορισμένο σε 5–1440). |
| price_bucketsoptional | int | Αριθμός κάδων τιμής (προεπιλογή 50, περιορισμένο σε 5–100). |
Παράδειγμα Απάντησης
"symbol": "BTC", "window_minutes": 240, "price_buckets": 50,
"price_min": 91000.0, "price_max": 99000.0, "price_bucket_size": 160.0,
"price_levels": [ 91080.0, 91240.0, … ], "time_buckets": [ … ],
"matrix": [ [ … ] ], "long_matrix": [ [ … ] ], "short_matrix": [ [ … ] ],
"clusters": [
{ "price": 93250.0, "notional": 4820000.0, "long_notional": 4100000.0,
"short_notional": 720000.0, "count": 37, "dominant_side": "long" }
],
"by_side": { "long": 6100000.0, "short": 2400000.0 },
"totals": { "long_liq_notional": 6100000.0, "short_liq_notional": 2400000.0, "total_notional": 8500000.0, "count": 214 },
"exchanges": { "binance": 120, "okx": 40, "bybit": 34, "bitget": 12, "bitmex": 8 },
"generated_at": 1710940200, "public": true
}
totals.count is 0, clusters είναι άδειο, και ένα note πεδίο εξηγεί γιατί. Είναι ένα αρχείο εκτελεσμένων ρευστοποιήσεων — όχι μια πρόβλεψη. Για την εκτιμώμενη εκτίμηση "πού είναι τα stop", χρησιμοποιήστε το πιστοποιημένο /liquidations endpoint.GET /liquidations/onchain
Εκτελεσμένες on-chain ρευστοποιήσεις δανεισμού DeFi που καταγράφονται απευθείας από τους δικούς μας τοπικούς BSC + Avalanche πλήρεις κόμβους — ανεξάρτητα από οποιοδήποτε trading bot. Καλύπτει Venus/Cream και Moolah στο BSC, και AAVE V3/V2, Benqi, BankerJoe, Granary και Vinium στο Avalanche. Το επίπεδο Pro επιστρέφει επιπλέον at_risk θέσεις (εξαρτάται από bot, μπορεί να λείπουν).
Παράμετροι
| Παράμετρος | Τύπος | Περιγραφή |
|---|---|---|
| chainoptional | string | bsc or avax. Παραλείψτε για όλες τις αλυσίδες. |
| limitoptional | integer | Μέγιστες γραμμές (προεπιλογή 100, μέγιστο 500). Πιο πρόσφατες πρώτα. |
Παράδειγμα Απάντησης
"chain": "bsc", "count": 2,
"liquidations": [
{ "chain": "bsc", "protocol": "Venus", "borrower": "0x2be6…8dfa",
"debt_symbol": "DAI", "repay_usd": 426.15,
"collateral_symbol": "WBNB", "tx_hash": "0x718c…7c0e", "block": 89170816, "ts": 1710940200 }
],
"summary": {
"window_hours": 24, "enabled": true,
"by_protocol": { "bsc:Venus": { "count": 61, επιστροφή_usd_γνωστό: 148230.55 } },
κόμβοι: { bsc: { προσβάσιμος: True, κεφαλικός_μπλοκ: 89173010, γεγονότα_σύνολο: 61 } }
}
}
GET /smart-stop
Υπολογίζει έξυπνα επίπεδα stop-loss με βάση τον τρέχοντα χάρτη ρευστοποίησης, τις ζώνες μεταβλητότητας και τη δομή της αγοράς. Επιστρέφει βαθμιδωτές συστάσεις stop και προτάσεις take-profit προσαρμοσμένες στην τιμή εισόδου και την ανοχή κινδύνου σας.
Παράμετροι
| Παράμετρος | Τύπος | Περιγραφή |
|---|---|---|
| symbolrequired | string | Σύμβολο περιουσιακού στοιχείου: BTC, ETH, ή SOL |
| directionrequired | string | Κατεύθυνση θέσης: long ή short |
| entry_priceoptional | float | Η τιμή εισόδου σας. Προεπιλογή στην τρέχουσα τιμή της αγοράς εάν παραλειφθεί. |
| risk_pctoptional | float | Μέγιστη αποδεκτή έκθεση κινδύνου ως % του λογαριασμού. Προεπιλογή: 2.0 |
Παράδειγμα Απάντησης
symbol: BTC,
direction: long,
entry_price: 96420,
stops: {
tight: { price: 95100, note: Κάτω από δομή 1h. Καλύτερο για scalping. },
recommended: { price: 93800, note: Κάτω από μεγάλη συγκέντρωση ρευστοποίησης στα $94K. Τυπικό stop για swing. },
wide: { price: 91200, note: Κάτω από ζώνη ζήτησης 4h. Stop για θέση trade. }
},
avoid_zones: [
{ low: 94200, high: 94800, reason: Πυκνή συγκέντρωση ρευστοποίησης — υψηλός κίνδυνος slippage }
],
take_profit_suggestions: [
{ tp1: 98500, tp2: 101000, tp3: 104200 }
]
}
recommended stop. Πλάνο Pro: Και τις τρεις βαθμίδες stop, avoid_zones, και πλήρεις προτάσεις take-profit.GET /funding-arb
Αναγνωρίζει ευκαιρίες arbitrage επιτοκίων χρηματοδότησης μεταξύ ανταλλακτηρίων σε πραγματικό χρόνο. Επιστρέφει καταταγμένες ευκαιρίες με εκτιμώμενη ετήσια απόδοση, το βέλτιστο ζεύγος ανταλλακτηρίου και την απαιτούμενη ενέργεια hedge για την αξιοποίηση της διαφοράς.
Παράμετροι
| Παράμετρος | Τύπος | Περιγραφή |
|---|---|---|
| min_spreadoptional | float | Ελάχιστη διαφορά επιτοκίου χρηματοδότησης για συμπερίληψη (ως δεκαδικό). Προεπιλογή: 0.01 |
| symboloptional | string | Φιλτράρισμα σε συγκεκριμένο περιουσιακό στοιχείο. Παραλείψτε για σάρωση όλων των υποστηριζόμενων περιουσιακών στοιχείων. |
Παράδειγμα Απάντησης
ts: 1710940821,
opportunities: [
{
symbol: BTC,
spread: 0.032,
apr: 84.2,
long_exchange: hyperliquid,
short_exchange: bybit,
action: Long HYPE / Short BYBIT,
estimated_profit_8h_usd: 26.4
}
]
}
Δωρεάν δημόσια παραλλαγή No auth
Ένα δημόσιο endpoint χωρίς κλειδί επιστρέφει τις κορυφαίες 10 ευκαιρίες με ένα ζωντανό cross-exchange screener, ιδανικό για ενσωμάτωση ή γρήγορους ελέγχους. Παραλείπει το ιστορικό διαφοράς ανά σύμβολο και βαριά πεδία και εξυπηρετείται από μια cache 120 δευτερολέπτων. Όταν δεν υπάρχουν διαφορές επιτοκίου χρηματοδότησης μεταξύ ανταλλακτηρίων στο παράθυρο φρεσκάδας, επιστρέφει ένα κενό opportunities πίνακα με ένα note — ποτέ πλαστογραφημένα δεδομένα.
opportunities: [
{
σύμβολο: OGN,
spread_pct: 0.297667,
annualized_apr: 325.95,
long_exchange: bybit,
short_exchange: hyperliquid,
estimated_profit_per_10k: 29.77,
risk_notes: Χαμηλό spread — βεβαιωθείτε ότι τα τέλη δεν καταναλώνουν το περιθώριο αρμπιτράζ.
}
],
scanned_symbols: 222,
ts: 1783268753,
public: True,
limited: True
}
GET /smart-money/flow
Ένας ποιοτικά σταθμισμένος δείκτης κατεύθυνσης φαλαιών ανά σύμβολο, βαθμολογημένος -100 (τα χρήματα των φαλαιών τείνουν προς short) σε +100 (τείνουν προς long). Δημιουργήθηκε από χιλιάδες παρακολουθούμενους πορτοφόλες φαλαιών Hyperliquid — κάθε ένας σταθμισμένος με το δικό του ιστορικό ποσοστό νίκης και PnL και εξασθενημένος από την πρόσφατη χρονική στιγμή. Αυτός είναι ένας δείκτης θέσης, όχι σήμα αγοράς/πώλησης ή πρόβλεψη τιμής. Τα σύμβολα με λίγους συνεισφέροντες πορτοφόλες επισημαίνονται thin και βαθμολογούνται ειλικρινά. Ζωντανή σελίδα: smart-money-flow.html.
Παράμετροι
| Παράμετρος | Τύπος | Περιγραφή |
|---|---|---|
| σύμβολοπροαιρετικό | string | Ενιαίο σύμβολο (π.χ. BTC). Παραλείψτε για να λάβετε όλα τα παρακολουθούμενα σύμβολα ταξινομημένα κατά |score|. |
| window_hoursπροαιρετικό | int | Περίοδος βαθμολόγησης, περιορισμένη σε 1..168. Προεπιλογή 24. |
Παράδειγμα Απάντησης
σύμβολα: [
{
σύμβολο: SPX,
score: -90.93,
direction: strong_short,
n_wallets: 26,
long_usd: 184200.0, short_usd: 2410000.0,
quality_weighted: True,
sample_quality: rich,
top_contributors: [ { πορτοφόλι: 0x31ca…974b, direction: short, value_usd: 5338.25, weight: 0.4948 } ]
}
],
window_hours: 24,
quality_weighted: True,
ts: 1783270000,
note: Ποιοτικά σταθμισμένος δείκτης κατεύθυνσης θέσης φαλαιών (-100..+100). Δεν είναι πρόβλεψη τιμής ή σήμα αγοράς/πώλησης.
}
top_contributors. Τα βάρη των πορτοφολιών περιορίζονται σε [0.25,1.0]; Το PnL είναι ένας μη πραγματοποιημένος διαμεσολαβητής από τις τελευταίες στιγμιότυπες θέσεις.GET /v1/whales/crowding
Συνδυασμένη θέση φαλαιών & πλαίσιο συγκέντρωσης ανά σύμβολο, συγχωνευμένα σε Hyperliquid + GMX v2 + Jupiter Perps. Επιστρέφει ακαθάριστο/καθαρό ονομαστικό, κατευθυντική κλίση, αριθμό πορτοφολιών & χώρων, συγκέντρωση θέσεων (μερίδιο top-3 + HHI), ένα σταθμισμένο μέσο όρο μόχλευσης, και κάδους εγγύτητας εκκαθάρισης ($ ονομαστικό που βρίσκεται εντός 5% και 10% της εκτιμώμενης τιμής εκκαθάρισης, διαχωρισμένο long/short). Αυτό είναι πλαίσιο, όχι κατευθυντικό σήμα. Τα πεδία που δεν είναι προσδιορίσιμα είναι null και εμφανίζονται ως — — π.χ. lev_wavg/crowding_index όταν καμία θέση δεν μεταφέρει μόχλευση. Οι αποστάσεις εκκαθάρισης είναι μια εκτίμηση απομονωμένου περιθωρίου (pct_to_liq ≈ 1/lev + upnl/notional − mmr, mmr = 0.01), όχι τιμές εκκαθάρισης που αναφέρονται από το χρηματιστήριο.
Παράμετροι
| Παράμετρος | Τύπος | Περιγραφή |
|---|---|---|
| min_notionalπροαιρετικό | float | Ελάχιστο συνδυασμένο ακαθάριστο ονομαστικό (USD) για να συμπεριληφθεί ένα σύμβολο. Προεπιλογή: 1000000. |
Παράδειγμα Αίτησης
Παράδειγμα Απάντησης
"ok": True, "ts": 1783423500, min_notional: 1000000, n_symbols: 92,
symbols: [
{
symbol: BTC,
gross_usd: 2447900000.0, net_usd: -51000000.0, skew: -0.021,
n_whales: 414, n_venues: 3,
venues: {
hl: { gross: 1900000000.0, net: -40000000.0, n_whales: 272 },
gmx: { gross: 320000000.0, net: -6000000.0, n_whales: 59 },
jupiter: { gross: 227900000.0, net: -5000000.0, n_whales: 83 }
},
conc_top3: 0.159, hhi: 0.011, lev_wavg: 19.1,
liq_within_5pct: { long: 621700000.0, short: 665600000.0 },
liq_within_10pct: { long: 840000000.0, short: 910000000.0 },
crowding_index: 0.003
}
],
caveats: [ Οι αποστάσεις εκκαθάρισης είναι εκτιμήσεις μεμονωμένου περιθωρίου, όχι αναφερόμενες από το χρηματιστήριο. ]
}
skew είναι net/gross ∈ [-1,1]; crowding_index = |skew|·conc_top3·min(lev/20,1). Μόνο οι πλατφόρμες που υπάρχουν πραγματικά εμφανίζονται στο venues. Οι θέσεις χωρίς μόχλευση εξαιρούνται από τις ομάδες εκκαθάρισης αντί να υποτεθούν. Οι ανώνυμοι χρήστες λαμβάνουν τα top 10 σύμβολα κατά gross (με gated: true). Οι Trader+ λαμβάνουν την πλήρη λίστα.GET /v1/options/gex
Dealer gamma exposure (GEX) αναλυτικά για BTC & ETH, υπολογιζόμενα σε πραγματικό χρόνο από την δημόσια αλυσίδα επιλογών Deribit (χωρίς πιστοποίηση). Επιστρέφει το καθαρό GEX ανά strike (SpotGamma dealer-short σύμβαση), το gamma-flip level (strike όπου το αθροιστικό καθαρό GEX διασχίζει το μηδέν), την IV term structure (ATM υπονοούμενη διακύμανση ανά ημέρες-έως-λήξη), και μια front-expiry IV skew (25Δ-proxy risk reversal). Το καθεστώς GEX είναι positive (dealers long gamma → καταστολή διακύμανσης) ή negative (ενίσχυση διακύμανσης). Πλήρως αυτόνομο — επανυπολογίζεται σε κάθε κλήση, χωρίς εξάρτηση από αποθηκευμένη βάση δεδομένων.
Παράμετροι
| Παράμετρος | Τύπος | Περιγραφή |
|---|---|---|
| symbolπροαιρετικό | string | BTC ή ETH μόνο. Προεπιλογή: BTC. |
Παράδειγμα Αίτησης
Παράδειγμα Απάντησης
"symbol": "BTC", "available": true, "spot": 63203.0,
"net_gex": 18240000.0, "regime": "positive",
"gamma_flip": 64919.82, "gamma_flip_pct": 2.72,
"call_gex": 31200000.0, "put_gex": -12960000.0,
"by_strike": [
{ "strike": 60000, "net_gex": -2100000.0 },
{ "strike": 65000, "net_gex": 4800000.0 }
],
"term_structure": [
{ "expiry": "8JUL26", "dte": 0.76, "atm_iv": 62.1 },
{ "expiry": "27MAR26", "dte": 14.2, "atm_iv": 58.4 }
],
"skew": {
"expiry": "8JUL26", "dte": 0.76,
"put_iv": 69.69, "atm_iv": 62.1, "call_iv": 55.34,
"risk_reversal": 14.35, "bias": "downside_fear"
}
}
available: false με κενές ενότητες — ποτέ κατασκευασμένο GEX. Το IV skew χρησιμοποιεί ένα σταθερό ±10% strike proxy για 25Δ (το πραγματικό 25-delta απαιτεί επίλυση delta ανά strike)· επαρκές για εμφάνιση, τεκμηριωμένο ως προσέγγιση.GET /v1/liquidations/simulate
Interactive δοκιμή πίεσης για καταρρακωδή ρευστοποίηση. Δεδομένης μιας υποθετικής κίνησης τιμής, επιστρέφει τις εκτιμώμενες μόχλευση θέσεις που θα ρευστοποιηθούν, τον εξαναγκασμένο όγκο ανά επίπεδο τιμής / πλευρά / ανταλλακτήριο και μια ανάγνωση του βάθους της καταρράκωσης. Μια καθοδική κίνηση ρευστοποιεί μακρές θέσεις των οποίων η τιμή ρευστοποίησης βρίσκεται σε/πάνω από τον στόχο· μια ανοδική κίνηση ρευστοποιεί κοντές θέσεις των οποίων η τιμή ρευστοποίησης βρίσκεται σε/κάτω από αυτήν. Δύο ανεξάρτητες μέθοδοι συνδυάζονται: ακριβείς τιμές ρευστοποίησης από παρακολουθούμενες μεγάλες θέσεις (whales) του Hyperliquid με πραγματική μόχλευση/είσοδο, συν στατιστικά συμπλέγματα ζωνών ανοιχτών θέσεων (OI) ανά ανταλλακτήριο (πληθαριθμική μόχλευση που προκύπτει από τη χρηματοδότηση). Όλα είναι σαφώς επισημασμένα estimated: true — δεν μπορεί να γνωρίζει το περιθώριο ανά λογαριασμό, cross vs isolated, προστιθέμενο περιθώριο ή ADL.
Παράμετροι
| Παράμετρος | Τύπος | Περιγραφή |
|---|---|---|
| symboloptional | string | Σύμβολο περιουσιακού στοιχείου. Προεπιλογή: BTC. |
| move_pctoptional | float | Υποθετική κίνηση τιμής ως ποσοστό (αρνητικό = κάτω, θετικό = πάνω). Προεπιλογή: -5. |
Παράδειγμα Αίτησης
Παράδειγμα Απάντησης
"ok": true, "estimated": true, "symbol": "BTC",
"ref_price": 63000.0, "move_pct": -5.0, "target_price": 59850.0,
"triggered_notional_usd": 380000000.0,
"cascade_depth": 0.029, "cascade_bucket": "low",
"by_exchange": { "hyperliquid": 260000000.0, "binance": 80000000.0, "bybit": 40000000.0 },
"by_side": { "long": 380000000.0, "short": 0.0 },
"clusters": [
{ "price": 60100.0, "side": "long", "notional_usd": 42000000.0, "whale_usd": 18000000.0, "oi_usd": 24000000.0 }
],
"whale_positions_used": 272, "exchanges": 3,
"realized_context": { "available": true, "coverage_hours": 17.8, "by_side_24h": { "long": 6100000.0, "short": 2400000.0 } },
"methodology": { "disclaimer": "Εκτιμώμενο — δεν μπορεί να γνωρίζει το περιθώριο ανά λογαριασμό, cross vs isolated, προστιθέμενο περιθώριο ή ADL." }
}
ok: true, empty: true με ένα απλό μήνυμα στα Αγγλικά, όχι ψεύτικα δεδομένα. realized_context είναι ένα νέο, αναπτυσσόμενο δείγμα από τη ζωντανή ροή εξαναγκασμένων ρευστοποιήσεων, που εμφανίζεται μόνο ως πλαίσιο — ποτέ δεν κάνει την πρόβλεψη "πραγματοποιημένη."GET /v1/wallet/{addr}/profile
Ένα cross-venue προφίλ πορτοφολιού που χτίζεται εξ ολοκλήρου από live snapshots παρακολουθούμενων μεγάλων θέσεων (whales). Για έναν παρακολουθούμενο whale του Hyperliquid, επιστρέφει τις τρέχουσες ανοιχτές θέσεις, μια σειρά χρόνου για μη πραγματοποιημένο κέρδος/ζημία / έκθεση / αριθμό θέσεων σειρά χρόνου, μια χρονολογική γραμμή δραστηριότητας OPEN/CLOSE/FLIP (ανακατασκευασμένη με διαφοροποίηση διαδοχικών snapshots), την αποκωδικοποιημένη ετικέτα leaderboard του HL και μια σύνοψη ανοιχτού βιβλίου. Ζωντανή σελίδα: wallet-profiler.html.
Παράμετροι
| Παράμετρος | Τύπος | Περιγραφή |
|---|---|---|
| addrrequired | string | Διεύθυνση πορτοφολιού (τμήμα διαδρομής), π.χ. /v1/wallet/0x3bcae23e…/profile. |
| daysoptional | integer | Παράθυρο αναζήτησης για τη σειρά και τη χρονολογική γραμμή. Προεπιλογή: 30. |
Παράδειγμα Αίτησης
Παράδειγμα Απάντησης
"ok": true, "wallet": "0x3bcae23e…", "tracked": true,
"first_seen_ts": 1782827733, "latest_snapshot_ts": 1783418468, "as_of": 1783418468,
"hyperliquid": {
"label": { "name": "Andre is back", "score": 74,
"window_pnl_usd": 1307000, ποσοστό_νίκης: 71, συναλλαγές: 42 },
θέσεις: [
{ χώρος: hyperliquid, σύμβολο: ETH, κατεύθυνση: short,
μέγεθος: 1200.0, τιμή_εισόδου: 1800.0, μη_πραγματοποιημένο_κέρδος: 34800.0,
μόχλευση: 20.0, αξία_usd: 2160000.0 }
],
σειρά: [ { ts: 1783330000, μη_πραγματοποιημένο_κέρδος: 42000.0, έκθεση_usd: 18400000.0, θέσεις: 5 } ],
χρονολόγιο: [ { ts: 1783400000, γεγονός: flip, σύμβολο: ETH,
κατεύθυνση: short, από_κατεύθυνση: long, αξία_usd: 2160000.0 } ],
περίληψη: {
ανοιχτές_θέσεις: 5, σε_κέρδος: 3, σε_ζημία: 2, longs: 0, shorts: 5,
συνολικό_μη_πραγματοποιημένο_κέρδος: -12000.0, συνολική_έκθεση_usd: 21000000.0, μικτή_μόχλευση: 19.9,
παράθυρο_ημερών: 30, στιγμιότυπα_στο_παράθυρο: 474,
πραγματοποιημένο_κέρδος: None, σημείωση_πραγματοποιημένου_κερδούς: Μη παραγωγικό — εμφανίζονται μόνο ανοιχτά στιγμιότυπα, ποτέ κλειστές συμπληρώσεις.
}
}
}
pnl είναι το δικό της της HL μη πραγματοποιημένο mark-to-market, value_usd είναι ανοιχτό ονομαστικό. Το πραγματοποιημένο P&L ανά round-trip δεν είναι διαθέσιμο (βλέπουμε μόνο ανοιχτά στιγμιότυπα, ποτέ κλειστές συμπληρώσεις) και εμφανίζεται ως null / —; τα γεγονότα CLOSE στο χρονολόγιο δεν φέρουν αξίωση P&L. Μια έγκυρη αλλά μη παρακολουθούμενη διεύθυνση επιστρέφει tracked: false με μια σημείωση· μια μη έγκυρη διεύθυνση επιστρέφει ok: false, error: "invalid_address" (HTTP 400). Η ετικέτα HL-leaderboard είναι η δική της της HL θέση στο παράθυρο κατά την ανακάλυψη, δεν υπολογίζεται από εμάς.GET /flows
Επιστρέφει δεδομένα κεφαλαιακών ροών διασταυρούμενων περιουσιακών στοιχείων που δείχνουν μοτίβα περιστροφής μεταξύ BTC, ETH και SOL σε πολλαπλά χρονικά παράθυρα. Χρήσιμο για τον εντοπισμό του ποιου περιουσιακού στοιχείου συσσωρεύει κεφάλαιο και ποιου διανέμεται σε κάθε δεδομένη στιγμή.
Παράδειγμα Απάντησης
ts: 1710940821,
ροές: {
BTC: { 1h: 142000000, 4h: 380000000, 12h: -90000000, 24h: 220000000 },
ETH: { 1h: -38000000, 4h: -110000000, 12h: 55000000, 24h: -80000000 },
SOL: { 1h: 12000000, 4h: 29000000, 12h: 18000000, 24h: 44000000 }
},
εντοπισμένες_περιστροφές: [
Κεφάλαιο που περιστρέφεται από ETH σε BTC σε παράθυρο 4h,
Συσσώρευση SOL συνεπής σε όλα τα παράθυρα
]
}
GET /whale-events
Επιστρέφει σημαντικές αλλαγές θέσεων φαλαινών — ανοίγματα, κλείσιματα και αλλαγές κατεύθυνσης — που εντοπίστηκαν σε παρακολουθούμενες διευθύνσεις πορτοφολιών και on-chain εντός του καθορισμένου παραθύρου αναζήτησης.
Παράμετροι
| Παράμετρος | Τύπος | Περιγραφή |
|---|---|---|
| σύμβολοπροαιρετικό | string | Φιλτράρισμα ανά περιουσιακό στοιχείο. Παραλείψτε για όλα τα παρακολουθούμενα περιουσιακά στοιχεία. |
| σημασίαπροαιρετικό | string | Φιλτράρισμα ανά σημασία γεγονότος: high, medium, ή all. Προεπιλογή: all |
| ώρεςπροαιρετικό | integer | Παράθυρο αναζήτησης σε ώρες. Προεπιλογή: 24 |
Παράδειγμα Απάντησης
σύμβολο: BTC,
περίληψη: {
flips_to_long: 3,
flips_to_short: 1,
new_opens: 7,
closes: 2
},
γεγονότα: [
{
τύπος: flip_long,
πορτοφόλι: 0xWhale...a4f2,
κατεύθυνση: long,
size_usd: 4200000,
ts: 1710938400
}
]
}
summary αντικείμενο μόνο. Σχέδιο Pro: Πλήρης events ροή με αναγνωριστικά πορτοφολιών, μεγέθη και χρονικές σημάνσεις.GET /regimes/history
Επιστρέφει ιστορικά δεδομένα ταξινόμησης καθεστώτος για ένα συγκεκριμένο περιουσιακό στοιχείο. Χρησιμοποιήστε το για να δοκιμάσετε πώς έχουν αποδώσει ιστορικά συγκεκριμένοι τύποι καθεστώτων, πόσο διαρκεί συνήθως κάθε τύπος καθεστώτος και πώς εξελίσσονται οι μεταβάσεις καθεστώτων με την πάροδο του χρόνου.
Παράμετροι
| Παράμετρος | Τύπος | Περιγραφή |
|---|---|---|
| symbolπροαιρετικό | string | Σύμβολο περιουσιακού στοιχείου. Προεπιλογή: BTC |
| regimeπροαιρετικό | string | Φιλτράρισμα σε συγκεκριμένο τύπο καθεστώτος, π.χ. late_cycle_divergence. Παραλείψτε για όλα τα καθεστώτα. |
| daysπροαιρετικό | integer | Παράθυρο αναζήτησης σε ημέρες. Προεπιλογή: 30. Μέγιστο: 365 |
Παράδειγμα Απάντησης
"symbol": "BTC",
"current_regime": "late_cycle_divergence",
"regime_summary": {
"late_cycle_divergence": { "occurrences": 4, "avg_duration_h": 38, "avg_return_pct": -2.1 },
"accumulation": { "occurrences": 6, "avg_duration_h": 72, "avg_return_pct": 5.4 },
"breakout": { "occurrences": 3, "avg_duration_h": 18, "avg_return_pct": 9.2 }
},
"transitions": [
{ "from": "accumulation", "to": "breakout", "ts": 1710850000 },
{ "from": "breakout", "to": "late_cycle_divergence", "ts": 1710915000 }
]
}
/analysis για να επαληθεύσετε τις υποθέσεις στρατηγικής έναντι ιστορικών δεδομένων απόδοσης καθεστώτων.GET /exchange-health
Επιστρέφει την κατάσταση υγείας σε πραγματικό χρόνο για όλες τις παρακολουθούμενες ανταλλαγές, συμπεριλαμβανομένης της καθυστέρησης ανά ανταλλαγή, των ποσοστών σφαλμάτων και των δεικτών παλαιότητας δεδομένων. Δεν απαιτείται πιστοποίηση - δημόσια προσβάσιμο endpoint.
Παράδειγμα Απάντησης
"overall_status": "ok",
"ts": 1710940821,
"exchanges": {
"bybit": { "status": "ok", "latency_ms": 42, "error_rate_1h": 0.0, "last_data_age_s": 18 },
"binance": { "status": "ok", "latency_ms": 38, "error_rate_1h": 0.0, "last_data_age_s": 22 },
"hyperliquid": { "status": "degraded", "latency_ms": 310, "error_rate_1h": 0.04, "last_data_age_s": 95 },
"okx": { "status": "ok", "latency_ms": 55, "error_rate_1h": 0.0, "last_data_age_s": 30 }
}
}
GET /sentiment
Επιστρέφει ένα δείκτη Φόβου & Άπληστου (0-100) που υπολογίζεται από το συναίσθημα παραγώγων, τη δραστηριότητα φαλαινών, τη μεταβλητότητα και τα κοινωνικά σήματα. Περιλαμβάνει ανάλυση στοιχείων και ιστορικό 24 ωρών για ανάλυση τάσης.
Παράμετροι
| Παράμετρος | Τύπος | Περιγραφή |
|---|---|---|
| symbolπροαιρετικό | string | Σύμβολο περιουσιακού στοιχείου. Προεπιλογή: BTC |
Παράδειγμα Απάντησης
"symbol": "BTC",
"score": 72,
"label": "Greed",
"components": {
"volatility": 65,
"momentum": 78,
"derivatives": 70,
"whale_activity": 75,
"social": 68
},
"history_24h": [
{ "ts": 1710940800, "score": 68, "label": "Greed" },
{ "ts": 1710937200, "score": 65, "label": "Greed" }
],
"ts": 1710940821
}
Ενσωματώσεις
GET /tradingview/setup
Επιστρέφει την προσωποποιημένη ρύθμιση ενσωμάτωσης TradingView: URL webhook, μυστικό για επαλήθευση και έτοιμα για χρήση Pine Script δείκτες που συνδέονται απευθείας με το Smart Money API. Αντιγράψτε και επικολλήστε το Pine Script στο TradingView για να εμφανίσετε τα σήματά μας σε οποιοδήποτε γράφημα.
Παράδειγμα Απάντησης
"webhook_url": "https://api.smartmoneyapi.com/v1/tradingview/webhook",
"webhook_secret": "tvs_a1b2c3...",
"pine_scripts": {
"composite_indicator": "// Smart Money Composite v1 //@version=5 indicator(...)...",
"whale_activity": "// Whale Activity Overlay v1 ...",
"funding_dashboard": "// Funding Rate + LSR Dashboard v1 ..."
}
}
POST /tradingview/webhook
Λαμβάνει μια ειδοποίηση από το TradingView, την επεξεργάζεται μέσω /confirm, και επιστρέφει την επιβεβαίωση. Το TradingView δεν μπορεί να στείλει προσαρμοσμένες κεφαλίδες, οπότε επαληθεύστε συμπεριλαμβάνοντας το webhook σας secret στο σώμα JSON (αυτό το endpoint δεν χρησιμοποιεί X-API-Key). Η απάντηση περιβάλλει την επιβεβαίωση και προσθέτει ένα ανώτερο επίπεδο action του CONFIRMED (daemon confidence HIGH/MEDIUM) ή VETOED.
Σώμα Αίτησης
"secret": "your_webhook_secret",
"symbol": "BTC",
"direction": "long",
"timeframe": "1h",
"strategy": "EMA crossover",
"price": 67500.0
}
Απαιτείται: secret, symbol, direction (long|short). Προαιρετικό: source, timeframe, strategy, price.
Προσωποποίηση
GET /preferences
Επιστρέφει τις τρέχουσες ρυθμίσεις προσωποποίησής σας, συμπεριλαμβανομένων των προεπιλεγμένων παραμέτρων συναλλαγής, προφίλ κινδύνου, λίστας παρακολούθησης και προτιμήσεων ειδοποιήσεων.
Ενημερώστε τις προτιμήσεις στέλνοντας ένα σώμα JSON με οποιοδήποτε υποσύνολο των παρακάτω πεδίων. Τα παραλειπόμενα πεδία διατηρούν τις τρέχουσες τιμές τους.
Πεδία Προτιμήσεων
| Πεδίο | Τύπος | Περιγραφή |
|---|---|---|
| default_trade_size_usd | float | Προεπιλεγμένο μέγεθος θέσης σε USD για υπολογισμούς Kelly και smart-stop |
| risk_tolerance | string | conservative, moderate, ή aggressive |
| default_risk_pct | float | Προεπιλεγμένος κίνδυνος ανά συναλλαγή ως % του λογαριασμού. Χρησιμοποιείται από /smart-stop όταν risk_pct παραλείπεται |
| watchlist | array | Διατεταγμένη λίστα συμβόλων περιουσιακών στοιχείων, π.χ. ["BTC","ETH","SOL"] |
| notification_email | string | Διεύθυνση email για παράδοση ειδοποιήσεων |
| timezone | string | IANA συμβολοσειρά ζώνης ώρας, π.χ. America/New_York |
"default_trade_size_usd": 5000,
"risk_tolerance": "moderate",
"default_risk_pct": 1.5,
"watchlist": ["BTC", "ETH", "SOL"]
}
GET /watchlist
Επιστρέφει μια στιγμιότυπη κατάσταση επιβεβαίωσης και βασικές μετρήσεις κινδύνου για όλα τα σύμβολα στη ρυθμισμένη λίστα παρακολούθησης. Παρέχει μια επισκόπηση πολλαπλών περιουσιακών στοιχείων χωρίς να χρειάζεται να καλείτε /confirm ξεχωριστά για κάθε σύμβολο.
Παράδειγμα Απάντησης
"ts": 1710940821,
"watchlist": [
{
"symbol": "BTC",
"confidence": "HIGH",
"action": "CONFIRM",
"regime": "accumulation",
"cascade_risk": "LOW"
},
{
"symbol": "ETH",
"confidence": "MEDIUM",
"action": "REDUCE",
"regime": "late_cycle_divergence",
"cascade_risk": "HIGH"
},
{
"symbol": "SOL",
"confidence": "HIGH",
"action": "CONFIRM",
"regime": "breakout",
"cascade_risk": "MEDIUM"
}
]
}
Ροή σε Πραγματικό Χρόνο (Ζωντανές Ανταλλαγές)
Ροή DEX ανταλλαγών ≥ $500 που εντοπίζονται σε πραγματικό χρόνο από τους δικούς μας κόμβους BSC και Avalanche. Διατίθενται δύο μεταφορές: μια δημόσια ροή Server-Sent Events (SSE) για δωρεάν/πελάτες προγράμματος περιήγησης, και μια ροή WebSocket χαμηλής καθυστέρησης για επίπεδα πληρωμής. Τα συμβάντα μεταδίδονται εντός δευτερολέπτων από την ένταξη σε ένα μπλοκ.
Δημόσια Ροή SSE (Δωρεάν)
Δεν απαιτείται πιστοποίηση. Εγγενής EventSource υποστήριξη σε όλα τα σύγχρονα προγράμματα περιήγησης. Ο διακομιστής εκπέμπει swap συμβάντα και περιοδικά σήματα καρδιακής λειτουργίας για να διατηρήσει τη σύνδεση ενεργή.
es.addEventListener("swap", e => {
const swap = JSON.parse(e.data);
console.log(swap.chain, swap.pair, swap.amount_usd);
});
WebSocket Firehose (Πληρωμή)
Πιστοποίηση (συνιστάται): ποτέ μην βάζετε το μακροχρόνιο κλειδί σας στη διεύθυνση URL — καταγράφεται από τους διαμεσολαβητές και αποθηκεύεται στο ιστορικό του προγράμματος περιήγησης. Αντίθετα, δημοσιεύστε το κλειδί σας σε /v1/ws/ticket χρησιμοποιώντας την ασφαλή X-API-Key κεφαλίδα, στη συνέχεια ανοίξτε την υποδοχή με το επιστραφέν μοναδικής χρήσης ticket (έγκυρο ~60s, εξαργυρώθηκε μία φορά). Οι πελάτες από την πλευρά του διακομιστή που μπορούν να ορίσουν κεφαλίδες μπορούν αντίθετα να περάσουν X-API-Key απευθείας στη χειραψία. Τα κλειδιά δωρεάν επιπέδου λαμβάνουν μια 402 payment_required απάντηση. Ένα hello πλαίσιο αποστέλλεται κατά τη σύνδεση με το επίπεδο σας και το όριο μετάδοσης.
const r = await fetch("https://api.smartmoneyapi.com/v1/ws/ticket", {
method: "POST", headers: { "X-API-Key": "sm_xxx" }
});
const { ticket } = await r.json();
// 2. Ανοίξτε την υποδοχή με το εισιτήριο μοναδικής χρήσης
const ws = new WebSocket(`wss://api.smartmoneyapi.com/v1/ws/live-swaps?ticket=${ticket}`);
ws.onmessage = e => {
const swap = JSON.parse(e.data);
if (swap.type === "swap") console.log(swap);
};
Πιστοποίηση WebSocket (εισιτήρια)
Γιατί: ποτέ μην βάζετε το κλειδί API σας σε μια διεύθυνση URL WebSocket — οι συμβολοσειρές ερωτημάτων καταγράφονται από τους διαμεσολαβητές, τους εξισορροπητές φόρτου και αποθηκεύονται στο ιστορικό του προγράμματος περιήγησης. Αντίθετα, ανταλλάξτε το κλειδί σας για ένα βραχύβιο, μοναδικής χρήσης εισιτήριο μέσω μιας κανονικής πιστοποιημένης POST, στη συνέχεια συνδεθείτε με αυτό το εισιτήριο.
Ροή: POST σε /v1/ws/ticket με την X-API-Key κεφαλίδα → λάβετε { "ticket": "…", "expires_in": 60 }. Στη συνέχεια ανοίξτε wss://api.smartmoneyapi.com/v1/ws/live-swaps?ticket=<ticket>. Το εισιτήριο είναι μονόχρηστο και λήγει σε ~60 δευτερόλεπτα. Οι πελάτες που μπορούν να ορίσουν κεφαλίδες αιτήματος μπορούν αντίθετα να περάσουν X-API-Key απευθείας στο WebSocket handshake — δεν απαιτείται εισιτήριο.
Δημιουργεί ένα εφάπαξ εισιτήριο για μια πιστοποιημένη WebSocket handshake. Πιστοποιήστε με την X-API-Key κεφαλίδα (το κλειδί σας δεν φεύγει ποτέ από τις κεφαλίδες αιτήματος). Το επιστραφέν εισιτήριο μπορεί να εξαργυρωθεί μία φορά στο /v1/ws/live-swaps πριν λήξει.
"https://api.smartmoneyapi.com/v1/ws/ticket"
Παράδειγμα Απάντησης
"ticket": "wst_9f3c1a8e4b2d…",
"expires_in": 60
}
Πεδία Απάντησης
| Πεδίο | Τύπος | Περιγραφή |
|---|---|---|
| ticket | string | Εφάπαξ token για προσάρτηση ως ?ticket= στο URL του WebSocket. Εξαργυρώνεται μία φορά, μετά ακυρώνεται. |
| expires_in | number | Δευτερόλεπτα μέχρι τη λήξη του εισιτηρίου (~60). Δημιουργήστε ένα νέο εισιτήριο για κάθε προσπάθεια σύνδεσης. |
Σημείωση: το παλαιό ?key= query-param authentication είναι δεν γίνεται πλέον αποδεκτό στα WebSocket endpoints για λόγους ασφαλείας. Χρησιμοποιήστε ένα εισιτήριο (πελάτες browser) ή την X-API-Key κεφαλίδα handshake (πελάτες server-side).
REST Snapshot
Επιστρέφει τα τελευταία N broadcast swaps από τον rolling buffer. Χρήσιμο για πρώτη εμφάνιση σε dashboards πριν ανοίξει η σύνδεση ροής. Διαθέσιμο επίσης: /v1/live-swaps/status για στατιστικά broadcaster.
Σχήμα Συμβάντος
| Πεδίο | Τύπος | Περιγραφή |
|---|---|---|
| chain | string | bsc ή avalanche |
| dex | string | Όνομα δρομολογητή (π.χ. pancakeswap_v2, traderjoe) ή unknown_dex |
| swapper | string | Πλήρης διεύθυνση 0x του πορτοφολιού που εκτέλεσε το swap |
| swapper_short | string | Συντομευμένη μορφή για εμφάνιση (π.χ. 0xb300…028d) |
| swapper_url | string | Απευθείας σύνδεση στον swapper στον block explorer της αλυσίδας |
| tx_hash | string | Hash συναλλαγής |
| explorer_url | string | Απευθείας σύνδεση στη συναλλαγή στο BscScan / Snowtrace |
| token_in | string | Σύμβολο του token που πωλήθηκε (π.χ. USDT) |
| token_out | string | Σύμβολο του token που αγοράστηκε |
| amount_usd | number | Αξία του swap σε USD (ελάχιστο: $500) |
| pair | string | Μορφοποιημένη ετικέτα ζεύγους (π.χ. USDT → USDC) |
| block | number | Αριθμός μπλοκ όπου έγινε το swap |
| timestamp | number | Unix epoch δευτερόλεπτα |
| significance | string | low / medium / high / critical βασισμένο σε μέγεθος USD |
| seq | number | Μονοτονικός αριθμός ακολουθίας broadcast — χρησιμοποιήστε για ανίχνευση κενών |
POST /alerts/conditions
Δημιουργήστε προσαρμοσμένους κανόνες ειδοποιήσεων που ενεργοποιούνται όταν ένα καθορισμένο μετρικό διασχίσει ένα όριο. Οι ειδοποιήσεις παραδίδονται μέσω webhook, email ή του feed ειδοποιήσεων του dashboard ανάλογα με τις προτιμήσεις σας.
Επιστρέφει μια λίστα με όλους τους ρυθμισμένους κανόνες ειδοποιήσεων με τα IDs, τους ορισμούς και την τρέχουσα κατάστασή τους.
Αφαιρεί μόνιμα έναν κανόνα ειδοποίησης με βάση το ID του.
Επιστρέφει πρόσφατα συμβάντα ενεργοποίησης ειδοποιήσεων με χρονικές σημάνσεις, αντιστοιχισμένους κανόνες και την τιμή του μετρικού κατά τη στιγμή της ενεργοποίησης.
Δημιουργία Ειδοποίησης — Σώμα Αιτήματος
| Πεδίο | Τύπος | Περιγραφή |
|---|---|---|
| namerequired | string | Επιγραφή αναγνώσιμη από ανθρώπους για αυτό το alert (μέχρι 64 χαρακτήρες) |
| metricrequired | string | Το μετρικό προς παρακολούθηση. Δείτε τον πίνακα διαθέσιμων μετρικών παρακάτω. |
| symboloptional | string | Πλαίσιο περιουσιακού στοιχείου. Απαιτείται για μετρικά με εμβέλεια σύμβολου όπως funding_rate. |
| operatorrequired | string | Τελεστής σύγκρισης: gt, lt, eq, crosses_above, crosses_below |
| thresholdrequired | float | Αριθμητική τιμή προς σύγκριση με το μετρικό |
| deliveryoptional | string | Κανάλι παράδοσης, π.χ. telegram (default) ή webhook |
| cooldown_minutesoptional | integer | Ελάχιστα λεπτά μεταξύ επανενεργοποιήσεων (προεπιλογή 60) |
Η ζωντανή λίστα των έγκυρων μετρικών και τελεστών επιστρέφεται από GET /v1/alerts/conditions ως available_metrics και available_operators.
Διαθέσιμα Μετρικά
| Μετρικό | Περιγραφή |
|---|---|
| funding_rate | Τρέχουσα τιμή χρηματοδότησης για το σύμβολο (ως δεκαδικό) |
| global_lsr | Παγκόσμιος λόγος long/short για το σύμβολο |
| long_pct | Ποσοστό λογαριασμών net long για το σύμβολο |
| top_trader_lsr | Λόγος long/short κορυφαίων επενδυτών για το σύμβολο |
| taker_ratio | Λόγος αγοράς/πώλησης taker για το σύμβολο |
| mvrv | Λόγος Αγοραίας Αξίας προς Επιτευχθείσα Αξία (BTC/ETH) |
| sopr | Λόγος Κέρδους Εξόδων που Δαπανήθηκαν (BTC/ETH) |
| exchange_net_flow | Σήμα καθαρής ροής on-chain ανταλλαγών |
| accumulation | Σήμα συσσώρευσης on-chain |
| whale_long_pct | Ποσοστό παρακολουθούμενων πορτοφολιών whale που κρατούν long θέσεις για το σύμβολο |
| whale_n_wallets | Αριθμός παρακολουθούμενων πορτοφολιών whale με θέση στο σύμβολο |
| composite_long | Σύνθετη βαθμολογία για το σύμβολο που ερωτήθηκε σε long κατεύθυνση |
| composite_short | Σύνθετη βαθμολογία για το σύμβολο που ερωτήθηκε σε short κατεύθυνση |
| funding_spread | Διαφορά χρηματοδότησης μεταξύ πλατφορμών για το σύμβολο |
"name": "BTC funding rate spike",
"metric": "funding_rate",
"symbol": "BTC",
"operator": "gt",
"threshold": 0.05
}
GET /kelly
Επιστρέφει συστάσεις μεγέθους θέσης Kelly Criterion βασισμένες στην ιστορική απόδοση σήματος για το δοθέν σύμβολο, επίπεδο εμπιστοσύνης και κατεύθυνση. Βασίζει το μέγεθος θέσης σε εμπειρικά ποσοστά νίκης για να αποφευχθεί η υπερβολική μόχλευση.
Παράμετροι
| Παράμετρος | Τύπος | Περιγραφή |
|---|---|---|
| symbolrequired | string | Σύμβολο περιουσιακού στοιχείου: BTC, ETH, ή SOL |
| confidenceoptional | string | Επίπεδο εμπιστοσύνης σήματος προς μοντελοποίηση: HIGH, MEDIUM, ή LOW. Προεπιλογή: HIGH |
| directionoptional | string | Κατεύθυνση συναλλαγής: long ή short. Προεπιλογή: long |
| account_sizeoptional | float | Μέγεθος λογαριασμού σε USD για υπολογισμό suggested_size_usd. Προεπιλογή: 10000 |
Παράδειγμα Απάντησης
"symbol": "BTC",
"confidence": "HIGH",
"direction": "long",
"win_rate": 0.68,
"avg_reward_risk_ratio": 2.1,
"kelly_fraction": 0.36,
"half_kelly": 0.18,
"suggested_size_usd": 1800,
"samples": 142,
"note": "Η Half-Kelly συνιστάται για ζωντανές συναλλαγές για να ληφθεί υπόψη το σφάλμα εκτίμησης."
}
GET /performance
Επιστρέφει ιστορικά στατιστικά ακρίβειας για σήματα που εκδίδονται από το API, αναλυτικά ανά επίπεδο εμπιστοσύνης. Χρήσιμο για την κατανόηση της αξιοπιστίας των σημάτων πριν από τη δέσμευση κεφαλαίου.
Παράμετροι
| Παράμετρος | Τύπος | Περιγραφή |
|---|---|---|
| symboloptional | string | Φιλτράρισμα ανά περιουσιακό στοιχείο. Παραλείψτε για συγκεντρωτικά στατιστικά σε όλα τα σύμβολα. |
| daysoptional | integer | Παράθυρο αναζήτησης σε ημέρες. Προεπιλογή: 30 |
Παράδειγμα Απάντησης
"symbol": "BTC",
"period_days": 30,
"by_confidence": {
"HIGH": { "win_rate": 0.71, "samples": 58, "avg_return_pct": 3.4 },
"MEDIUM": { "win_rate": 0.54, "samples": 84, "avg_return_pct": 1.2 }
}
}
Στατιστικά & Σήματα
GET /v1/stats
Στατιστικά ειλικρινούς απόδοσης σε όλη την ιστοσελίδα που προέρχονται από smart_money_confirm διακριτά αποτελέσματα κλήσης. Επιστρέφει ποσοστά νίκης στα επίπεδα υψηλής και μέσης εμπιστοσύνης, συνολική ακρίβεια, παράγοντα κέρδους και ανάλυση ανά σύμβολο. Όλα τα στοιχεία είναι εντός δείγματος κατά το παράθυρο βαθμολόγησης· συμβουλευτείτε το calibration.html για πληροφορίες και μεθοδολογία προοπτικής δοκιμής.
Παράδειγμα Απάντησης
"high_winrate": 0.714,
"high_winrate_n": 14,
"medium_winrate": 0.530,
"medium_winrate_n": 34,
"overall_accuracy": 0.613,
"overall_accuracy_n": 48,
"profit_factor": 1.77,
"avg_win_pct": 4.2,
"winrate_horizon": "24h",
"winrate_basis": "διακριτές κλήσεις επιβεβαίωσης, αποτελέσματα που επιλύθηκαν σε 24h",
"winrate_by_symbol": {
"BTC": { "win_rate": 0.68, "n": 22 },
"ETH": { "win_rate": 0.55, "n": 18 },
"SOL": { "win_rate": 0.60, "n": 8 }
},
"forward_holdout": {
"win_rate": 0.59,
"high_win_rate": 0.70,
"high_n": 10,
"is_distinct_from_insample": false
}
}
forward_holdout αντικείμενο είναι ο μόνος αριθμός που συγκεντρώνεται σε δεδομένα που ο βαθμολογητής δεν έχει δει ποτέ — παρακολουθήστε να μεγαλώνει με το χρόνο. Δείτε το calibration.html για την πλήρη μεθοδολογία και το όριο εντός δείγματος / προοπτικής δοκιμής.GET /v1/signals/performance
Παρακολούθηση αποτελεσμάτων σήματος σε πολλαπλούς ορίζοντες ανάλυσης (4h, 12h, 24h, 72h). Επιστρέφει ποσοστά επιτυχίας ανά ορίζοντα, συνολικό αριθμό σημάτων και ανάλυση ανά τύπο σήματος.
Παράμετροι
| Παράμετρος | Τύπος | Περιγραφή |
|---|---|---|
| daysoptional | integer | Παράθυρο αναζήτησης σε ημέρες. Προεπιλογή: 30 |
| signal_typeoptional | string | Φιλτράρισμα ανά τύπο, π.χ. smart_money_confirm or regime_flip. Παραλείψτε για όλους τους τύπους. |
| symboloptional | string | Φιλτράρισμα ανά σύμβολο περιουσιακού στοιχείου, π.χ. BTC. Παραλείψτε για συγκεντρωτικά σε όλα τα σύμβολα. |
Παράδειγμα Απάντησης
"signal_type": "smart_money_confirm",
"symbol": "BTC",
"days": 30,
"total_signals": 48,
ορίζοντες: {
4h: { ποσοστό επιτυχίας: 0.65, επιλυμένα: 46 },
12h: { ποσοστό επιτυχίας: 0.61, επιλυμένα: 44 },
24h: { ποσοστό επιτυχίας: 0.58, επιλυμένα: 40 },
72h: { ποσοστό επιτυχίας: 0.54, επιλυμένα: 32 }
},
ανάλυση τύπου: {
επιβεβαίωση έξυπνων χρημάτων: { πλήθος: 35, ποσοστό επιτυχίας_24h: 0.61 },
αλλαγή καθεστώτος: { πλήθος: 13, ποσοστό επιτυχίας_24h: 0.47 }
}
}
GET /v1/signals/recent
Ροή πρόσφατα δημοσιευμένων σημάτων HIGH και MEDIUM σε όλα τα παρακολουθούμενα σύμβολα. Κάθε εγγραφή περιλαμβάνει τον τύπο σήματος, το επίπεδο εμπιστοσύνης, την κατεύθυνση και την κατάσταση επίλυσης όπου είναι διαθέσιμη.
Παράδειγμα Απάντησης
signals: [
{
id: 1042,
symbol: BTC,
direction: long,
signal_type: smart_money_confirm,
confidence: HIGH,
composite: 0.74,
ts: 1710940821,
resolved: true,
outcome_24h: win
}
],
count: 50
}
GET /v1/signals/{id}/outcome
Επιλυμένο αποτέλεσμα για ένα μόνο σήμα με βάση το αριθμητικό του ID. Επιστρέφει επιτυχία/αποτυχία σε κάθε ορίζοντα επίλυσης (4h, 12h, 24h, 72h) μαζί με την τιμή κατά τη στιγμή του σήματος και την επίλυση.
Παράμετροι
| Παράμετρος | Τύπος | Περιγραφή |
|---|---|---|
| idαπαιτείται | ακέραιος | ID σήματος (τμήμα διαδρομής), π.χ. /v1/signals/1042/outcome |
Παράδειγμα Απάντησης
id: 1042,
symbol: BTC,
direction: long,
confidence: HIGH,
entry_price: 63200.0,
ts: 1710940821,
outcomes: {
4h: { result: win, price: 64100.0, pct: 1.41 },
12h: { result: win, price: 65200.0, pct: 3.16 },
24h: { result: win, price: 65800.0, pct: 4.11 },
72h: { result: pending, price: null, pct: null }
}
}
GET /v1/confirm-winrate
Ανάλυση ποσοστού επιτυχίας σημάτων επιβεβαίωσης για το δικό σας κλειδί API. Επιστρέφει ποσοστά επιτυχίας διακριτών κλήσεων σε κάθε επίπεδο εμπιστοσύνης, παράγοντα κέρδους και στοιχεία ανά σύμβολο. Απαιτεί έγκυρο X-API-Key header.
Παράδειγμα Αίτησης
"https://api.smartmoneyapi.com/v1/confirm-winrate"
Παράδειγμα Απάντησης
high_winrate: 0.714,
high_n: 14,
medium_winrate: 0.530,
μέσος όρος: 34,
συνολική ακρίβεια: 0.613,
συνολικός αριθμός: 48,
παράγοντας κέρδους: 1.77,
ποσοστό νίκης ανά ορίζοντα: 24h,
ανά σύμβολο: {
BTC: { ποσοστό νίκης: 0.68, αριθμός: 22 },
ETH: { ποσοστό νίκης: 0.55, αριθμός: 18 }
}
}
Shadow Gate
Ένα άθικτο, προσθετικό ημερολόγιο προσωπικών αποφάσεων. Υποβάλετε τις αποφάσεις συναλλαγών πριν ή μετά την εκτέλεσή τους· το σύστημα υπολογίζει ένα σκορ επιβεβαίωσης έναντι της μηχανής Smart Money και προσθέτει μια μόνιμη εγγραφή. Χρησιμοποιήστε το για να δημιουργήσετε μια ειλικρινή, χρονοσφραγισμένη καταγραφή του πόσο καλά το σήμα του API ευθυγραμμίστηκε με τις δικές σας εισόδους — εντελώς ανεξάρτητη από το παγκόσμιο pool ποσοστού νίκης. Οι απαντήσεις των επιπέδων Δωρεάν και Trader έχουν αφαιρεμένα τα πεδία αποδεικτικών στοιχείων· το Pro επιστρέφει την πλήρη ανάλυση. Ισχύει μια καθυστέρηση επιπέδου για τα δεδομένα του επιπέδου Δωρεάν.
Υποβολή μιας απόφασης. Είναι αμετάβλητο στην Idempotency-Key κεφαλίδα αίτησης — η επανυποβολή του ίδιου κλειδιού επιστρέφει την υπάρχουσα εγγραφή χωρίς να δημιουργεί διπλότυπο. Το σύστημα καλεί αμέσως τη μηχανή επιβεβαίωσης και προσθέτει το αποτέλεσμα ως μια άθικτη εγγραφή ημερολογίου.
Σώμα Αίτησης
| Πεδίο | Τύπος | Περιγραφή |
|---|---|---|
| symbolαπαιτείται | string | Σύμβολο περιουσιακού στοιχείου, π.χ. BTC |
| sideαπαιτείται | string | Κατεύθυνση συναλλαγής: long ή short |
| strategy_idπροαιρετικό | string | Ετικέτα στρατηγικής που ορίζεται από τον καλούντα (μέγιστο 64 χαρακτήρες). Αποθηκεύεται ως έχει για ομαδοποίηση και φιλτράρισμα. |
Παράδειγμα Αίτησης
-H "X-API-Key: sm_your_key" \
-H "Idempotency-Key: my-signal-20260701-001" \
-H "Content-Type: application/json" \
-d '{"symbol":"BTC","side":"long","strategy_id":"ema_crossover"}' \
"https://api.smartmoneyapi.com/v1/shadow-gate/decisions"
Παράδειγμα Απάντησης
"id": 318,
"symbol": "BTC",
"side": "long",
"strategy_id": "ema_crossover",
"decision": "CONFIRM",
"confidence": "HIGH",
"composite": 0.74,
"size_mult": 1.5,
"ts": 1710940821,
"resolved": false
}
factors / adjustments πεδία αποδεικτικών στοιχείων. Το Pro επιστρέφει την πλήρη ανάλυση επιβεβαίωσης. Ισχύει μια καθυστέρηση επιπέδου για το Δωρεάν — η εγγραφή γράφεται αμέσως αλλά το σκορ επιβεβαίωσης μπορεί να αντικατοπτρίζει προσωρινά δεδομένα έως και 60 δευτερόλεπτα παλιά.Λίστα των δικών σας αποφάσεων shadow-gate, από τις νεότερες προς τις παλαιότερες. Περιορίζεται στον κάτοχο — επιστρέφονται μόνο οι αποφάσεις που υποβλήθηκαν από το κλειδί API σας.
Παράμετροι
| Παράμετρος | Τύπος | Περιγραφή |
|---|---|---|
| limitπροαιρετικό | integer | Μέγιστος αριθμός εγγραφών προς επιστροφή. Προεπιλογή: 50, μέγιστο: 200 |
| cursorπροαιρετικό | string | Αδιαφανές δρομέα σελιδοποίησης από το πεδίο next_cursor μιας προηγούμενης απάντησης. Παραλείψτε για την πρώτη σελίδα. |
Παράδειγμα Απάντησης
"decisions": [
{ "id": 318, "symbol": "BTC", "side": "long", "decision": "CONFIRM", "confidence": "HIGH", "composite": 0.74, "size_mult": 1.5, "ts": 1710940821, "resolved": false },
{ "id": 317, "symbol": "ETH", "side": short, απόφαση: SKIP, βεβαιότητα: LOW, σύνθετο: -0.12, size_mult: 0.0, ts: 1710937000, επιλυμένο: True }
],
πλήθος: 2,
next_cursor: None
}
Μία απόφαση με βάση το ID, συμπεριλαμβανομένων όλων των στοιχείων επιβεβαίωσης για το επίπεδο Pro. Οι απαντήσεις για τα επίπεδα Free και Trader έχουν factors και adjustments αφαιρεμένα. Επιστρέφει 403 αν η απόφαση ανήκει σε διαφορετικό κλειδί API.
Παράδειγμα Απάντησης (Pro)
id: 318,
symbol: BTC,
side: long,
strategy_id: ema_crossover,
απόφαση: CONFIRM,
βεβαιότητα: HIGH,
σύνθετο: 0.74,
size_mult: 1.5,
παράγοντες: {
παράγωγα: { score: 0.81, weight: 0.40, weighted: 0.324 },
onchain: { score: 0.68, weight: 0.35, weighted: 0.238 },
whale: { score: 0.73, weight: 0.25, weighted: 0.183 }
},
ts: 1710940821,
επιλυμένο: False,
αποτέλεσμα: None
}
Επίλυση της απόφασης χειροκίνητα. Καλέστε αυτό μετά το κλείσιμο της συναλλαγής για να καταγραφεί το τελικό αποτέλεσμα στον ιστότοπο. Μόλις επιλυθεί, η εγγραφή είναι αμετάβλητη και δεν μπορεί να αλλάξει ξανά.
Σώμα Αίτησης
| Πεδίο | Τύπος | Περιγραφή |
|---|---|---|
| αποτέλεσμαrequired | string | Αποτέλεσμα συναλλαγής: win ή loss |
| exit_priceoptional | float | Τιμή εξόδου για τη συναλλαγή. Αποθηκεύεται για αναφορά· χρησιμοποιείται για τον υπολογισμό του P&L % εάν παρέχεται. |
| pnl_pctoptional | float | Πραγματοποιημένο κέρδος ή ζημία ως ποσοστό του μεγέθους θέσης, π.χ. 3.5 ή -1.2 |
Παράδειγμα Απάντησης
id: 318,
επιλυμένο: True,
αποτέλεσμα: win,
exit_price: 65800.0,
pnl_pct: 4.1,
resolved_at: 1711027200
}
Κωδικοί Σφαλμάτων
| Κατάσταση | Κωδικός | Περιγραφή |
|---|---|---|
| 400 | invalid_params | Λείπουν ή είναι άκυρες παράμετροι ερωτήματος |
| 401 | unauthorized | Λείπει ή είναι άκυρο το κλειδί API |
| 403 | plan_restriction | Το endpoint δεν είναι διαθέσιμο στο τρέχον πλάνο σας |
| 429 | rate_limit_exceeded | Έχετε φτάσει το ημερήσιο όριο ή το όριο ανά διαστήματα |
| 500 | internal_error | Σφάλμα διακομιστή — ελέγξτε το /health για την κατάσταση της πηγής |
| 503 | data_stale | Η πηγή δεδομένων δεν είναι διαθέσιμη· επιστρέφονται τα τελευταία γνωστά δεδομένα |
Παραδείγματα Κώδικα
Python
r = requests.get(
"https://api.smartmoneyapi.com/v1/confirm",
params={"symbol": "BTC", "direction": "long"},
headers={X-API-Key: sm_your_key}
)
data = r.json()
print(data["confidence"]) # HIGH / MEDIUM
print(data["size_mult"]) # 1.5 / 1.0
API_KEY = "sm_your_key"
BASE_URL = "https://api.smartmoneyapi.com/v1"
def confirm_trade(symbol, direction):
resp = requests.get(
f"{BASE_URL}/confirm",
params={"symbol": symbol, "direction": direction},
headers={"X-API-Key": API_KEY},
timeout=5
)
resp.raise_for_status()
return resp.json()
# Στον βρόχο συναλλαγών:
signal = confirm_trade("BTC", "long")
if signal["confidence"] not in ["HIGH", "MEDIUM"]:
print("Παράλειψη — ανεπαρκής βεβαιότητα")
else:
size = base_size * signal["size_mult"]
place_order(symbol, direction, size)
JavaScript / Node.js
async function confirmTrade(symbol, direction) {
const params = new URLSearchParams({ symbol, direction });
const res = await fetch(
`https://api.smartmoneyapi.com/v1/confirm?${params}`,
{ headers: { 'X-API-Key': API_KEY } }
);
if (!res.ok) throw new Error(`Σφάλμα API: ${res.status}`);
return res.json();
}
// Χρήση
confirmTrade('BTC', 'long')..then(data => {
console.log(data.confidence, data.size_mult);
});
cURL
curl -X GET \
-H "X-API-Key: sm_your_key" \
"https://api.smartmoneyapi.com/v1/confirm?symbol=BTC&direction=long"
# Λήψη δεδομένων φαλαινών
curl -X GET \
-H "X-API-Key: sm_your_key" \
"https://api.smartmoneyapi.com/v1/whales?symbol=BTC"
# Έλεγχος χρήσης
curl -X GET \
-H X-API-Key: sm_your_key \
https://api.smartmoneyapi.com/v1/usage
Ενσωμάτωση Freqtrade
Προσθέστε επιβεβαίωση Smart Money σε οποιαδήποτε στρατηγική Freqtrade παρακάμπτοντας τη confirm_trade_entry μέθοδο.
from freqtrade.strategy import IStrategy
class SmartMoneyStrategy(IStrategy):
SM_API_KEY = "sm_your_key"
SM_BASE = "https://api.smartmoneyapi.com/v1"
def confirm_trade_entry(self, pair, order_type,
amount, rate, time_in_force,
current_time, entry_tag, **kwargs):
symbol = pair.split("/")[0]
if symbol not in ["BTC", "ETH", "SOL"]:
return True # Παράλειψη ελέγχου για μη υποστηριζόμενα
try:
r = requests.get(
f"{self.SM_BASE}/confirm",
params={"symbol": symbol, "direction": "long"},
headers={"X-API-Key": self.SM_API_KEY},
timeout=3
).json()
return r.get("confidence") in ["HIGH", "MEDIUM"]
except:
return True # Αποτυχία ανοίγματος σε σφάλμα API
CCXT + Smart Money
exchange = ccxt.bybit({
"apiKey": "YOUR_BYBIT_KEY",
"secret": "YOUR_BYBIT_SECRET"
})
SM_KEY = "sm_your_key"
def smart_trade(symbol, side, amount):
# Έλεγχος επιβεβαίωσης πρώτα
conf = requests.get(
"https://api.smartmoneyapi.com/v1/confirm",
params={"symbol": symbol, "direction": side},
headers={"X-API-Key": SM_KEY}
).json()
if conf["confidence"] not in ["HIGH", "MEDIUM"]:
print(f"Παράλειψη {symbol} {side} — ανεπαρκής εμπιστοσύνη.")
return None
adj_amount = amount * conf["size_mult"]
order = exchange.create_market_order(
f"{symbol}/USDT", side, adj_amount
)
print(f"Η εντολή τοποθετήθηκε: {adj_amount} {symbol} {side}")
return order
Ελέγξτε τη σελίδα κατάστασης API για πληροφορίες υγείας σε πραγματικό χρόνο ή χρησιμοποιήστε την φόρμα επικοινωνίας.