Skip to main content
Use this page to look up the objects named in an endpoint’s response. The tables come from the documented OpenAPI schema and list each field’s type, presence, and meaning.
  • Required: Yes means the field is always present. Its value can still be null when the type allows it.
  • Required: No means the field can be omitted. An omitted value is not zero or an empty result.
  • Type names a scalar, a nested object, or the allowed alternatives. For a named object, find its heading on this page.
Start with the endpoint reference for request parameters and examples. See missing numbers for handling absent analytics without inventing a value.

AccountIdentity

AgentRegistration

A sandbox key and the path to live access (#13959). Nothing is stored: the key cannot be listed or revoked and does not expire. Register again for a new one.

AnalyticInteger

A computed count with its truth state; the same envelope as AnalyticNumber.

AnalyticNumber

A computed number with its truth state. value is present when state is computed or known_zero and may be present when stale; any other state says why there is no number, never a stand-in zero.

ApiDiscovery

ApiError

ApiErrorBody

BatchGameHoldersItem

BatchMarketCloseItem

BatchMarketFlowItem

BatchRateLimitMeta

BatchResponseMeta

BatchTraderItem

Candle

One bucketed OHLC price candle. Prices are in provider [0, 1] units: truncated to 4 decimals at 1d and 1w, unrounded at 5m and 1h. At 5m and 1h, basis says which Polymarket series the candle comes from: provider_bucket is Polymarket’s own bucket price, so open, high, low and close are equal; provisional_minutes is built from Polymarket’s 60-second prices in a bucket it has not published yet.

CategoryLeader

CategoryNumbers

Whether a wallet’s category figures take its latest settlements (#36089). The figures are updated from a queue as the wallet’s markets settle. state is behind when an update for this wallet has waited over an hour, because the whole queue is behind or because the wallet’s own updates wait until its settled record is complete; the figures then stay served, and as_of says when the oldest waiting update was queued. Read from a check the server runs about every three minutes, never on the request.

CategorySkillModelReadiness

Model-wide readiness, read in the same database snapshot as category_records. Individual category rows retain their own status.

CategorySkillV2

Forward-only category evidence from observed Polymarket taker fills. Status is category eligibility, not a global letter grade or a guarantee of positive edge. Scores are probability differences. Unknown and degraded rows withhold scores. Coverage is partial; observation counts are not lifetime market counts.

Clv

ClvOutcome

One outcome of the market.

Combo

ComboCoverage

ComboCoverageCursor

ComboDetail

One combo with its newest 100 fills and all-time lifecycle totals. Paid API callers receive full access.

ComboFill

ComboFillsResponse

ComboLeg

ComboLegMarket

ComboLifecycleStats

ComboLiveCount

ComboResponse

ComboTotals

ComboWindowStats

CombosSummary

Stored live combo count. Null means the first count is unavailable, never zero.

CombosSummaryResponse

ContentSearchResult

CounterpartyAnalysis

CounterpartyExecution

CounterpartyMakerPage

CounterpartyMatchBreakdown

CounterpartyParticipant

CreateWebhookRequest

CreateWebhookVerificationAttemptRequest

DataQuality

Compact data age and coverage for a response body, always present on the operations that publish it. Read status and as_of to decide whether to use the body at all, and field_groups to see which part is weak. Everything here comes from stored observation clocks, and each clocked group is judged against its writer’s budget when the body is served, so a cached body reports the same ages and verdicts a freshly computed one does: meta.cached and meta.cache_age_s stay the only transport-time facts and neither makes this block newer. The per-field audit object is still available through expand=trust; this is the default summary of the same question.

DataQualityGroup

One group of response fields that share a writer and therefore share a clock.

EdgeHunterBoard

The full Max-only Edge Hunter board. Defaults cover all sports and esports with B grade floor, 48-hour horizon and at most 30 rows; common selections, legacy category, min_grade and limit narrow that projection. No pagination or ETag. Rows add frozen market_context discovery metadata.

EdgeHunterBoardResponse

EdgeHunterCategorySkill

Category evidence over the full uncapped piled-side S/A/B holder allocation. It never changes signal membership, ordering, routing, or sizing.

EdgeHunterFunnelReport

Per-sport accountable funnel for the full observation snapshot, returned on every page.

EdgeHunterMarketContext

Metadata frozen with the read generation. Values are nullable when the provider/canonical source has no value; no title-based inference or current-clock fallback.

EdgeHunterMostHeld48hCutoff

One sport’s most_held_48h cutoff: the last market the selection admitted and the values it was ranked by.

EdgeHunterObservation

One explicitly observation-only holder-pile measurement. It is evidence for cohort evaluation, not an execution instruction, and is isolated from the funded Edge Hunter signals view.

EdgeHunterObservationCoverage

Measured coverage of the frozen canonical observation generation and this requested page. For sports and esports reads, the first four counts remain global through category, cohort and all selectors; with admission=most_held_48h they count that selection’s generation, where every wider_holder candidate it did not take is capacity_limited. They are neither a census of all provider markets nor a count of successfully evaluated holders. Selected and returned counts describe the requested projection. An unmappable legacy category synthesizes a zero-work empty generation with all six counts zero and no degradation reasons; it does not read the all-sports cache.

EdgeHunterObservationDegradationReason

One observed cause of operational degradation in the canonical all-sports observation generation. Reasons are independent of the one-terminal-per-input funnel and remain unchanged through category, cohort and selector projection. Intentional capacity limits and an unconfigured upcoming source are not degradation reasons.

EdgeHunterObservationDeparture

A market whose wider_holder card left this selection before kickoff, with why it left.

EdgeHunterObservationTerminalReason

Closed 25-value terminal-reason vocabulary for the accountable Edge Hunter observation funnel. capacity_limited is intentional bounded provider-work admission and does not itself set the snapshot degraded. board_source_unavailable is a completed board-source failure; board_deadline_unavailable means live-board work missed either an internal configured-scope deadline or the outer fair-wave deadline; both classify only already-started rows, so for the upcoming source read funnel.sports[].board_upcoming_status instead; provider_unavailable is reserved for a holder read sent to the provider that failed, with no reusable holder page; holder_deadline_unavailable is holder cache/provider absolute-deadline exhaustion or a holder read local capacity never sent, with no reusable holder page. String enum: outside_horizon, resolved, provider_closed, provider_excluded, invalid_market, missing_token, missing_stored_market, not_provider_live, board_source_unavailable, board_deadline_unavailable, primary_slate_candidate, zero_indexed_holder_research, capacity_limited, provider_unavailable, holder_deadline_unavailable, holder_computation_unavailable, holder_scan_incomplete, no_current_graded_holder, split_holder_pile, price_unavailable, wider_holder_emitted, in_play_emitted, in_play_stale_observed, in_play_directional_unavailable, internal_unclassified.

EdgeHunterObservationsResponse

Full Edge Hunter observations list envelope. Required degradation_reasons explains the source-generation verdict; required coverage distinguishes source input, intentional capacity exclusions, source emissions, incomplete holder scans, selection and the returned page. The view literal distinguishes advanced collections, including empty pages.

EdgeHunterOutcome

One provider outcome in fixed YES/NO order, including its frozen token identity and independently observed quote. Null current_price means no verified current quote is available.

EdgeHunterParticipant

EdgeHunterPrice

EdgeHunterRankedSignal

One ranked pre-game sports market where graded sharp money is piled on one side, with required-status category evidence from partial forward-observed Polymarket fills.

EdgeHunterRow

One full Max row from Edge Hunter. signal is populated on every row this endpoint returns. Identity and quotes preserve provider values; unknown values stay null.

EdgeHunterSelection

Normalized requested selection axes. Only requested axes appear; omitted for unselected defaults. Arrays are nonempty, sorted and deduplicated. OR within an axis, AND across axes.

EdgeHunterSignal

Backed-side analytics, token identity, frozen ranked_at and aggregate category evidence from the ranked snapshot, plus a separately dated current quote. Scores rank attention; they are not probabilities or order instructions.

EdgeHunterSignalsResponse

Full Edge Hunter signals list envelope. The view literal distinguishes advanced collections, including empty pages.

EdgeHunterSportFunnelReport

Independent sports-board supply plus stored-universe terminal accounting for one canonical sport.

EventReplayEvent

EventReplayFreshness

EventReplayMeta

EventReplaySource

ExactDecimal

A lossless decimal atom rendered from the canonical NUMERIC or provider value. The value is a decimal string and must be parsed with a decimal library; it is never a display string and must not be converted through a binary float. scale is the source decimal scale. The field is omitted when its source is unavailable.

ExploreEntry

One of: ExploreGroup, ExploreStandalone. Discriminated by type.

ExploreFacetValue

ExploreFacets

ExploreGroup

ExploreMarket

ExploreStandalone

ExportCompleteness

ExportCounts

ExportJobCancelledData

export_job_cancelled data: the owner’s export stopped because its owner cancelled it.

ExportJobExpiredData

export_job_expired data: the owner’s ready export passed retention.

ExportJobFailedData

export_job_failed data: the owner’s asynchronous export reached a terminal failure.

ExportJobReadyData

export_job_ready data: the owner’s asynchronous export can be downloaded. Download authorization stays on the status and download routes.

ExportSourceRange

ExportVolumeReconciliation

FairPrice

One game outcome’s Polymarket fair price, with the checks that say whether it is fit to price a bet against.

FreshnessFailure

Game

One sports or esports game: both sides, its schedule, provider status, its winner markets (the moneyline, or the soccer 1X2 legs) with their available provider moneyline price states and liquidity, and the game’s traded volume. The event’s other markets are on GET /api/v1/games/{event_slug}/markets. Assembled from the same provider-first live and upcoming projections the site’s boards use, with no request-time provider fan-out.

GameCompetitor

One side of the game.

GameCoverage

What this game’s read actually supplied, so a client branches on coverage instead of on a missing key.

GameFreshness

How current this game’s facts are. Independent per source: the board half that produced the game, and the live-score frame that produced its scores.

GameHoldersItem

One market of a game holders batch: GET /api/v1/market/{condition_id}/holders unfiltered and cut to the batch limit.

GameMap

One map of an esports series.

GameMapState

The per-map state of an esports series, read from 0xinsider’s stored composition of Polymarket’s per-map breakdown (the GRID data behind Polymarket’s own esports scoreboard), which 0xinsider checks against the series score every 5 to 10 seconds while the series is in play. No provider is read for this response. maps is present only when availability is available; a series with no map reading says why in reason and never carries an empty or guessed list.

GameMarket

One Polymarket market linked to this game.

GameMarketLiquidity

One market’s liquidity as Polymarket reports it (Gamma liquidityNum), verbatim. Polymarket documents it only as reported market liquidity, with no unit. It describes the market’s resting order book, not traded volume.

GameMarketPriceBindingProvenance

How the existing sports-board writer bound prices to competitors. String enum: provider_ids, exact_labels, containment_labels, elimination.

GameMarketPriceCompetitor

One competitor-bound provider moneyline price. No YES/NO inference is required.

GameMarketPriceIncomplete

The provider moneyline pair is incomplete; no numeric pair is invented.

GameMarketPriceInvalid

The provider moneyline pair is invalid; no numeric pair is invented.

GameMarketPricePaired

A validated provider moneyline pair bound to the two competitors.

GameMarketPrices

Provider-owned moneyline state with the observation clock that can be compared with game freshness.

GameMarketProviderPrices

One of: GameMarketPricePaired, GameMarketPriceIncomplete, GameMarketPriceInvalid. Discriminated by state.

GameMarketQuote

The YES outcome’s best bid and best ask as Polymarket reports them (Gamma bestBid and bestAsk), verbatim; no midpoint is computed from them. In a binary market the NO outcome’s book mirrors this one (its bid is 1 minus this ask). Per-outcome CLOB books with depth are on GET /api/v1/games/{event_slug}/markets?expand=quotes.

GameSharpMoney

Event-level sharp money for one game. Every aggregate field is null unless status is computed, except lifecycle and at_kickoff, which describe the game; null means unknown, never zero.

GameSharpMoneyVerdict

One of: .

GameStatus

Where the game is in its own life, as the provider reports it. A postponement, a cancellation and a suspension each keep their own state, so a client can tell a game that will be played later from one that never will be.

GameTournament

The tennis tournament edition a game belongs to, curated from official ATP, WTA and ITF pages (source_urls), never from Polymarket, which supplies the competition label and tour only. Selected by the game’s provider competition label, the one tour both players carry, and the kickoff’s day at the venue. A fact no official page states is omitted.

GameTournamentLocation

A verified tournament venue.

GameTrade

One fill in a game, as the game page’s activity list shows it.

GameVolume

A game’s traded volume as Polymarket reports it, read by the sports board or, for a game read from its stored record, summed from its markets’ stored volumes, with no request-time provider call. A one-side taker share count, the number Polymarket’s own pages print behind a dollar sign, not the cash that changed hands.

GamesCoverage

What this deployment covers, published with every page so a client never has to guess whether an empty list means no games or no coverage.

HolderCategoryEvidence

Current category evidence, independent of the global grade. Pick of the Day stamps only the served display roster; frozen entry snapshots remain unchanged.

HoldersAsOf

The instant a stored kickoff roster stands at, with each of its clocks (#34064). Present only on as_of=kickoff; every clock is before kickoff_at.

LargeExportPolicy

LargePosition

LargePositionsUpdatedData

large_positions_updated data: one large-positions refresh finished.

LargeTrade

LargeTradeDetail

No documented fields.

LargeTradeHistoryMeta

LargeTradeInsertedV2Data

large_trade_inserted_v2 data (Pro and Max): one large trade, with the trade itself. The three amounts are decimal strings that keep the stored precision: parse them with a decimal library when the exact value matters. The endpoint’s trade_filters decide which trades it receives.

LargeTradeSubscriptionFilters

All present fields narrow large_trade_inserted_v2 delivery. min_grade reads the payload’s grade, observed at publication; min_grade_at_trade reads its grade_at_trade, the grade when the trade filled. Send one of the two, not both (400). An empty object matches every large trade.

LargeTradesInsertedData

large_trades_inserted data (Pro and Max): new large trades were ingested. It carries a count and no trade; subscribe to large_trade_inserted_v2 for the trade itself. The deprecated spelling whale_trades_inserted delivers the same object until its sunset on 2027-02-01 (#29352).

LeaderboardEntry

LeaderboardLeagues

Every league with a skill leaderboard, by sport: the league values GET /api/v1/leaderboard/sports/{sport} accepts.

LeaderboardPriceEdge

Edge over the price paid (#32270): how often the side a wallet bought won, minus the average price it paid, over its settled sports and esports markets of $20 or more at a known entry price. Probabilities throughout: edge 0.12 is 12 percentage points. A wallet buying at 99 cents that wins every market has an edge of about 0.01. A market bought on both sides counts by its shares: the winning side’s share of the shares bought is its hit, the cost over those shares its price.

LeaderboardSummary

The whole board’s totals, the counts the 0xinsider leaderboard page shows (#32737), read with the ranking snapshot the page is served at. Sent on every page of a request with no category and no strategy, whatever its sort, dir and activity, which order or split the same wallets. Omitted on a category or strategy page, which lists a subset these totals do not describe, and while the ranking has no totals for the served generation.

LiveSportsScoreEntry

One side’s score line inside a live_sports_updated pulse.

LiveSportsUpdatedData

live_sports_updated data: one bounded pulse for one live game. A pulse fires when a material field moved since this game’s previous delivered pulse (scores, status, period, live, ended), at most once per game per 20 seconds. A live or ended transition is exempt from that interval, and the game clock alone never fires a pulse. Suppressed frames are folded into the next pulse’s changed, and its body carries the current state.

MarketCandles

Provider-first bucketed OHLC price candles for a market’s outcome tokens (open and resolved markets): 5m and 1h from Polymarket’s /v2/prices-history buckets, 1d and 1w from our stored copy of its price history.

MarketClose

A market’s stored closing line (#32517): Polymarket’s price-history value for the last minute bucket ending at or before kickoff, read once after settlement and never recomputed.

MarketFlow

MarketFlowSharpMoney

One market’s outcome-aware large-trade flow in the window and its top graded positions: the shape of MarketFlow’s sharp_money and of its deprecated alias smart_money.

MarketHolder

MarketHoldersMarket

MarketHoldersScan

MarketHoldersSideGradeUsd

The rows’ current_value_usd per grade on one side, over the same wallets and values as that side’s usd total. Each value is rounded to the cent after summing, so s + a + b can differ from the side total by up to 2 cents.

MarketHoldersSideGrades

MarketHoldersTotals

Roster totals BEFORE any outcome or min_grade filter, so a page always knows the whole market it was cut from.

MarketPriceMovedData

market_price_moved data, also the MarketPriceMoved frame on GET /api/v1/stream: a sports or esports market’s outcome-0 midpoint moved a whole-cent level over one window. Prices are decimal strings at full precision. A missing value is null with its *_unavailable_reason.

MarketSearchResult

MarketSettledData

market_settled data, also the MarketSettled frame on GET /api/v1/stream: a sports or esports game market settled, sent once per settled state the first time 0xinsider records it. A market can settle in more than one state: a resolved UMA question row with no winner yet, the same row with the winner ConditionalTokens paid on chain, and the condition row with the provider’s payouts; each is its own event with its own settlement_id, except a state naming the winner an earlier event named, which is not sent.

MarketSnapshot

MarketSnapshotFreshness

MarketSnapshotTopOfBook

MarketSnapshotTrust

Price and spread trust metadata returned only when GET /api/v1/market/{condition_id}/snapshot includes expand=trust.

MarketTopHolder

MarketTopHolders

MarketTopHoldersTotals

MarketTrade

One taker fill of 100 USD or more on a market, from the exchange’s on-chain fill events.

MarketWalletsInOut

One market’s net buyers and net sellers over a 24h or 7d window, as the market page’s wallets in/out panel shows a Pro viewer.

McpJsonRpcError

OutcomeCandles

One outcome token’s bucketed candle series.

PickHolder

PickHolderPriceEdge

Edge over the price paid in one category, game or league: how often the side a wallet bought won, minus the average price it paid, over its settled markets there at a known entry price (every_size). Probabilities throughout: edge -0.171 is -17.1 percentage points. A market bought on both sides counts by its shares: the winning side’s share of the shares bought is its hit, the cost over those shares its price. Figures from the daily record rebuild.

PickHolderPriceEdgeHold

An edge the holder row does not show, and why.

PickLeadBacker

Recorded lead wallet facts on a full response when available. Position and category history are frozen at publication; they are not live balances or pick win probabilities.

PickOfTheDay

PickOfTheDayArchive

PickOfTheDayArchiveDay

PickOfTheDayArchiveEntry

PickOfTheDayArchiveSummary

The archive with view=summary: hit_rate without its daily series, one short row per pick, and page. Page with limit and cursor; view=full returns every field of a row.

PickOfTheDayAskComparison

PickOfTheDayCommitmentPayload

Select using the entry commitment_version, never implicit payload shape. All historic v1 hashes remain unchanged. One of: PickOfTheDayCommitmentPayloadV1, PickOfTheDayCommitmentPayloadV2.

PickOfTheDayCommitmentPayloadV1

The frozen identity of the pick, exactly as the hash was taken over it. Served byte for byte as it was hashed — keys sorted by UTF-8 byte value, no insignificant whitespace — so a verifier concatenates and hashes with nothing to reconstruct. Property order below is the wire order. The outcome is deliberately NOT part of it: surviving a corrected outcome unchanged is the case the commitment exists for. Worked example: {“backed_price”:“0.545000”,“condition_id”:“0xabc”,“kickoff”:“2026-09-20T23:05:00Z”,“pick_date”:“2026-09-20”,“pick_outcome_index”:1,“pick_outcome_label”:“Lakers”,“pick_rank”:1,“platform”:“polymarket”} with the nonce 000102030405060708090a0b0c0d0e0f101112131415161718191a1b1c1d1e1f hashes to 44d18fa5e2aa3a2bf3c971dcc9317c8ccbdfd5480a4773b6d8ffd5fbeeea84dc.

PickOfTheDayCommitmentPayloadV2

Version 2 rank-free canonical payload: sorted nine keys, unchanged string escaping, exact decimal text and whole-second UTC kickoff. pick_id is decimal text; version is JSON integer 2.

PickOfTheDayHitRate

PickOfTheDayLedger

The commitment ledger: every published pick, ascending, in the state its commitment is actually in. The counts are derived from entries in the same pass that builds it.

PickOfTheDayLedgerEntry

One ledger entry. Read state to know which shape you have; the three are disjoint. One of: PickOfTheDayLedgerSealedEntry, PickOfTheDayLedgerOpenedEntry, PickOfTheDayLedgerUncommittedEntry. Discriminated by state.

PickOfTheDayLedgerOpenedEntry

A settled pick whose commitment is open: the nonce plus the exact payload the hash was taken over. Concatenate the payload bytes as received with the decoded nonce and sha256 them to reproduce commitment_hash.

PickOfTheDayLedgerSealedEntry

An unresolved published pick. Carries only date, rank, hash, algorithm, seal instant and permalink. Kickoff and game identity are withheld; seal time remains public commitment provenance.

PickOfTheDayLedgerUncommittedEntry

A pick without a commitment, retained so the record cannot omit unprovable entries. Unresolved entries omit game identity; once resolved, matchup, category and payload become public. Existing opened canonical payload bytes and hashes are unchanged.

PickOfTheDayMarketExpectations

PickOfTheDayNoEntitledPicks

A successful current-day entitlement response when only unauthorized ranks have published. It carries an empty pick set, identity-free locked ranks and an upgrade message. Selection IDs, game identity, prices and unauthorized clocks are absent. Any scheduled or proof-pending rows are entitled rows.

PickOfTheDayOutcomeStats

PickOfTheDayStats

PickOfTheDayStatsBucket

PickOfTheDayStatsDay

PickOfTheDayStatsRecords

PickOfTheDayStatsSections

The stats with view=summary or sections: only the named sections, listed in sections. view=summary names every section except series, days, categories, months and voids.

PickOfTheDayStatsStreaks

PickOfTheDayStatsVoid

PickOfTheDayUncommittedPayload

A settled uncommitted pick’s market, side and price. The same eight fields as PickOfTheDayCommitmentPayload, in the same key order, so a settled pick’s side and price sit under payload whatever the entry’s state. It is NOT a commitment: no hash was taken over it before the game, and it proves nothing about when the pick was made.

PickSportsContext

Provider-first sports context for a Pick of the Day market: team crests, league branding, and live score. Each team logo is a registered club crest or national flag as a same-origin path where one exists, and provider artwork otherwise.

PickSportsTeam

A single sports team or competitor in a Pick of the Day market’s sports context. Identity and score fields are provider-owned and nullable. The structured score fields (sets, format, sets_won) and the tennis fields (headshot, headshot_revision, tour) are backend-owned and are OMITTED rather than null when they do not apply, so a consumer must treat an absent key and a null the same way.

PlatformCapabilities

PlatformCapabilityStatus

Every capability the API serves reports supported. The field names a per-capability status so a client can branch on coverage; no other value is emitted. String enum: supported.

Platforms

PnlCorrection

A derived 0xinsider correction to Polymarket’s P&L, never a Polymarket value. Polymarket misbooks neg-risk conversions, in both directions: it puts cost on placeholder YES outcomes minted by a conversion and never books it as a loss (negative amount), and its position records leave out shares the wallet really got, such as YES minted by a conversion, so it books no P&L on them (positive amount). Per neg-risk market the wallet converted in, 0xinsider measures Polymarket’s own activity cash against the sum of its position P&L, and sums the difference over every measured market whose shares did not move by direct transfer: transferred shares have no activity row, so such a market keeps Polymarket’s figure and is counted in markets_excluded. It is published once every neg-risk market with a sports or esports event that the wallet converted in is measured and checked for transfers, and stays as last published until then; a market with no sports or esports event is not measured, and counts only when it was measured before (on the trader body, pnl.correction_pending says so); a sum under $1 either way publishes nothing. The body’s own P&L fields keep Polymarket’s figures; this object adds the amount and the corrected figures. Money is truncated toward zero to cents.

Position

PositionExact

Lossless position atoms from wallet_positions. shares and current_value_usd are required when this object is present; other source values are omitted when the mirror has no verified value.

PositionTimelineEvent

PotdEntryAuthorization

Returned entry permission bound to the named market, token and outcome. Honor the immutable max_entry_price and expires_at, and quote a current executable book for the actual stake. The submitted order price must remain within the returned limit; fills may be lower. Fees are separate, and this grant does not guarantee liquidity, execution or positive expected value.

PriceMoveOutcomeAfter

What outcome 0’s midpoint did after the move, read from the live order book: two-sided with a spread of 10 cents or less. Each checkpoint is measured (mid and its read time), unavailable (unavailable_reason), or pending. Null never means 0.

PriceMoveSubscriptionFilters

Settings for market_price_moved: required when event_types includes it, refused (400) when it does not. A PATCH without it keeps the stored settings; removing the event clears them. A subscription receives at most one delivery per market per window: the one level step whose (previous_level_cents, level_cents] holds min_move_cents.

ProofPendingPickSlot

One PUBLISHED same-day pick whose holder proof is not readable yet: its stable slot rank, the release and kickoff instants, and the instant before which a retry cannot succeed. Every item in picks carries its full required shape, so a pick that cannot meet it is listed here instead of being served with missing fields or a synthetic zero.

ReportPayload

ReportReconciliation

ReportSnapshot

ReportSourceRange

ResolutionReport

ResponseMeta

ScheduledPickSlot

An entitled same-day slot with a future scheduled release: stable identity and backend-owned release/kickoff instants. It leaves this list at its release instant; an unpublished slot is never a delayed recommendation. No matchup, category, platform, side, price, or holder fields appear before release. Unauthorized scheduled ranks appear only in locked_picks.

ScoreCell

One side’s score in a single set. The verbatim provider text stays on the team’s score string; this is the parsed form.

ScoreFormat

Shape the provider score string was parsed into. two_side is one aggregate per side (basketball 105-98), multi_set is per-set columns (tennis 6-7(5-7), 6-0, 1-0), esports_series is a maps/sets/format triplet (000-000\|2-0\|Bo3). Omitted when the score could not be parsed. String enum: two_side, multi_set, esports_series.

SettledMarketData

One GET /api/v1/markets/settled row: the market_settled webhook’s data, MarketSettledData, protocol_version included. Kept as its own name for clients generated since SDK 0.45.0. No documented fields.

SettlementSubscriptionFilters

Settings for market_settled; every set field must match. Optional: subscribing without it stores {“sports_market_types”: [“moneyline”]}, every market Polymarket labels moneyline, and sending it without the event is refused (400). That label is each head-to-head game’s winner market, but in golf and other field events Polymarket labels every player market moneyline (winner, make the cut, round leader), so one tournament can send hundreds of states. Narrow it with leagues, which no market outside the list matches, including one whose league is null (a golf event slug that starts with a year, such as 2026-world-wide-technology-championship), or with condition_ids. A PATCH without it keeps the stored settings while the event stays subscribed; removing the event clears them. Stored as the API normalized it: trimmed and deduplicated, leagues, market types and condition IDs lowercased, and sports_market_types filled in when omitted.

SharpMoneyFlowDetectedData

sharp_money_flow_detected data (Pro and Max): ranked-trader net flow on a market crossed the threshold. The deprecated spelling smart_money_flow_detected delivers the same object until its sunset on 2027-02-01 (#29352).

SmartMoneyFlowMarket

SnapshotCompleteness

SnapshotState

SportLeaderboard

One sport’s skill leaderboard, or one league’s. Every figure on a row is the wallet’s record in this sport or league, except grade, the wallet’s all-time grade, and volume (see volume_scope).

StoredPriceMove

One stored price move: the market_price_moved payload of the episode’s largest step, unchanged, plus move_id, episode_started_at and outcome_after. No documented fields.

SuspiciousTrade

SuspiciousTradeFlaggedData

suspicious_trade_flagged data (Pro and Max): a trade’s suspicion score crossed the flag threshold for the first time. The deprecated spelling insider_radar_flag_raised delivers the same object until its sunset on 2027-02-01 (#29352).

TennisPoints

Optional current-game tennis facts from API-Tennis, aligned with live_score.scores display order. These facts have their own revision and expiry; Polymarket remains the source of sets, match status, period, and the outer live-score revision, except on ITF singles, which Polymarket does not score: there API-Tennis supplies the whole live_score, bound on both players’ names, the tournament and the date. New observations require corroborated identity, current set/games, and live state. Where Polymarket publishes no score (tennis doubles, whose live_score reads one 0-0 set throughout), the group binds on both pairs’ names, the tour, the date and API-Tennis’s live flag, and carries set_games, the provider’s set score for the match. Cached responses and replayed frames may still carry expired facts, so clients must enforce expires_at.

TennisRanking

A provider-reported ATP/WTA singles rank with independent retrieval and expiry clocks. API-Tennis provides no ranking publication date. Retrieval time does not establish when the tour published the ranking.

Trader

TraderBreakdowns

The profile’s strategy measures (expand=breakdowns, #32622), the same figures as the wallet profile’s Insights and Performance breakdown cards. Every figure counts the wallet’s sports and esports markets only, from the same read the profile makes.

TraderCategoryRecord

TraderCategoryRecords

TraderCategoryScopeRecord

TraderClv

Closing line value over one wallet’s large trades in a window (#32517).

TraderContext

TraderEntryPriceAnalysis

Results by the entry price the wallet paid for the side it held, over its settled sports and esports positions with a held entry price. coverage counts the settled positions the buckets leave out, and why.

TraderEntryPriceBucket

One entry-price band. Each measure is an analytic value: read state before value.

TraderEntryPriceCoverage

The settled sports and esports positions the entry-price section reads. The buckets’ markets plus every unbucketed row’s are settled_markets, and their realized P&L sums to settled_pnl. settled_pnl adds up the wallet’s per-market realized P&L, so it differs from pnl.in_scope.realized_pnl, which is Polymarket’s published sports and esports P&L with a share of the wallet’s rebates.

TraderEntryPriceUnbucketed

Settled positions with no entry-price bucket, for one reason.

TraderEsportsGameRecord

TraderExportArtifactManifest

TraderExportCategoryWatermark

TraderExportGeneration

TraderExportJob

TraderExportPnlWatermark

TraderExportPositionWatermark

TraderExportSnapshot

TraderExportSourceWatermarks

TraderExportTradeWatermark

TraderGradeAt

TraderHourlyPerformance

P&L and win rate by the UTC hour of the wallet’s first trade in each settled sports or esports market.

TraderPnl

A trader’s sports and esports daily P&L object. id, freshness_at, series_status and realized are always present. The five sections — entries, stats, monthly, year_totals, drawdown — are present unless the request’s sections parameter excluded them, so a request that sends no sections always carries all five. An excluded section is absent from the object, never null and never an empty array. While series_status is pending the sections are empty and never mean zero.

TraderPnlExact

Deprecated since 2026-10-27 and never sent: pnl.exact held the lossless counterpart of the retired wallet-wide pnl.realized (#29830). The member shape below is what the object held before; it is kept so existing type declarations still compile.

TraderPnlInScope

A wallet’s sports and esports record (#27311). basis names the rule behind realized_pnl (#29370): polymarket_sports_esports_v1 is Polymarket’s own realized P&L for the wallet in its sports and esports categories, plus the wallet’s maker and taker rebates apportioned by its sports and esports share of its Polymarket volume (by cost while Polymarket reports no overall volume) and the in-scope part of any published neg-risk conversion correction; sports_esports_split_v1, used until both of the wallet’s category figures are confirmed, is Polymarket’s published wallet-wide realized P&L (with any published correction) split into the part earned on sports and esports markets, with fees, refunds and rebates apportioned by cost. Refreshed after each wallet sync and each read of Polymarket’s category leaderboards; as_of dates the market counts.

TraderPriceEdge

Edge over the price paid (#32270, #32622): how often the side a wallet bought won, minus the average price it paid, over its settled sports and esports markets of $20 or more at a known entry price. Probabilities throughout: edge 0.012 is 1.2 percentage points. The same figures as LeaderboardPriceEdge, plus the shrunk edge the profile badge and the leaderboard show. No hold: a hold is a fact of a leaderboard row, not of the wallet.

TraderRiskMetrics

Position sizes over the wallet’s sports and esports positions with trades, and how concentrated its volume is across categories. Each measure is an analytic value: read state before value. The four size measures are not_computed while any position’s cost is unknown; the counts are always measured.

TraderStatsExact

Lossless counterparts for trader statistics. The object is present exactly when stats.total_volume is.

TraderSyncedData

trader_synced data: a tracked wallet finished a sync pass and has a fresh grade. The deprecated spelling whale_trader_synced delivers the same object until its sunset on 2027-02-01 (#29352).

TraderTimeBreakdownBand

One band of a time breakdown.

TraderTimeBreakdowns

The hold-time and first-trade-hour bands of the profile’s Performance breakdown card, over the wallet’s sports and esports markets with a realized P&L.

TraderTrust

Field-level trust metadata returned only when GET /api/v1/trader/{address} includes expand=trust. A field served with a clock takes its data_quality group’s verdict: freshness.status is that group’s fresh or stale, with its as_of and max_age_s, so the two never disagree (since 2026-11-15, #35613).

TrendingWallet

TrustCompleteness

Whether the described value or result set is complete for its stated contract.

TrustFreshness

Freshness metadata for a trust-critical value. This is separate from transport cache fields in ResponseMeta.

TrustMetadata

Shared source/freshness/reconciliation/completeness metadata for public API values that may be cached, stale, partial, computed, or provider-unavailable. Unavailable provider values must be represented with explicit metadata instead of fabricated zeros or empty arrays.

TrustReconciliation

How provider-owned facts were reconciled with stored/read-model values.

TrustSource

Source metadata for a trust-critical value. Providers and DB/read models own business truth; clients should not infer missing provider facts from titles, slugs, zeros, or empty arrays.

UpdateWebhookRequest

Usage

VerifyWebhookRequest

WalletGradeChangedData

wallet_grade_changed data (Pro and Max): a tracked wallet’s grade moved on a re-grade.

WebhookDelivery

Owner-scoped view of one webhook delivery attempt. Deliberately omits the request body and the endpoint signing secret: a delivery log never re-exposes the payload or any secret material.

WebhookEndpoint

WebhookEventDescriptor

Self-describing entry in the webhook event catalog: the event type a subscriber lists in event_types, when it fires, the data payload shape, and whether it currently fires (active) or is reserved (dormant, subscribable but not yet delivered). Pro-only event types (large_trades_inserted, whale_trades_inserted, wallet_grade_changed, suspicious_trade_flagged, insider_radar_flag_raised, sharp_money_flow_detected, smart_money_flow_detected) only deliver to API keys on an active Pro subscription. Export lifecycle event types (export_job_ready, export_job_failed, export_job_expired, export_job_cancelled) are owner-scoped to the API-key account that created the export and contain no download URL; use the authorized export status/download routes. Some entries are two spellings of one event: large_trades_inserted and whale_trades_inserted, trader_synced and whale_trader_synced, suspicious_trade_flagged and insider_radar_flag_raised, sharp_money_flow_detected and smart_money_flow_detected. Either spelling subscribes, and an endpoint receives deliveries under the spelling it registered. The deprecated spellings (whale_trades_inserted, whale_trader_synced, insider_radar_flag_raised, smart_money_flow_detected) reach their sunset on 2027-02-01 (#29352); register the canonical spelling.

WebhookEventType

String enum: large_trade_inserted_v2, large_trades_inserted, whale_trades_inserted, live_sports_updated, trader_synced, whale_trader_synced, large_positions_updated, wallet_grade_changed, suspicious_trade_flagged, insider_radar_flag_raised, sharp_money_flow_detected, smart_money_flow_detected, export_job_ready, export_job_failed, export_job_expired, export_job_cancelled, market_price_moved, market_settled.

WebhookRetryPolicy

WebhookSecretRotation

WebhookStatus

String enum: pending_verification, active, disabled.

WebhookVerification

WebhookVerificationAttempt

WhaleDatasetArtifactManifest

WhaleDatasetContinuation

WhaleDatasetFilters

Normalized immutable request; [from, to), maximum 31 days; min_size rounded to cents like durable replay.

WhaleDatasetGeneration

WhaleDatasetJob

WhaleDatasetTrade