{"externalDocs":{"url":"https://whalegrader.com/api"},"info":{"contact":{"url":"https://whalegrader.com/api"},"description":"No key, CORS open. Data only, not financial advice; no prediction edge has been validated. Please link back to whalegrader.com. Stored flags usually refresh every 2 to 3 minutes; grading runs hourly.","license":{"name":"CC BY 4.0","url":"https://creativecommons.org/licenses/by/4.0/"},"summary":"Free, read-only data on Polymarket and Kalshi whale trades and how each one graded against the price paid.","title":"WhaleGrader API","version":"1.0"},"openapi":"3.1.0","paths":{"/api/live.json":{"get":{"description":"Latest $10k+ Polymarket trades read straight from Polymarket (about 10 seconds of caching), before they are stored as flags.","operationId":"live_tape","responses":{"200":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"JSON"}},"summary":"Live tape"}},"/api/v1/flag/{flag_id}/history":{"get":{"description":"Price series for one Polymarket flag's traded outcome from before entry to resolution, with entry and resolution details.","operationId":"flag_history","parameters":[{"description":"","in":"path","name":"flag_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"JSON"},"404":{"description":"Not found"}},"summary":"Flag price history"}},"/api/v1/flag/{flag_id}/related":{"get":{"description":"For one flag id (Polymarket or Kalshi), the other flags on the same market plus flags on the same game or event on the other venue.","operationId":"flag_related","parameters":[{"description":"Flag id as returned by recent_flags","in":"path","name":"flag_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"JSON"},"404":{"description":"Not found"}},"summary":"Related flags across venues"}},"/api/v1/flags":{"get":{"description":"Latest whale flags (large single trades and sharp odds moves) on Polymarket and/or Kalshi, newest first, with grade status (pending, called, missed, excluded) once the market resolves.","operationId":"recent_flags","parameters":[{"description":"Default polymarket","in":"query","name":"venue","required":false,"schema":{"enum":["polymarket","kalshi","all"],"type":"string"}},{"description":"Default 25","in":"query","name":"limit","required":false,"schema":{"default":50,"maximum":200,"minimum":1,"type":"integer"}},{"description":"Only trades at least this size in USD","in":"query","name":"min","required":false,"schema":{"type":"number"}},{"description":"","in":"query","name":"status","required":false,"schema":{"enum":["pending","called","missed","excluded"],"type":"string"}},{"description":"Words in the market title, or a 0x wallet address (Polymarket)","in":"query","name":"q","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"JSON"},"404":{"description":"Not found"}},"summary":"Recent whale flags"}},"/api/v1/games":{"get":{"description":"Open sports games: Polymarket and Kalshi home-team probability next to the median no-vig sportsbook line, with American-odds equivalents.","operationId":"games","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"JSON"},"404":{"description":"Not found"}},"summary":"Game board"}},"/api/v1/leaderboard":{"get":{"description":"Polymarket wallets ranked by price-adjusted edge on graded flags (minimum sample applies).","operationId":"leaderboard","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"JSON"},"404":{"description":"Not found"}},"summary":"Wallet leaderboard"}},"/api/v1/market/{condition_id}":{"get":{"description":"One Polymarket market by condition id: prices, biggest holders per side tagged PROVEN/LOSING, and WhaleGrader's flags on it.","operationId":"market","parameters":[{"description":"0x + 64 hex chars","in":"path","name":"condition_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"JSON"},"404":{"description":"Not found"}},"summary":"Market detail"}},"/api/v1/scoreboard":{"get":{"description":"How often graded whale flags called the outcome versus what their entry prices implied (called vs expected, edge in points, standard error), per venue. Historical record only; no edge has been validated for prediction.","operationId":"scoreboard","parameters":[{"description":"","in":"query","name":"venue","required":false,"schema":{"enum":["polymarket","kalshi","all"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"JSON"},"404":{"description":"Not found"}},"summary":"Public scoreboard"}},"/api/v1/wallet/{address}":{"get":{"description":"One Polymarket wallet's graded record (called vs expected, edge) and its last 50 whale flags.","operationId":"wallet","parameters":[{"description":"0x... Polymarket wallet address","in":"path","name":"address","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"JSON"},"404":{"description":"Not found"}},"summary":"Wallet record"}}},"servers":[{"url":"https://whalegrader.com"}]}