The Infrastructure Layer of
Prediction Markets

Real-time market data, trader intelligence, and predictive signals for developers and AI agents.

By:

Get Your API Key Log in Get B2B Access

Get Started

Choose how you want to access prediction market intelligence.

🤖

Claude MCP

Recommended

Works with Paid & Free/Desktop plans

⚡

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://retriever.falconapi.net/api/v2/semantic/retrieve/parameterized \
  -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

{
  "pagination": {"limit": 100, "offset": 0, "has_more": false},
  "data": {
    "results": [
      {
        "question": "Bitcoin Up or Down - January 17, 3PM ET",
        "slug": "bitcoin-up-or-down-january-17-3pm-et",
        "condition_id": "0xeaff81adbcd9dcd88a73a41402cb...",
        "volume_total": 104456.760687,
        "closed": true,
        "winning_outcome": "Up",
        "side_a_outcome": "Up",
        "side_b_outcome": "Down",
        "start_date": "2026-01-15T20:01:06Z",
        "end_date": "2026-01-17T21:00:00Z",
        "closed_date": "2026-01-17T22:07:24Z"
      }
    ]
  }
}

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://retriever.falconapi.net/api/v2/semantic/retrieve/parameterized \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": 586,
    "params": {
      "wallet_address": "0x6ac5bb06a9eb05641fd5e82640268b92f3ab4b6e"
    },
    "formatter_config": {"format_type": "raw"}
  }'

Response

{
  "pagination": {"limit": 200, "offset": 0, "has_more": false},
  "data": {
    "results": [
      {
        "proxy_wallet": "0x6ac5bb06a9eb05641fd5e82640268b92f3ab4b6e",
        "total_pnl": "-1396944.57",
        "roi_pct": "-2.09",
        "total_invested": "66883824.61",
        "avg_pnl_per_trade": "-3.75",
        "avg_trade_size": "179.41",
        "total_trades": 372796,
        "last_updated": "2026-07-20T00:00:00Z"
      }
    ]
  }
}

Top Polymarket Traders

Advanced trading analytics and performance rankings.

Rank	Wallet	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%

View leaderboard →

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.

Start Building with Falcon

Get API access in minutes or schedule a demo.

Get Your API Key

The Infrastructure Layer of Prediction Markets