For informational & educational purposes only. Not financial advice. No guarantee of outcomes. Users are responsible for compliance with local laws. 18+. Read full disclaimer →
DashboardDevelopers · Public API · v1
PolySharks API · v1

Build with the same whale data that powers PolySharks.

Programmatic access to the top-50 Polymarket whale leaderboard and the live "tailable bets" feed. Two simple tiers — pay-as-you-grow. No credit-card-required free trial coming Q2.

JSON · stable v1 contract Per-second + per-day rate limits X-RateLimit-* response headers

Pricing

Simple monthly subscriptions — cancel anytime.

API · Starter
$39/ month

For solo developers and side-project builders.

  • 10,000 requests / day
  • 5 requests / second burst
  • Read-only access: leaderboard, tailable-whales, trending-topics
  • 6 months of receipts history
  • Community support
API · ProMost popular
$69/ month

For teams building production dashboards.

  • 50,000 requests / day
  • 20 requests / second burst
  • Everything in Starter, plus:
  • Receipts API + cross-platform confluence
  • Higher concurrency · burst headroom
  • Priority email support

Endpoints

All endpoints are read-only and live under /api/public/v1/.

GET/api/public/v1/leaderboard

Top-50 Polymarket whales ranked by PnL or volume. Filter by period and category.

Query: ?period=?category=?limit=
GET/api/public/v1/tailable-whales

Live feed of whale bets that are still actionable right now (fresh + market open + odds within 10pts of entry).

Query: ?window=
curl
curl https://polysharks.ai/api/public/v1/leaderboard \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -G --data-urlencode "period=WEEK" --data-urlencode "category=CRYPTO" --data-urlencode "limit=10"
JavaScript
const res = await fetch(
  'https://polysharks.ai/api/public/v1/tailable-whales?window=60',
  { headers: { Authorization: 'Bearer ' + process.env.POLYSHARKS_API_KEY } }
);
const data = await res.json();
console.log(data.rows); // [{ market_question, side, size_usd, polymarket_url, ... }]
Every response includes X-RateLimit-Limit-Day, X-RateLimit-Remaining-Day, and (on 429s) Retry-After so you can build robust client backoff.

Your API keys

Generate a key, then send it as Authorization: Bearer … on every request. Plaintext is shown exactly once — copy it immediately.

Sign in to manage your API keys.

Log in
Free weekly email
Sunday Whale Report — top consensus moves of the week.
Free. Unsubscribe in 1 click. See verified call history →
Compliance & Disclosures

PolySharks.ai is a market-intelligence and analytics platform operated by 8eight8 LLC. The site is provided for informational and educational purposes only — it is not financial, legal, tax, or gambling advice. Past whale performance and historical data carry no guarantee of future outcomes. Trading prediction markets involves substantial risk of loss, including 100% of principal. Users are solely responsible for compliance with the laws of their local jurisdiction — prediction-market access is restricted or prohibited in some US states and countries; verify legality before depositing or trading on Polymarket or Kalshi. PolySharks does not custody funds and is not affiliated with Polymarket Inc. or Kalshi Inc. 18+ only (21+ in some jurisdictions).