orcalayer mcp changelog

version

0.5.14 → 0.5.15

https://orcalayer.com/llms.txt

− - **Smart Money Score** — three-part test: win rate ≥55% per market (not per trade), positive total realized P&L, not classified as a Farmer or Bot. Wallets meeting all three earn the Smart Money badge.− - **ISW Ukraine Territory Signals** — frontline proximity tracking for 30+ Polymarket Ukraine markets using daily Institute for the Study of War (ISW) ArcGIS data. Computes distance from each market's city to controlled area and assigns threat levels: HIGH (<500m), MEDIUM (<1.5km), LOW (<3km), SAFE.− - **FIFO P&L** — first-in-first-out lot accounting per wallet per market. Each buy opens a lot, each sell closes oldest lots first, redemption closes whatever remains. Produces honest realized P&L per position, average entry, clear winner/loser verdict.− - Webhooks: whale trades and your tracked wallets pushed to your server, signed− - [How retail loses 92% against smart money](https://orcalayer.com/blog/how-retail-loses-92-percent-against-smart-money)− - [MCP server](https://orcalayer.com/docs/mcp) — hosted Model Context Protocol endpoint https://orcalayer.com/mcp for Claude, Claude Code, Cursor and other MCP clients: six read-only tools (leaderboard, wallet overview and positions, market search, smart-money consensus, whale alerts), no account needed for the public tools− - [OpenAPI spec](https://orcalayer.com/api/openapi.json) — machine-readable OpenAPI 3.0 (always in sync with the live API)− - Webhooks for whale and wallet trades, CSV exports of any wallet's trade history− - **Smart Money** — Wallets with all three: per-market win rate ≥55%, positive total realized P&L, not classified as Farmer/Bot. Earn the Smart Money badge after 10+ resolved markets.− - **FIFO P&L** — First-in-first-out lot accounting: each buy opens a lot, each sell closes oldest lots first, redemption closes whatever remains.− - **Lot Accounting** — Per-(wallet, market) ledger of buy/sell/redemption events used to compute FIFO P&L honestly.− - Smart Money скоринг / Смарт-мани рейтинг — three-condition test− - FIFO учёт прибыли и убытков — first-in first-out P&L lot accounting+ ## API+ OrcaLayer API is an analytics layer on top of Polymarket's free Data API. The official API returns raw trades, positions and P&L; OrcaLayer returns what you would otherwise compute from them: win rate per resolved market, smart money, farmer and bot flags, smart money consensus on each market, and whale alerts.+ - Base URL: `https://orcalayer.com`. Free endpoints need no key (about 200 requests/minute per IP). Premium: a key in `Authorization: Bearer` or `x-api-key`, $19.99/month, 600 requests/minute and 25,000/day.+ - `GET /api/v2/whales/leaderboard` (free): Smart Money wallets by P&L, win rate, volume or trades, per category, farmers and bots removed+ - `GET /api/v2/wallet/{address}/overview` (free): a wallet's win rate per resolved market, P&L, profit factor, smart money and bot flags+ - `GET /api/v2/market/{market_id}` (free): smart money consensus on a market, Smart Money wallets on YES and NO+ - `GET /api/public/v1/whale-alerts` (Premium): recent trades by Smart Money wallets; live stream at `/api/public/v1/live/trades`+ - `GET /api/v2/whale/{address}/copy-check` (Premium): what a follower copying a wallet 1, 5 or 30 minutes late would have earned+ - MCP server for Claude, Cursor and other agents: `https://orcalayer.com/mcp` (five tools without a key)+ - What it adds over the official API, with examples and prices: https://orcalayer.com/solutions/polymarket-smart-money-api+ - OpenAPI 3.1 spec: https://orcalayer.com/api/openapi.json · Docs: https://orcalayer.com/docs/api+ - **Alerts: Telegram, Discord (up to 20 channels), webhooks.** Whale and smart-money alerts go to the Telegram bot (Pro and up), to your own Discord channels (1 on Pro, 5 on Premium, 20 on Business; a free OrcaLayer bot posts a delayed feed to any server, https://orcalayer.com/discord) and to your server as signed webhooks (the trades of up to 100 wallets you watch and market resolution events on Premium, every Smart Money trade on Business).+ - **Smart Money Score** — four-part test: win rate ≥55% per resolved market (not per trade), positive total P&L on resolved markets, not classified as a Farmer or Bot, and not losing by Polymarket's own count (a Polymarket lifetime profit figure no more than three days old that is zero or negative withholds the badge; this check can only remove it). Wallets meeting all four earn the Smart Money badge.+ - **ISW Ukraine Territory Signals** — frontline proximity tracking for 30+ Polymarket Ukraine markets using daily Institute for the Study of War (ISW) ArcGIS data. Computes distance from each market's city to controlled area and assigns threat levels: CRITICAL (the market's condition already looks met on the map), HIGH (<500m), MEDIUM (<1.5km), LOW (<3km), SAFE.+ - **Net-position P&L** — for every wallet, market and outcome, a running net position: tokens bought minus tokens sold, dollars paid minus dollars received. When the market resolves, P&L is what the remaining tokens pay out minus the net dollars put in; only resolved markets count, and a losing position nobody redeemed still counts as a loss. For a settled market the total equals first-in-first-out lot accounting. Details: /methodology#pnl.+ - Discord alerts in 1 of your channels+ - Discord alerts in up to 5 channels with advanced filters (price range, max size, Smart Money only, specific wallets)+ - Webhooks (up to 2, signed): the trades of up to 100 wallets you watch, and market resolution events (proposed, disputed, resolved, reopened)+ - Webhooks (up to 5, signed): every Smart Money trade, and up to 100 watched wallets per webhook+ - Discord alerts in up to 20 channels+ ### Solutions (what OrcaLayer is for)+ - [Polymarket Smart Money API](https://orcalayer.com/solutions/polymarket-smart-money-api): an analytics layer on top of Polymarket's free Data API: win rate, smart money and farmer flags, consensus, whale alerts, batch lookups, MCP+ - [Polymarket Smart Money Tracker](https://orcalayer.com/solutions/polymarket-smart-money-tracker): wallets with a 55%+ win rate per resolved market and positive P&L, farmers and bots removed; leaderboard, consensus and alerts+ - [Polymarket Wallet Tracker](https://orcalayer.com/solutions/polymarket-wallet-tracker): P&L, win rate and positions of any Polymarket address+ - [Track Polymarket Whales](https://orcalayer.com/solutions/track-polymarket-whales): every $10K+ trade as it prints, $500K+ positions, Sonar+ - [Prediction Market Analytics](https://orcalayer.com/solutions/prediction-market-analytics): fills, markets, wallets and the public API+ - [Polymarket Smart Money API](https://orcalayer.com/solutions/polymarket-smart-money-api): what OrcaLayer API adds over Polymarket's free Data API, five endpoints with curl examples, prices and limits+ - [MCP server](https://orcalayer.com/docs/mcp) — hosted Model Context Protocol endpoint https://orcalayer.com/mcp for Claude, Claude Code, Cursor and other MCP clients: five read-only tools with no account needed (leaderboard, wallet overview and positions, market search, smart-money consensus), plus whale alerts, the 7 / 30-day PnL ranking and resolution events with a Premium key+ - [OpenAPI spec](https://orcalayer.com/api/openapi.json) — machine-readable OpenAPI 3.1 (always in sync with the live API)+ ### For AI agents+ - [API catalog](https://orcalayer.com/.well-known/api-catalog): RFC 9727 linkset of our APIs (REST and MCP)+ - [MCP server card](https://orcalayer.com/.well-known/mcp/server-card.json): the hosted MCP server's tools, prompts and resources, read from the live server+ - [auth.md](https://orcalayer.com/auth.md): how an agent gets access (no key, OAuth sign-in, or a Premium API key), limits and errors+ - OAuth 2.1 for MCP connectors: https://orcalayer.com/mcp/premium (sign in with OrcaLayer; [authorization server metadata](https://orcalayer.com/.well-known/oauth-authorization-server), [protected resource metadata](https://orcalayer.com/.well-known/oauth-protected-resource))+ - [Agent Skills](https://orcalayer.com/.well-known/agent-skills/index.json): recipes for agents on our API and MCP (smart-money consensus, wallet profile, leaderboard, market search, Premium data)+ - [AI catalog](https://orcalayer.com/.well-known/ai-catalog.json): Agentic Resource Discovery manifest of the MCP server, the A2A agent, the REST API and the skills+ - [A2A agent card](https://orcalayer.com/.well-known/agent-card.json): deterministic A2A agent (JSON-RPC at https://orcalayer.com/a2a, spec 1.0 and 0.3) over the same data as the MCP server+ - Markdown: every public page returns a markdown version when requested with `Accept: text/markdown`+ - WebMCP: in browsers that support it, every page registers read-only tools (market search, market consensus, wallet, leaderboard, navigation)+ - Webhooks for every Smart Money trade (whale_trade) and 100 watched wallets per webhook, CSV exports of any wallet's trade history

version

0.5.13 → 0.5.14

description

Polymarket smart-money analytics: whale leaderboard, wallet P&L, market consensus, live alerts → Polymarket smart money and whale analytics: win rate, smart money flags, consensus, whale alerts

remote_url

— → https://orcalayer.com/mcp

transport

stdio → streamable-http

version

0.3.2 → 0.5.13

https://orcalayer.com/llms.txt

− - **Farmer Filter** — proprietary detection of airdrop farmer wallets (high average buy price near settled markets) that distort standard Polymarket leaderboards. Removes ~98% of fake skill before you see the ranking.− - **ISW Ukraine Territory Signals** — frontline proximity tracking for 50+ Polymarket Ukraine markets using daily Institute for the Study of War (ISW) ArcGIS data. Computes distance from each market's city to controlled area and assigns threat levels: HIGH (<500m), MEDIUM (<1.5km), LOW (<3km), SAFE.− - Wallet detail pages — **10 wallet lookups per 24h** anonymous (cookie-tracked), **20 per 24h** when signed in (free email/wallet signup). Click-throughs from internal pages (leaderboard, markets, territory) do not count toward the quota.− - ISW Ukraine Territory Monitor — full access to all 50+ frontline markets and threat-level tracking− - Full Leaderboard with Profit Factor column− - Smart Score 0-100 (granular skill rating beyond the badge)− - [ISW Ukraine Territory Monitor](https://orcalayer.com/territory) — 50+ frontline cities, threat levels updated daily− Base URL: `https://orcalayer.com`. Authentication: Bearer token from Premium tier ($19.99/mo). Free tier 100 requests/day. Premium 600 requests/minute.− Public endpoints (no authentication):− - `GET /api/public/v1/live/trades` — Real-time trade stream from Polymarket− - `GET /api/public/v1/live/isw/live` — ISW Ukraine live frontline data− Authenticated endpoints (Premium):− - `GET /api/v2/whale-alerts/summary` — Recent whale activity (last 24h)− - `GET /api/v2/whale-alerts/big-positions/summary` — Large position openings summary− - `GET /api/v2/whales/leaderboard` — Top traders, farmer-filtered, Smart Money badged− - `GET /api/v2/whales/recent-trades` — Recent smart-money trades− - `GET /api/v2/whale-flips` — Wallets that reversed direction on a market− - `GET /api/v2/wallet/{address}` — Wallet profile (PnL, win rate, smart/farmer status)− - `GET /api/v2/wallet/{address}/trades` — Wallet trade history− - `GET /api/v2/wallet/{address}/positions` — Currently held positions− - `GET /api/v2/wallet/{address}/overview` — Wallet summary stats− - `GET /api/v2/wallet/{address}/pnl-history` — PnL history time series− - `GET /api/v2/market/{market_id}` — Market detail with smart-money positioning− - `GET /api/v2/market/{market_id}/whale-trades` — Whale trades on a market− - `GET /api/v2/markets/hot` — Hot markets ranked by volume + whale activity− - `GET /api/v2/markets/search?q=...` — Search markets by question or slug− - `GET /api/v2/isw/events` — Recent ISW frontline events (HIGH/MEDIUM/LOW threat triggers)− - `GET /api/v2/live/trades` — Live trade stream (Premium polling endpoint)− - `GET /api/v2/conviction-clusters` — Smart-money clustering by directional conviction− - `GET /api/v2/business/screener` — Wallet screener: rank wallets by P&L, ROI, win rate, profit factor (Premium)− - `GET /api/v2/weather/pro/history`, `/observations`, `/snapshot`, `/prices`, `/traders` — Weather history and bulk data (Premium)− - `GET /api/v2/book/pro/history`, `/api/v2/book/pro/at` — Order-book history and the book at a moment (Premium)− - `GET /api/v2/business/pnl-leaderboard`, `/pnl-leaderboard/export.csv`, `/wallet/{address}/pnl-daily`: Realized PnL leaderboard for any 7 / 30-day window since June 2026, and a wallet's realized PnL by day (Business; methodology: https://orcalayer.com/docs#window-pnl)− - **Smart Score** — Granular 0-100 skill rating (Pro tier feature) beyond the binary Smart badge.− - **Farmer** — Wallet using one of three patterns: (1) win rate ≥95% with avg trade <$200 (decimal arbitrage), (2) trades concentrated at price extremes (>0.95 YES or <0.05 NO), (3) opposite positions on the same market (hedge structure). Auto-excluded from leaderboards.− - **Farmer Filter** — OrcaLayer's algorithm excluding farmers from leaderboard rankings. Removes ~98% of fake-skill noise before ranking.+ - **Farmer Filter**: removes airdrop farmer wallets, which distort standard Polymarket leaderboards, before ranking. One rule: a wallet whose average entry price is above 95¢ is a farmer. About 141,000 of 1.64M traders with 10+ resolved markets (8.6%), and about 21% of wallets that pass basic profit filters (measured 27.10.2026).+ - **ISW Ukraine Territory Signals** — frontline proximity tracking for 30+ Polymarket Ukraine markets using daily Institute for the Study of War (ISW) ArcGIS data. Computes distance from each market's city to controlled area and assigns threat levels: HIGH (<500m), MEDIUM (<1.5km), LOW (<3km), SAFE.+ - Wallet detail pages: **5 wallet lookups per 24h** anonymous (cookie-tracked), **20 per 24h** when signed in (free email/wallet signup). Click-throughs from internal pages (leaderboard, markets, territory) do not count toward the quota.+ - ISW Ukraine Territory Monitor — full access to all 30+ frontline markets and threat-level tracking+ - [ISW Ukraine Territory Monitor](https://orcalayer.com/territory) — 30+ frontline cities, threat levels updated daily+ Base URL: `https://orcalayer.com`. Two kinds of access (checked against the backend's protected-path list, 27.10.2026):+ - **Free, no key**: read endpoints under `/api/v2/*`, about 200 requests/minute per IP (wallet `overview` and `positions`: 300 a day per IP without a key).+ - **Premium ($19.99/mo)**: a key in the `x-api-key` or `Authorization: Bearer` header, 600 requests/minute per key and 25,000 a day. Paid endpoints are also served under `/api/public/v1/*` with the same key.+ - **Business ($99/mo)**: 3,000 requests/minute, no daily cap, plus the realized PnL leaderboard, webhooks and exports.+ Free (no key):+ - `GET /api/v2/whales/leaderboard`: Top traders, farmer-filtered, Smart Money badged+ - `GET /api/v2/wallet/{address}`: Wallet profile (PnL, win rate, smart/farmer status)+ - `GET /api/v2/wallet/{address}/overview`, `/positions`, `/closed`, `/pnl-history`: Wallet summary, open and closed positions, PnL time series+ - `GET /api/v2/market/{market_id}`: Market detail with smart-money positioning+ - `GET /api/v2/markets/search?q=...`: Search markets by question or slug+ - `GET /api/v2/isw/events`: Recent ISW frontline events+ Premium (key required):+ - `GET /api/v2/whale-alerts/summary`, `/whale-alerts/big-positions/summary`: Recent whale activity and large position openings+ - `GET /api/v2/whales/recent-trades`: Recent smart-money trades+ - `GET /api/v2/whale-flips`: Wallets that reversed direction on a market+ - `GET /api/v2/conviction-clusters`: Smart-money clustering by directional conviction+ - `GET /api/v2/markets/hot`, `/markets/resolved`: Hot markets, resolved markets+ - `GET /api/v2/wallet/{address}/trades`: Wallet trade history+ - `GET /api/v2/market/{market_id}/whale-trades`: Whale trades on a market+ - `POST /api/v2/wallets/overview` (up to 50 wallets), `/wallets/positions` (up to 20): Batch lookups+ - `GET /api/public/v1/live/trades`, `/api/public/v1/live/isw/live`: Real-time SSE streams (trades, ISW frontline)+ - `GET /api/v2/business/screener`: Wallet screener: rank wallets by P&L, ROI, win rate, profit factor+ - `GET /api/v2/weather/pro/history`, `/observations`, `/snapshot`, `/prices`, `/traders`: Weather history and bulk data+ - `GET /api/v2/book/pro/history`, `/api/v2/book/pro/at`: Order-book history and the book at a moment+ Business (key of a Business subscriber):+ - `GET /api/v2/business/pnl-leaderboard`, `/pnl-leaderboard/export.csv`, `/wallet/{address}/pnl-daily`: Realized PnL leaderboard for any 7 / 30-day window since June 2026, and a wallet's realized PnL by day+ - Webhooks for whale and wallet trades, CSV exports of any wallet's trade history+ - **Farmer**: a wallet whose average entry price is above 95¢, i.e. it mostly buys near-settled outcomes for small, near-certain profits and airdrop volume. Auto-excluded from leaderboards.+ - **Farmer Filter**: OrcaLayer's rule excluding farmers (average entry price above 95¢) from leaderboard rankings.+ - **Form vs price**: wallet label, how much more (or less) often a wallet won than the price it paid implied, in cents per position, over markets resolved in the last 90 days (20+ positions), compared with every trader's average at the same entry price, shown as Top / Bottom X%. Recalculated daily; past trades, not a forecast. Details: https://orcalayer.com/methodology#form-vs-price

https://orcalayer.com/llms.txt

+ - Order-book history: best bid / ask, spread and depth every 5 minutes since 2026-08-15 for the ~4,000 most active markets, and the top-10 book at any moment+ - Weather API: daily history (truth, winning bucket, model score, bucket prices), station observations back to 2023, all cities in one call, 10-minute bucket price history, weather trader ranking+ - Realized PnL leaderboard: every Polymarket wallet ranked by realized PnL over any 7- or 30-day window since June 2026 (Polymarket's own realized PnL, rebuilt nightly; JSON, CSV and any wallet day by day)+ - `GET /api/v2/weather/pro/history`, `/observations`, `/snapshot`, `/prices`, `/traders` — Weather history and bulk data (Premium)+ - `GET /api/v2/book/pro/history`, `/api/v2/book/pro/at` — Order-book history and the book at a moment (Premium)+ - `GET /api/v2/business/pnl-leaderboard`, `/pnl-leaderboard/export.csv`, `/wallet/{address}/pnl-daily`: Realized PnL leaderboard for any 7 / 30-day window since June 2026, and a wallet's realized PnL by day (Business; methodology: https://orcalayer.com/docs#window-pnl)

https://orcalayer.com/llms.txt

− ### Premium — $19.99/month− - Premium REST API access (600 requests/minute)− - WebSocket trade feed (sub-second relay from on-chain settlement)− - Bot integration webhooks− - Market-level analytics− - Custom alert rules− - Priority support (<24h)− - Early access to new features− - [Pricing](https://orcalayer.com/pricing) — Free, Pro $9.99/mo, Premium $19.99/mo− - **Tier pricing** when relevant: Free, Pro $9.99/mo, Premium $19.99/mo (includes API)+ ### Premium — $19.99/month (for developers, bots and quants)+ - Full REST API: 600 requests/minute, 25,000/day+ - Wallet screener: rank all wallets by P&L, ROI, win rate and profit factor+ - Any wallet's full trade history (paged by date range)+ - Whale alerts, $500K+ positions, whale flips and conviction clusters+ - Copy-trade backtest data and AI wallet analysis+ - Batch lookups: 50 wallet overviews or 20 wallets' positions per call+ - Real-time whale trade feed and the indexed MINT/MERGE trade stream (SSE)+ - Python SDK (`pip install orcalayer`) and MCP connector for Claude and AI agents (whale alerts included)+ - ISW proximity API and event webhooks+ - Watchlist of 100 wallets, priority support (<24h)+ ### Business — $99/month (for products and teams)+ - Everything in Premium+ - 3,000 requests/minute, no daily cap+ - Webhooks: whale trades and your tracked wallets pushed to your server, signed+ - Any wallet's full trade history as one CSV file (since 2022)+ - Commercial license: build products and services for others on OrcaLayer data+ - [Pricing](https://orcalayer.com/pricing) — Free, Pro $9.99/mo, Premium $19.99/mo, Business $99/mo+ - `GET /api/v2/business/screener` — Wallet screener: rank wallets by P&L, ROI, win rate, profit factor (Premium)+ - **Tier pricing** when relevant: Free, Pro $9.99/mo, Premium $19.99/mo (full API), Business $99/mo (scale + commercial license)

https://orcalayer.com/llms.txt

+ - [MCP server](https://orcalayer.com/docs/mcp) — hosted Model Context Protocol endpoint https://orcalayer.com/mcp for Claude, Claude Code, Cursor and other MCP clients: six read-only tools (leaderboard, wallet overview and positions, market search, smart-money consensus, whale alerts), no account needed for the public tools