ຄູ່ມືການປະສານງານ

ໃຊ້ Smart Money API ຄຽງຄູ່ກັບ CCXT

ອ່ານຂໍ້ມູນຕະຫຼາດຕົວຈິງດ້ວຍ CCXT, ຖາມ Smart Money API ວ່າກະແສວານແລະຕໍາແຫນ່ງອະນຸພັນຢືນຢັນທິດທາງຂອງທ່ານບໍ່, ຈາກນັ້ນຈຶ່ງສັ່ງຊື້ໃນຕະຫຼາດທີ່ທ່ານເລືອກ.

ໃຜຄວນໃຊ້

ນັກພັດທະນາ Python ທີ່ກໍາລັງສ້າງບັອດທີ່ບໍ່ຂຶ້ນກັບຕະຫຼາດໃດໜຶ່ງໃນ CCXT ຜູ້ທີ່ຕ້ອງການການກວດສອບບໍລິບົດຕະຫຼາດເປັນອິດສະຫຼະກ່ອນແຕ່ລະຄໍາສັ່ງ. Smart Money API ເປັນການສະໜັບສະໜູນການຕັດສິນໃຈ — ມັນບໍ່ສັ່ງຊື້ໃຫ້ທ່ານ; CCXT ຍັງຄວບຄຸມການປະຕິບັດ.

ສິ່ງທີ່ຕ້ອງການກ່ອນ

  • Python 3.9+ ພ້ອມກັບ pip install ccxt requests.
  • ກະແຈ API ຕະຫຼາດທີ່ຕັ້ງຄ່າສໍາລັບ CCXT (ອ່ານເທົ່ານັ້ນກໍ່ພໍສໍາລັບການທົດສອບ).
  • ກະແຈ Smart Money API ໜຶ່ງອັນ (ລະດັບຟຣີຄຸ້ມຄອງ BTC).

ເອົາກະແຈ API ຂອງທ່ານ

ທຸກໆຄໍາຮ້ອງຂໍຈະກວດສອບຄວາມຖືກຕ້ອງດ້ວຍ X-API-Key ຫົວຂໍ້. ເພື່ອເອົາກະແຈ:

  1. 1ສ້າງບັນຊີຟຣີ, ຈາກນັ້ນເປີດ ແຜງຄວບຄຸມ.
  2. 2ຄັດລອກກະແຈ API ທີ່ສະແດງຢູ່ໃຕ້ API Access. ລະດັບຟຣີຄຸ້ມຄອງ 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.

ຕົວຢ່າງການເຮັດວຽກ

ສະຄຣິບນີ້ອ່ານຕົວຊີ້ວັດດ້ວຍ 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

ສັນຍານປະສົມປະສານ. ພິຈາລະນາຕໍາແຫນ່ງທີ່ນ້ອຍກວ່າ, ຢຸດທີ່ແຄບກວ່າ, ຫຼືລໍຖ້າການຕັ້ງຄ່າທີ່ສະອາດກວ່າ.

SKIP

ບໍລິບົດຕະຫຼາດບໍ່ສະໜັບສະໜູນການຊື້ຂາຍນີ້. ຢຸດແລະກວດສອບອີກຄັ້ງໃນຜູ້ສົມມຸດຕໍ່ໄປ.

ພ້ອມສ້າງແລ້ວບໍ?

ເອົາກະແຈຟຣີແລະເຮັດການເອີ້ນຢືນຢັນຄັ້ງທໍາອິດພາຍໃນນາທີ.

ບໍ່ແມ່ນຄໍາແນະນໍາດ້ານການເງິນ. ການຊື້ຂາຍ crypto ມີຄວາມສ່ຽງ.