API Documentation

Real-time Polymarket smart money analytics. 500M+ trades indexed, 137K+ smart whales tracked.

Quick Start

Public

No key required. Anonymous, rate-limited to 200 req/min per IP.

curl "https://orcalayer.com/api/v2/markets/search?q=Trump"

Premium

Bearer token required. 600 req/min per key. If using a custom User-Agent and seeing Cloudflare 1010 errors, use a browser-like UA (e.g. Mozilla/5.0) — server-side fix is in place, this is a fallback.

curl -H "Authorization: Bearer YOUR_KEY" "https://orcalayer.com/api/public/v1/whale-alerts"

Python SDK

Official Python client — handles auth, rate-limit retries and the heavy-wallet 202 contract for you.

pip install orcalayer

Source: github.com/orcalayer/orcalayer-python · Example: whale-watchlist-monitor — position alerts for a wallet watchlist.

Authentication

Public

Base URL: https://orcalayer.com/api/v2

Market data, search, wallet lookups, leaderboard, ISW status. No key, 200 req/min per IP.

Premium

Base URL: https://orcalayer.com/api/public/v1

Real-time whale-alerts, SSE live feeds, deep analytics (whale history/backtest, hot markets, AI insights). Send key via Authorization: Bearer YOUR_KEY header (fallback X-API-Key). 600 req/min per key.

Errors: 401 missing/invalid key, 403 not a Premium plan, 429 rate limit exceeded, 500 server error.

Public Endpoints

Anonymous, rate-limited 200 req/min per IP. Base /api/v2.

Markets

Wallets

Leaderboards & Discovery

Ukraine / ISW

Premium Endpoints

Bearer token required. 600 req/min per key. Base /api/public/v1. Get a Premium key on /upgrade and manage it on /settings.

Live SSE

Wallet Premium

Whale Alerts

Smart-Money Analytics

Hot & Resolved Markets

Whale Deep-Dive

Per-Market

Public base: /api/v2 · Premium base: /api/public/v1 · Data updates every 5s · 500M+ trades indexed