Gabay sa Integrasyon
Gamitin ang Smart Money API kasabay ng CCXT
Basahin ang live na market data gamit ang CCXT, tanungin ang Smart Money API kung kumpirmado ng whale flow at derivatives positioning ang iyong direksyon, pagkatapos ay ilagay ang order sa exchange na iyong pinili.
Para kanino ito
Mga Python developer na gumagawa ng exchange-agnostic bot sa CCXT na gustong may independiyenteng market-context check bago ang bawat order. Ang Smart Money API ay decision support — hindi ito naglalagay ng order para sa iyo; ang CCXT ang may kontrol sa execution.
Mga Kailangan
- Python 3.9+ na may
pip install ccxt requests. - Exchange API keys na naka-configure para sa CCXT (okay lang ang read-only para mag-test).
- Isang Smart Money API key (saklaw ng free tier ang BTC).
Kunin ang iyong API key
Bawat request ay naka-authenticate 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 matest ang gabay na ito mula simula hanggang dulo.
- 3Kailangan ng mas maraming symbols o mas mataas na limits? 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". - 3Hayaan ang iyong strategy na magdecide ng candidate direction mula sa CCXT market data, pagkatapos tawagan ang
/v1/confirmbilang final context gate. - 4Ilagay ang order gamit ang CCXT lamang kapag ang action ay
CONFIRM, sizing bysize_mult.
Working example
Ang script na ito ay nagbabasa ng ticker gamit ang CCXT, kumukuha ng candidate direction, pagkatapos tatawag sa GET /v1/confirm?symbol=BTC&direction=long bago magdecide kung ilalagay ang order.
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")
Inaasahang response
Ang successful call 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 base sa response
CONFIRM
Sinusuportahan ng context ang iyong direksyon. Magpatuloy sa iyong sariling entry at risk rules, opsyonal na i-scale ang size by size_mult.
REDUCE
Magkahalong signals. Isaalang-alang ang mas maliit na position, mas strict na stops, o paghintay para sa mas malinis na setup.
SKIP
Hindi sinusuportahan ng market context ang trade na ito. Maghintay at mag-recheck sa susunod na candidate.
Handa nang mag-build?
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.