REST API & WebSocket

// Wrapped: Computed, Datasaham, Holders, Macro, News, Track Record
{
  "success": true,
  "data": { ... }
}

// Bare: Signals, Market Data, Brokers, AI Agents, Network, and the rest.
// The payload object is returned directly, with no "success" wrapper.
{
  "ticker": "BBCA",
  "data": [ ... ]
}

// Error (all groups: the FastAPI shape, nested under "detail")
{
  "detail": {
    "error": "rate_limit_exceeded",
    "retry_after_seconds": 60
  }
}

import requests

API_KEY = "ba_live_xxxx_xxxx"
BASE = "https://bandaralert.com/api/v1"
headers = {"X-API-Key": API_KEY}

# 1. BASS scores. This group wraps its payload as {"data": [...], "meta": {...}}
resp = requests.get(f"{BASE}/signals/broker-accumulation", headers=headers)
signals = resp.json()["data"]

for s in signals[:5]:
    # The field is signal_confidence, not confidence.
    print(f"{s['ticker']}: BASS={s['bass_score']:.0f}, {s['signal_confidence']}")

# 2. OHLCV for BBCA (30 days) -> {"ticker", "interval", "data": [...]}
ohlcv = requests.get(f"{BASE}/data/ohlcv/BBCA?days=30", headers=headers).json()
print(f"BBCA: {len(ohlcv['data'])} data points")

# 3. Market regime. The state field is current_state, and its values are
# foreign_inflow_bull | domestic_rotation_neutral | risk_off_bear.
# Probabilities are an object, one float per state, not a single number.
regime = requests.get(f"{BASE}/signals/market-regime", headers=headers).json()
probs = regime["probabilities"]
print(f"Regime: {regime['current_state']} for {regime['days_in_state']} days")
print(f"  bull={probs['bull']:.0%} neutral={probs['neutral']:.0%} bear={probs['bear']:.0%}")