Gabay sa Integrasyon
Kumpirmahin ang mga entry sa isang Binance Futures bot
Magdagdag ng panghuling market-context gate sa iyong Binance USDⓈ-M futures bot: kumpirmahin ang direksyon gamit ang whale flow at derivatives positioning, pagkatapos ay i-size ang order ayon sa suggested multiplier.
Para kanino ito
Mga developer na nagpapatakbo ng Binance USDⓈ-M perpetual futures bot na gustong magkaroon ng independiyenteng confirmation layer bago ang bawat entry. Ang Smart Money API ay decision support — ang iyong bot ay mananatiling may buong kontrol sa order placement at risk management.
Mga Kailangan
- Python 3.9+ with
pip install ccxt requests(Saklaw ng CCXT ang Binance USDⓈ-M futures). - Binance futures API keys na may trade permission (subukan muna sa testnet).
- 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
- 1Panatilihin ang iyong existing entry logic na gumagawa ng candidate long/short signal.
- 2I-export ang iyong key:
export SMA_API_KEY="sm_your_key_here". - 3Bago ang bawat entry, tawagan ang
/v1/confirmgamit ang symbol at direksyon. - 4Buksan ang futures position lamang sa
CONFIRM, i-scale ang notional ayon sasize_mult.
Working example
Ang bot na ito ay nagkukumpirma ng long o short gamit ang GET /v1/confirm?symbol=BTC&direction=long at nagbubukas lamang ng Binance USDⓈ-M futures position kapag ang aksyon ay CONFIRM.
import os
import ccxt
import requests
API_KEY = os.environ["SMA_API_KEY"]
SMA_BASE = "https://api.smartmoneyapi.com"
binance = ccxt.binance({
"apiKey": os.environ["BINANCE_KEY"],
"secret": os.environ["BINANCE_SECRET"],
"options": {"defaultType": "future"}, # USDⓈ-M futures
})
def confirm(symbol: str, direction: str) -> dict:
r = requests.get(
f"{SMA_BASE}/v1/confirm",
params={"symbol": symbol, "direction": direction, "source": "binance-fut"},
headers={"X-API-Key": API_KEY},
timeout=10,
)
r.raise_for_status()
return r.json()
def maybe_enter(symbol: str, direction: str, base_qty: float):
sig = confirm(symbol, direction)
print(sig["symbol"], direction, "->", sig["action"], sig["confidence"])
if sig["action"] != "CONFIRM":
print("Not confirmed -> no entry") # REDUCE or SKIP
return
qty = round(base_qty * sig["size_mult"], 3) # size by multiplier
side = "buy" if direction == "long" else "sell"
# binance.create_order("BTC/USDT", "market", side, qty)
print(f"Would open {direction} {qty} BTC/USDT (futures)")
if __name__ == "__main__":
# your strategy decided it wants a long here
maybe_enter("BTC", "long", base_qty=0.02)
Inaasahang response
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 suggested size multiplier. Tingnan ang buong field reference sa API docs.
Paano kumilos sa response
CONFIRM
Sinusuportahan ng konteksto ang iyong direksyon. Buksan ang position gamit ang iyong sariling risk rules, i-scale ang notional ayon sa size_mult.
REDUCE
Magkahalo ang mga signal. Isaalang-alang ang mas maliit na position at mas mahigpit na leverage, o maghintay ng kumpirmasyon.
SKIP
Hindi sinusuportahan ng market context ang trade na ito. Maghintay at mag-recheck sa susunod na signal.
Handa nang magtayo?
Kumuha ng libreng key at gumawa ng iyong unang confirmation call sa ilalim ng isang minuto.
Hindi ito financial advice. May risk ang crypto trading.