Kalopoly is a professional analytics platform for Polymarket and Kalshi prediction markets. It provides real-time odds, whale tracking, trader leaderboards, price alerts, and execution tools to help traders make better decisions.

How does whale tracking work on Kalopoly?

Kalopoly monitors large trades on Polymarket in real-time, identifying 'whale' traders who move significant volume. You can see their positions, track their performance, and set alerts when whales enter or exit markets.

Is Kalopoly free to use?

Yes, Kalopoly offers a free tier with access to market data, basic whale tracking (24hr delay), top 10 trader leaderboard, and 10 execution plans per day. Premium plans start at $20/month for faster data and more features.

What prediction markets does Kalopoly support?

Kalopoly currently supports Polymarket (crypto-based prediction market) and Kalshi (CFTC-regulated exchange). You can compare odds across both platforms and find arbitrage opportunities.

How often is Kalopoly data updated?

Free users get data refreshed every 5 minutes. Pro subscribers get 3-minute updates, and Pro Plus users get near real-time data with 1-minute refresh rates.

Kalopoly API

Build trading bots, custom dashboards, and integrations with real-time prediction market data from Polymarket and Kalshi.

Get API Key View Documentation

Real-time Data

Live orderbook snapshots, price updates, and trade feeds from both venues.

Proprietary Grades

Liquidity, execution, activity, and stability scores for every market.

Whale Tracking

Real-time whale trades, wallet activity, and smart money signals.

Multi-venue

Unified API for Polymarket and Kalshi. One integration, both exchanges.

Authentication

All API requests require authentication via an API key.

API Key Authentication

Include your API key in the X-API-Key header with every request.

curl -X GET "https://api.kalopoly.com/v1/markets" \
  -H "X-API-Key: klp_live_your_key_here"

Key Format

klp_live_* - Production keys for live data
klp_test_* - Test keys for development

API keys are only shown once when created. Store them securely.

Rate Limiting

API requests are rate limited to ensure fair usage.

req/min (Starter)

300

req/min (Pro)

1,000

req/min (Enterprise)

Rate Limit Headers

Every response includes headers to help you track your usage:

X-RateLimit-Limit60

X-RateLimit-Remaining58

X-RateLimit-Reset1704067260

Quick Start

Get up and running in three simple steps.

Get your API key

Create an API key from your settings page. Keys start with klp_live_

Make your first request

curl -X GET "https://api.kalopoly.com/v1/markets" \
  -H "X-API-Key: klp_live_your_key_here"

Build something great

Trading bots, Discord alerts, custom dashboards, research tools - the data is yours.

API Endpoints

Everything you need to build prediction market applications.

GET/v1/markets

List and filter prediction markets from both venues.

GET/v1/markets/{id}

Get detailed market info including all outcomes.

GET/v1/orderbooks/{id}

Real-time orderbook snapshots with bids and asks.

GET/v1/orderbooks/{id}/history

Historical orderbook data at various resolutions.

GET/v1/grades/{id}

Proprietary liquidity, execution, and stability grades.

GET/v1/grades/top

Top-graded outcomes across all active markets.

GET/v1/whales/trades

Recent whale trades with size and direction.

GET/v1/whales/activity

Whale activity summary with volume, buy/sell pressure, and top wallets.

GET/v1/whales/{wallet}

Trading history and stats for a specific whale wallet.

View full documentation →

Code Examples

Get started quickly with examples in your favorite language.

Python

import requests

API_KEY = "klp_live_your_key_here"
BASE_URL = "https://api.kalopoly.com/v1"

# Get all active markets
response = requests.get(
    f"{BASE_URL}/markets",
    headers={"X-API-Key": API_KEY},
    params={"status": "active", "limit": 100}
)

markets = response.json()["data"]
for market in markets:
    print(f"{market['title']}: {market['venue']}")

JavaScript / TypeScript

const API_KEY = "klp_live_your_key_here";
const BASE_URL = "https://api.kalopoly.com/v1";

// Get whale trades
const response = await fetch(
  `${BASE_URL}/whales/trades?min_size_usd=10000`,
  { headers: { "X-API-Key": API_KEY } }
);

const { data } = await response.json();
data.forEach(trade => {
  console.log(`${trade.wallet} bought $${trade.size_usd} of ${trade.market}`);
});

Error Handling

The API uses standard HTTP status codes and returns JSON error responses.

400Bad Request

Invalid parameters or malformed request.

{
  "error": "bad_request",
  "message": "Invalid market ID format"
}

401Unauthorized

Missing or invalid API key.

{
  "error": "invalid_api_key",
  "message": "Invalid, expired, or revoked API key"
}

403Forbidden

API key lacks permission for this resource.

{
  "error": "forbidden",
  "message": "Pro Plus subscription required"
}

429Rate Limited

Too many requests. Wait and retry.

{
  "error": "rate_limit_exceeded",
  "message": "Rate limit exceeded. 60/60 requests per minute.",
  "retry_after": 60
}

Real-time WebSocket

Subscribe to real-time updates for prices, orderbooks, and whale trades.

Connection

wss://api.kalopoly.com/ws?token=klp_live_your_key_here

Subscribe to Updates

// Subscribe to price updates for a market
{
  "action": "subscribe",
  "channel": "prices",
  "market_id": "abc-123-def"
}

// Subscribe to whale trades
{
  "action": "subscribe",
  "channel": "whales",
  "min_size_usd": 10000
}

Example Message

{
  "channel": "prices",
  "market_id": "abc-123-def",
  "data": {
    "outcome_id": "xyz-456",
    "mid": 0.65,
    "spread_bps": 25,
    "ts": "2024-01-15T12:00:00Z"
  }
}

API Pricing

Three tiers to match your usage. All plans include full REST API access.

Starter

$99/mo

For personal projects and prototypes

✓60 requests/minute
✓10k requests/day, 100k/month
✓Markets, orderbooks, grades
-Whale data delayed 1hr
-No whale/insider endpoints

Get Started

Pro

$499/mo

For trading bots and production apps

✓300 requests/minute
✓100k requests/day, 1M/month
✓All endpoints including whales/insiders
✓Real-time whale data (no delay)
✓Webhook delivery

Get Started

Enterprise

$1,500/mo

For teams and high-volume use cases

✓1,000 requests/minute
✓Unlimited daily, 10M/month
✓All endpoints, real-time everything
✓Priority support
✓Custom rate limits available

Get Started

Feature	Starter	Pro	Enterprise
Rate limit	60/min	300/min	1,000/min
Daily cap	10,000	100,000	Unlimited
Monthly cap	100,000	1,000,000	10,000,000
Markets, orderbooks, grades	✓	✓	✓
Whale and insider endpoints	-	✓	✓
Whale data delay	1 hour	Real-time	Real-time
Webhook delivery	-	✓	✓
Priority support	-	-	✓

Kalopoly API

Build trading bots, custom dashboards, and integrations with real-time prediction market data from Polymarket and Kalshi.

Get API Key View Documentation

Real-time Data

Live orderbook snapshots, price updates, and trade feeds from both venues.

Proprietary Grades

Liquidity, execution, activity, and stability scores for every market.

Whale Tracking

Real-time whale trades, wallet activity, and smart money signals.

Multi-venue

Unified API for Polymarket and Kalshi. One integration, both exchanges.

Authentication

All API requests require authentication via an API key.

API Key Authentication

Include your API key in the X-API-Key header with every request.

curl -X GET "https://api.kalopoly.com/v1/markets" \
  -H "X-API-Key: klp_live_your_key_here"

Key Format

klp_live_* - Production keys for live data
klp_test_* - Test keys for development

API keys are only shown once when created. Store them securely.

Rate Limiting

API requests are rate limited to ensure fair usage.

req/min (Starter)

300

req/min (Pro)

1,000

req/min (Enterprise)

Rate Limit Headers

Every response includes headers to help you track your usage:

X-RateLimit-Limit60

X-RateLimit-Remaining58

X-RateLimit-Reset1704067260

Quick Start

Get up and running in three simple steps.

Get your API key

Create an API key from your settings page. Keys start with klp_live_

Make your first request

curl -X GET "https://api.kalopoly.com/v1/markets" \
  -H "X-API-Key: klp_live_your_key_here"

Build something great

Trading bots, Discord alerts, custom dashboards, research tools - the data is yours.

API Endpoints

Everything you need to build prediction market applications.

GET/v1/markets

List and filter prediction markets from both venues.

GET/v1/markets/{id}

Get detailed market info including all outcomes.

GET/v1/orderbooks/{id}

Real-time orderbook snapshots with bids and asks.

GET/v1/orderbooks/{id}/history

Historical orderbook data at various resolutions.

GET/v1/grades/{id}

Proprietary liquidity, execution, and stability grades.

GET/v1/grades/top

Top-graded outcomes across all active markets.

GET/v1/whales/trades

Recent whale trades with size and direction.

GET/v1/whales/activity

Whale activity summary with volume, buy/sell pressure, and top wallets.

GET/v1/whales/{wallet}

Trading history and stats for a specific whale wallet.

View full documentation →

Code Examples

Get started quickly with examples in your favorite language.

Python

import requests

API_KEY = "klp_live_your_key_here"
BASE_URL = "https://api.kalopoly.com/v1"

# Get all active markets
response = requests.get(
    f"{BASE_URL}/markets",
    headers={"X-API-Key": API_KEY},
    params={"status": "active", "limit": 100}
)

markets = response.json()["data"]
for market in markets:
    print(f"{market['title']}: {market['venue']}")

JavaScript / TypeScript

const API_KEY = "klp_live_your_key_here";
const BASE_URL = "https://api.kalopoly.com/v1";

// Get whale trades
const response = await fetch(
  `${BASE_URL}/whales/trades?min_size_usd=10000`,
  { headers: { "X-API-Key": API_KEY } }
);

const { data } = await response.json();
data.forEach(trade => {
  console.log(`${trade.wallet} bought $${trade.size_usd} of ${trade.market}`);
});

Error Handling

The API uses standard HTTP status codes and returns JSON error responses.

400Bad Request

Invalid parameters or malformed request.

{
  "error": "bad_request",
  "message": "Invalid market ID format"
}

401Unauthorized

Missing or invalid API key.

{
  "error": "invalid_api_key",
  "message": "Invalid, expired, or revoked API key"
}

403Forbidden

API key lacks permission for this resource.

{
  "error": "forbidden",
  "message": "Pro Plus subscription required"
}

429Rate Limited

Too many requests. Wait and retry.

{
  "error": "rate_limit_exceeded",
  "message": "Rate limit exceeded. 60/60 requests per minute.",
  "retry_after": 60
}

Real-time WebSocket

Subscribe to real-time updates for prices, orderbooks, and whale trades.

Connection

wss://api.kalopoly.com/ws?token=klp_live_your_key_here

Subscribe to Updates

// Subscribe to price updates for a market
{
  "action": "subscribe",
  "channel": "prices",
  "market_id": "abc-123-def"
}

// Subscribe to whale trades
{
  "action": "subscribe",
  "channel": "whales",
  "min_size_usd": 10000
}

Example Message

{
  "channel": "prices",
  "market_id": "abc-123-def",
  "data": {
    "outcome_id": "xyz-456",
    "mid": 0.65,
    "spread_bps": 25,
    "ts": "2024-01-15T12:00:00Z"
  }
}

API Pricing

Three tiers to match your usage. All plans include full REST API access.

Starter

$99/mo

For personal projects and prototypes

✓60 requests/minute
✓10k requests/day, 100k/month
✓Markets, orderbooks, grades
-Whale data delayed 1hr
-No whale/insider endpoints

Get Started

Pro

$499/mo

For trading bots and production apps

✓300 requests/minute
✓100k requests/day, 1M/month
✓All endpoints including whales/insiders
✓Real-time whale data (no delay)
✓Webhook delivery

Get Started

Enterprise

$1,500/mo

For teams and high-volume use cases

✓1,000 requests/minute
✓Unlimited daily, 10M/month
✓All endpoints, real-time everything
✓Priority support
✓Custom rate limits available

Get Started

Feature	Starter	Pro	Enterprise
Rate limit	60/min	300/min	1,000/min
Daily cap	10,000	100,000	Unlimited
Monthly cap	100,000	1,000,000	10,000,000
Markets, orderbooks, grades	✓	✓	✓
Whale and insider endpoints	-	✓	✓
Whale data delay	1 hour	Real-time	Real-time
Webhook delivery	-	✓	✓
Priority support	-	-	✓