Data API

The Fivesight Data API exposes the same streams that power FiveCharts, Watchtower, Radars, and the developer dashboards. You can search markets, stream order book updates, pull whale moves, and surface arbitrage/claim insights with a single authenticated key.

WARNING

Access restricted: Every HTTP call must include a valid X-API-KEY, and API access is gated behind paid plans (Trader or Ultimate for most production workloads). Usage-based plans are tracked from the Developer Dashboard; contact the team for higher tiers.

Authentication

Attach your key via the X-API-KEY header (or Authorization: Bearer <token> when proxying through the frontend).

curl -H "X-API-KEY: fs_live_..." https://api.fivesight.ai/api/v1/markets?term=Fed%20Rates

All responses are JSON. Most endpoints support the source parameter (polymarket by default, all fans out to every provider we aggregate) plus standard limit, page, and sort helpers.

Pricing

Plan	Monthly price	Notes
Free	$0	Basic discovery via the FiveCharts UI; Data API calls are blocked.
Lite	$15/mo	1s charts, alerts, and Watchtower. API access is limited.
Trader	$30/mo	Radars, replay trading, and full Data API access for experimentation.
Ultimate	$100/mo	Invite-only tier with priority support, data exports, and API + sandbox credits for serious automation.

Beta discount: Lite, Trader, and Ultimate are 50% off for 12 months today (standard pricing is 2× once live billing flips, and the discount locks for 12 months).

Usage-based pricing

Requests are metered per endpoint family (see fivesight-backend/config/api_access.json):

• Default data-api endpoints: $0.05 per request, 100 RPM.
• Market history (markets.market_history): $0.10/request, 200 RPM.
• Candlesticks (markets.market_candlesticks): $0.08/request, 180 RPM.
• Trade feeds (markets.market_trades): $0.06/request, 150 RPM.
• Explore feed (markets.explore_feed): $0.04/request, 80 RPM.
• Simulation session creation (simulation.create_session): $0.12/request, 60 RPM.
• Simulation order placement (simulation.place_order): $0.15/request, 120 RPM.
• Simulation order polling (simulation.orders): $0.10/request, 120 RPM.

Every API key logs usage per endpoint. Billing is expressed in cents, and you can review metrics in the Developer Dashboard or by inspecting /api/openapi.json.

Base URL

https://api.fivesight.ai/api/v1
wss://api.fivesight.ai/ws

HTTP endpoints live under /api/v1; WebSocket streams use the same host with the /ws prefix. Stream parameters mirror their HTTP counterparts, keeping your hydration logic consistent.

Markets

Discovery

• GET /api/v1/markets & GET /api/v1/markets/search

  • Search markets with filters such as term, categories, status, order/ascending, limit (1–100), and page.
  • Response: {count, page, page_size, markets} with normalized metadata, probabilities, liquidity, and optional group/event references.

• GET /api/v1/markets/top

  • Ranked list by metric (volume, liquidity, trades) and window (24h, 7d, 30d, all). Add category, limit, minLiquidity, or minVolume to tune the scoreboard.

• GET /api/v1/markets/explore

  • Curated “explore” feed that bundles markets by event. Control metric, window, limit, page, marketsPerGroup, and source.

• GET /api/v1/markets/search/name

  • Direct alias to Polymarket’s search. Provide q, limit, and source to resolve slugs or titles without knowing token IDs.

Contextual detail

• GET /api/v1/markets/{market_id}

  • Detailed metadata: market stats, probabilities, metrics, descriptions, and optional orderbook hints (includeBooks=true).

• GET /api/v1/markets/{market_id}/event

  • Parent event details (title, slug, resolutionTime, linked markets, etc.).

• GET /api/v1/events/{event_id}/markets & GET /api/v1/groups/{group_id}/markets

  • Lists every market inside an event or group. Accepts limit, page, and source.

• GET /api/v1/events/slug/{slug}/markets

  • Same payload keyed by event slug instead of numeric ID.

Order books & trades

• GET /api/v1/markets/{market_id}/orderbook

  • Snapshot depth for each outcome with bid/ask ticks.

• WS /ws/markets/{market_id}/orderbook

  • Streams updates whenever the upstream hash changes; ideal for live dashboards.

• GET /api/v1/markets/{market_id}/trades

  • Paginated trade feed filtered by limit, offset, outcomeId, since, until, side, and source.

• GET /api/v1/markets/up-down

  • Gamma “up or down” groupings by asset and window. Each group carries asset, window, metrics, markets, and normalized probabilities.

History & charting

• GET /api/v1/markets/{market_id}/history

  • Candles from 1s to 1d. Use interval, since/until, limit, metric, and source; the response includes candles, outcomeSeries, and pagination metadata.

• GET /api/v1/markets/{market_id}/correlations

  • Returns the markets with the highest Pearson coefficient. Configure window, resolution, limit, candidateLimit, and source.

• WS /ws/markets/{market_id}/chart

  • Streams an initial history payload followed by incremental candle events for every token.

• GET /view

  • A lightweight Chart.js wrapper that fetches /markets/{market_id}/history so you can debug responses in the browser.

Explore & Radar

• GET /api/v1/markets/snapshot

  • Flat snapshot of up to 500 markets with prices, spreads, liquidity, and delta metrics. Filter by limit, category, status, and source.

• GET /api/v1/markets/aggregates

  • Rolling aggregates for Movers/Volatility feeds (same filters as /snapshot).

• GET /api/v1/markets/lifecycle

  • Lifecycle/freshness data (age, first trade, time since last trade) used to highlight New & Emerging markets.

• GET /api/v1/markets/signals

  • Mechanical signal flags (highVolLowLiq, wideSpread, thinLiquidity, choppy, momentum). Only markets with active signals are returned.

• GET /api/v1/markets/by-time

  • Filter markets by remaining time-to-resolution (ltHours, ltDays) plus limit and source.

• GET /api/v1/themes

  • Aggregated themes/tags with counts, keywords, and volumes.

• GET /api/v1/themes/{theme_id}/markets

  • Markets belonging to a specific theme.

• GET /api/v1/groups

  • Event group metadata (tags, description, score, market count, sample markets).

• GET /api/v1/sports

  • Sports-focused event cards with league/asset metadata.

• GET /api/v1/sports/metadata

  • Sports metadata (supported leagues, asset tags, time windows).

• GET /api/v1/globe (Trader/Ultimate)

  • Polyglobe snapshot with tweet layers, heat zones, and breaking signals.

• GET /api/v1/globe/{market_id} (Trader/Ultimate)

  • Deep dive on a Globe market: tweet history, quote layers, and computed risk scores.

Arbitrage & Stats

• GET /api/v1/arbitrage/list

  • Real-time arbitrage board. Filter with headers (Min-Arbitrage-Percent, Min-Combined-Volume, Sort-By, Sort-Order) and limit.

• GET /api/v1/stats/overview

  • Exchange-wide totals (markets, liquidity, volume, trades) for window (24h, 7d, 30d, all) and optional includeCategories.

Whales & Leaderboards

• GET /api/v1/leaderboard/pm

  • Polymarket leaderboard; filter by category, timePeriod, ordering, limit, start, user, username, and includePortfolioValue.

• GET /api/v1/leaderboard/pm/wallet

  • Wallet-specific leaderboard snapshot; requires wallet and the same optional filters as /leaderboard/pm.

• GET /api/v1/whales/leaderboard

  • Enriched whale leaderboard (profiles, avatars, portfolio values) with the same filters described above.

• GET /api/v1/whales/trades

  • Aggregated recent trades by leaderboard wallets. Configure timeframe, minNotionalUsd, side, leaderboardLimit, perTraderLimit, limit, and the whale filters.

Profiles & Wallets

• GET /api/v1/profiles

  • Lists every tracked influencer profile (count, profiles). Each profile includes avatar_url.

• GET|POST /api/v1/profiles/{handle}/analysis

  • Runs the tweet → claim → Polymarket pipeline for handle. Accepts query params or JSON body (tweet_limit, tweet_window_days, market_limit, market_term, market_closed, market_categories). Returns tweets, synthesized claims, matching markets, and score metadata.

• GET /api/v1/claims

  • Cached cross-profile claim feed with pagination (limit, offset), sorting (recent, controversial, confidence, tweet_count), and scoring knobs.

• GET /api/v1/wallets/{wallet}/snapshot

  • Headline wallet KPIs (equity, spread, PnL, percentile, exposures).

• GET /api/v1/wallets/{wallet}/details

  • Extended analytics (volume, win/loss ratios, performance windows, exposures).

• GET /api/v1/wallets/{wallet}/positions

  • Open positions with categories, ROI, sparkline, and allocation flags; optional limit and status.

• GET /api/v1/wallets/{wallet}/timeline

  • Net-flow timeline plus cumulative stats and win/loss counts.

• GET /api/v1/wallets/{wallet}/history

  • Wallet equity timeseries mirroring market history. Supports resolution, interval, since, until, limit, page, pageSize, and metric.

• GET /api/v1/wallets/{wallet}/trades

  • Paginated trade log with limit, offset, side, and trade metadata; supports Dome-sourced activity when configured.

• GET /api/v1/wallets/{wallet}/scenarios

  • Scenario cards for the wallet’s biggest exposures (impact, confidence, hedging note).

• GET /api/v1/wallets/{wallet}/pnl

  • Realized PnL history (from Dome API). Filters: granularity, start_time, end_time.

• GET /api/v1/wallets/{wallet}/activity

  • Highlights the wallet’s headline events (fills, merges, redeems).

• GET /api/v1/wallets/widgets/defaults

  • Default widget configuration for wallet dashboards.

• GET /api/v1/wallets/lookup

  • Resolve wallet addresses (or prefixes) to enriched metadata. Use wallets, startsWith, or other filters.

Notes

For full request/response schemas, refer to the hosted OpenAPI schema at https://api.fivesight.ai/api/openapi.json. Endpoints that require higher tiers (for example, /api/v1/globe*) return 403 unless your plan meets the requirement.