Gabay sa Integrasyon
Kumpirmahin ang mga entry ng Bybit perpetuals gamit ang Smart Money API
Basahin ang live na swap market data ng Bybit gamit ang CCXT, tanungin ang Smart Money API kung kumpirmado ng whale flow at derivatives positioning ang iyong direksyon, pagkatapos ay ilagay ang perpetuals entry — na may sukat ayon sa iminungkahing multiplier.
Para kanino ito
Mga Python developer na nagpapatakbo ng Bybit USDT-perpetuals bot sa CCXT na gustong magkaroon ng independiyenteng pagsusuri sa konteksto ng market bago ang bawat entry. Ang Smart Money API ay suporta sa desisyon — hindi ito naglalagay ng mga order para sa iyo; ang iyong CCXT code ang may kontrol sa execution at risk.
Mga Kailangan
- Python 3.9+ na may
pip install ccxt requests. - Bybit API keys na naka-configure para sa CCXT (ang read-only ay sapat para sa pag-test).
- Isang Smart Money API key (saklaw ng free tier ang BTC).
Kunin ang iyong API key
Ang bawat request ay nagpapatunay gamit ang X-API-Key header. Para makakuha ng key:
- 1Gumawa ng libreng account, pagkatapos buksan ang iyong dashboard.
- 2Kopyahin ang API key na makikita sa ilalim ng API Access. Saklaw ng free tier ang BTC sa 200 requests/day — sapat para subukan ang gabay na ito mula simula hanggang katapusan.
- 3Kailangan ng mas maraming simbolo o mas mataas na limit? Ihambing ang mga tier sa pricing page.
Panatilihing lihim ang key — itago ito sa environment variable, huwag itong i-commit sa source control.
Setup
- 1I-install ang mga library:
pip install ccxt requests. - 2I-export ang iyong key:
export SMA_API_KEY="sm_your_key_here". - 3Buksan ang Bybit swaps gamit ang CCXT (
ccxt.bybit({"options":{"defaultType":"swap"}})), hayaan ang iyong strategy na pumili ng candidate direction, pagkatapos tawagan ang/v1/confirmbilang final context gate. - 4Ilagay ang perpetuals entry gamit ang CCXT lamang kapag ang aksyon ay
CONFIRM, sukat ayon sasize_mult.
Working example
Ang script na ito ay nagbabasa ng Bybit swap ticker gamit ang CCXT, kumukuha ng candidate direction, pagkatapos tatawag sa GET /v1/confirm?symbol=BTC&direction=long bago magdesisyon kung ilalagay ang entry.
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")
Inaasahang tugon
Ang matagumpay na tawag sa /v1/confirm ay nagbabalik ng JSON na ganito:
{
"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 ay mula -1.0 (strong contra) hanggang +1.0 (strong confirm), confidence ay HIGH o MEDIUM, at size_mult ay 0.0–1.5 na iminungkahing size multiplier. Tingnan ang buong field reference sa API docs.
Paano kumilos sa tugon
CONFIRM
Ang konteksto ay sumusuporta sa iyong direksyon. Magpatuloy sa iyong sariling entry at risk rules, opsyonal na i-scale ang size ayon sa size_mult.
REDUCE
Magkahalong signal. Isaalang-alang ang mas maliit na posisyon, mas mahigpit na stops, o paghintay para sa mas malinis na setup.
SKIP
Hindi sinusuportahan ng market context ang trade na ito. Tumigil at mag-recheck sa susunod na candidate.
Handa nang magtayo?
Kumuha ng libreng key at gumawa ng iyong unang confirmation call sa ilalim ng isang minuto.
Hindi ito financial advice. Ang crypto trading ay may risk.