# Falcon

## Docs

- [Falcon API](https://api.polymarketanalytics.com/docs/introduction.md): A unified intelligence API for prediction markets — real-time data, trade history, and analytics across Polymarket and Kalshi.
- [How Falcon Works](https://api.polymarketanalytics.com/docs/introduction/how-falcon-works.md): Falcon is an intelligence execution layer for prediction markets. It connects to live data sources, enriches everything through autonomous data agents, and serves it all through a single, sub-300ms API.
- [Quick Start](https://api.polymarketanalytics.com/docs/getting-started/quickstart.md): Authentication, base URL, and your first API call. All endpoints respond in under 300ms with seconds-fresh data.
- [API Integration](https://api.polymarketanalytics.com/docs/introduction/api-integration.md): Integrate directly into your trading systems, bots, dashboards, or analytical workflows via REST API.
- [Working with AI](https://api.polymarketanalytics.com/docs/introduction/working-with-ai.md): Connect Falcon to Claude via MCP and query prediction markets in natural language. No code, no API calls — just ask questions and get structured answers instantly.
- [Authentication](https://api.polymarketanalytics.com/docs/getting-started/authentication.md): Authenticate every Falcon API request using a Bearer token.
- [F-Score Methodology](https://api.polymarketanalytics.com/docs/introduction/fscore-methodology.md): The Falcon Score (F-Score) is a proprietary 0–100 rating that measures a wallet's prediction market trading skill. It's designed to separate consistently skilled traders from those who got lucky once.
- [Data Foundations](https://api.polymarketanalytics.com/docs/introduction/data-foundation.md): Falcon continuously collects, cleans, and normalizes data from multiple prediction market platforms and social sources.
- [Streaming and Reliability](https://api.polymarketanalytics.com/docs/introduction/streaming-and-reliability.md): Built for speed and reliability from day one. Heisenberg handles the infrastructure complexity so your integrations stay fast, fresh, and always-on.
- [Trading & Execution](https://api.polymarketanalytics.com/docs/introduction/trading-execution.md): Build prediction market trading tools with live data, wallet intelligence, and market analytics — all from one API.
- [AI Agents](https://api.polymarketanalytics.com/docs/introduction/ai-agents.md): Give your AI agents live prediction market intelligence through Claude MCP or direct API calls.
- [Analysis & Research](https://api.polymarketanalytics.com/docs/introduction/analysis-research.md): Power dashboards, research tools, and analytical platforms with comprehensive prediction market data.
- [Markets](https://api.polymarketanalytics.com/docs/market-data/markets.md): Access prediction market listings and metadata across Polymarket and Kalshi.
- [Trades](https://api.polymarketanalytics.com/docs/trade-data/trades.md): Access historical trade executions across Polymarket and Kalshi.
- [SDKs and Libraries](https://api.polymarketanalytics.com/docs/market-data/sdk-and-libraries.md): The Falcon API is a single POST endpoint — no SDK required. But here are ready-to-use wrappers to get you started faster.
- [Migration Guide](https://api.polymarketanalytics.com/docs/market-data/migration-guide.md): Migrate from Polymarket’s CLOB API to a single Falcon endpoint, unified data, and richer metrics.
- [Glossary](https://api.polymarketanalytics.com/docs/market-data/glossary.md): Key terms used across the Falcon API and prediction market ecosystem.
- [Analyze Market](https://api.polymarketanalytics.com/docs/composite-workflows/analyze-market.md): MCP composite tool. Calls Market Pulse Summary (593), Market Pulse Positions (594), Sport Market Insights (600), Polymarket Markets, Closing Line (602), and Price Jumps (596, token-resolved from the market) in parallel and returns one combined response.
- [Scout Wallet](https://api.polymarketanalytics.com/docs/composite-workflows/scout-wallet.md): MCP composite tool. Calls Sport Wallet 360 (599) and Sport PnL (601) in parallel for one wallet, returns a combined response.
- [Batch Wallet Trades](https://api.polymarketanalytics.com/docs/composite-workflows/batch-wallet-trades.md): MCP composite tool. Calls Sport Trades (597) in parallel for up to 50 wallets and returns a dict keyed by wallet address (with the per-wallet error captured rather than failing the whole batch).
- [Batch Market Resolution](https://api.polymarketanalytics.com/docs/composite-workflows/batch-market-resolution.md): MCP composite tool. Calls Closing Line (602) and Polymarket Markets in parallel for up to 50 condition IDs. Returns a dict keyed by `condition_id` with:
- [Polymarket Markets](https://api.polymarketanalytics.com/docs/market-data/polymarket-markets.md): Retrieve Polymarket market listings with filtering by condition ID, slug prefix, volume, or resolution status.
- [Polymarket Trades](https://api.polymarketanalytics.com/docs/trade-data/polymarket-trades.md): Returns historical trade data from Polymarket with different filters such as trader's address and market slug.
- [Candlesticks](https://api.polymarketanalytics.com/docs/market-data/candlesticks.md): Retrieve historical OHLCV candlestick data for a Polymarket token over a defined time interval.
- [Polymarket Price Jumps](https://api.polymarketanalytics.com/docs/market-data/polymarket-price-jumps.md): Detect significant price jumps on a Polymarket market by scanning candlestick data bucketed at a chosen resolution. Returns all candle-to-candle moves exceeding the configured threshold, sorted by magnitude.
- [Orderbook](https://api.polymarketanalytics.com/docs/market-data/orderbook.md): Order book snapshots for a Polymarket token. Check liquidity depth and spread on sport markets before placing trades.
- [Profit & Loss](https://api.polymarketanalytics.com/docs/traders/profit-and-loss.md): Retrieves realized profit and loss (PnL) for a given wallet address over a specified time range and aggregation interval. You may optionally filter results to a single market using `condition_id`. Unlike Polymarket’s dashboard, which displays unrealized PnL, this API reports realized gains only, cal…
- [PnL Leaderboard](https://api.polymarketanalytics.com/docs/market-intelligence/leaderboard.md): Falcon Leaderboard API
- [Lifetime Performance](https://api.polymarketanalytics.com/docs/traders/lifetime-performance.md): View lifetime trading performance for a specific wallet address. Wallet Stats All Time on Our data (~9mo)
- [Falcon Leaderboard](https://api.polymarketanalytics.com/docs/market-data/fscore-leaderboards.md): Rank Polymarket traders using the Falcon F-Score, a composite metric for consistent high-quality performance.
- [Wallet 360](https://api.polymarketanalytics.com/docs/market-intelligence/wallet-360.md): Falcon Extensive Wallet Profile
- [Market 360](https://api.polymarketanalytics.com/docs/market-intelligence/market-360.md): Market Quality & Structure Endpoint
- [Kalshi Markets](https://api.polymarketanalytics.com/docs/market-data/kalshi-markets.md): Search markets on Kalshi using different filters including ticker, status, volume, and etc.
- [Kalshi Trades](https://api.polymarketanalytics.com/docs/trade-data/kalshi-trades.md): Retrieve trade history from Kalshi markets, filtered by ticker and time range.
- [Social Pulse](https://api.polymarketanalytics.com/docs/market-intelligence/social-pulse.md): Monitor social media conversations and trending topics related to prediction markets.
- [WebSocket](https://api.polymarketanalytics.com/docs/reference/websocket.md): Stream live prediction-market events over a single persistent connection — no polling, no rate-limit juggling. The first live stream delivers Polymarket trades as they execute, with server-side filtering by wallet, market, outcome, and more so you only receive the events you care about.
- [Research Data](https://api.polymarketanalytics.com/docs/research/research-data.md): Deep historical archives and purpose-built training datasets for quantitative research, backtesting strategies, and machine learning on prediction markets.
- [API Structure](https://api.polymarketanalytics.com/docs/reference/api-structure.md): Understand the unified request and response format used across all Falcon API endpoints.
- [Error Handling](https://api.polymarketanalytics.com/docs/reference/error-handling.md): How to interpret error responses and how you can recover.
- [Core Concepts](https://api.polymarketanalytics.com/docs/reference/core-concepts.md): Key concepts for querying Falcon API: agent IDs, pagination, and time filters.
- [Best Practices](https://api.polymarketanalytics.com/docs/reference/best-practices.md): Tips for building reliable integrations with the Falcon API.

## OpenAPI Specs

- [social-pulse.openapi](https://api.polymarketanalytics.com/docs/api-reference/social-pulse.openapi.json)
- [polymarket-wallet-360.openapi](https://api.polymarketanalytics.com/docs/api-reference/polymarket-wallet-360.openapi.json)
- [polymarket-trades.openapi](https://api.polymarketanalytics.com/docs/api-reference/polymarket-trades.openapi.json)
- [polymarket-profit-and-loss.openapi](https://api.polymarketanalytics.com/docs/api-reference/polymarket-profit-and-loss.openapi.json)
- [polymarket-price-jumps.openapi](https://api.polymarketanalytics.com/docs/api-reference/polymarket-price-jumps.openapi.json)
- [polymarket-pnl-leaderboard.openapi](https://api.polymarketanalytics.com/docs/api-reference/polymarket-pnl-leaderboard.openapi.json)
- [polymarket-orderbook.openapi](https://api.polymarketanalytics.com/docs/api-reference/polymarket-orderbook.openapi.json)
- [polymarket-markets.openapi](https://api.polymarketanalytics.com/docs/api-reference/polymarket-markets.openapi.json)
- [polymarket-market-360.openapi](https://api.polymarketanalytics.com/docs/api-reference/polymarket-market-360.openapi.json)
- [polymarket-lifetime-performance.openapi](https://api.polymarketanalytics.com/docs/api-reference/polymarket-lifetime-performance.openapi.json)
- [polymarket-falcon-leaderboard.openapi](https://api.polymarketanalytics.com/docs/api-reference/polymarket-falcon-leaderboard.openapi.json)
- [polymarket-candlesticks.openapi](https://api.polymarketanalytics.com/docs/api-reference/polymarket-candlesticks.openapi.json)
- [kalshi-trades.openapi](https://api.polymarketanalytics.com/docs/api-reference/kalshi-trades.openapi.json)
- [kalshi-markets.openapi](https://api.polymarketanalytics.com/docs/api-reference/kalshi-markets.openapi.json)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.