The Infrastructure Layer of
Prediction Markets
Real-time market data, trader intelligence, and predictive signals for developers and AI agents.
By:
Get Started
Choose how you want to access prediction market intelligence.
⚡
Direct API
curl
-X POST https://narrative.agent...
-H "Authorization: Bearer ..."
{"total_pnl": 588617.70}
curl, Python, JS — First call in <1 min
The Data Suite for Prediction Markets
Everything from raw market data to real-time intelligence, delivered through one unified API.
Historical and Real-Time Market Data
Clean, normalized data across the full market lifecycle.
- •Markets, outcomes, and metadata
- •Trades and orderbooks
- •Prices, volume, liquidity, spreads
- •Deep historical coverage for backtesting
Request
curl -X POST https://narrative.agent.heisenberg.so/v2/markets/retrieve \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"agent_id": 574,
"params": {
"market_slug": "bitcoin-up-or-down-january-17-3pm-et",
"min_volume": "100",
"closed": "True"
},
"pagination": {"limit": 100, "offset": 0},
"formatter_config": {"format_type": "raw"}
}'Response
{
"question": "Bitcoin Up or Down — January 17, 3PM ET",
"slug": "bitcoin-up-or-down-january-17-3pm-et",
"condition_id": "0xeaff81adbcd9dcd88a73a41402cb...",
"volume_total": 104456.76,
"closed": true,
"side_a_outcome": "Up",
"side_b_outcome": "Down",
"winning_outcome": "Up",
"start_date": "2026-01-15T20:01:06Z",
"end_date": "2026-01-17T21:00:00Z"
}Real-Time Aggregated Intelligence
Understand behavior, not just prices.
- •Wallet and trader performance insights
- •PnL, ROI, win rate, drawdowns
- •Financial indicators and trading patterns
- •Smart money and whale activity
Request
curl -X POST https://narrative.agent.heisenberg.so/v2/traders/stats \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"wallet": "0x1a2b3c4d5e6f...",
"metrics": ["pnl", "roi", "win_rate", "drawdown"],
"timeframe": "90d"
}'Response
{
"wallet": "0x1a2b3c4d5e6f...",
"total_pnl": 588617.70,
"roi": 0.342,
"win_rate": 0.71,
"max_drawdown": -0.18,
"total_trades": 1247,
"active_positions": 23
}Real-Time Cross-Market Analysis
See across platforms as one system.
- •Market matching across Polymarket and Kalshi
- •Cross-venue price disagreement
- •Trader and wallet overlap detection
- •Early signal and lead-lag analysis
Request
curl -X POST https://narrative.agent.heisenberg.so/v2/cross/compare \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"topic": "us-election-2026",
"venues": ["polymarket", "kalshi"],
"metrics": ["price_gap", "volume_ratio"]
}'Response
{
"matched_markets": 12,
"largest_disagreement": {
"topic": "Senate Control 2026",
"polymarket_yes": 0.62,
"kalshi_yes": 0.55,
"price_gap": 0.07,
"volume_ratio": 3.2
},
"avg_price_gap": 0.031
}Real-Time Web Intelligence
Measure narrative pressure against market pricing.
- •Social media impressions and volume
- •Sentiment scoring
- •Narrative vs price divergence
- •Influential accounts and signals
Request
curl -X POST https://narrative.agent.heisenberg.so/v2/signals/sentiment \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"market_slug": "fed-rate-cut-march-2026",
"sources": ["twitter", "reddit", "news"],
"window": "24h"
}'Response
{
"market": "Fed Rate Cut — March 2026",
"sentiment_score": 0.73,
"mention_volume": 14820,
"price_sentiment_divergence": -0.12,
"top_influencer": "@macroanalyst",
"narrative_trend": "bullish",
"confidence": 0.88
}Top Polymarket Traders
Advanced trading analytics and performance rankings.
| Rank | Wallet | F-Score | 15d ROI |
|---|---|---|---|
| #1 | 0x93ab...9723 | +16.2% | |
| #2 | 0x036c...178d | +18.3% | |
| #3 | 0xe524...d34f | +20.2% | |
| #4 | 0x3f5e...e7db | +20.6% | |
| #5 | 0x2707...0afa | +15.8% |
Built for Teams That Need Confidence
Data collection handled end-to-end
No stitching multiple APIs
Built on distributed infrastructure for reliability and scale
Designed for production workloads and automation
Private deployments and custom intelligence layers available.
© 2026 Falcon. All rights reserved.