Sona

Docs
Quick Start

Quick Start

Get your first Sona Engine signal in under 2 minutes. Make your first request and understand the response.

Get a free API key (10 seconds)

Sona is in open beta.
• Pro tier free during beta (unlimited signals + full context)
• First 100 sign-ups lock in 50% off Pro for 12 months

Step 1 — Choose an Endpoint

Sona is in open beta. Get a free API key (10 seconds) using the form above to:

  • Pro tier free during beta (unlimited signals + full context)
  • First 100 sign-ups lock in 50% off Pro for 12 months

Tiers and pricing:

TierAccessPrice
Anonymous5 signals/month, basic metadataFree
Beta memberUnlimited, full contextFree during beta
ProUnlimited, full context$99/mo
Pro FoundingUnlimited, full context$49.50/mo for 12 months (first 100 only)
AgentCustomContact us

Beta usage runs on fair-use; specific rate limits are not enforced for sign-ups.

Step 2 — Make Your First Request

Fetch the latest signals across all markets, passing your API key as a Bearer token:

curl -X GET "https://api.agentsona.com/v1/signals/latest?limit=5" \
  -H "Authorization: Bearer YOUR_API_KEY"

Or query Engine A for smart money activity on a specific market:

curl -X POST "https://api.agentsona.com/v1/signals/smart-money" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "market_id": "YOUR_MARKET_ID",
    "limit": 10
  }'

Additional filters are available in the full Engine A reference.

Step 3 — Parse the Response

A Smart Money signal looks like this:

{
  "data": [
    {
      "signal_id": "3f7a1c2e-...",
      "signal_type": "SMART_MONEY_FLOW",
      "timestamp": "2026-04-01T09:03:11Z",
      "signal_expiry": "2026-04-01T15:03:11Z",
      "market": {
        "platform": "polymarket",
        "market_id": "...",
        "question": "Will X happen before May?",
        "category": "CRYPTO",
        "volume_24h": 215000,
        "market_closes_at": "2026-05-01T00:00:00Z"
      },
      "signal": {
        "flow_type": "INFLOW",
        "direction": "YES",
        "total_flow_usd": 85000,
        "price_before": 0.42,
        "price_after": 0.51,
        "time_window_sec": 7200,
        "average_entry_price": 0.44
      },
      "analysis": {
        "consensus_wallet_count": 4,
        "wallet_historical_win_rate": 0.69,
        "decay_applied": false
      }
    }
  ],
  "pagination": {
    "next_cursor": null,
    "has_more": false
  }
}

The on-demand Engine A endpoint can return more than one signal for the requested market. Pagination is included for schema consistency, but it is currently always empty for these responses.

What's Next

  • Overview — How data flows through Sona Engine
  • Engine A — Full request/response reference for Smart Money
  • Authentication — Anonymous access, beta API keys, and tier-based responses
IntroductionOverview