> ## Documentation Index
> Fetch the complete documentation index at: https://docs.predexon.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Data & Signals

> Normalized prediction-market data, wallet analytics, smart-money signals, and real-time WebSocket feeds across every major venue.

Everything in this tab is built for one job: **giving you the data and signals you need to find edges in prediction markets.** Markets, prices, orderbook history, trades, positions, wallet P\&L, smart-money flow, and live streaming — all behind one API key, normalized across Polymarket, Kalshi, Limitless, Opinion, Predict.fun, and Binance.

<Tip>
  **Most of what's here is free and unlimited.** All list-market and orderbook-history endpoints don't count toward your monthly quota on any plan. [See the full free-endpoint list →](/rate-limits)
</Tip>

***

## Your first call

<CodeGroup>
  ```bash cURL theme={null}
  curl -H "x-api-key: YOUR_API_KEY" \
    "https://api.predexon.com/v2/polymarket/markets?status=open&sort=volume&limit=5"
  ```

  ```python Python theme={null}
  import requests

  r = requests.get(
      "https://api.predexon.com/v2/polymarket/markets",
      headers={"x-api-key": "YOUR_API_KEY"},
      params={"status": "open", "sort": "volume", "limit": 5},
  )
  for m in r.json()["markets"]:
      print(m["title"])
  ```

  ```javascript Node.js theme={null}
  const res = await fetch(
    "https://api.predexon.com/v2/polymarket/markets?status=open&sort=volume&limit=5",
    { headers: { "x-api-key": "YOUR_API_KEY" } }
  );
  const { markets } = await res.json();
  markets.forEach(m => console.log(m.question));
  ```
</CodeGroup>

New here? Walk through the full setup in [Quickstart →](/quickstart)

***

## What's in this tab

<CardGroup cols={2}>
  <Card title="Cross-Venue Search" icon="magnifying-glass" href="/api-reference/matching/search">
    Text search and programmatic matching across every venue — find the same question on Polymarket, Kalshi, Limitless, Opinion, and Predict.fun.
  </Card>

  <Card title="Markets" icon="layer-group" href="/api-reference/markets/list-markets">
    List markets and events across all venues, plus live lifecycle events (creation, resolution) over WebSocket.
  </Card>

  <Card title="Pricing & Candles" icon="chart-line" href="/api-reference/markets/candlesticks">
    Spot price, OHLCV candlesticks (1m–1d), volume curves, open interest, Binance reference candles, and Chainlink crypto streams.
  </Card>

  <Card title="Orderbooks" icon="layer-group" href="/api-reference/markets/orderbooks">
    Historical orderbook snapshots across venues plus the live L2 WebSocket stream for Polymarket.
  </Card>

  <Card title="Trades" icon="receipt" href="/api-reference/trading/trades">
    Full historical trade tape (Polymarket, Kalshi) plus live trades and mempool pending-trade signals over WebSocket.
  </Card>

  <Card title="Ticks" icon="wave-pulse" href="/data-signals/ticks/kalshi">
    Raw, tick-level price changes and orderbook deltas as bulk Parquet — every update at full resolution, across Polymarket, Kalshi, and Opinion. <strong>New.</strong>
  </Card>

  <Card title="Activity & Positions" icon="bolt" href="/api-reference/trading/activity">
    On-chain activity (splits, merges, redemptions, NegRisk conversions), position snapshots, and the live activity WebSocket channel.
  </Card>

  <Card title="Wallets & P&L" icon="wallet" href="/api-reference/wallet/pnl">
    Wallet profiles, positions, realized + unrealized P\&L, similar-wallet discovery, and connected-wallet clusters on Polymarket.
  </Card>

  <Card title="Smart Money & Leaderboards" icon="user-secret" href="/api-reference/smart-money/smart-money-market">
    Profitable-wallet positioning, top holders, smart-activity-per-market, global + per-market leaderboards, cohort stats.
  </Card>

  <Card title="Oracle & Settlement" icon="gavel" href="/api-reference/uma/list-markets">
    UMA resolution markets and live oracle + collateral events for tracking how questions resolve.
  </Card>

  <Card title="Backtesting" icon="rotate-left" href="/data-signals/backtesting/orderbook-replay">
    Replay historical orderbook state, reconcile candles with the trade tape, and backtest signals against the pending-trade leading indicator.
  </Card>
</CardGroup>

***

## Common recipes

<CardGroup cols={2}>
  <Card title="List trending markets" icon="fire" href="/api-reference/markets/list-markets">
    `GET /v2/polymarket/markets?sort=volume`
  </Card>

  <Card title="Search across venues" icon="magnifying-glass" href="/api-reference/matching/search">
    `GET /v2/markets/search?q=trump`
  </Card>

  <Card title="Fetch OHLCV candles" icon="chart-candlestick" href="/api-reference/markets/candlesticks">
    `GET /v2/polymarket/candlesticks/{condition_id}`
  </Card>

  <Card title="Orderbook history" icon="layer-group" href="/api-reference/markets/orderbooks">
    `GET /v2/polymarket/orderbooks`
  </Card>

  <Card title="Wallet P&L (free)" icon="chart-line" href="/api-reference/wallet/pnl">
    `GET /v2/polymarket/wallet/pnl/{wallet}`
  </Card>

  <Card title="Smart-money for a market" icon="brain" href="/api-reference/smart-money/smart-money-market">
    `GET /v2/polymarket/market/{condition_id}/smart-money`
  </Card>

  <Card title="Find matching markets" icon="left-right" href="/api-reference/matching/find-matches">
    `GET /v2/matching-markets?polymarket_market_slug=...`
  </Card>

  <Card title="Stream pending trades" icon="clock" href="/websocket/pending-trades">
    Subscribe with `filters.status: "pending"` on the trades channel.
  </Card>
</CardGroup>

***

## Authentication & limits

All endpoints in this tab live on `https://api.predexon.com` and authenticate via the `x-api-key` header. See [Authentication](/authentication) and [Rate limits](/rate-limits) in **Start Here** for plan details, free-endpoint lists, and best-practice patterns (caching, retries, connection pooling).
