Docs
Overview

Overview

How Sona delivers prediction market signals through REST and WebSocket APIs.

Architecture

Sona is a prediction market signal API. It observes market and wallet activity, turns relevant activity into structured signals, and exposes those signals through REST and WebSocket endpoints.

Market activity
  ↓
Signal detection
  ↓
Structured signal payloads
  ↓
REST API / WebSocket stream

Signal Lifecycle

Signals are generated from observed market-side flow events. Each signal includes:

  • Market metadata
  • Signal direction and flow data
  • Detection timestamp
  • Supporting analysis fields

The latest-signal feed is ordered by creation time and can be paginated for older records.

Delivery

Use the REST API for request/response access:

  • GET /v1/signals/latest
  • GET /v1/signals/market/{market_id}
  • GET /v1/signals/{signal_id}
  • POST /v1/signals/smart-money

Use the WebSocket endpoint when you need a live stream of newly generated signals.

Wallet Metrics

Wallet-level metrics may appear in signal context, reports, or leaderboard views when available. These fields are informational and should be interpreted as supporting context rather than investment advice.