Step 1 — Choose an Endpoint
Signal endpoints are public. You can call them directly without an API key.
Current request tiers are:
| Tier | Rate Limit | Use Case |
|---|---|---|
free | 120 req/min | Evaluation |
pro | 600 req/min | Production traders |
agent | 3,000 req/min | AI agents / automated systems |
Step 2 — Make Your First Request
Fetch the latest signals across all markets:
curl -X GET "https://api.agentsona.com/v1/signals/latest?limit=5"Or query Engine A for smart money activity on a specific market:
curl -X POST "https://api.agentsona.com/v1/signals/smart-money" \
-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 — Public access, API keys, and rate limits