통합 가이드

Smart Money API로 Bybit 영구계약 진입 확인

CCXT로 실시간 Bybit 스왑 시장 데이터를 읽고, Smart Money API에 고래 흐름과 파생상품 포지션이 당신의 방향을 확인하는지 묻습니다. 그런 다음 제안된 승수로 크기를 조정한 영구계약 진입을 실행하세요.

대상 사용자

CCXT에서 Bybit USDT-영구계약 봇을 실행하는 Python 개발자 CCXT 각 진입 전에 독립적인 시장 상황 확인을 원하는 분들. Smart Money API는 의사 결정 지원 도구입니다. 주문을 대신 실행하지 않으며, 실행과 리스크 관리는 여전히 당신의 CCXT 코드가 제어합니다.

필수 조건

  • Python 3.9+ 및 pip install ccxt requests.
  • CCXT용으로 구성된 Bybit API 키(테스트에는 읽기 전용으로 충분합니다).
  • Smart Money API 키(무료 티어로 BTC 커버 가능).

API 키 받기

모든 요청은 다음으로 인증됩니다 X-API-Key 헤더. 키를 얻으려면:

  1. 1무료 계정을 생성한 후 대시보드.
  2. 2에 표시된 API 키를 복사하세요. API 액세스. 무료 티어는 BTC에 대해 하루 100회 요청을 제공합니다. 이 가이드를 처음부터 끝까지 테스트하기에 충분합니다.
  3. 3더 많은 심볼이나 더 높은 한도가 필요하신가요? 가격 페이지.

키를 비밀로 유지하세요. 환경 변수에 저장하고 소스 컨트롤에 커밋하지 마십시오.

설정

  1. 1라이브러리 설치: pip install ccxt requests.
  2. 2키 내보내기: export SMA_API_KEY="sm_your_key_here".
  3. 3CCXT로 Bybit 스왑 열기 (ccxt.bybit({"options":{"defaultType":"swap"}})), 전략이 후보 방향을 선택하도록 한 다음 /v1/confirm 최종 컨텍스트 게이트로 호출하세요.
  4. 4액션이 있을 때만 CCXT로 퍼페츄얼 진입을 하세요. CONFIRM, 사이징 기준 size_mult.

작동 예시

이 스크립트는 CCXT로 Bybit 스왑 티커를 읽어 후보 방향을 도출한 다음, 진입 여부를 결정하기 전에 GET /v1/confirm?symbol=BTC&direction=long 을 호출합니다.

bybit_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.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")

예상 응답

에 대한 성공적인 호출은 /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

시장 상황이 이 거래를 지지하지 않습니다. 거래를 중단하고 다음 후보를 다시 확인하세요.

구축 준비 완료?

무료 키를 받아 1분 이내에 첫 확인 호출을 진행하세요.

재무적 조언이 아닙니다. 암호화폐 거래는 위험을 수반합니다.