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.