API Documentation

Real-time Polymarket smart money analytics. 1.5B+ fills indexed, 200K+ 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.

Keys start with sk_orca_ and are 40 characters long. Either header works on both namespaces — X-API-Key: YOUR_KEY or Authorization: Bearer YOUR_KEY.

Not sure whether your key is live? Ask it directly — this endpoint needs no subscription and never echoes the key back:

curl -H "X-API-Key: YOUR_KEY" https://orcalayer.com/api/v2/key/verify

It reports whether the key is recognised, which header it arrived in, your plan, your rate limit and whether Premium endpoints are open to you. The API lives on orcalayer.com — there is no api.orcalayer.com subdomain.

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

Business Endpoints

Business plan: everything in Premium, plus 3,000 req/min with no daily cap, the wallet screener, webhooks, CSV exports and the commercial license (use the data in products and services you provide to others). Same API key, sent as X-API-Key or Authorization: Bearer. Base /api/v2/business. See /pricing and code samples on /developers.

Screener

Webhooks

Exports

Public base: /api/v2 · Premium base: /api/public/v1 · Business base: /api/v2/business · Data updates in batches, typically 15-20s behind chain · 1.5B+ fills indexed