Data API

The Fivesight Data API provides programmatic access to our high-frequency market engine, including real-time order books, historical ticks, whale tracking, and arbitrage opportunities.

WARNING

Access Restricted: These endpoints require a Dev Pro or Ultimate subscription.

Authentication

All requests must include your API Key in the X-API-KEY header. You can generate keys in the Developer Dashboard.

curl -H "X-API-KEY: fs_live_..." https://api.fivesight.ai/api/v1/markets/top

Markets

Search & List

GET /api/v1/markets

Search for markets with rich filtering.

Parameters:

• term: Search query.
• limit: Max results (default 20).
• status: active, resolved, pending.
• categories: Comma-separated list (e.g. Politics,Crypto).

import requests

resp = requests.get(
    "https://api.fivesight.ai/api/v1/markets",
    params={"term": "Fed Rates", "limit": 5},
    headers={"X-API-KEY": "YOUR_KEY"}
)
print(resp.json())

Top Markets

GET /api/v1/markets/top

Rank markets by volume, liquidity, or trades.

Parameters:

• metric: volume (default), liquidity.
• window: 24h, 7d, 30d.

Orderbook

GET /api/v1/markets/:id/orderbook

Returns full Level 2 order book depth for all outcomes.

Time Series (History)

Market History / OHLCV

GET /api/v1/markets/:id/history

Get historical price candles.

Parameters:

• resolution: 1m, 5m, 1h, 1d.
• limit: Number of candles.
• metric: price (default).

# Get 1-hour candles for a market
resp = requests.get(
    "https://api.fivesight.ai/api/v1/markets/12345/history",
    params={"resolution": "1h", "limit": 24},
    headers={"X-API-KEY": "YOUR_KEY"}
)
candles = resp.json()['outcomeSeries'][0]['points']

Global Ticks

GET /api/v1/pm-data/ticks

Stream recent trades across the entire exchange.

Arbitrage

GET /api/v1/arbitrage/list

Real-time arbitrage opportunities between Polymarket and Kalshi (or other sources).

Headers (Filtering):

• Min-Arbitrage-Percent: e.g. 1.5
• Min-Combined-Volume: e.g. 1000

resp = requests.get(
    "https://api.fivesight.ai/api/v1/arbitrage/list",
    headers={
        "X-API-KEY": "YOUR_KEY",
        "Min-Arbitrage-Percent": "2.0"
    }
)
for arb in resp.json()['data']:
    print(f"{arb['pm_title']} -> {arb['arbitrage_percent']}%")

Whales

Leaderboard

GET /api/v1/whales/leaderboard

Top traders by PnL or Volume.

Parameters:

• category: POLITICS, CRYPTO, etc.
• timePeriod: WEEK, MONTH, ALL.

Whale Trades

GET /api/v1/whales/trades

Feed of recent trades made by top leaderboard wallets.

Indicators & Signals

Signals

GET /api/v1/markets/signals

Markets triggering technical signals like momentum, highVolLowLiq, wideSpread.

Heatmap

GET /api/v1/markets/heatmap

Pre-computed metrics for visualization.

NOTE

Future Data: We are constantly adding new endpoints and WebSocket streams. Check back often for updates.