> For the complete documentation index, see [llms.txt](https://falcon-bot.gitbook.io/falcon-api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://falcon-bot.gitbook.io/falcon-api/getting-started/falcon-api-overview.md).

# Falcon API Overview

## Overview

<figure><img src="/files/ClhKzANPDiyAgLyF6Fpf" alt=""><figcaption></figcaption></figure>

Falcon API is an intelligence layer for prediction markets, providing structured access to market data, trade activity, and trader analytics across multiple platforms.

All datasets are exposed through a unified request format, allowing developers to query different market platforms using a consistent schema.

Falcon is designed for applications such as:

* trading bots
* analytics dashboards
* market research tools
* automated trading systems
* data pipelines and monitoring tools

***

## Supported Platforms

Falcon currently aggregates prediction market data from:

**Polymarket**\
Market listings, trade activity, orderbook data, and wallet analytics.

**Kalshi**\
Market listings and trade activity.

Base API URL

```
https://narrative.agent.heisenberg.so/api/v2/semantic/retrieve/parameterized
```

***

## Available Data

Falcon provides structured datasets organized into the following categories.

#### Market Data

Access prediction market listings and liquidity data.

Includes:

* [Markets](/falcon-api/market-data/markets.md)\
  \- [Polymarket Markets](/falcon-api/market-data/markets/polymarket-markets.md)\
  \- [Kalshi Markets](/falcon-api/market-data/markets/kalshi-markets.md)
* [Candlesticks](/falcon-api/market-data/candlesticks.md)
* [Orderbooks](/falcon-api/market-data/orderbook.md)

#### Trade Data

Retrieve historical trade executions across supported platforms.

Includes:

* [Polymarket Trades](/falcon-api/trade-data/trades/polymarket-trades.md)
* [Kalshi Trades](/falcon-api/trade-data/trades/kalshi-trades.md)

#### Traders

Analyze wallet performance and trading behavior.

Includes:

* [Lifetime Performance](/falcon-api/traders/lifetime-performance.md)
* [Profit and Loss](/falcon-api/traders/profit-and-loss.md)
* [Top Traders](/falcon-api/traders/top-traders.md)

#### Market Intelligence

Derived insights and analytics built on top of market activity.

Includes:

* [Market Insights](/falcon-api/market-intelligence/market-insights.md)
* [Social Pulse](/falcon-api/market-intelligence/social-pulse.md)
* [Falcon Leaderboard API](/falcon-api/market-intelligence/falcon-leaderboard-api.md)
* [Falcon Wallet Analytics](/falcon-api/market-intelligence/falcon-wallet-360.md)

#### Reference

Technical documentation for integrating with the Falcon API.

Includes:

* [API request and response structure](/falcon-api/reference/api-structure.md)
* [Pagination and filtering concepts](/falcon-api/reference/core-concepts.md)
* [Performance and best practices](/falcon-api/reference/best-practices.md)

***

## Authentication

All Falcon API requests require a **Bearer token**.

Example:

```
Authorization: Bearer YOUR_API_TOKEN
```

See the [**Authentication** page](/falcon-api/getting-started/authentication.md) for full details.

***

## Data Characteristics

Falcon is designed for high-frequency and production use cases.

* **Low latency** – near real-time market updates
* **Full coverage** – historical and live datasets
* **Unified schema** – consistent structure across platforms