Οδηγός Ενσωμάτωσης
Χρησιμοποιήστε το Smart Money API μαζί με το CCXT
Διαβάστε ζωντανά δεδομένα αγοράς με το CCXT, ρωτήστε το Smart Money API αν η ροή των φαλαινών και η θέση των παραγώγων επιβεβαιώνουν την κατεύθυνσή σας, και στη συνέχεια τοποθετήστε την εντολή στην ανταλλαγή της επιλογής σας.
Για ποιον είναι αυτό
Προγραμματιστές Python που δημιουργούν ανταλλαγής-αγνωστικά bot στο CCXT που θέλουν μια ανεξάρτητη επαλήθευση του πλαισίου της αγοράς πριν από κάθε εντολή. Το Smart Money API είναι υποστήριξη απόφασης — δεν τοποθετεί εντολές για εσάς· το CCXT παραμένει υπεύθυνο για την εκτέλεση.
Προαπαιτούμενα
- Python 3.9+ με
pip install ccxt requests. - Κλειδιά API ανταλλαγής ρυθμισμένα για το CCXT (μόνο για ανάγνωση είναι εντάξει για δοκιμή).
- Ένα κλειδί Smart Money API (η δωρεάν βαθμίδα καλύπτει το BTC).
Πάρτε το κλειδί API σας
Κάθε αίτημα πιστοποιείται με την X-API-Key κεφαλίδα. Για να πάρετε ένα κλειδί:
- 1Δημιουργήστε έναν δωρεάν λογαριασμό και μετά ανοίξτε το πίνακα ελέγχου.
- 2Αντιγράψτε το κλειδί API που εμφανίζεται κάτω από Πρόσβαση API. Η δωρεάν βαθμίδα καλύπτει το BTC με 20 αιτήματα/ημέρα — αρκετά για να δοκιμάσετε αυτόν τον οδηγό από την αρχή μέχρι το τέλος.
- 3Χρειάζεστε περισσότερα σύμβολα ή υψηλότερα όρια; Συγκρίνετε τις βαθμίδες στην σελίδα τιμολόγησης.
Κρατήστε το κλειδί μυστικό — αποθηκεύστε το σε μια μεταβλητή περιβάλλοντος, ποτέ μην το αποθηκεύετε στον έλεγχο πηγαίου κώδικα.
Ρύθμιση
- 1Εγκαταστήστε τις βιβλιοθήκες:
pip install ccxt requests. - 2Εξάγετε το κλειδί σας:
export SMA_API_KEY="sm_your_key_here". - 3Αφήστε τη στρατηγική σας να αποφασίσει μια υποψήφια κατεύθυνση από τα δεδομένα αγοράς του CCXT, και μετά καλέστε
/v1/confirmως τελική πύλη πλαισίου. - 4Τοποθετήστε την εντολή με το CCXT μόνο όταν η ενέργεια είναι
CONFIRM, μεγέθυνση κατάsize_mult.
Εργαζόμενο παράδειγμα
Αυτό το σενάριο διαβάζει ένα ticker με το CCXT, εξάγει μια υποψήφια κατεύθυνση, και μετά καλεί GET /v1/confirm?symbol=BTC&direction=long πριν αποφασίσει αν θα τοποθετήσει την εντολή.
import os
import ccxt
import requests
API_KEY = os.environ["SMA_API_KEY"] # never hard-code
SMA_BASE = "https://api.smartmoneyapi.com"
exchange = ccxt.binance() # any CCXT exchange
def confirm(symbol: str, direction: str) -> dict:
"""Ask Smart Money API for market-context confirmation."""
r = requests.get(
f"{SMA_BASE}/v1/confirm",
params={"symbol": symbol, "direction": direction, "source": "ccxt-bot"},
headers={"X-API-Key": API_KEY},
timeout=10,
)
r.raise_for_status()
return r.json()
# 1. Read market data with CCXT and pick a candidate direction
ticker = exchange.fetch_ticker("BTC/USDT")
direction = "long" if ticker["percentage"] and ticker["percentage"] > 0 else "short"
# 2. Confirm with Smart Money API before acting
sig = confirm("BTC", direction)
print(sig["action"], sig["confidence"], "size_mult", sig["size_mult"])
# 3. Act on the recommendation (CCXT executes; the API only advises)
if sig["action"] == "CONFIRM":
base_qty = 0.01
qty = base_qty * sig["size_mult"] # scale by suggested multiplier
# exchange.create_order("BTC/USDT", "market", direction, qty)
print(f"Would place {direction} {qty} BTC/USDT")
elif sig["action"] == "REDUCE":
print("Context is mixed -> trade smaller or wait for a cleaner setup")
else: # SKIP
print("Context does not support this trade -> stand aside")
Αναμενόμενη απάντηση
Μια επιτυχημένη κλήση στο /v1/confirm επιστρέφει JSON σαν αυτό:
{
"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": [
"Funding rate positive across all venues",
"LSR favors longs: 1.42",
"Whales: 67% long consensus",
"MVRV above 1.0 — on-chain bullish"
]
}
composite κυμαίνεται από -1.0 (ισχυρή αντίθεση) έως +1.0 (ισχυρή επιβεβαίωση), confidence είναι HIGH ή MEDIUM, και size_mult είναι ένας πολλαπλασιαστής προτεινόμενου μεγέθους 0.0–1.5. Δείτε την πλήρη αναφορά πεδίων στα έγγραφα API.
Πώς να ενεργήσετε στην απάντηση
ΕΠΙΒΕΒΑΙΩΣΗ
Το πλαίσιο υποστηρίζει την κατεύθυνσή σας. Προχωρήστε με τους δικούς σας κανόνες εισόδου και κινδύνου, προαιρετικά κλιμακώνοντας το μέγεθος κατά size_mult.
ΜΕΙΩΣΗ
Τα σήματα είναι μικτά. Σκεφτείτε μια μικρότερη θέση, πιο σφιχτά stop, ή αναμονή για μια καθαρότερη ρύθμιση.
ΠΑΡΑΛΕΙΨΗ
Το πλαίσιο της αγοράς δεν υποστηρίζει αυτήν την συναλλαγή. Μείνετε μακριά και ελέγξτε ξανά στην επόμενη υποψήφια.
Έτοιμοι να δημιουργήσετε;
Πάρτε ένα δωρεάν κλειδί και κάντε την πρώτη σας κλήση επιβεβαίωσης σε λιγότερο από ένα λεπτό.
Δεν είναι χρηματοοικονομική συμβουλή. Η συναλλαγή κρυπτονομισμάτων περιλαμβάνει κίνδυνο.