Ghid de integrare
Confirmă intrările pe Bybit perpetuals cu Smart Money API
Citește datele live ale pieței swap Bybit cu CCXT, întreabă Smart Money API dacă fluxul de balene și poziționarea derivatelor confirmă direcția ta, apoi plasează intrarea pe perpetuals — dimensionată de multiplicatorul sugerat.
Pentru cine este acest ghid
Dezvoltatori Python care rulează un bot Bybit USDT-perpetuals pe CCXT care doresc o verificare independentă a contextului pieței înainte de fiecare intrare. Smart Money API este un suport pentru decizii — nu plasează comenzi pentru tine; codul tău CCXT rămâne în controlul execuției și al riscului.
Cerințe preliminare
- Python 3.9+ cu
pip install ccxt requests. - Chei API Bybit configurate pentru CCXT (doar citire este suficient pentru testare).
- O cheie API Smart Money API (nivelul gratuit acoperă BTC).
Obține cheia ta API
Fiecare cerere se autentifică cu X-API-Key header. Pentru a obține o cheie:
- 1Creează un cont gratuit, apoi deschide panoul de control.
- 2Copiază cheia API afișată sub Acces API. Nivelul gratuit acoperă BTC cu 20 de cereri/zi — suficient pentru a testa acest ghid de la cap la coadă.
- 3Ai nevoie de mai multe simboluri sau limite mai mari? Compară nivelurile pe pagina de prețuri.
Păstrează cheia secretă — stochează-o într-o variabilă de mediu, nu o comite niciodată în controlul surselor.
Configurare
- 1Instalează bibliotecile:
pip install ccxt requests. - 2Exportă cheia ta:
export SMA_API_KEY="sm_your_key_here". - 3Deschide swap-uri Bybit cu CCXT (
ccxt.bybit({"options":{"defaultType":"swap"}})), lasă strategia ta să aleagă o direcție candidată, apoi apelează/v1/confirmca o poartă finală de context. - 4Plasează intrarea pe perpetuals cu CCXT doar când acțiunea este
CONFIRM, dimensionând dupăsize_mult.
Exemplu funcțional
Acest script citește un ticker swap Bybit cu CCXT, derivă o direcție candidată, apoi apelează GET /v1/confirm?symbol=BTC&direction=long înainte de a decide dacă să plaseze intrarea.
import os
import ccxt
import requests
API_KEY = os.environ["SMA_API_KEY"] # never hard-code
SMA_BASE = "https://api.smartmoneyapi.com"
exchange = ccxt.bybit({"options": {"defaultType": "swap"}}) # Bybit perpetuals
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": "bybit-bot"},
headers={"X-API-Key": API_KEY},
timeout=10,
)
r.raise_for_status()
return r.json()
# 1. Read Bybit swap market data with CCXT and pick a candidate direction
ticker = exchange.fetch_ticker("BTC/USDT: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:USDT", "market", direction, qty)
print(f"Would place {direction} {qty} BTC/USDT:USDT perp")
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")
Răspuns așteptat
Un apel reușit către /v1/confirm returnează JSON de genul:
{
"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 variază de la -1.0 (contra puternic) la +1.0 (confirmare puternică), confidence este HIGH sau MEDIUM, și size_mult este un multiplicator de dimensiune sugerat 0.0–1.5. Vezi referința completă a câmpurilor în documentația API.
Cum să acționezi pe baza răspunsului
CONFIRM
Contextul susține direcția ta. Continuă cu propriile reguli de intrare și risc, eventual scalând dimensiunea după size_mult.
REDUCE
Semnalul este mixt. Ia în considerare o poziție mai mică, stopuri mai strânse sau așteaptă un setup mai clar.
SKIP
Contextul pieței nu susține această tranzacție. Stai deoparte și verifică din nou la următorul candidat.
Gata să construiești?
Ia o cheie gratuită și fă prima ta cerere de confirmare în mai puțin de un minut.
Nu este un sfat financiar. Tranzacționarea crypto implică riscuri.