คู่มือการอินทิเกรต

ใช้ Smart Money API ร่วมกับ CCXT

อ่านข้อมูลตลาดสดด้วย CCXT, ถาม Smart Money API ว่าโฟลว์วาฬและตำแหน่งอนุพันธ์ยืนยันทิศทางของคุณหรือไม่, จากนั้นวางออร์เดอร์บน exchange ที่คุณเลือก

เหมาะสำหรับใคร

นักพัฒนา Python ที่สร้างบอทที่ไม่ขึ้นกับ exchange บน CCXT ที่ต้องการตรวจสอบบริบทตลาดอิสระก่อนแต่ละออร์เดอร์ Smart Money API เป็นเครื่องมือสนับสนุนการตัดสินใจ — มันไม่วางออร์เดอร์ให้คุณ; CCXT ยังคงควบคุมการดำเนินการ

สิ่งที่ต้องมีก่อน

  • Python 3.9+ พร้อม pip install ccxt requests.
  • Exchange API keys ที่กำหนดค่าให้ CCXT (แบบอ่านอย่างเดียวก็ใช้ทดสอบได้)
  • คีย์ Smart Money API (ระดับฟรีครอบคลุม BTC)

รับคีย์ API ของคุณ

ทุกคำขอต้องยืนยันตัวตนด้วย X-API-Key header. เพื่อรับคีย์:

  1. 1สร้างบัญชีฟรี แล้วเปิด แดชบอร์ด.
  2. 2คัดลอกคีย์ API ที่แสดงอยู่ใต้ การเข้าถึง API. ระดับฟรีครอบคลุม BTC ที่ 20 คำขอ/วัน — เพียงพอสำหรับทดสอบคู่มือนี้ตั้งแต่ต้นจนจบ
  3. 3ต้องการสัญลักษณ์มากขึ้นหรือจำกัดที่สูงขึ้นหรือไม่? เปรียบเทียบระดับบน หน้าตารางราคา.

เก็บคีย์ไว้เป็นความลับ — จัดเก็บไว้ในตัวแปรสภาพแวดล้อม อย่าเก็บไว้ในระบบควบคุมต้นทาง

การตั้งค่า

  1. 1ติดตั้งไลบรารี: pip install ccxt requests.
  2. 2ส่งออกคีย์ของคุณ: export SMA_API_KEY="sm_your_key_here".
  3. 3ให้กลยุทธ์ของคุณตัดสินใจทิศทางที่อาจเป็นไปได้จากข้อมูลตลาด CCXT แล้วเรียกใช้ /v1/confirm เป็นเกตบริบทสุดท้าย
  4. 4ส่งคำสั่งซื้อด้วย CCXT เฉพาะเมื่อการดำเนินการคือ CONFIRM, ขนาดโดย size_mult.

ตัวอย่างการทำงาน

สคริปต์นี้จะอ่านข้อมูล ticker ด้วย CCXT หาทิศทางที่เป็นไปได้ แล้วจึงเรียกใช้ GET /v1/confirm?symbol=BTC&direction=long ก่อนตัดสินใจว่าจะวางคำสั่งซื้อหรือไม่

ccxt_confirm.py
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 แบบนี้:

200 OK · application/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.

วิธีดำเนินการตามการตอบสนอง

CONFIRM

บริบทสนับสนุนทิศทางของคุณ ดำเนินการตามกฎการเข้าและความเสี่ยงของคุณ โดยอาจปรับขนาดด้วย size_mult.

REDUCE

สัญญาณผสมกัน ลองพิจารณาตำแหน่งที่เล็กกว่า ตั้ง stop ที่แน่นขึ้น หรือรอการตั้งค่าที่ชัดเจนกว่า

SKIP

บริบทตลาดไม่สนับสนุนการเทรดนี้ รอและตรวจสอบอีกครั้งในโอกาสถัดไป

พร้อมที่จะสร้างแล้วหรือยัง?

รับคีย์ฟรีและทำการเรียกยืนยันครั้งแรกของคุณในไม่ถึงนาที

ไม่ใช่คำแนะนำทางการเงิน การเทรดคริปโตมีความเสี่ยง