⌘K
Build trading bots, custom dashboards, and integrations with real-time prediction market data from Polymarket and Kalshi.
Live orderbook snapshots, price updates, and trade feeds from both venues.
Liquidity, execution, activity, and stability scores for every market.
Real-time whale trades, wallet activity, and smart money signals.
Unified API for Polymarket and Kalshi. One integration, both exchanges.
All API requests require authentication via an API key.
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_test_your_key_here"klp_live_* - Production keys for live dataklp_test_* - Test keys for developmentAPI keys are only shown once when created. Store them securely.
API requests are rate limited to ensure fair usage.
Every response includes headers to help you track your usage:
Get up and running in three simple steps.
Create an API key from your settings page (requires Pro Plus). Keys start with klp_live_
curl -X GET "https://api.kalopoly.com/v1/markets" \
-H "X-API-Key: klp_test_your_key_here"Trading bots, Discord alerts, custom dashboards, research tools - the data is yours.
Everything you need to build prediction market applications.
/v1/marketsList and filter prediction markets from both venues.
/v1/markets/{id}Get detailed market info including all outcomes.
/v1/orderbooks/{id}Real-time orderbook snapshots with bids and asks.
/v1/orderbooks/{id}/historyHistorical orderbook data at various resolutions.
/v1/grades/{id}Proprietary liquidity, execution, and stability grades.
/v1/grades/topTop-graded outcomes across all active markets.
/v1/whales/tradesRecent whale trades with size and direction.
/v1/whales/activityWhale activity summary with volume, buy/sell pressure, and top wallets.
/v1/whales/{wallet}Trading history and stats for a specific whale wallet.
Get started quickly with examples in your favorite language.
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']}")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}`);
});The API uses standard HTTP status codes and returns JSON error responses.
Invalid parameters or malformed request.
{
"error": "bad_request",
"message": "Invalid market ID format"
}Missing or invalid API key.
{
"error": "invalid_api_key",
"message": "Invalid, expired, or revoked API key"
}API key lacks permission for this resource.
{
"error": "forbidden",
"message": "Pro Plus subscription required"
}Too many requests. Wait and retry.
{
"error": "rate_limit_exceeded",
"message": "Rate limit exceeded. 60/60 requests per minute.",
"retry_after": 60
}Subscribe to live updates for prices, orderbooks, and whale trades. Available for Pro Plus subscribers.
wss://api.kalopoly.com/ws?token=klp_test_your_key_here// 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
}{
"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 access is included with Pro Plus. See rate limits for each plan below.
Browse markets and explore data
For traders who want the edge
For desks, bots, and power users
| Feature | Free | Pro | Pro Plus |
|---|---|---|---|
| API access | - | - | ✓ |
| Rate limit | - | - | 300/min |
| Monthly cap | - | - | 1,000,000 |
| Markets, orderbooks, grades | Web only | Web only | ✓ |
| Whale and insider endpoints | - | - | ✓ |
| Whale data delay | 24 hours | 1 hour | No delay |
| Webhook delivery | - | - | ✓ |
| WebSocket streaming | - | - | Coming soon |
| Priority support | - | - | ✓ |