WebSocket

Real-time signal push over WebSocket. Receive events the moment they happen instead of polling.

---

Connection

wss://bv7x.ai/ws/signal

Authentication: Basic tier (500M+ $BV7X). Pass the bearer token as a query parameter:

wss://bv7x.ai/ws/signal?token=eyJhbGci...

---

Event Types

Event	Description	Frequency
signal.new	New daily signal computed	Once daily (~21:35 UTC)
signal.resolved	A pending prediction resolved (WIN/LOSS)	As outcomes settle
wager.placed	Polymarket wager executed	Once daily (~21:42 UTC)
wager.settled	A Polymarket wager settled	As markets resolve
attestation.created	New on-chain attestation written	Once daily (~21:38 UTC)
regime.changed	Market regime changed	When regime transitions

---

Message Format

All messages are JSON with this structure:

{
  "type": "signal.new",
  "data": { ... },
  "timestamp": "2026-03-28T21:35:00Z"
}

signal.new

{
  "type": "signal.new",
  "data": {
    "signal": "SELL",
    "confidence": 0.615,
    "direction": "DOWN",
    "btcPrice": 66027,
    "regime": "BEAR_TREND",
    "horizon": "7d"
  },
  "timestamp": "2026-03-28T21:35:00Z"
}

signal.resolved

{
  "type": "signal.resolved",
  "data": {
    "date": "2026-03-21",
    "direction": "UP",
    "outcome": "WIN",
    "btcAtSignal": 64500,
    "btcAtResolution": 67200
  },
  "timestamp": "2026-03-28T14:15:00Z"
}

wager.placed

{
  "type": "wager.placed",
  "data": {
    "market": "Will BTC be above $66,000 on April 4?",
    "side": "NO",
    "amount": 1.0,
    "odds": 0.42
  },
  "timestamp": "2026-03-28T21:42:00Z"
}

regime.changed

{
  "type": "regime.changed",
  "data": {
    "from": "CHOP",
    "to": "BEAR_TREND",
    "timestamp": "2026-03-28T21:35:00Z"
  },
  "timestamp": "2026-03-28T21:35:00Z"
}

---

JavaScript Example

const ws = new WebSocket("wss://bv7x.ai/ws/signal?token=eyJhbGci...");

ws.onopen = () => {
  console.log("Connected to BV-7X signal feed");
};

ws.onmessage = (event) => {
  const msg = JSON.parse(event.data);
  switch (msg.type) {
    case "signal.new":
      console.log(`New signal: ${msg.data.signal} (${msg.data.confidence})`);
      break;
    case "signal.resolved":
      console.log(`Resolved: ${msg.data.date} -> ${msg.data.outcome}`);
      break;
    case "regime.changed":
      console.log(`Regime: ${msg.data.from} -> ${msg.data.to}`);
      break;
  }
};

ws.onclose = () => {
  console.log("Disconnected -- reconnect after a short delay");
};

---

Connection Notes

• The server sends a ping frame every 30 seconds. Respond with pong to keep the connection alive.

• If the connection drops, wait 5 seconds before reconnecting.

• The token is validated on connection. If it expires mid-session, the connection will close with code 4001.

• Connection limits apply per wallet address to prevent abuse.

---

Next

• Webhooks -- push delivery for server-side integrations

• Copy-Trade API -- structured trade intent