Open interest context as a confirmation input

import os
import requests

API_KEY = os.environ["SMA_API_KEY"]            # never hard-code
SMA_BASE = "https://api.smartmoneyapi.com"

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": "oi-bot"},
        headers={"X-API-Key": API_KEY},
        timeout=10,
    )
    r.raise_for_status()
    return r.json()

# Your strategy proposes a candidate direction
sig = confirm("BTC", "long")

# deriv_score folds OI momentum + funding + LSR into one 0-1 sub-score
deriv = sig["deriv_score"]
print("action", sig["action"], "deriv_score", deriv)
for reason in sig["reasons"]:
    print("  -", reason)                       # e.g. funding / LSR / OI notes

# Use open-interest context as a risk filter
if sig["action"] == "CONFIRM" and deriv >= 0.6:
    qty = 0.01 * sig["size_mult"]              # scale by suggested multiplier
    print(f"Derivatives support the move -> would place long {qty} BTC")
elif sig["action"] == "REDUCE":
    print("Derivatives context is mixed -> trade smaller or wait")
else:  # SKIP or weak deriv_score
    print("Open-interest context does not back this trade -> stand aside")

{
  "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"
  ]
}