API Documentation

{
  "regime": "risk_on",
  "summary": "BTC trending above VWAP. Altcoin breadth 68%. Funding neutral.",
  "btc_price": 105420.0,
  "btc_24h_pct": 1.84,
  "regime_changed_at": "2026-06-09T08:15:00Z"
}

{
  "positions": [
    {
      "symbol": "SOLUSDT",
      "name": "Solana",
      "sector": "L1",
      "side": "Buy",
      "entry_price": 179.20,
      "current_price": 183.42,
      "pnl_pct": 2.35,
      "pnl_usd": 11.75,
      "sl_pct_entry": -3.0,
      "sl_distance": -5.35,
      "sl_consumed": 56.1,
      "hold_minutes": 247,
      "xs_score": 91.2,
      "ts_score": 79.4,
      "ms_score": 88.1,
      "combined_score": 87.3,
      "entry_label": "Optimal",
      "leverage": 2
    }
  ],
  "aggregate": {
    "total_positions": 7,
    "total_pnl_usd": 48.32,
    "avg_pnl_pct": 1.94,
    "avg_hold_minutes": 310
  }
}

import httpx

API_KEY = "mb_live_XXXXXXXXXXXXXXXXXXXX"
BASE_URL = "https://api.masterbitcoin.com/v1"

headers = {"Authorization": f"Bearer {API_KEY}"}


def get_signals(min_score: float = 70.0, signal_tier: str = "strong") -> dict:
    """Fetch current scored signals."""
    resp = httpx.get(
        f"{BASE_URL}/signals",
        params={"min_score": min_score, "signal": signal_tier, "per_page": 50},
        headers=headers,
    )
    resp.raise_for_status()
    return resp.json()


def get_picks() -> dict:
    """Fetch the top 10 highest-scoring active signals."""
    resp = httpx.get(f"{BASE_URL}/picks", headers=headers)
    resp.raise_for_status()
    return resp.json()


def stream_webhook(event_payload: dict) -> None:
    """Handle incoming webhook events from MasterBitcoin."""
    event = event_payload.get("event")
    data = event_payload.get("data", {})

    if event == "signal.new":
        symbol = data["symbol"]
        score = data["combined_score"]
        print(f"New signal: {symbol} - score {score:.1f}")

    elif event == "regime.changed":
        print(f"Regime changed to: {data.get('regime')}")


if __name__ == "__main__":
    picks = get_picks()
    print(f"Regime: {picks['regime']}")
    for p in picks["picks"]:
        print(f"  {p['symbol']:12s}  score={p['combined_score']:.1f}  {p['signal']}")

const API_KEY = "mb_live_XXXXXXXXXXXXXXXXXXXX";
const BASE_URL = "https://api.masterbitcoin.com/v1";

const headers = {
  Authorization: `Bearer ${API_KEY}`,
  "Content-Type": "application/json",
};

async function getSignals({ minScore = 70, tier = "strong" } = {}) {
  const params = new URLSearchParams({
    min_score: minScore,
    signal: tier,
    per_page: 50,
  });
  const res = await fetch(`${BASE_URL}/signals?${params}`, { headers });
  if (!res.ok) throw new Error(`HTTP ${res.status}`);
  return res.json();
}

async function getPicks() {
  const res = await fetch(`${BASE_URL}/picks`, { headers });
  if (!res.ok) throw new Error(`HTTP ${res.status}`);
  return res.json();
}

async function getRegime() {
  const res = await fetch(`${BASE_URL}/regime`, { headers });
  if (!res.ok) throw new Error(`HTTP ${res.status}`);
  return res.json();
}

// Express.js webhook handler example
import express from "express";
const app = express();
app.use(express.json());

app.post("/webhook", (req, res) => {
  const { event, data } = req.body;
  if (event === "signal.new") {
    console.log(`New signal: ${data.symbol} - score ${data.combined_score}`);
  }
  res.sendStatus(200);
});

// Main
(async () => {
  const picks = await getPicks();
  console.log(`Regime: ${picks.regime}`);
  picks.picks.forEach((p) =>
    console.log(`  ${p.symbol.padEnd(12)} score=${p.combined_score.toFixed(1)}  ${p.signal}`)
  );
})();