@0xinsider/sdk 0.32.0 → 0.35.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +11 -0
- package/dist/client.d.ts +212 -4
- package/dist/client.d.ts.map +1 -1
- package/dist/client.js +228 -13
- package/dist/client.js.map +1 -1
- package/dist/errors.d.ts +4 -3
- package/dist/errors.d.ts.map +1 -1
- package/dist/errors.js +6 -4
- package/dist/errors.js.map +1 -1
- package/dist/index.d.ts +3 -3
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1 -1
- package/dist/index.js.map +1 -1
- package/dist/provenance.d.ts +2 -2
- package/dist/provenance.d.ts.map +1 -1
- package/dist/provenance.js +3 -3
- package/dist/provenance.js.map +1 -1
- package/dist/schema.d.ts +1366 -147
- package/dist/schema.d.ts.map +1 -1
- package/package.json +1 -1
package/dist/schema.d.ts
CHANGED
|
@@ -3,7 +3,8 @@ export type AccountIdentity = {
|
|
|
3
3
|
data: {
|
|
4
4
|
user_id: number;
|
|
5
5
|
credential_id: number;
|
|
6
|
-
|
|
6
|
+
/** The kind of credential that made the request: api_key is a full-access developer key, oauth_grant an OAuth access token, integration_key a named integration key with fixed scopes created on https://0xinsider.com/developers. Before integration_key was added, these keys reported oauth_grant. */
|
|
7
|
+
credential_kind: "api_key" | "oauth_grant" | "integration_key";
|
|
7
8
|
/** The credential is currently valid; revoked, expired or unknown credentials are rejected. */
|
|
8
9
|
credential_status: "active";
|
|
9
10
|
entitlement: {
|
|
@@ -11,7 +12,7 @@ export type AccountIdentity = {
|
|
|
11
12
|
/** When paid data access is lapsed, the caller should renew the subscription; otherwise null. */
|
|
12
13
|
recovery_action: "renew_subscription" | null;
|
|
13
14
|
};
|
|
14
|
-
/**
|
|
15
|
+
/** The scopes an OAuth grant or integration key carries; null for full developer-key access. */
|
|
15
16
|
scopes: string[] | null;
|
|
16
17
|
};
|
|
17
18
|
meta: ResponseMeta;
|
|
@@ -93,6 +94,14 @@ export type ApiErrorBody = {
|
|
|
93
94
|
/** ADDITIVE (#7209). The specific, actionable cause behind `code`, when there is one more specific than the code itself. `code` keeps its published values, so existing clients are unaffected; new clients branch on `reason`. Omitted when the code already says everything we know. pick_not_released: no Pick of the Day is published for the current product day; schedule one request against retry_at instead of polling. unknown_endpoint: the PATH is not a route on this API -- read GET /api/v1, do not retry. trader_not_tracked: the wallet is real and the URL is right, but the trader is not on the warm sync tier (the wallets we sync most often) -- stop asking for this wallet. market_out_of_scope (404 not_found, #27303): the market or event is real and the URL is right, but 0xinsider serves sports and esports markets only -- stop asking for this market; neither a retry nor another URL for it can succeed. cursor_expired: pagination went stale mid-walk -- re-request the first page and continue. read_model_warming: the requested endpoint cannot serve its read model yet; exact causes are endpoint-specific and can include a cold or contended refresh or a dependency that prevented refresh. database_unavailable: the API's database or its connection pool is temporarily unreachable (a connection-class failure, not a query fault); code stays rate_limit_unavailable, nothing is rate-limited, retry after Retry-After / retry_at. idempotency_in_progress: retain the exact Idempotency-Key and request body, then retry shortly. webhook_delivery_in_progress: retry the URL or signing-secret configuration change after the destination's active request completes. request_accounting_unavailable: accounting capacity is unavailable before the handler executes; retry after Retry-After / retry_at. sandbox_api_key: the credential is a sandbox key (oxi_sk_test_) from POST /api/v1/agents/register, which only the sandbox server accepts -- call the sandbox base URL with it, or get a live key or OAuth access token; do not retry it here. api_key_in_query: the key was sent as a ?token= query parameter, which no route reads because URLs land in logs and history; the key itself was not checked -- resend it as Authorization: Bearer. subscription_inactive: the key is valid but the account's Pro subscription has lapsed (402 subscription_required); permanent until a person reactivates at https://0xinsider.com/billing, which the message names -- stop retrying on a schedule and surface the link. The key owner is emailed once per lapse. monthly_quota_exceeded: the account has used the requests its plan includes for the UTC calendar month (429 rate_limited); retry_at and Retry-After name the first of next month, the only retry that can succeed, and the message names https://0xinsider.com/developers, where pay as you go for requests over the quota is turned on. The X-Monthly-Quota-Limit, X-Monthly-Quota-Remaining and X-Monthly-Quota-Reset headers on every authenticated response say how close the account is. invalid_query, invalid_path, invalid_body (400 bad_request, #16146): a query parameter, a path segment or the JSON body did not parse or does not fit the route's schema, so no handler ran; param names the field when the parser named one (a query key, a path segment, a JSON path such as traders[0], or body); fix the request, never retry it as sent. unsupported_media_type (415 bad_request, param content-type): send the body with Content-Type: application/json. payload_too_large (413 bad_request, param body): the body is over 1048576 bytes. method_not_allowed (405 bad_request): the path is a route but not with this method; the Allow header names the methods it serves. ip_rate_limited (429 rate_limited, #16380): the per-address budget every caller behind one IP shares, counted before authentication, is spent; not the key's own window, and the RateLimit-* headers describe that bucket. ip_throttled (429 rate_limited): the address is in a cooldown after sustained over-limit traffic; Retry-After is minutes to days, and a request before it does not shorten the cooldown. cold_read_limited (429 rate_limited, #28752): the account has used its share of cold reads on GET /api/v1/market/{condition_id}/holders, requests for a market whose roster is not cached, each of which walks Polymarket (6 a minute, in bursts of up to 400); not the per-minute window, so a cached market still answers, and the next cold read is admitted at Retry-After. max_plan_required (403 forbidden, #23085): the key is valid and its account is on Pro, but the route is part of Max (GET /api/v1/edge-hunter); every Pro route keeps working with the same key, so do not disable it. The message names https://0xinsider.com/pricing, where the account upgrades; a retry never clears it. endpoint_retired (410): this legacy sports endpoint no longer serves data. Migrate to GET /api/v1/edge-hunter; retrying the retired path cannot succeed. */
|
|
94
95
|
reason?: "cursor_expired" | "unknown_endpoint" | "pick_not_released" | "trader_not_tracked" | "market_out_of_scope" | "read_model_warming" | "database_unavailable" | "request_accounting_unavailable" | "idempotency_in_progress" | "webhook_delivery_in_progress" | "webhook_secret_rotation_not_prepared" | "webhook_secret_rotation_overlap_active" | "sandbox_api_key" | "api_key_in_query" | "subscription_inactive" | "monthly_quota_exceeded" | "invalid_query" | "unknown_query_parameter" | "invalid_path" | "invalid_body" | "unsupported_media_type" | "payload_too_large" | "method_not_allowed" | "ip_rate_limited" | "ip_throttled" | "cold_read_limited" | "export_expired" | "freshness_ceiling_unsatisfied" | "max_plan_required" | "endpoint_retired";
|
|
95
96
|
};
|
|
97
|
+
export type BatchGameHoldersItem = {
|
|
98
|
+
/** Zero-based request index. Duplicate inputs keep separate result rows. */
|
|
99
|
+
index: number;
|
|
100
|
+
input: string;
|
|
101
|
+
status: "ok" | "error";
|
|
102
|
+
data?: GameHoldersItem;
|
|
103
|
+
error?: ApiErrorBody;
|
|
104
|
+
};
|
|
96
105
|
export type BatchMarketFlowItem = {
|
|
97
106
|
/** Zero-based request index. Duplicate inputs keep separate result rows. */
|
|
98
107
|
index: number;
|
|
@@ -141,6 +150,22 @@ export type Candle = {
|
|
|
141
150
|
/** Close price in provider [0, 1] units (last observed point in the bucket). */
|
|
142
151
|
c: number;
|
|
143
152
|
};
|
|
153
|
+
export type CategoryLeader = {
|
|
154
|
+
address: string;
|
|
155
|
+
as_of: string;
|
|
156
|
+
category: string;
|
|
157
|
+
edge_lower_bound: number | null;
|
|
158
|
+
grade: "S" | "A" | "B" | "C" | "D" | "F" | null;
|
|
159
|
+
id: string;
|
|
160
|
+
independent_events: number;
|
|
161
|
+
n_resolved: number | null;
|
|
162
|
+
platform: "polymarket";
|
|
163
|
+
pnl: number | null;
|
|
164
|
+
rank: number;
|
|
165
|
+
unresolved_events: number;
|
|
166
|
+
username: string | null;
|
|
167
|
+
win_rate: number | null;
|
|
168
|
+
};
|
|
144
169
|
/** Model-wide readiness, read in the same database snapshot as category_records. Individual category rows retain their own status. */
|
|
145
170
|
export type CategorySkillModelReadiness = {
|
|
146
171
|
status: "live" | "insufficient" | "stale" | "unknown" | "degraded";
|
|
@@ -267,8 +292,6 @@ export type ComboFillsResponse = {
|
|
|
267
292
|
/** Continuation offset for largest or payout ordering. */
|
|
268
293
|
next_offset?: number;
|
|
269
294
|
meta: ResponseMeta;
|
|
270
|
-
/** Not computed for combo fill pages; omitted. */
|
|
271
|
-
total?: number;
|
|
272
295
|
};
|
|
273
296
|
export type ComboLeg = {
|
|
274
297
|
leg_index: number;
|
|
@@ -604,7 +627,7 @@ export type EdgeHunterObservation = {
|
|
|
604
627
|
provider_read_source: "cached" | "live";
|
|
605
628
|
/** True only when the provider page read for each outcome token listed every holder of that token. Observation collection reads one 100-row page per token; a token with more holders stays incomplete. False means holder counts and dollar totals measure the observed positive-holder subset. sharp_pct describes that observed subset and is not a lower bound on the full-population percentage. Incomplete scans cannot satisfy a future capital-promotion gate. */
|
|
606
629
|
holder_scan_complete: boolean;
|
|
607
|
-
/** Proven provider holder observation time. A warm cache hit uses only the original provider completion time from its companion metadata, never cache-read time. A wider_holder or emerging_pile row whose holder read did not finish in the current pass may reuse that market's last pregame holder page for up to 15 minutes; an in_play row may reuse its last in-play page, read after the provider reported the game live and never before that market's own kickoff, for up to 10 minutes. Both ages are counted when the snapshot is computed. Either reuse carries that page's original time here and provider_read_source cached. A pregame market more than an hour before kickoff reuses its last page the same way until that page is 10 minutes old, and only then is read again. Once that market's own kickoff has passed, an in_play row with provider_read_source cached, a warm hit or a reuse, never carries a page read before it. Null, malformed, future, or stale holder time fails in-play closed. */
|
|
630
|
+
/** Proven provider holder observation time. A warm cache hit uses only the original provider completion time from its companion metadata, never cache-read time. A wider_holder or emerging_pile row whose holder read did not finish or failed in the current pass may reuse that market's last pregame holder page for up to 15 minutes; an in_play row may reuse its last in-play page, read after the provider reported the game live and never before that market's own kickoff, for up to 10 minutes. Both ages are counted when the snapshot is computed. Either reuse carries that page's original time here and provider_read_source cached. A pregame market more than an hour before kickoff reuses its last page the same way until that page is 10 minutes old, and only then is read again; while that market has had no trade since the page, it keeps reusing the page until it is 30 minutes old. Once that market's own kickoff has passed, an in_play row with provider_read_source cached, a warm hit or a reuse, never carries a page read before it. Null, malformed, future, or stale holder time fails in-play closed. */
|
|
608
631
|
holder_snapshot_at: string | null;
|
|
609
632
|
/** Truthful state of the directional read, which classifies each graded holder by its fresh synced legs across the game's markets and, when holder_scan_complete is true, by Polymarket's currentValue on both outcomes of this market. A wider_holder row can remain emitted with unavailable and terminal wider_holder_emitted; in_play fails closed instead and terminates as in_play_directional_unavailable. */
|
|
610
633
|
directional_status: "available" | "unknown_ungrouped" | "unknown_stale" | "unavailable";
|
|
@@ -656,7 +679,7 @@ export type EdgeHunterObservationDeparture = {
|
|
|
656
679
|
last_observed_at: string;
|
|
657
680
|
/** snapshot_as_of of the first snapshot of this selection without the card. */
|
|
658
681
|
departed_at: string;
|
|
659
|
-
/** Why the market has no card: its terminal in this selection's funnel in the snapshot it left, and while that terminal reports a read that did not finish (holder_deadline_unavailable, provider_unavailable, holder_computation_unavailable, internal_unclassified), the terminal of each later snapshot until one answers; an answered reason
|
|
682
|
+
/** Why the market has no card: its terminal in this selection's funnel in the snapshot it left, and while that terminal reports a read that did not finish (holder_deadline_unavailable, provider_unavailable, holder_computation_unavailable, internal_unclassified), the terminal of each later snapshot until one answers; an answered reason stays, except as view=signals starts or stops listing the market. primary_slate_candidate: view=signals lists the market. While the entry stays, a later snapshot that read view=signals and no longer excludes the market replaces it with that snapshot's terminal, one that excludes the market replaces any other reason with it, and one with signals_as_of null leaves it as it is. capacity_limited: it lost its evaluation place without another outcome. missing_stored_market: the market was no longer in the stored market universe. Any other value means what it means in the funnel, for example split_holder_pile, no_current_graded_holder or resolved. */
|
|
660
683
|
reason: EdgeHunterObservationTerminalReason;
|
|
661
684
|
};
|
|
662
685
|
/** 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. */
|
|
@@ -680,10 +703,12 @@ export type EdgeHunterObservationsResponse = {
|
|
|
680
703
|
selection?: EdgeHunterSelection;
|
|
681
704
|
/** Echoes the opt-in admission rule a request named; omitted on a default read. When present, data, funnel, coverage, degraded and degradation_reasons describe that selection, not the default one. */
|
|
682
705
|
admission?: "most_held_48h";
|
|
683
|
-
/** cohort=wider_holder only, for the default selection and for admission=most_held_48h: markets that had a wider_holder card in an earlier snapshot of the same selection, have none in this one, and have not kicked off. Newest departed_at first. An entry stays until the game_start_time it carries passes, and leaves as soon as the market has a card again; while it stays only
|
|
706
|
+
/** cohort=wider_holder only, for the default selection and for admission=most_held_48h: markets that had a wider_holder card in an earlier snapshot of the same selection, have none in this one, and have not kicked off. Newest departed_at first. An entry stays until the game_start_time it carries passes, and leaves as soon as the market has a card again; while it stays, its reason changes only while it reports an unfinished read or when view=signals starts or stops listing the market (see reason), and a later departure of the same market is a new entry. Filtered by the same category and selectors as data, and identical on every page of one snapshot. At most 336 entries; when more are open, the oldest departures leave first. An empty array means no card of this selection is departed. Omitted on in_play and emerging_pile, and on a snapshot that could not establish its departures, never reported as an empty array. Tracking that restarts after its record is lost starts empty. */
|
|
684
707
|
departures?: EdgeHunterObservationDeparture[];
|
|
708
|
+
/** The ranked_at of the view=signals snapshot whose listed markets this snapshot excluded from wider_holder as primary_slate_candidate. The refresh that computed this snapshot read it as it started, so it can be one refresh older than the view=signals snapshot a reader sees at the same moment. null when no view=signals snapshot could be read: that refresh excluded no market, and the funnel counts no primary_slate_candidate. Omitted on an unmappable legacy category, which reads no generation. */
|
|
709
|
+
signals_as_of?: string | null;
|
|
685
710
|
};
|
|
686
|
-
/** 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
|
|
711
|
+
/** 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. */
|
|
687
712
|
export type EdgeHunterObservationTerminalReason = "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";
|
|
688
713
|
/** 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. */
|
|
689
714
|
export type EdgeHunterOutcome = {
|
|
@@ -703,6 +728,8 @@ export type EdgeHunterParticipant = {
|
|
|
703
728
|
headshot_revision?: number;
|
|
704
729
|
tour?: string;
|
|
705
730
|
name: string;
|
|
731
|
+
logo_mark_light?: boolean;
|
|
732
|
+
logo_mark_measured?: boolean;
|
|
706
733
|
};
|
|
707
734
|
export type EdgeHunterPrice = {
|
|
708
735
|
/** Provider probability as a decimal string. Keep its precision until display. */
|
|
@@ -878,15 +905,15 @@ export type EdgeHunterSportFunnelReport = {
|
|
|
878
905
|
board_live_available: boolean;
|
|
879
906
|
/** Whether a provider-backed upcoming-board source is configured and applicable for this sport. False means not applicable, not provider failure. */
|
|
880
907
|
board_upcoming_configured: boolean;
|
|
881
|
-
/** Whether every configured upcoming-board scope completed as available. False with board_upcoming_configured=false means not applicable. When board_upcoming_configured is true and this flag is false, read board_upcoming_status for the cause (
|
|
908
|
+
/** Whether every configured upcoming-board scope completed as available. False with board_upcoming_configured=false means not applicable. When board_upcoming_configured is true and this flag is false, read board_upcoming_status for the cause (unknown means no cause was recorded, which no computed snapshot reports): the board_source_unavailable and board_deadline_unavailable terminals are assigned only to already-started rows (the live half) and are structurally 0 for the upcoming source, so they never explain this flag. */
|
|
882
909
|
board_upcoming_available: boolean;
|
|
883
|
-
/** Why the upcoming-board source is (un)available. Board supply is one canonical-sport union: the bare category owns live truth and every configured composed league scope contributes upcoming rows; folded leagues without a configured board (currently
|
|
910
|
+
/** Why the upcoming-board source is (un)available. Board supply is one canonical-sport union: the bare category owns live truth and every configured composed league scope contributes upcoming rows; folded leagues without a configured board (currently CFL) are not in the upcoming union. available: every configured scope completed truthfully (a successful empty schedule still counts). capacity_limited: provider pagination or a configured upcoming cache published an intentionally bounded complete-event prefix; those rows are excluded from diagnostic-universe input and must not be treated as a complete upcoming universe. Cache-bound prefixes are limited to an exact 5,000,000-byte final envelope. source_unavailable: composition failed before a truthful union; resolved scope readers turn half failures into cold_unavailable, so fresh producers are whole-union identity reconciliation or a registry contract failure and carry zero rows. cold_unavailable: every scope completed but at least one reported its upcoming half unavailable because no servable entry was inside the stale-serve bound and the background warm did not land in time; it is not by itself proof of a provider outage. deadline_unavailable: an internal configured-scope deadline or the outer bounded fair wave expired. An internal deadline may retain healthy bare-category or sibling-scope rows; the outer wave records zero rows. These upcoming fields do not describe league live-membership availability. If the bare-category live scope fails, all live rows are dropped even when a league scope completed, because the bare category is the sole live-truth owner. not_configured: no upcoming scope applies to the sport. unknown: no cause was recorded; every computed snapshot reports a concrete status, so none reads unknown. board_upcoming_available is exactly board_upcoming_status == available. */
|
|
884
911
|
board_upcoming_status: "unknown" | "not_configured" | "available" | "capacity_limited" | "source_unavailable" | "cold_unavailable" | "deadline_unavailable";
|
|
885
|
-
/** Configured upcoming scopes that did not complete as available. Values are category, a provider league tag slug (nfl, cfb, nba, wnba, euroleague-basketball, nhl, mls, valorant, league-of-legends, counter-strike-2, or dota-2), registry when the compiled scope/projection contract drifted, union when cross-scope identity reconciliation failed, or wave when the outer fair-wave deadline expired before scope-level evidence returned. Empty means no unavailable upcoming scope was identified; this includes healthy/not-configured rows and a legacy cached row. Observation league scopes are upcoming-only and perform no live-membership read. */
|
|
886
|
-
board_upcoming_unavailable_scopes: ("category" | "nfl" | "cfb" | "nba" | "wnba" | "euroleague-basketball" | "nhl" | "mls" | "valorant" | "league-of-legends" | "counter-strike-2" | "dota-2" | "registry" | "union" | "wave")[];
|
|
912
|
+
/** Configured upcoming scopes that did not complete as available. Values are category, a provider league tag slug (nfl, cfb, nba, wnba, euroleague-basketball, ncaa-basketball, cwbb, nhl, mls, valorant, league-of-legends, counter-strike-2, or dota-2), registry when the compiled scope/projection contract drifted, union when cross-scope identity reconciliation failed, or wave when the outer fair-wave deadline expired before scope-level evidence returned. Empty means no unavailable upcoming scope was identified; this includes healthy/not-configured rows and a legacy cached row. Observation league scopes are upcoming-only and perform no live-membership read. */
|
|
913
|
+
board_upcoming_unavailable_scopes: ("category" | "nfl" | "cfb" | "nba" | "wnba" | "euroleague-basketball" | "ncaa-basketball" | "cwbb" | "nhl" | "mls" | "valorant" | "league-of-legends" | "counter-strike-2" | "dota-2" | "registry" | "union" | "wave")[];
|
|
887
914
|
/** Stored-universe rows plus provider-board rows missing from storage. */
|
|
888
915
|
input: number;
|
|
889
|
-
/** Sparse counts over the closed 25-value terminal vocabulary: 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, or internal_unclassified. primary_slate_candidate means
|
|
916
|
+
/** Sparse counts over the closed 25-value terminal vocabulary: 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, or internal_unclassified. primary_slate_candidate means the view=signals snapshot named by signals_as_of lists the market at its widest selection (horizon_hours=48, min_grade=B, no selector), so it is not a wider_holder candidate; when no view=signals snapshot could be read (signals_as_of null), no market takes it. capacity_limited is intentional bounded provider-work admission, is fully accounted here, and does not itself set degraded=true. board_source_unavailable means a completed board source was unavailable; board_deadline_unavailable means live-board work missed either an internal configured-scope deadline or the outer fair-wave deadline; provider_unavailable means a holder read sent to the provider failed and the market had no reusable holder page; holder_deadline_unavailable means holder cache/provider work missed the absolute request deadline, or local capacity never sent the holder read, and the market had no reusable holder page; holder_computation_unavailable means post-holder provider or DB-backed price/metadata evaluation was unavailable. */
|
|
890
917
|
terminals: Record<string, number>;
|
|
891
918
|
/** Sum of every sparse terminal count. */
|
|
892
919
|
terminal_total: number;
|
|
@@ -928,7 +955,6 @@ export type EventReplayMeta = {
|
|
|
928
955
|
/** Unique request ID (req_ prefix). The same value as the X-Request-Id response header, the request's usage accounting row and its log lines. */
|
|
929
956
|
request_id: string;
|
|
930
957
|
cached: boolean;
|
|
931
|
-
cache_age_s?: number;
|
|
932
958
|
/** Advisory request weight (relative compute cost). 1 for simple reads; higher for heavier endpoints. Not a credit/price. */
|
|
933
959
|
cost: number;
|
|
934
960
|
replay: {
|
|
@@ -1130,7 +1156,7 @@ export type ExportCompleteness = {
|
|
|
1130
1156
|
sync_coverage: number;
|
|
1131
1157
|
};
|
|
1132
1158
|
export type ExportCounts = {
|
|
1133
|
-
/**
|
|
1159
|
+
/** The days in the export file's pnl section, the wallet's sports and esports realized P&L by UTC day: the file's export_metadata.pnl_rows, at most its earliest 3650 days. 0 while source_range.pnl_series_status is pending, and 0 with it ready for a wallet that traded no sports or esports market. */
|
|
1134
1160
|
pnl_days: number;
|
|
1135
1161
|
/** The wallet's sports and esports markets: the rows of the export's markets section, before its 50,000-row cap. */
|
|
1136
1162
|
exported_markets: number;
|
|
@@ -1174,21 +1200,28 @@ export type ExportJobReadyData = {
|
|
|
1174
1200
|
data_as_of: string | null;
|
|
1175
1201
|
};
|
|
1176
1202
|
export type ExportSourceRange = {
|
|
1203
|
+
/** The first UTC day in the export file's pnl section, the wallet's sports and esports realized P&L by day: the file's export_metadata.pnl_date_from. Null when that section has no day, including while pnl_series_status is pending. */
|
|
1177
1204
|
first_pnl_date: string | null;
|
|
1205
|
+
/** The last UTC day in the export file's pnl section: the file's export_metadata.pnl_date_to. Null when that section has no day. */
|
|
1178
1206
|
last_pnl_date: string | null;
|
|
1207
|
+
/** Whether the export file's pnl section holds the wallet's sports and esports day series, the file's export_metadata.pnl_series_status. pending means 0xinsider has not computed the series yet: the dates are null and counts.pnl_days is 0, which then never means the wallet has no day. A wallet that traded no sports or esports market is ready with null dates and counts.pnl_days 0: it never gets a series, and with nothing stored completeness.status is empty (since 2026-10-29, #30620, #30657). */
|
|
1208
|
+
pnl_series_status: "ready" | "pending";
|
|
1179
1209
|
/** The latest trade in the wallet's sports and esports markets. Null when it has none. */
|
|
1180
1210
|
latest_trade_at: string | null;
|
|
1181
1211
|
/** Same instant as latest_trade_at: the latest activity of the markets the export holds. */
|
|
1182
1212
|
latest_market_activity_at: string | null;
|
|
1183
1213
|
};
|
|
1184
1214
|
export type ExportVolumeReconciliation = {
|
|
1185
|
-
/**
|
|
1215
|
+
/**
|
|
1216
|
+
* Deprecated (#30499): always null since 2026-10-29. It held Polymarket's volume across every market of the wallet, which reconciles nothing against the sports and esports exported_activity_volume; the key stays so existing V1 clients keep parsing. Read exported_activity_volume for the wallet's sports and esports volume.
|
|
1217
|
+
* @deprecated
|
|
1218
|
+
*/
|
|
1186
1219
|
provider_lifetime_volume: number | null;
|
|
1187
|
-
/**
|
|
1220
|
+
/** Volume in USD, buys and sells, in sports and esports markets, each fill's size times its price with fees excluded, summed over the wallet's stored daily volume rows (from the fills 0xinsider stores for the wallet): the export file's summary.volume_reconciliation.exported_activity_volume, not the sum of its pnl[].total_volume, which is null on a day the trade rollups do not cover. Never Polymarket's share count. Null when any of those rows has no volume: a sum over the other days would be a partial subtotal. */
|
|
1188
1221
|
exported_activity_volume: number | null;
|
|
1189
1222
|
/** Cost basis in USD summed over the wallet's sports and esports markets, the markets section of the export. */
|
|
1190
1223
|
exported_market_cost_basis: number;
|
|
1191
|
-
/** Always null. provider_lifetime_volume
|
|
1224
|
+
/** Always null. provider_lifetime_volume covered every market and exported_activity_volume sports and esports markets only, so their difference measured nothing; the field stays so existing clients keep parsing the object. */
|
|
1192
1225
|
provider_activity_volume_gap: number | null;
|
|
1193
1226
|
/** Always null, for the same reason as provider_activity_volume_gap. */
|
|
1194
1227
|
activity_volume_coverage: number | null;
|
|
@@ -1203,7 +1236,7 @@ export type FreshnessFailure = {
|
|
|
1203
1236
|
/** The trader body's whole-response data-quality status. Only fresh can satisfy max_age_s. */
|
|
1204
1237
|
data_quality_status: "fresh" | "partial" | "unknown" | "untracked" | "unavailable";
|
|
1205
1238
|
};
|
|
1206
|
-
/** One sports or esports game: both sides, its schedule, provider status,
|
|
1239
|
+
/** 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. */
|
|
1207
1240
|
export type Game = {
|
|
1208
1241
|
object: "game";
|
|
1209
1242
|
/** The game's identity, for example mlb-mil-cin-2026-06-22. The same key the live_sports_updated webhook pulse carries and the same key /api/v1/games/{event_slug} takes. */
|
|
@@ -1225,12 +1258,15 @@ export type Game = {
|
|
|
1225
1258
|
series_format?: string;
|
|
1226
1259
|
/** Whether this read includes a market classified as paying on a draw, including soccer's independent 1X2 draw leg. Read this instead of assuming a two-outcome moneyline. */
|
|
1227
1260
|
draw_offered: boolean;
|
|
1228
|
-
/**
|
|
1261
|
+
/** The game's winner markets the sports board binds to its sides (the moneyline, or a soccer game's three 1X2 legs), ordered by condition_id. Spreads, totals, period lines and props are on GET /api/v1/games/{event_slug}/markets. */
|
|
1229
1262
|
markets: GameMarket[];
|
|
1230
1263
|
freshness: GameFreshness;
|
|
1231
1264
|
coverage: GameCoverage;
|
|
1232
1265
|
/** The game's page on 0xinsider. */
|
|
1233
1266
|
url: string;
|
|
1267
|
+
sharp_money?: GameSharpMoney;
|
|
1268
|
+
/** The game's traded volume, the figure the sports board carries for it, with its source, basis, unit and observation clock. A client can rank or filter games by volume.value. Omitted when the board carries no volume for the game, and on a finished game read from its stored record (freshness.source stored); never 0 in place of a missing figure. */
|
|
1269
|
+
volume?: GameVolume;
|
|
1234
1270
|
};
|
|
1235
1271
|
/** One side of the game. */
|
|
1236
1272
|
export type GameCompetitor = {
|
|
@@ -1247,7 +1283,7 @@ export type GameCompetitor = {
|
|
|
1247
1283
|
};
|
|
1248
1284
|
/** What this game's read actually supplied, so a client branches on coverage instead of on a missing key. */
|
|
1249
1285
|
export type GameCoverage = {
|
|
1250
|
-
/** available when a live-score frame supplied this game
|
|
1286
|
+
/** available when a live-score frame supplied a score for this game. A game no live-score feed has reported yet, as most scheduled games are, reads unavailable. */
|
|
1251
1287
|
scores: "available" | "unavailable";
|
|
1252
1288
|
/** provider_ids when every side carries a provider id, labels when only the provider's names identify them, unavailable when neither exists. Do not join on names when this reads labels. */
|
|
1253
1289
|
competitors: "provider_ids" | "labels" | "unavailable";
|
|
@@ -1256,15 +1292,15 @@ export type GameCoverage = {
|
|
|
1256
1292
|
};
|
|
1257
1293
|
/** 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. */
|
|
1258
1294
|
export type GameFreshness = {
|
|
1259
|
-
/**
|
|
1260
|
-
source: "live" | "upcoming";
|
|
1295
|
+
/** What produced this game: live or upcoming, the board half that carried it, or stored, the stored record of a finished game that has left the board (GET /api/v1/games/{event_slug}, and GET /api/v1/games with a finished status). */
|
|
1296
|
+
source: "live" | "upcoming" | "stored";
|
|
1261
1297
|
/** Whether that half returned a truthful source body for this read. */
|
|
1262
1298
|
source_status: "ok" | "unavailable";
|
|
1263
1299
|
/** Whether that half had a source body at all. not_applicable means the sport has no configured source for that half. */
|
|
1264
1300
|
source_availability: "available" | "unavailable" | "not_applicable";
|
|
1265
|
-
/** Freshness of the cached source body, never inferred from the response clock or the row count. */
|
|
1301
|
+
/** Freshness of the cached source body, never inferred from the response clock or the row count. not_applicable for a stored game, whose record is final. */
|
|
1266
1302
|
source_freshness: "fresh" | "stale" | "unknown" | "not_applicable";
|
|
1267
|
-
/** The source body's data vintage. Omitted when the read has no vintage anchor, which is not age zero. */
|
|
1303
|
+
/** The source body's data vintage. Omitted when the read has no vintage anchor, which is not age zero. For a stored game, the later of its last live-score write and its last leg settlement. */
|
|
1268
1304
|
source_observed_at?: string;
|
|
1269
1305
|
/** Age of source_observed_at in seconds, capped at 600. Omitted past the cap or with no anchor. */
|
|
1270
1306
|
source_age_seconds?: number;
|
|
@@ -1275,6 +1311,22 @@ export type GameFreshness = {
|
|
|
1275
1311
|
/** The provider's own frame clock. Omitted when the frame carries none. */
|
|
1276
1312
|
scores_source_at?: string;
|
|
1277
1313
|
};
|
|
1314
|
+
/** One market of a game holders batch: GET /api/v1/market/{condition_id}/holders unfiltered and cut to the batch limit. */
|
|
1315
|
+
export type GameHoldersItem = {
|
|
1316
|
+
/** The roster's top holders by current value, at most limit. */
|
|
1317
|
+
data: MarketHolder[];
|
|
1318
|
+
/** More graded holders than limit: page them on GET /api/v1/market/{condition_id}/holders. */
|
|
1319
|
+
has_more: boolean;
|
|
1320
|
+
/** Graded holders in the roster, across every page. */
|
|
1321
|
+
total: number;
|
|
1322
|
+
market: MarketHoldersMarket;
|
|
1323
|
+
scan: MarketHoldersScan;
|
|
1324
|
+
totals: MarketHoldersTotals;
|
|
1325
|
+
/** When this roster was computed. A cached roster is at most 60 seconds old. */
|
|
1326
|
+
computed_at: string;
|
|
1327
|
+
/** true when the roster came from the 60-second roster cache. */
|
|
1328
|
+
cached: boolean;
|
|
1329
|
+
};
|
|
1278
1330
|
/** One Polymarket market linked to this game. */
|
|
1279
1331
|
export type GameMarket = {
|
|
1280
1332
|
/** The mkt_-prefixed market id every other V1 response uses. */
|
|
@@ -1297,6 +1349,17 @@ export type GameMarket = {
|
|
|
1297
1349
|
outcome_token_ids?: string[];
|
|
1298
1350
|
/** Default provider moneyline state. Omitted when this market has no classified moneyline projection; incomplete and invalid projections remain explicit. */
|
|
1299
1351
|
prices?: GameMarketPrices;
|
|
1352
|
+
/** Polymarket's reported liquidity for this market. Omitted when the provider read carried none, and on a finished game read from its stored record; never 0 in place of a missing figure. */
|
|
1353
|
+
liquidity?: GameMarketLiquidity;
|
|
1354
|
+
};
|
|
1355
|
+
/** 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. */
|
|
1356
|
+
export type GameMarketLiquidity = {
|
|
1357
|
+
/** The provider's figure at full precision. */
|
|
1358
|
+
value: number;
|
|
1359
|
+
/** Always gamma: the Polymarket Gamma API. */
|
|
1360
|
+
source: "gamma";
|
|
1361
|
+
/** When 0xinsider read the sports board body this figure came from, never a provider-authored timestamp. Omitted when that read has no clock. */
|
|
1362
|
+
observed_at?: string;
|
|
1300
1363
|
};
|
|
1301
1364
|
/** How the existing sports-board writer bound prices to competitors. */
|
|
1302
1365
|
export type GameMarketPriceBindingProvenance = "provider_ids" | "exact_labels" | "containment_labels" | "elimination";
|
|
@@ -1357,28 +1420,132 @@ export type GameMarketProviderPrices = GameMarketPricePaired | GameMarketPriceIn
|
|
|
1357
1420
|
export type GamesCoverage = {
|
|
1358
1421
|
/** Canonical sport buckets served, sorted. */
|
|
1359
1422
|
sports: string[];
|
|
1360
|
-
/** League tags served, sorted. EuroLeague is euroleague under the Basketball sport bucket. */
|
|
1423
|
+
/** League tags served, sorted. EuroLeague is euroleague, NCAA men's college basketball cbb and NCAA women's college basketball cwbb, all under the Basketball sport bucket. */
|
|
1361
1424
|
leagues: string[];
|
|
1362
1425
|
/** Scopes whose source half was unavailable for this read, as <sport>:<half>. Empty means every scope answered. */
|
|
1363
1426
|
sources_unavailable: string[];
|
|
1364
1427
|
};
|
|
1428
|
+
/** Event-level sharp money for one game. Every aggregate field is null unless status is computed; null means unknown, never zero. */
|
|
1429
|
+
export type GameSharpMoney = {
|
|
1430
|
+
allocation: "exact" | "degraded" | null;
|
|
1431
|
+
computed_at: string | null;
|
|
1432
|
+
event_slug: string;
|
|
1433
|
+
holders_partial: boolean | null;
|
|
1434
|
+
lifecycle: "live" | "settled" | "indeterminate" | null;
|
|
1435
|
+
money_as_of: string | null;
|
|
1436
|
+
object: string;
|
|
1437
|
+
outcomes: ({
|
|
1438
|
+
is_leader: boolean;
|
|
1439
|
+
label: string;
|
|
1440
|
+
pct: number;
|
|
1441
|
+
side: "home" | "draw" | "away";
|
|
1442
|
+
usd: number;
|
|
1443
|
+
wallets: {
|
|
1444
|
+
a: number;
|
|
1445
|
+
b: number;
|
|
1446
|
+
s: number;
|
|
1447
|
+
};
|
|
1448
|
+
})[];
|
|
1449
|
+
status: "computed" | "not_computed" | "unavailable";
|
|
1450
|
+
total_usd: number | null;
|
|
1451
|
+
trader_count: number | null;
|
|
1452
|
+
unallocated_usd: number | null;
|
|
1453
|
+
verdict: {
|
|
1454
|
+
kind: "no_sharp_money";
|
|
1455
|
+
} | {
|
|
1456
|
+
kind: "all_on";
|
|
1457
|
+
label: string;
|
|
1458
|
+
} | {
|
|
1459
|
+
kind: "split";
|
|
1460
|
+
} | {
|
|
1461
|
+
kind: "leans";
|
|
1462
|
+
label: string;
|
|
1463
|
+
pct: number;
|
|
1464
|
+
} | {
|
|
1465
|
+
kind: "unavailable";
|
|
1466
|
+
} | {
|
|
1467
|
+
divergence_pts: number;
|
|
1468
|
+
kind: "leans_over_price";
|
|
1469
|
+
label: string;
|
|
1470
|
+
} | {
|
|
1471
|
+
kind: "no_clear_lean";
|
|
1472
|
+
} | {
|
|
1473
|
+
kind: "withheld";
|
|
1474
|
+
} | null;
|
|
1475
|
+
};
|
|
1365
1476
|
/** 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. */
|
|
1366
1477
|
export type GameStatus = {
|
|
1367
|
-
/** scheduled: kickoff is ahead or the provider still
|
|
1478
|
+
/** scheduled: kickoff is ahead, or the provider still lists the game open and neither in play nor ended. With no live-score frame a game stays scheduled past its kickoff until the provider says otherwise. live: the provider reports it in play. paused: halftime or a provider-reported break. ended: the provider reported a final, an award or a forfeit. postponed, cancelled, suspended, delayed: the provider's own verdict, kept distinct. A tennis match that the provider still lists in play, with no live score feed and no change of period or score for 3 hours, also reads suspended. unknown: no provider state reached this read. A kickoff in the past is never read as live on its own. */
|
|
1368
1479
|
state: "scheduled" | "live" | "paused" | "ended" | "postponed" | "cancelled" | "suspended" | "delayed" | "unknown";
|
|
1369
|
-
/** The provider status folded onto one vocabulary across leagues. unknown means the provider sent a value this API has no meaning for; provider_status keeps that value verbatim. Omitted when no live-score frame carries a status. */
|
|
1480
|
+
/** The provider status folded onto one vocabulary across leagues. unknown means the provider sent a value this API has no meaning for; provider_status keeps that value verbatim. Omitted when no live-score frame carries a status, as for a listed game no live-score feed has reported yet. */
|
|
1370
1481
|
match_status?: "scheduled" | "in_progress" | "halftime" | "penalty_shootout" | "delayed" | "suspended" | "final" | "final_overtime" | "final_shootout" | "awarded" | "forfeit" | "not_necessary" | "postponed" | "cancelled" | "unknown";
|
|
1371
|
-
/** The
|
|
1482
|
+
/** The live-score feed's status string, verbatim. Omitted when no live-score frame carries one. This API never puts a label of its own here, such as Scheduled for a listed game. */
|
|
1372
1483
|
provider_status?: string;
|
|
1373
1484
|
/** The provider's period label, for example Q3, End Q2 or T5. Omitted when the provider sent none. */
|
|
1374
1485
|
period?: string;
|
|
1375
1486
|
/** The game clock as the provider spells it, never reformatted. Omitted when the provider sent none. */
|
|
1376
1487
|
clock?: string;
|
|
1377
|
-
/** Whether the game is in play. It is the provider's own in-play flag, except that a game the provider reports suspended (period SUS)
|
|
1488
|
+
/** Whether the game is in play. It is the provider's own in-play flag, except that three cases read false: a game the provider reports suspended (period SUS), a game rescheduled to a later kickoff, and a tennis match that the provider still lists in play with no live score feed and no change of period or score for 3 hours. Omitted when no live-score frame exists, which is not the same as false. */
|
|
1378
1489
|
live?: boolean;
|
|
1379
1490
|
/** Whether the game is over. Always present. */
|
|
1380
1491
|
ended: boolean;
|
|
1381
1492
|
};
|
|
1493
|
+
/** One fill in a game, as the game page's activity list shows it. */
|
|
1494
|
+
export type GameTrade = {
|
|
1495
|
+
/** Stable fill identity: {transaction_hash}:{token_id}:{wallet}:{shares}. Deduplicate on it across polls. */
|
|
1496
|
+
id: string;
|
|
1497
|
+
/** When the fill happened, to the second. */
|
|
1498
|
+
traded_at: string;
|
|
1499
|
+
/** The provider's side of the fill. */
|
|
1500
|
+
side: "BUY" | "SELL";
|
|
1501
|
+
/** The traded outcome's label; null when the provider named none. */
|
|
1502
|
+
outcome: string | null;
|
|
1503
|
+
/** 0 for the first (Yes) outcome token, 1 for the second (No); null when the provider did not say. */
|
|
1504
|
+
outcome_index: number | null;
|
|
1505
|
+
/** Fill price, 0 to 1. */
|
|
1506
|
+
price: number;
|
|
1507
|
+
/** Shares filled. */
|
|
1508
|
+
shares: number;
|
|
1509
|
+
/** USDC notional of the fill. */
|
|
1510
|
+
size_usd: number;
|
|
1511
|
+
/** The signed handicap the fill's side carries on a spread line, for example -1.5 or 1.5; null off spreads. */
|
|
1512
|
+
point: number | null;
|
|
1513
|
+
trader: {
|
|
1514
|
+
/** Lowercase proxy wallet. */
|
|
1515
|
+
address: string;
|
|
1516
|
+
/** The name the site shows: the 0xinsider username, else the provider's name or pseudonym, else the shortened address. */
|
|
1517
|
+
display_name: string;
|
|
1518
|
+
/** The trader's grade today; null for an ungraded or untracked wallet. */
|
|
1519
|
+
grade: "S" | "A" | "B" | "C" | "D" | "F" | null;
|
|
1520
|
+
};
|
|
1521
|
+
market: {
|
|
1522
|
+
/** The market's v1 id, mkt_ plus the condition_id. */
|
|
1523
|
+
id: string;
|
|
1524
|
+
/** The raw provider condition_id. */
|
|
1525
|
+
condition_id: string;
|
|
1526
|
+
/** The market's question. */
|
|
1527
|
+
title: string | null;
|
|
1528
|
+
/** The market's page slug. */
|
|
1529
|
+
slug: string | null;
|
|
1530
|
+
/** The market's name within the game, for example Draw, O/U 2.5, First to Score: CD Guadalajara, Game 2: Any Player Quadra Kill. */
|
|
1531
|
+
line_label: string | null;
|
|
1532
|
+
};
|
|
1533
|
+
};
|
|
1534
|
+
/** A game's traded volume as Polymarket reports it, read by the sports board 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. */
|
|
1535
|
+
export type GameVolume = {
|
|
1536
|
+
/** The volume at full precision, in unit. */
|
|
1537
|
+
value: number;
|
|
1538
|
+
/** taker_shares: cumulative one-side taker volume in shares. One share pays $1 at settlement, so this is not cash traded. Omitted only on a figure observed before units were recorded; never assume cash. */
|
|
1539
|
+
unit?: "taker_shares";
|
|
1540
|
+
/** game_lines: the game volume Polymarket's game page states, summed over the game's own lines. event_total: the whole event's volume, stated when no game volume was readable. The two can differ in either direction. Omitted when the basis is unknown. */
|
|
1541
|
+
basis?: "game_lines" | "event_total";
|
|
1542
|
+
/** The Polymarket API the figure was read from: polymarket_data (the Data API's live volume) or gamma (the Gamma API). */
|
|
1543
|
+
source: "polymarket_data" | "gamma";
|
|
1544
|
+
/** When 0xinsider read the figure from the provider, never a provider-authored timestamp. Omitted when no read time is held for it. */
|
|
1545
|
+
observed_at?: string;
|
|
1546
|
+
/** How long after observed_at 0xinsider treats the figure as current: 60 or 300 by source and basis, or 3600 for an older figure kept because a later read of the same total was lower or missing (a cumulative volume never falls). */
|
|
1547
|
+
fresh_for_seconds: number;
|
|
1548
|
+
};
|
|
1382
1549
|
/** Current category evidence, independent of the global grade. Pick of the Day stamps only the served display roster; frozen entry snapshots remain unchanged. */
|
|
1383
1550
|
export type HolderCategoryEvidence = {
|
|
1384
1551
|
status: "live" | "insufficient" | "stale" | "unknown" | "degraded";
|
|
@@ -1405,9 +1572,20 @@ export type LargeExportPolicy = {
|
|
|
1405
1572
|
/** How long a finished export is retained before expiry. */
|
|
1406
1573
|
retention: string;
|
|
1407
1574
|
};
|
|
1408
|
-
direct_streaming:
|
|
1409
|
-
|
|
1410
|
-
|
|
1575
|
+
direct_streaming: {
|
|
1576
|
+
available_when: string;
|
|
1577
|
+
backpressure: string;
|
|
1578
|
+
chunk_size_rows: number;
|
|
1579
|
+
};
|
|
1580
|
+
async_job: {
|
|
1581
|
+
available_when: string;
|
|
1582
|
+
status_values: string[];
|
|
1583
|
+
retention: string;
|
|
1584
|
+
};
|
|
1585
|
+
rate_limit: {
|
|
1586
|
+
daily_cap_per_user: number;
|
|
1587
|
+
per_address_hourly_cap: number;
|
|
1588
|
+
};
|
|
1411
1589
|
};
|
|
1412
1590
|
export type LargePosition = {
|
|
1413
1591
|
/** Composite prefixed ID `pos_<wallet>:<condition_id>:<outcome_index>`. */
|
|
@@ -1465,9 +1643,16 @@ export type LargePosition = {
|
|
|
1465
1643
|
address: string;
|
|
1466
1644
|
username?: string;
|
|
1467
1645
|
grade?: "S" | "A" | "B" | "C" | "D" | "F";
|
|
1646
|
+
/** Sports and esports win rate as a ratio from 0 to 1 (0.62 means 62%): wins over the decided sports and esports markets on the wallet's record, the same figure as pnl.in_scope.win_rate on GET /api/v1/trader/{address}. Since 2026-10-27 it no longer counts other markets (#29953). Absent when the wallet has no record or no decided market. */
|
|
1468
1647
|
win_rate?: number;
|
|
1469
|
-
/**
|
|
1648
|
+
/**
|
|
1649
|
+
* Deprecated since 2026-10-27 and never sent. It was Polymarket's net total P&L over every Polymarket market of the wallet, and wallet figures cover sports and esports markets only (#29953). Read trader.in_scope_realized_pnl.
|
|
1650
|
+
* @deprecated
|
|
1651
|
+
*/
|
|
1470
1652
|
pnl?: number;
|
|
1653
|
+
/** The wallet's realized P&L in USD on sports and esports markets, the figure the 0xinsider profile shows: the record behind pnl.in_scope.realized_pnl on GET /api/v1/trader/{address}, to cents. Distinct from this position's position_unrealized_pnl. For a graded wallet it is read from the latest grading pass, so it can trail that figure until the next pass. Omitted until 0xinsider has computed the wallet's record (#29953). */
|
|
1654
|
+
in_scope_realized_pnl?: number;
|
|
1655
|
+
/** Sports and esports markets on the wallet's record, pnl.in_scope.markets on GET /api/v1/trader/{address}. Since 2026-10-27 it no longer counts other markets (#29953). Absent when the wallet has no record. */
|
|
1471
1656
|
markets_traded?: number;
|
|
1472
1657
|
};
|
|
1473
1658
|
market: {
|
|
@@ -1521,7 +1706,7 @@ export type LargeTrade = {
|
|
|
1521
1706
|
address: string;
|
|
1522
1707
|
username?: string;
|
|
1523
1708
|
/** The trader's grade today, on every row however old. For what the grade was when the trade happened, read grade_at_trade. */
|
|
1524
|
-
grade?:
|
|
1709
|
+
grade?: "S" | "A" | "B" | "C" | "D" | "F";
|
|
1525
1710
|
/** The grade the trader held when the trade happened, from recorded grade history (recorded from 2026-09-19T23:00Z). Null unless grade_at_trade_status is graded. Never today's grade projected backward. */
|
|
1526
1711
|
grade_at_trade: "S" | "A" | "B" | "C" | "D" | "F" | null;
|
|
1527
1712
|
/** graded: grade_at_trade holds the recorded grade. ungraded: the trader was recorded without a grade at that moment. unknown: no record covers the moment, which is every trade before 2026-09-19T23:00Z and a trade that fell between a grade change and its confirmation. unknown never means ungraded. */
|
|
@@ -1603,29 +1788,73 @@ export type LeaderboardEntry = {
|
|
|
1603
1788
|
id: string;
|
|
1604
1789
|
address: string;
|
|
1605
1790
|
username?: string;
|
|
1606
|
-
grade?:
|
|
1791
|
+
grade?: "S" | "A" | "B" | "C" | "D" | "F";
|
|
1607
1792
|
/** Hot-streak tier (trailing-7d cross-sectional percentile); a separate axis from the all-time grade. Omitted when there is no recent activity. */
|
|
1608
1793
|
streak_tier?: "hot" | "rising" | "neutral" | "cooling" | "cold";
|
|
1609
1794
|
score?: number;
|
|
1610
|
-
/**
|
|
1795
|
+
/**
|
|
1796
|
+
* Deprecated since 2026-10-27 and never sent. It was Polymarket's all-time leaderboard P&L, which covered every Polymarket market of the wallet, and wallet figures cover sports and esports markets only (#29971). Read in_scope.realized_pnl.
|
|
1797
|
+
* @deprecated
|
|
1798
|
+
*/
|
|
1611
1799
|
pnl?: number;
|
|
1612
|
-
/**
|
|
1800
|
+
/**
|
|
1801
|
+
* Deprecated since 2026-10-27 and never sent. It was native Polymarket realized P&L over every Polymarket market of the wallet, and wallet figures cover sports and esports markets only (#29971). Read in_scope.realized_pnl.
|
|
1802
|
+
* @deprecated
|
|
1803
|
+
*/
|
|
1613
1804
|
realized_pnl?: number;
|
|
1614
|
-
/**
|
|
1805
|
+
/**
|
|
1806
|
+
* Deprecated since 2026-10-27 and never sent. It was the neg-risk conversion correction to the wallet-wide realized_pnl (#29971). Its sports and esports part is inside in_scope.realized_pnl.
|
|
1807
|
+
* @deprecated
|
|
1808
|
+
*/
|
|
1615
1809
|
pnl_correction?: PnlCorrection;
|
|
1616
|
-
/**
|
|
1810
|
+
/**
|
|
1811
|
+
* Deprecated since 2026-10-27 and never sent. It was full-history USD cash volume over every Polymarket market of the wallet, and wallet figures cover sports and esports markets only (#29971).
|
|
1812
|
+
* @deprecated
|
|
1813
|
+
*/
|
|
1617
1814
|
volume?: number;
|
|
1815
|
+
/** Sports and esports markets on the wallet's record, the same count as in_scope.markets. Since 2026-10-27 (#29971); before, it counted every Polymarket market. Sent exactly when in_scope is. */
|
|
1618
1816
|
markets_traded?: number;
|
|
1619
|
-
/** The wallet's win rate
|
|
1817
|
+
/** The wallet's sports and esports win rate, in_scope.win_rate rounded to four places. Since 2026-10-27 (#29971); before, it covered every Polymarket market. ?category= decides WHICH wallets are listed (the wallet must be ranked in that category); it does not rescope this field. For a per-category record use GET /api/v1/trader/{address}/categories. Omitted when in_scope is omitted or has no win rate. */
|
|
1620
1818
|
win_rate?: number;
|
|
1621
|
-
/** Additive (#27859): the wallet's sports and esports record, the same object as GET /api/v1/trader/{address} pnl.in_scope, as of the leaderboard's last refresh. The 0xinsider leaderboard page shows and sorts by in_scope.realized_pnl and in_scope.win_rate. Omitted until 0xinsider has computed the wallet's record; absent means not computed yet, never zero.
|
|
1819
|
+
/** Additive (#27859): the wallet's sports and esports record, the same object as GET /api/v1/trader/{address} pnl.in_scope, as of the leaderboard's last refresh. The 0xinsider leaderboard page shows and sorts by in_scope.realized_pnl and in_scope.win_rate. Omitted until 0xinsider has computed the wallet's record; absent means not computed yet, never zero. */
|
|
1622
1820
|
in_scope?: TraderPnlInScope;
|
|
1821
|
+
/** Additive (#32270): the wallet's edge over the price paid on its sports and esports markets, the figures the 0xinsider leaderboard page's Edge column states for the row. sort=edge orders by price_edge.edge. Omitted when the wallet has no settled sports or esports market of $20 or more at a known entry price. */
|
|
1822
|
+
price_edge?: LeaderboardPriceEdge;
|
|
1623
1823
|
/** Observed trading style identifier. New rows use two_sided, category_focused, high_activity, diversified, mixed, or unclassified, counted over the wallet's sports and esports markets only. Historical identifiers remain readable during normal reclassification; style does not predict skill or intent. */
|
|
1624
1824
|
strategy_type?: string;
|
|
1625
1825
|
/** Provider platform. Always polymarket. */
|
|
1626
1826
|
platform: "polymarket";
|
|
1827
|
+
/** When the wallet last traded: its most recent recorded trade, as of the leaderboard row's last refresh, which re-reads it hourly, so a new trade can take about an hour to show. It agrees with the activity filter: every wallet listed under activity=inactive last traded more than 30 days ago. Since 2026-11-02 (#32322); before, it carried the time 0xinsider last synced the wallet, usually within the past week whether or not the wallet traded. Omitted when the wallet has no recorded trade. */
|
|
1627
1828
|
last_active?: string;
|
|
1628
1829
|
};
|
|
1830
|
+
export type LeaderboardLeagues = {
|
|
1831
|
+
leagues: {
|
|
1832
|
+
category: string;
|
|
1833
|
+
name: string;
|
|
1834
|
+
ranked_traders: number;
|
|
1835
|
+
slug: string;
|
|
1836
|
+
sport: string;
|
|
1837
|
+
total_traders: number;
|
|
1838
|
+
}[];
|
|
1839
|
+
min_ranked: number;
|
|
1840
|
+
min_resolved: number;
|
|
1841
|
+
refreshed_at: string;
|
|
1842
|
+
};
|
|
1843
|
+
/** 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. */
|
|
1844
|
+
export type LeaderboardPriceEdge = {
|
|
1845
|
+
/** Settled sports and esports markets of $20 or more at a known entry price that the edge is measured over. */
|
|
1846
|
+
markets: number;
|
|
1847
|
+
/** Share of those markets whose bought side won, 0-1. */
|
|
1848
|
+
hit_rate: number;
|
|
1849
|
+
/** Mean entry price paid, 0-1. */
|
|
1850
|
+
avg_price: number;
|
|
1851
|
+
/** hit_rate minus avg_price, full precision. The value sort=edge orders by. */
|
|
1852
|
+
edge: number;
|
|
1853
|
+
/** Whether the edge ranks. ranked: at least 30 such markets, and the share of the decided ones that made money at settlement within 10 points of the win rate over the same markets. too_few_markets: fewer than 30. sample_mismatch: that share is more than 10 points away, so these markets do not describe the wallet's record. Only a ranked edge with no hold orders on sort=edge. */
|
|
1854
|
+
status: "ranked" | "too_few_markets" | "sample_mismatch";
|
|
1855
|
+
/** Why the leaderboard does not rank a ranked edge. record_incomplete: the wallet's stored sports and esports record shows more profit than Polymarket reports for it, so some losing markets are likely missing. Omitted when nothing holds the edge, and always omitted unless status is ranked. */
|
|
1856
|
+
hold?: "record_incomplete";
|
|
1857
|
+
};
|
|
1629
1858
|
/** One side's score line inside a `live_sports_updated` pulse. */
|
|
1630
1859
|
export type LiveSportsScoreEntry = {
|
|
1631
1860
|
/** Team name, ordered for the league (away first where the league reads that way). */
|
|
@@ -1706,7 +1935,7 @@ export type MarketFlow = {
|
|
|
1706
1935
|
id: string;
|
|
1707
1936
|
address: string;
|
|
1708
1937
|
username: string | null;
|
|
1709
|
-
grade:
|
|
1938
|
+
grade: "S" | "A" | "B" | "C" | "D" | "F" | null;
|
|
1710
1939
|
side: "YES" | "NO";
|
|
1711
1940
|
/** The Polymarket CLOB token id (ERC1155 asset id, decimal string) for this outcome; null when unavailable (e.g. unsynced markets). */
|
|
1712
1941
|
token_id: string | null;
|
|
@@ -1737,7 +1966,7 @@ export type MarketFlow = {
|
|
|
1737
1966
|
id: string;
|
|
1738
1967
|
address: string;
|
|
1739
1968
|
username: string | null;
|
|
1740
|
-
grade:
|
|
1969
|
+
grade: "S" | "A" | "B" | "C" | "D" | "F" | null;
|
|
1741
1970
|
side: "YES" | "NO";
|
|
1742
1971
|
/** The Polymarket CLOB token id (ERC1155 asset id, decimal string) for this outcome; null when unavailable (e.g. unsynced markets). */
|
|
1743
1972
|
token_id: string | null;
|
|
@@ -1771,18 +2000,18 @@ export type MarketHolder = {
|
|
|
1771
2000
|
other_outcome_shares?: number;
|
|
1772
2001
|
/** The wallet's last recorded trade anywhere, null when unknown. */
|
|
1773
2002
|
last_traded_at: string | null;
|
|
1774
|
-
/** This wallet's win rate in the market's canonical category (`market.category`): the share of its
|
|
2003
|
+
/** This wallet's win rate in the market's canonical category (`market.category`): the share of its settled markets in that category (it closed its position by selling out, or the market resolved) whose realized P&L closed positive, as a 0..1 fraction. Present only with `category_win_rate_status` = `measured`. The same read `GET /api/v1/trader/{address}/categories` serves per wallet. */
|
|
1775
2004
|
category_win_rate?: number;
|
|
1776
|
-
/** The two counts `category_win_rate` is the ratio of, from the same row: `wins / decided` equals the rate. Every
|
|
2005
|
+
/** The two counts `category_win_rate` is the ratio of, from the same row: `wins / decided` equals the rate. Every settled Polymarket market the wallet traded (it closed its position by selling out, or the market resolved) in the market's canonical category, at any position size, rebuilt daily. Present only with `category_win_rate_status` = `measured`. */
|
|
1777
2006
|
category_win_record?: {
|
|
1778
|
-
/**
|
|
2007
|
+
/** Settled markets in the category that this wallet closed with a profit. */
|
|
1779
2008
|
wins: number;
|
|
1780
|
-
/**
|
|
2009
|
+
/** Settled markets in the category that this wallet closed with a profit or a loss. A market resolved at zero realized P&L is in neither count. */
|
|
1781
2010
|
decided: number;
|
|
1782
2011
|
};
|
|
1783
|
-
/** The wallet's average entry price in the market's canonical category, as a 0..1 fraction of $1 (0.98 is 98 cents). Its sample is the wallet's
|
|
2012
|
+
/** The wallet's average entry price in the market's canonical category, as a 0..1 fraction of $1 (0.98 is 98 cents). Its sample is the wallet's markets in that category that resolved to a winning side, of $20 or more where it bought one side at a known price, so it can differ from the `category_win_record` sample. A wallet that buys near-certain outcomes wins almost every time, so read the win rate beside this price. Present only with `category_win_rate_status` = `measured`, and only when that sample has at least 5 markets. When `category_win_rate_game` is present the price is still the whole `category` bucket's: this field has no per-game or per-league price. Absent otherwise and on payloads predating the field. */
|
|
1784
2013
|
category_avg_price?: number;
|
|
1785
|
-
/**
|
|
2014
|
+
/** Where `category_win_rate` and `category_win_record` were measured: for an esports market the game (`LoL`, `CS2`, `Dota 2`, `Valorant`, `Call of Duty`, `Honor of Kings`, `Mobile Legends: Bang Bang`, `Overwatch`, `Rainbow Six Siege`, `Rocket League` or `StarCraft II`), and for a market in a registered league that league, by the name Pick of the Day uses for it (`NBA`, `NFL`, `NHL`, `MLB`, `UFC`, `ATP`, `WTA`, `LaLiga`, `Premier League`, `Serie A`, `UEFA Champions League`, `MLS` and the other registered leagues). Present only when the wallet's record there clears the 5-settled-market floor, in which case the rate and record are the game's or league's rather than the whole `category` bucket's. Absent when the rate is the bucket's (the wallet's history there is under the floor, or the competition is not a registered league), on every other market, and beside every non-measured status. Label the rate with this when present and with the market's `category` otherwise. */
|
|
1786
2015
|
category_win_rate_game?: string;
|
|
1787
2016
|
/** Why `category_win_rate` is present or absent: `measured` (rate present), `not_enough_data` (under the floor of 5 decided markets in the category), or `unavailable` (the market has no canonical category, or the read failed; retry later). Always present on this route. */
|
|
1788
2017
|
category_win_rate_status: "measured" | "not_enough_data" | "unavailable";
|
|
@@ -1830,6 +2059,15 @@ export type MarketHoldersSideGrades = {
|
|
|
1830
2059
|
a: number;
|
|
1831
2060
|
b: number;
|
|
1832
2061
|
};
|
|
2062
|
+
/** Polymarket currentValue in USD per grade on one side, over the same wallets 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. */
|
|
2063
|
+
export type MarketHoldersSideGradeUsd = {
|
|
2064
|
+
/** USD held by S-grade wallets netting this side. */
|
|
2065
|
+
s: number;
|
|
2066
|
+
/** USD held by A-grade wallets netting this side. */
|
|
2067
|
+
a: number;
|
|
2068
|
+
/** USD held by B-grade wallets netting this side. */
|
|
2069
|
+
b: number;
|
|
2070
|
+
};
|
|
1833
2071
|
/** Roster totals BEFORE any `outcome` or `min_grade` filter, so a page always knows the whole market it was cut from. */
|
|
1834
2072
|
export type MarketHoldersTotals = {
|
|
1835
2073
|
/** Distinct graded wallets with net exposure; a two-sided wallet counts once. */
|
|
@@ -1844,6 +2082,10 @@ export type MarketHoldersTotals = {
|
|
|
1844
2082
|
no_usd: number;
|
|
1845
2083
|
yes_grades: MarketHoldersSideGrades;
|
|
1846
2084
|
no_grades: MarketHoldersSideGrades;
|
|
2085
|
+
/** yes_usd split by grade: where the S, A and B money on YES sits. */
|
|
2086
|
+
yes_grade_usd: MarketHoldersSideGradeUsd;
|
|
2087
|
+
/** no_usd split by grade: where the S, A and B money on NO sits. */
|
|
2088
|
+
no_grade_usd: MarketHoldersSideGradeUsd;
|
|
1847
2089
|
};
|
|
1848
2090
|
export type MarketSearchResult = {
|
|
1849
2091
|
id: string;
|
|
@@ -1855,6 +2097,7 @@ export type MarketSearchResult = {
|
|
|
1855
2097
|
platform: "polymarket" | null;
|
|
1856
2098
|
/** closed once Polymarket has closed trading or the market has resolved; active otherwise. The same rule labels a market on markets/search, markets/explore and market/{condition_id}/snapshot. */
|
|
1857
2099
|
status: "active" | "closed";
|
|
2100
|
+
event_slug?: string;
|
|
1858
2101
|
};
|
|
1859
2102
|
export type MarketSnapshot = {
|
|
1860
2103
|
market: {
|
|
@@ -1949,9 +2192,147 @@ export type MarketSnapshotTrust = {
|
|
|
1949
2192
|
current_price: TrustMetadata;
|
|
1950
2193
|
spread_bps: TrustMetadata;
|
|
1951
2194
|
};
|
|
2195
|
+
export type MarketTopHolder = {
|
|
2196
|
+
/** 1-based position on this outcome, by shares. */
|
|
2197
|
+
rank: number;
|
|
2198
|
+
/** `trd_`-prefixed trader id, accepted by `GET /api/v1/trader/{address}`. */
|
|
2199
|
+
trader_id: string;
|
|
2200
|
+
/** Lowercased proxy wallet. */
|
|
2201
|
+
address: string;
|
|
2202
|
+
/** The wallet's display name; null when it shows none. */
|
|
2203
|
+
name: string | null;
|
|
2204
|
+
/** All-time trader grade, S to F. Null for a wallet 0xinsider has not graded: this route lists every holder whatever its grade. */
|
|
2205
|
+
grade: "S" | "A" | "B" | "C" | "D" | "F" | null;
|
|
2206
|
+
/** Shares held on this outcome. */
|
|
2207
|
+
shares: number;
|
|
2208
|
+
/** Polymarket's current value of this position, in USD. Null when the provider served none. */
|
|
2209
|
+
current_value_usd: number | null;
|
|
2210
|
+
/** Average price paid for the shares still held, as a 0..1 fraction of $1. Null when the provider served none. */
|
|
2211
|
+
avg_entry_price: number | null;
|
|
2212
|
+
/** Shares on the other outcome when the wallet holds both; the wallet is then listed on both sides. Absent when it is one-sided. */
|
|
2213
|
+
other_outcome_shares?: number;
|
|
2214
|
+
/** Polymarket's realized P&L of this position (sells and redemptions), in USD. Null when the provider served no economics for the row. */
|
|
2215
|
+
position_realized_pnl: number | null;
|
|
2216
|
+
/** Polymarket's mark-to-market P&L of the shares still held, in USD. On a resolved market the mark is the settlement price. */
|
|
2217
|
+
position_unrealized_pnl: number | null;
|
|
2218
|
+
/** `position_realized_pnl` plus `position_unrealized_pnl`, in USD. */
|
|
2219
|
+
position_total_pnl: number | null;
|
|
2220
|
+
/** The wallet's realized P&L on sports and esports markets, in USD, the figure on its 0xinsider profile. Null until 0xinsider has computed the record, never 0 in its place, and null for every row when `profiles_status` is `unavailable`. */
|
|
2221
|
+
in_scope_realized_pnl: number | null;
|
|
2222
|
+
/** The wallet's volume traded on sports and esports markets, in USD. Null under the same rule as `in_scope_realized_pnl`. */
|
|
2223
|
+
in_scope_volume: number | null;
|
|
2224
|
+
/** The wallet's stored trading-style label (see Wallet trading styles); null when it has none. */
|
|
2225
|
+
strategy_type: string | null;
|
|
2226
|
+
/** The wallet's last recorded trade anywhere, null when unknown. */
|
|
2227
|
+
last_traded_at: string | null;
|
|
2228
|
+
/** This wallet's win rate in the market's canonical category (`market.category`): the share of its settled markets in that category (it closed its position by selling out, or the market resolved) whose realized P&L closed positive, as a 0..1 fraction. Present only with `category_win_rate_status` = `measured`. The same read `GET /api/v1/trader/{address}/categories` serves per wallet. */
|
|
2229
|
+
category_win_rate?: number;
|
|
2230
|
+
/** The two counts `category_win_rate` is the ratio of, from the same row: `wins / decided` equals the rate. Every settled Polymarket market the wallet traded (it closed its position by selling out, or the market resolved) in the market's canonical category, at any position size, rebuilt daily. Present only with `category_win_rate_status` = `measured`. */
|
|
2231
|
+
category_win_record?: {
|
|
2232
|
+
/** Settled markets in the category that this wallet closed with a profit. */
|
|
2233
|
+
wins: number;
|
|
2234
|
+
/** Settled markets in the category that this wallet closed with a profit or a loss. A market resolved at zero realized P&L is in neither count. */
|
|
2235
|
+
decided: number;
|
|
2236
|
+
};
|
|
2237
|
+
/** The wallet's average entry price in the market's canonical category, as a 0..1 fraction of $1 (0.98 is 98 cents). Its sample is the wallet's markets in that category that resolved to a winning side, of $20 or more where it bought one side at a known price, so it can differ from the `category_win_record` sample. A wallet that buys near-certain outcomes wins almost every time, so read the win rate beside this price. Present only with `category_win_rate_status` = `measured`, and only when that sample has at least 5 markets. When `category_win_rate_game` is present the price is still the whole `category` bucket's: this field has no per-game or per-league price. Absent otherwise and on payloads predating the field. */
|
|
2238
|
+
category_avg_price?: number;
|
|
2239
|
+
/** Where `category_win_rate` and `category_win_record` were measured: for an esports market the game (`LoL`, `CS2`, `Dota 2`, `Valorant`, `Call of Duty`, `Honor of Kings`, `Mobile Legends: Bang Bang`, `Overwatch`, `Rainbow Six Siege`, `Rocket League` or `StarCraft II`), and for a market in a registered league that league, by the name Pick of the Day uses for it (`NBA`, `NFL`, `NHL`, `MLB`, `UFC`, `ATP`, `WTA`, `LaLiga`, `Premier League`, `Serie A`, `UEFA Champions League`, `MLS` and the other registered leagues). Present only when the wallet's record there clears the 5-settled-market floor, in which case the rate and record are the game's or league's rather than the whole `category` bucket's. Absent when the rate is the bucket's (the wallet's history there is under the floor, or the competition is not a registered league), on every other market, and beside every non-measured status. Label the rate with this when present and with the market's `category` otherwise. */
|
|
2240
|
+
category_win_rate_game?: string;
|
|
2241
|
+
/** Why `category_win_rate` is present or absent: `measured` (rate present), `not_enough_data` (under the floor of 5 decided markets in the category), or `unavailable` (the read failed; retry later). Absent when the market has no canonical category. */
|
|
2242
|
+
category_win_rate_status?: "measured" | "not_enough_data" | "unavailable";
|
|
2243
|
+
/** Whole days since this wallet's first trade, rounded down (3.6 days reads 3), so it changes once a day, not on every request. The five badge fields are present together, only for a wallet that draws at least one badge. */
|
|
2244
|
+
wallet_age_days?: number | null;
|
|
2245
|
+
/** True when the wallet's first trade was under 30 days ago. */
|
|
2246
|
+
is_new_wallet?: boolean;
|
|
2247
|
+
/** Distinct markets the wallet has traded. */
|
|
2248
|
+
markets_traded?: number | null;
|
|
2249
|
+
/** True when the wallet is flagged as automated. */
|
|
2250
|
+
is_bot?: boolean;
|
|
2251
|
+
/** The wallet's X handle without the @, when linked. */
|
|
2252
|
+
x_username?: string | null;
|
|
2253
|
+
};
|
|
2254
|
+
export type MarketTopHolders = {
|
|
2255
|
+
market: MarketHoldersMarket;
|
|
2256
|
+
/** The largest YES holders, by shares, up to `limit`. */
|
|
2257
|
+
yes: MarketTopHolder[];
|
|
2258
|
+
/** The largest NO holders, by shares, up to `limit`. */
|
|
2259
|
+
no: MarketTopHolder[];
|
|
2260
|
+
totals: MarketTopHoldersTotals;
|
|
2261
|
+
/** `unavailable` when the wallet record read failed: `in_scope_realized_pnl`, `in_scope_volume` and `strategy_type` are then null for every row because they were not read, not because they are unknown. */
|
|
2262
|
+
profiles_status: "available" | "unavailable";
|
|
2263
|
+
/** When the daily pass behind the rows' category win records began. Absent when the market has no category or the read answered no row. */
|
|
2264
|
+
category_records_as_of?: string;
|
|
2265
|
+
/** When this holder sample was built. */
|
|
2266
|
+
computed_at?: string;
|
|
2267
|
+
/** When Polymarket's holder board behind this sample was fetched: up to 120 s before `computed_at` on an open market. Absent on a resolved market, whose sample reads no live board, and when the fetch stamp could not be read. */
|
|
2268
|
+
positions_as_of?: string;
|
|
2269
|
+
};
|
|
2270
|
+
export type MarketTopHoldersTotals = {
|
|
2271
|
+
/** Holders in the YES sample, before `limit`. Equal to `sample_cap` means that many or more. */
|
|
2272
|
+
yes_count: number;
|
|
2273
|
+
/** Holders in the NO sample, before `limit`. */
|
|
2274
|
+
no_count: number;
|
|
2275
|
+
/** Shares summed over the YES sample. */
|
|
2276
|
+
yes_shares: number;
|
|
2277
|
+
/** Shares summed over the NO sample. */
|
|
2278
|
+
no_shares: number;
|
|
2279
|
+
/** The most holders the sample keeps per outcome (100). */
|
|
2280
|
+
sample_cap: number;
|
|
2281
|
+
};
|
|
2282
|
+
/** 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. */
|
|
2283
|
+
export type MarketWalletsInOut = {
|
|
2284
|
+
/** The market's raw provider condition id. */
|
|
2285
|
+
condition_id: string;
|
|
2286
|
+
/** The window the nets are summed over: 24h or 7d. */
|
|
2287
|
+
window: string;
|
|
2288
|
+
/** The window's inclusive start; null only when the bounds are unknown. */
|
|
2289
|
+
window_start: string | null;
|
|
2290
|
+
/** The window's inclusive end, the read's clock; null only when the bounds are unknown. */
|
|
2291
|
+
window_end: string | null;
|
|
2292
|
+
/** Totals over every wallet that traded the market in the window, not only the listed 50. */
|
|
2293
|
+
summary: {
|
|
2294
|
+
/** Wallets with a positive net in the window. */
|
|
2295
|
+
wallets_in: number;
|
|
2296
|
+
/** Wallets with a negative net in the window. */
|
|
2297
|
+
wallets_out: number;
|
|
2298
|
+
/** The sum of every wallet's net, in USD. A fully rotated wallet nets zero and is on neither side. */
|
|
2299
|
+
net_usd: number;
|
|
2300
|
+
};
|
|
2301
|
+
/** Wallets whose net is positive, largest first, at most 25. */
|
|
2302
|
+
net_buyers: ({
|
|
2303
|
+
/** Lowercase proxy wallet. */
|
|
2304
|
+
address: string;
|
|
2305
|
+
/** The name the site shows: the 0xinsider username, else the shortened address. */
|
|
2306
|
+
display_name: string;
|
|
2307
|
+
/** Today's grade; null for an ungraded or untracked wallet. */
|
|
2308
|
+
grade: "S" | "A" | "B" | "C" | "D" | "F" | null;
|
|
2309
|
+
/** Buys minus sells in the window, both outcomes, in USD: the matched notional, fees excluded. */
|
|
2310
|
+
net_usd: number;
|
|
2311
|
+
/** Fills in the window. */
|
|
2312
|
+
trades: number;
|
|
2313
|
+
/** The wallet's newest trade on any market, at or before window_end; null when unknown. */
|
|
2314
|
+
last_traded_at: string | null;
|
|
2315
|
+
})[];
|
|
2316
|
+
/** Wallets whose net is negative, most negative first, at most 25. */
|
|
2317
|
+
net_sellers: ({
|
|
2318
|
+
/** Lowercase proxy wallet. */
|
|
2319
|
+
address: string;
|
|
2320
|
+
/** The name the site shows: the 0xinsider username, else the shortened address. */
|
|
2321
|
+
display_name: string;
|
|
2322
|
+
/** Today's grade; null for an ungraded or untracked wallet. */
|
|
2323
|
+
grade: "S" | "A" | "B" | "C" | "D" | "F" | null;
|
|
2324
|
+
/** Buys minus sells in the window, both outcomes, in USD: the matched notional, fees excluded. */
|
|
2325
|
+
net_usd: number;
|
|
2326
|
+
/** Fills in the window. */
|
|
2327
|
+
trades: number;
|
|
2328
|
+
/** The wallet's newest trade on any market, at or before window_end; null when unknown. */
|
|
2329
|
+
last_traded_at: string | null;
|
|
2330
|
+
})[];
|
|
2331
|
+
};
|
|
1952
2332
|
export type McpJsonRpcError = {
|
|
1953
2333
|
jsonrpc: "2.0";
|
|
1954
|
-
id
|
|
2334
|
+
/** The request's id, or null when the request could not be parsed. Omitted on the answer to an unsolicited response message. */
|
|
2335
|
+
id?: string | number | null;
|
|
1955
2336
|
error: {
|
|
1956
2337
|
code: number;
|
|
1957
2338
|
message: string;
|
|
@@ -1980,20 +2361,20 @@ export type PickHolder = {
|
|
|
1980
2361
|
shares: number;
|
|
1981
2362
|
/** USD entry value of this wallet's position: `shares` times the pick's frozen `backed_price`. An entry valuation, never a live balance or the provider's current value. Omitted when the holder snapshot has no valid price. */
|
|
1982
2363
|
entry_value_usd?: number;
|
|
1983
|
-
/** This wallet's win rate in the pick's canonical category bucket (the pick's `category` field, e.g. Basketball -- label the rate with it, never with the narrower `display_category` league, except when `category_win_rate_game` is present, in which case the rate is that game's and is labelled with it): the share of the wallet's
|
|
2364
|
+
/** This wallet's win rate in the pick's canonical category bucket (the pick's `category` field, e.g. Basketball -- label the rate with it, never with the narrower `display_category` league, except when `category_win_rate_game` is present, in which case the rate is that game's or league's and is labelled with it): the share of the wallet's settled markets in that category (it closed its position by selling out, or the market resolved) whose realized P&L closed positive, as a 0..1 fraction. Present only with `category_win_rate_status` = `measured`, on `display_holders` entries, and only when the wallet clears the settled-market floor; recomputed at serve time from the current category read model, not frozen with the pick. Absent on `holders` entries, legacy rows, and payloads predating the field. */
|
|
1984
2365
|
category_win_rate?: number;
|
|
1985
|
-
/** The two counts `category_win_rate` is the ratio of, read from the same row: `wins / decided` equals the rate. Counts every
|
|
2366
|
+
/** The two counts `category_win_rate` is the ratio of, read from the same row: `wins / decided` equals the rate. Counts every settled Polymarket market the wallet traded (it closed its position by selling out, or the market resolved) in the pick's canonical category (or in its game or league, when `category_win_rate_game` is present), at any position size; the counts are rebuilt daily. Present only with `category_win_rate_status` = `measured`; absent otherwise and on payloads predating the field. */
|
|
1986
2367
|
category_win_record?: {
|
|
1987
|
-
/**
|
|
2368
|
+
/** Settled markets in the category that this wallet closed with a profit. */
|
|
1988
2369
|
wins: number;
|
|
1989
|
-
/**
|
|
2370
|
+
/** Settled markets in the category that this wallet closed with a profit or a loss. A market resolved at zero realized P&L is in neither count. */
|
|
1990
2371
|
decided: number;
|
|
1991
2372
|
};
|
|
1992
|
-
/** The wallet's average entry price in the pick's canonical category, as a 0..1 fraction of $1 (0.98 is 98 cents). Its sample is the wallet's
|
|
2373
|
+
/** The wallet's average entry price in the pick's canonical category, as a 0..1 fraction of $1 (0.98 is 98 cents). Its sample is the wallet's markets in that category that resolved to a winning side, of $20 or more where it bought one side at a known price, so it can differ from the `category_win_record` sample. A wallet that buys near-certain outcomes wins almost every time, so read the win rate beside this price. Present only with `category_win_rate_status` = `measured`, and only when that sample has at least 5 markets. When `category_win_rate_game` is present the price is still the whole `category` bucket's: this field has no per-game or per-league price. Absent otherwise and on payloads predating the field. */
|
|
1993
2374
|
category_avg_price?: number;
|
|
1994
|
-
/**
|
|
2375
|
+
/** Where `category_win_rate` and `category_win_record` were measured, by the same name the pick's `display_category` uses for it: for an esports pick the game (`LoL`, `CS2`, `Dota 2`, `Valorant`, `Call of Duty`, `Honor of Kings`, `Mobile Legends: Bang Bang`, `Overwatch`, `Rainbow Six Siege`, `Rocket League` or `StarCraft II`), and for a pick in a registered league that league (`NBA`, `NFL`, `NHL`, `MLB`, `UFC`, `ATP`, `WTA`, `LaLiga`, `Premier League`, `Serie A`, `UEFA Champions League`, `MLS` and the other registered leagues). Present only when the wallet's record there clears the 5-settled-market floor, in which case the rate and record are the game's or league's rather than the whole `category` bucket's. Absent when the rate is the bucket's (the wallet's history there is under the floor, or the competition is not a registered league), on every other pick, beside every non-measured status, and on payloads predating the field. Label the rate with this when present and with `category` otherwise. */
|
|
1995
2376
|
category_win_rate_game?: string;
|
|
1996
|
-
/** Why `category_win_rate` is present or absent on a `display_holders` entry: `measured` (rate present), `not_enough_data` (the wallet is below the
|
|
2377
|
+
/** Why `category_win_rate` is present or absent on a `display_holders` entry: `measured` (rate present), `not_enough_data` (the wallet is below the settled-market floor of 5 in the category), or `unavailable` (the annotation read failed; retry later). Absent entirely on `holders` entries, legacy rows, and payloads predating the field -- absence means the roster was never annotated, not a small sample. */
|
|
1997
2378
|
category_win_rate_status?: "measured" | "not_enough_data" | "unavailable";
|
|
1998
2379
|
/** Whole days since this wallet's first trade, rounded down (3.6 days reads 3), so it changes once a day, not on every request, and the pick's ETag holds between requests. Stamped at serve time from the wallet's current trader record, never frozen with the pick. The five badge fields are present together, and only for a wallet that carries at least one badge; all absent means no badge, or a body cached before the fields shipped. */
|
|
1999
2380
|
wallet_age_days?: number | null;
|
|
@@ -2141,9 +2522,9 @@ export type PickOfTheDay = {
|
|
|
2141
2522
|
grade: string | null;
|
|
2142
2523
|
/** The canonical sport bucket the win rate was measured over (for example Basketball). Can be BROADER than the pick's display_category, which names an exact league such as NBA — label the rate with this field, never with display_category. */
|
|
2143
2524
|
canonical_category: string;
|
|
2144
|
-
/** Share of the trader’s
|
|
2525
|
+
/** Share of the trader’s settled markets in canonical_category (closed by selling out, or resolved) with positive realized P&L, as a 0..1 fraction. Null when not measured. This is a trader statistic, not the pick’s probability of winning. */
|
|
2145
2526
|
win_rate: number | null;
|
|
2146
|
-
/** Number of
|
|
2527
|
+
/** Number of settled markets behind win_rate; null when not measured. */
|
|
2147
2528
|
n_resolved: number | null;
|
|
2148
2529
|
/** Recorded Polymarket position value on the backed outcome, in USD. It can change after this snapshot. */
|
|
2149
2530
|
position_usd: number;
|
|
@@ -2569,14 +2950,411 @@ export type PickOfTheDayNoEntitledPicks = {
|
|
|
2569
2950
|
message: string;
|
|
2570
2951
|
/** Rank-ordered entitled selections that have not released. Every row retains release_at and kickoff; unauthorized scheduled ranks appear only in identity-free locked_picks. */
|
|
2571
2952
|
scheduled_picks?: ScheduledPickSlot[];
|
|
2572
|
-
/** Entitled published picks whose holder proof is unreadable, ordered by rank. Unauthorized ranks appear only in locked_picks and cannot trigger proof warming. Read retry_at for the next read. */
|
|
2573
|
-
proof_pending_picks?: ProofPendingPickSlot[];
|
|
2574
2953
|
/**
|
|
2575
2954
|
* Deprecated (#24157): always null. No replacement lineage was ever recorded in this field; the key stays so existing V1 clients keep parsing. Identify a pick by pick_id.
|
|
2576
2955
|
* @deprecated
|
|
2577
2956
|
*/
|
|
2578
2957
|
supersedes_pick_id: string | null;
|
|
2579
2958
|
};
|
|
2959
|
+
export type PickOfTheDayStats = {
|
|
2960
|
+
categories: {
|
|
2961
|
+
canonical_category?: string;
|
|
2962
|
+
clv_avg_display?: string;
|
|
2963
|
+
clv_avg_pct?: number;
|
|
2964
|
+
clv_avg_pp?: number;
|
|
2965
|
+
clv_avg_pp_display?: string;
|
|
2966
|
+
clv_measured: number;
|
|
2967
|
+
edge_display?: string;
|
|
2968
|
+
edge_pp?: number;
|
|
2969
|
+
key: string;
|
|
2970
|
+
label: string;
|
|
2971
|
+
losses: number;
|
|
2972
|
+
net_profit_display?: string;
|
|
2973
|
+
net_profit_usd?: number;
|
|
2974
|
+
pending: number;
|
|
2975
|
+
picks: number;
|
|
2976
|
+
priced_decided: number;
|
|
2977
|
+
priced_in_display?: string;
|
|
2978
|
+
priced_in_pct?: number;
|
|
2979
|
+
roi_display?: string;
|
|
2980
|
+
roi_pct?: number;
|
|
2981
|
+
settled: number;
|
|
2982
|
+
small_sample: boolean;
|
|
2983
|
+
staked_usd: number;
|
|
2984
|
+
unit_score?: number;
|
|
2985
|
+
unit_score_display?: string;
|
|
2986
|
+
void: number;
|
|
2987
|
+
win_rate_display?: string;
|
|
2988
|
+
win_rate_pct?: number;
|
|
2989
|
+
wins: number;
|
|
2990
|
+
}[];
|
|
2991
|
+
days: ({
|
|
2992
|
+
date: string;
|
|
2993
|
+
losses: number;
|
|
2994
|
+
net_profit_display?: string;
|
|
2995
|
+
net_profit_usd?: number;
|
|
2996
|
+
pending: number;
|
|
2997
|
+
picks: number;
|
|
2998
|
+
sweep?: "win" | "loss";
|
|
2999
|
+
unit_score?: number;
|
|
3000
|
+
unit_score_display?: string;
|
|
3001
|
+
void: number;
|
|
3002
|
+
wins: number;
|
|
3003
|
+
})[];
|
|
3004
|
+
hit_rate: PickOfTheDayHitRate;
|
|
3005
|
+
market_expectations: {
|
|
3006
|
+
as_of_date: string;
|
|
3007
|
+
price_basis: string;
|
|
3008
|
+
timezone: string;
|
|
3009
|
+
windows: ({
|
|
3010
|
+
clv_avg_display: string | null;
|
|
3011
|
+
clv_avg_pct: number | null;
|
|
3012
|
+
clv_avg_pp: number | null;
|
|
3013
|
+
clv_avg_pp_display: string | null;
|
|
3014
|
+
clv_measured: number;
|
|
3015
|
+
clv_missing: number;
|
|
3016
|
+
expected_wins: number | null;
|
|
3017
|
+
expected_wins_display: string | null;
|
|
3018
|
+
from_date: string | null;
|
|
3019
|
+
key: string;
|
|
3020
|
+
label: string;
|
|
3021
|
+
numeric_unavailable: boolean;
|
|
3022
|
+
priced_decided: number;
|
|
3023
|
+
through_date: string;
|
|
3024
|
+
units: number | null;
|
|
3025
|
+
units_display: string | null;
|
|
3026
|
+
units_z: number | null;
|
|
3027
|
+
units_z_display: string | null;
|
|
3028
|
+
unpriced_decided: number;
|
|
3029
|
+
wins: number;
|
|
3030
|
+
wins_z: number | null;
|
|
3031
|
+
wins_z_display: string | null;
|
|
3032
|
+
})[];
|
|
3033
|
+
};
|
|
3034
|
+
market_types: {
|
|
3035
|
+
canonical_category?: string;
|
|
3036
|
+
clv_avg_display?: string;
|
|
3037
|
+
clv_avg_pct?: number;
|
|
3038
|
+
clv_avg_pp?: number;
|
|
3039
|
+
clv_avg_pp_display?: string;
|
|
3040
|
+
clv_measured: number;
|
|
3041
|
+
edge_display?: string;
|
|
3042
|
+
edge_pp?: number;
|
|
3043
|
+
key: string;
|
|
3044
|
+
label: string;
|
|
3045
|
+
losses: number;
|
|
3046
|
+
net_profit_display?: string;
|
|
3047
|
+
net_profit_usd?: number;
|
|
3048
|
+
pending: number;
|
|
3049
|
+
picks: number;
|
|
3050
|
+
priced_decided: number;
|
|
3051
|
+
priced_in_display?: string;
|
|
3052
|
+
priced_in_pct?: number;
|
|
3053
|
+
roi_display?: string;
|
|
3054
|
+
roi_pct?: number;
|
|
3055
|
+
settled: number;
|
|
3056
|
+
small_sample: boolean;
|
|
3057
|
+
staked_usd: number;
|
|
3058
|
+
unit_score?: number;
|
|
3059
|
+
unit_score_display?: string;
|
|
3060
|
+
void: number;
|
|
3061
|
+
win_rate_display?: string;
|
|
3062
|
+
win_rate_pct?: number;
|
|
3063
|
+
wins: number;
|
|
3064
|
+
}[];
|
|
3065
|
+
months: {
|
|
3066
|
+
canonical_category?: string;
|
|
3067
|
+
clv_avg_display?: string;
|
|
3068
|
+
clv_avg_pct?: number;
|
|
3069
|
+
clv_avg_pp?: number;
|
|
3070
|
+
clv_avg_pp_display?: string;
|
|
3071
|
+
clv_measured: number;
|
|
3072
|
+
edge_display?: string;
|
|
3073
|
+
edge_pp?: number;
|
|
3074
|
+
key: string;
|
|
3075
|
+
label: string;
|
|
3076
|
+
losses: number;
|
|
3077
|
+
net_profit_display?: string;
|
|
3078
|
+
net_profit_usd?: number;
|
|
3079
|
+
pending: number;
|
|
3080
|
+
picks: number;
|
|
3081
|
+
priced_decided: number;
|
|
3082
|
+
priced_in_display?: string;
|
|
3083
|
+
priced_in_pct?: number;
|
|
3084
|
+
roi_display?: string;
|
|
3085
|
+
roi_pct?: number;
|
|
3086
|
+
settled: number;
|
|
3087
|
+
small_sample: boolean;
|
|
3088
|
+
staked_usd: number;
|
|
3089
|
+
unit_score?: number;
|
|
3090
|
+
unit_score_display?: string;
|
|
3091
|
+
void: number;
|
|
3092
|
+
win_rate_display?: string;
|
|
3093
|
+
win_rate_pct?: number;
|
|
3094
|
+
wins: number;
|
|
3095
|
+
}[];
|
|
3096
|
+
outcome_stats: {
|
|
3097
|
+
concentration: {
|
|
3098
|
+
positive_wins: number;
|
|
3099
|
+
remaining_valued_decided: number;
|
|
3100
|
+
removed_wins: number;
|
|
3101
|
+
roi_without_top_wins_display: string | null;
|
|
3102
|
+
roi_without_top_wins_pct: number | null;
|
|
3103
|
+
target_wins: number;
|
|
3104
|
+
top_wins_share_display: string | null;
|
|
3105
|
+
top_wins_share_pct: number | null;
|
|
3106
|
+
valued_decided: number;
|
|
3107
|
+
};
|
|
3108
|
+
drawdown: {
|
|
3109
|
+
completed_days: number;
|
|
3110
|
+
current_days_below_peak: number | null;
|
|
3111
|
+
current_drawdown_display: string | null;
|
|
3112
|
+
current_drawdown_units: number | null;
|
|
3113
|
+
days_below_peak: number | null;
|
|
3114
|
+
excluded_days: number;
|
|
3115
|
+
from_date: string | null;
|
|
3116
|
+
longest_days_below_peak: number | null;
|
|
3117
|
+
longest_recovery_days: number | null;
|
|
3118
|
+
max_drawdown_display: string | null;
|
|
3119
|
+
max_drawdown_units: number | null;
|
|
3120
|
+
peak_date: string | null;
|
|
3121
|
+
peak_net_profit_usd: number | null;
|
|
3122
|
+
through_date: string | null;
|
|
3123
|
+
};
|
|
3124
|
+
profit_factor: {
|
|
3125
|
+
display: string | null;
|
|
3126
|
+
gross_loss_usd: number | null;
|
|
3127
|
+
gross_profit_usd: number | null;
|
|
3128
|
+
state: "empty" | "measured" | "no_losses" | "numeric_unavailable";
|
|
3129
|
+
value: number | null;
|
|
3130
|
+
valued_decided: number;
|
|
3131
|
+
};
|
|
3132
|
+
rolling: ({
|
|
3133
|
+
from_date: string | null;
|
|
3134
|
+
losses: number;
|
|
3135
|
+
roi_display: string | null;
|
|
3136
|
+
roi_pct: number | null;
|
|
3137
|
+
through_date: string | null;
|
|
3138
|
+
units: number | null;
|
|
3139
|
+
units_display: string | null;
|
|
3140
|
+
valued_decided: number;
|
|
3141
|
+
win_rate_display: string | null;
|
|
3142
|
+
win_rate_pct: number | null;
|
|
3143
|
+
window_size: number;
|
|
3144
|
+
wins: number;
|
|
3145
|
+
})[];
|
|
3146
|
+
};
|
|
3147
|
+
price_bands: {
|
|
3148
|
+
canonical_category?: string;
|
|
3149
|
+
clv_avg_display?: string;
|
|
3150
|
+
clv_avg_pct?: number;
|
|
3151
|
+
clv_avg_pp?: number;
|
|
3152
|
+
clv_avg_pp_display?: string;
|
|
3153
|
+
clv_measured: number;
|
|
3154
|
+
edge_display?: string;
|
|
3155
|
+
edge_pp?: number;
|
|
3156
|
+
key: string;
|
|
3157
|
+
label: string;
|
|
3158
|
+
losses: number;
|
|
3159
|
+
net_profit_display?: string;
|
|
3160
|
+
net_profit_usd?: number;
|
|
3161
|
+
pending: number;
|
|
3162
|
+
picks: number;
|
|
3163
|
+
priced_decided: number;
|
|
3164
|
+
priced_in_display?: string;
|
|
3165
|
+
priced_in_pct?: number;
|
|
3166
|
+
roi_display?: string;
|
|
3167
|
+
roi_pct?: number;
|
|
3168
|
+
settled: number;
|
|
3169
|
+
small_sample: boolean;
|
|
3170
|
+
staked_usd: number;
|
|
3171
|
+
unit_score?: number;
|
|
3172
|
+
unit_score_display?: string;
|
|
3173
|
+
void: number;
|
|
3174
|
+
win_rate_display?: string;
|
|
3175
|
+
win_rate_pct?: number;
|
|
3176
|
+
wins: number;
|
|
3177
|
+
}[];
|
|
3178
|
+
records: {
|
|
3179
|
+
best_day?: {
|
|
3180
|
+
date: string;
|
|
3181
|
+
date_display: string;
|
|
3182
|
+
losses: number;
|
|
3183
|
+
net_profit_display: string;
|
|
3184
|
+
net_profit_usd: number;
|
|
3185
|
+
picks: number;
|
|
3186
|
+
wins: number;
|
|
3187
|
+
};
|
|
3188
|
+
biggest_win?: {
|
|
3189
|
+
category: string;
|
|
3190
|
+
date: string;
|
|
3191
|
+
date_display: string;
|
|
3192
|
+
matchup: string;
|
|
3193
|
+
net_profit_display: string;
|
|
3194
|
+
net_profit_usd: number;
|
|
3195
|
+
};
|
|
3196
|
+
longest_losing_day_streak?: {
|
|
3197
|
+
days: number;
|
|
3198
|
+
end_date: string;
|
|
3199
|
+
net_profit_display: string;
|
|
3200
|
+
net_profit_usd: number;
|
|
3201
|
+
range_display: string;
|
|
3202
|
+
start_date: string;
|
|
3203
|
+
};
|
|
3204
|
+
longest_winning_day_streak?: {
|
|
3205
|
+
days: number;
|
|
3206
|
+
end_date: string;
|
|
3207
|
+
net_profit_display: string;
|
|
3208
|
+
net_profit_usd: number;
|
|
3209
|
+
range_display: string;
|
|
3210
|
+
start_date: string;
|
|
3211
|
+
};
|
|
3212
|
+
sweeps: {
|
|
3213
|
+
clean_sweeps: number;
|
|
3214
|
+
latest_clean_sweep?: {
|
|
3215
|
+
date: string;
|
|
3216
|
+
date_display: string;
|
|
3217
|
+
losses: number;
|
|
3218
|
+
wins: number;
|
|
3219
|
+
};
|
|
3220
|
+
latest_wipeout?: {
|
|
3221
|
+
date: string;
|
|
3222
|
+
date_display: string;
|
|
3223
|
+
losses: number;
|
|
3224
|
+
wins: number;
|
|
3225
|
+
};
|
|
3226
|
+
min_decided: number;
|
|
3227
|
+
wipeouts: number;
|
|
3228
|
+
};
|
|
3229
|
+
winning_days?: {
|
|
3230
|
+
flat: number;
|
|
3231
|
+
losing: number;
|
|
3232
|
+
settled: number;
|
|
3233
|
+
winning: number;
|
|
3234
|
+
winning_pct: number;
|
|
3235
|
+
winning_pct_display: string;
|
|
3236
|
+
};
|
|
3237
|
+
worst_day?: {
|
|
3238
|
+
date: string;
|
|
3239
|
+
date_display: string;
|
|
3240
|
+
losses: number;
|
|
3241
|
+
net_profit_display: string;
|
|
3242
|
+
net_profit_usd: number;
|
|
3243
|
+
picks: number;
|
|
3244
|
+
wins: number;
|
|
3245
|
+
};
|
|
3246
|
+
};
|
|
3247
|
+
sports: {
|
|
3248
|
+
canonical_category?: string;
|
|
3249
|
+
clv_avg_display?: string;
|
|
3250
|
+
clv_avg_pct?: number;
|
|
3251
|
+
clv_avg_pp?: number;
|
|
3252
|
+
clv_avg_pp_display?: string;
|
|
3253
|
+
clv_measured: number;
|
|
3254
|
+
edge_display?: string;
|
|
3255
|
+
edge_pp?: number;
|
|
3256
|
+
key: string;
|
|
3257
|
+
label: string;
|
|
3258
|
+
losses: number;
|
|
3259
|
+
net_profit_display?: string;
|
|
3260
|
+
net_profit_usd?: number;
|
|
3261
|
+
pending: number;
|
|
3262
|
+
picks: number;
|
|
3263
|
+
priced_decided: number;
|
|
3264
|
+
priced_in_display?: string;
|
|
3265
|
+
priced_in_pct?: number;
|
|
3266
|
+
roi_display?: string;
|
|
3267
|
+
roi_pct?: number;
|
|
3268
|
+
settled: number;
|
|
3269
|
+
small_sample: boolean;
|
|
3270
|
+
staked_usd: number;
|
|
3271
|
+
unit_score?: number;
|
|
3272
|
+
unit_score_display?: string;
|
|
3273
|
+
void: number;
|
|
3274
|
+
win_rate_display?: string;
|
|
3275
|
+
win_rate_pct?: number;
|
|
3276
|
+
wins: number;
|
|
3277
|
+
}[];
|
|
3278
|
+
streaks: {
|
|
3279
|
+
current?: number;
|
|
3280
|
+
current_day?: number;
|
|
3281
|
+
current_day_display?: string;
|
|
3282
|
+
current_display?: string;
|
|
3283
|
+
longest_loss: number;
|
|
3284
|
+
longest_win: number;
|
|
3285
|
+
};
|
|
3286
|
+
tiers: {
|
|
3287
|
+
canonical_category?: string;
|
|
3288
|
+
clv_avg_display?: string;
|
|
3289
|
+
clv_avg_pct?: number;
|
|
3290
|
+
clv_avg_pp?: number;
|
|
3291
|
+
clv_avg_pp_display?: string;
|
|
3292
|
+
clv_measured: number;
|
|
3293
|
+
edge_display?: string;
|
|
3294
|
+
edge_pp?: number;
|
|
3295
|
+
key: string;
|
|
3296
|
+
label: string;
|
|
3297
|
+
losses: number;
|
|
3298
|
+
net_profit_display?: string;
|
|
3299
|
+
net_profit_usd?: number;
|
|
3300
|
+
pending: number;
|
|
3301
|
+
picks: number;
|
|
3302
|
+
priced_decided: number;
|
|
3303
|
+
priced_in_display?: string;
|
|
3304
|
+
priced_in_pct?: number;
|
|
3305
|
+
roi_display?: string;
|
|
3306
|
+
roi_pct?: number;
|
|
3307
|
+
settled: number;
|
|
3308
|
+
small_sample: boolean;
|
|
3309
|
+
staked_usd: number;
|
|
3310
|
+
unit_score?: number;
|
|
3311
|
+
unit_score_display?: string;
|
|
3312
|
+
void: number;
|
|
3313
|
+
win_rate_display?: string;
|
|
3314
|
+
win_rate_pct?: number;
|
|
3315
|
+
wins: number;
|
|
3316
|
+
}[];
|
|
3317
|
+
total_sides: {
|
|
3318
|
+
canonical_category?: string;
|
|
3319
|
+
clv_avg_display?: string;
|
|
3320
|
+
clv_avg_pct?: number;
|
|
3321
|
+
clv_avg_pp?: number;
|
|
3322
|
+
clv_avg_pp_display?: string;
|
|
3323
|
+
clv_measured: number;
|
|
3324
|
+
edge_display?: string;
|
|
3325
|
+
edge_pp?: number;
|
|
3326
|
+
key: string;
|
|
3327
|
+
label: string;
|
|
3328
|
+
losses: number;
|
|
3329
|
+
net_profit_display?: string;
|
|
3330
|
+
net_profit_usd?: number;
|
|
3331
|
+
pending: number;
|
|
3332
|
+
picks: number;
|
|
3333
|
+
priced_decided: number;
|
|
3334
|
+
priced_in_display?: string;
|
|
3335
|
+
priced_in_pct?: number;
|
|
3336
|
+
roi_display?: string;
|
|
3337
|
+
roi_pct?: number;
|
|
3338
|
+
settled: number;
|
|
3339
|
+
small_sample: boolean;
|
|
3340
|
+
staked_usd: number;
|
|
3341
|
+
unit_score?: number;
|
|
3342
|
+
unit_score_display?: string;
|
|
3343
|
+
void: number;
|
|
3344
|
+
win_rate_display?: string;
|
|
3345
|
+
win_rate_pct?: number;
|
|
3346
|
+
wins: number;
|
|
3347
|
+
}[];
|
|
3348
|
+
voids: {
|
|
3349
|
+
backed_price?: number;
|
|
3350
|
+
backed_side?: string;
|
|
3351
|
+
category?: string;
|
|
3352
|
+
matchup?: string;
|
|
3353
|
+
pick_date: string;
|
|
3354
|
+
pick_id: string;
|
|
3355
|
+
pick_rank: number;
|
|
3356
|
+
}[];
|
|
3357
|
+
};
|
|
2580
3358
|
/** 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. */
|
|
2581
3359
|
export type PickOfTheDayUncommittedPayload = {
|
|
2582
3360
|
/** Frozen pre-game price of the backed side, 0..1, as the plain decimal text of the stored NUMERIC at full stored precision, trailing zeros included -- rendered exactly as the commitment payload renders it. */
|
|
@@ -2623,7 +3401,7 @@ export type PickSportsTeam = {
|
|
|
2623
3401
|
label: string | null;
|
|
2624
3402
|
/** Abbreviated team label (e.g. "POR"). */
|
|
2625
3403
|
short_label: string | null;
|
|
2626
|
-
/**
|
|
3404
|
+
/** The name to show for this team or competitor, the same on every surface (e.g. "UCF Knights", "Oklahoma City Thunder", "Portugal"). `label` keeps the market outcome's own spelling. */
|
|
2627
3405
|
full_name: string | null;
|
|
2628
3406
|
/** Provider team identifier (Polymarket /teams id). */
|
|
2629
3407
|
provider_id: number | null;
|
|
@@ -2650,6 +3428,10 @@ export type PickSportsTeam = {
|
|
|
2650
3428
|
headshot_revision?: number;
|
|
2651
3429
|
/** Optional latest retrieved ATP/WTA singles rank for this player. Absent for unranked, ambiguous, doubles, expired, or unavailable identities. This is not rank at match time. */
|
|
2652
3430
|
ranking?: TennisRanking;
|
|
3431
|
+
/** True when artwork measurements show that the team mark disappears on a white background and needs a dark plate there: the light-background twin of logo_mark_dark. Vendored crest verdicts are tied to the exact asset bytes; provider artwork is measured on white by the teams sync. Always sent; false when no current measurement marks the logo light. */
|
|
3432
|
+
logo_mark_light: boolean;
|
|
3433
|
+
/** True when logo_mark_dark and logo_mark_light are both measurements of this exact logo URL, so their false means the mark is legible on that background. Every vendored crest is measured; a provider logo is measured once the teams sync has scored it, usually within a few hourly cycles of first appearing. Always sent; false while the logo is not measured yet. */
|
|
3434
|
+
logo_mark_measured: boolean;
|
|
2653
3435
|
};
|
|
2654
3436
|
export type PlatformCapabilities = {
|
|
2655
3437
|
grade: PlatformCapabilityStatus;
|
|
@@ -2686,7 +3468,7 @@ export type PnlCorrection = {
|
|
|
2686
3468
|
amount: number;
|
|
2687
3469
|
/** Polymarket's net realized P&L plus amount. Since 2026-10-22 the grade reads this figure's sports and esports share. Omitted when Polymarket's figure is. */
|
|
2688
3470
|
realized?: number;
|
|
2689
|
-
/** Polymarket's net total P&L
|
|
3471
|
+
/** Polymarket's net total P&L over every Polymarket market of the wallet, plus amount. Omitted when Polymarket's figure is, and on leaderboard entries. */
|
|
2690
3472
|
net_total?: number;
|
|
2691
3473
|
/** The newest measurement among the measured markets. */
|
|
2692
3474
|
as_of: string;
|
|
@@ -2729,10 +3511,16 @@ export type Position = {
|
|
|
2729
3511
|
address: string;
|
|
2730
3512
|
username?: string;
|
|
2731
3513
|
grade?: "S" | "A" | "B" | "C" | "D" | "F";
|
|
2732
|
-
/**
|
|
3514
|
+
/** Sports and esports win rate as a ratio from 0 to 1 (0.62 means 62%): wins over the decided sports and esports markets on the wallet's record, the same figure as pnl.in_scope.win_rate and stats.win_rate on GET /api/v1/trader/{address}. Since 2026-10-27 it no longer counts other markets (#29953). Absent when the wallet has no record or no decided market. */
|
|
2733
3515
|
win_rate?: number;
|
|
2734
|
-
/**
|
|
3516
|
+
/**
|
|
3517
|
+
* Deprecated since 2026-10-27 and never sent. It was Polymarket's net total P&L over every Polymarket market of the wallet, and wallet figures cover sports and esports markets only (#29953). Read trader.in_scope_realized_pnl.
|
|
3518
|
+
* @deprecated
|
|
3519
|
+
*/
|
|
2735
3520
|
pnl?: number;
|
|
3521
|
+
/** The wallet's realized P&L in USD on sports and esports markets, the figure the 0xinsider profile shows: the record behind pnl.in_scope.realized_pnl on GET /api/v1/trader/{address}, to cents. For a graded wallet it is read from the latest grading pass, so it can trail that figure until the next pass. Omitted until 0xinsider has computed the wallet's record (#29953). */
|
|
3522
|
+
in_scope_realized_pnl?: number;
|
|
3523
|
+
/** Sports and esports markets on the wallet's record, pnl.in_scope.markets on GET /api/v1/trader/{address}. Since 2026-10-27 it no longer counts other markets (#29953). Absent when the wallet has no record. */
|
|
2736
3524
|
markets?: number;
|
|
2737
3525
|
/** Days since the wallet's first-seen time. For a wallet 0xinsider first recorded on or after March 21, 2026, that is when 0xinsider recorded it. For a wallet recorded earlier, it is usually the wallet's first Polymarket activity, so the age can run to years. It is not the wallet's on-chain age or the time of its first trade. Absent when the first-seen time is unknown. */
|
|
2738
3526
|
wallet_age_days?: number;
|
|
@@ -2871,7 +3659,7 @@ export type ReportPayload = {
|
|
|
2871
3659
|
/** Trader pseudonym, when no display name is known. */
|
|
2872
3660
|
pseudonym: string | null;
|
|
2873
3661
|
/** Trader grade (S-F) at snapshot time. */
|
|
2874
|
-
trader_grade:
|
|
3662
|
+
trader_grade: "S" | "A" | "B" | "C" | "D" | "F" | null;
|
|
2875
3663
|
})[] | null;
|
|
2876
3664
|
top_whale_trades: ({
|
|
2877
3665
|
/** Provider outcome label for the traded side. */
|
|
@@ -2899,11 +3687,19 @@ export type ReportPayload = {
|
|
|
2899
3687
|
/** Trader pseudonym, when no display name is known. */
|
|
2900
3688
|
pseudonym: string | null;
|
|
2901
3689
|
/** Trader grade (S-F) at snapshot time. */
|
|
2902
|
-
trader_grade:
|
|
3690
|
+
trader_grade: "S" | "A" | "B" | "C" | "D" | "F" | null;
|
|
3691
|
+
})[] | null;
|
|
3692
|
+
categories: ({
|
|
3693
|
+
category: string | null;
|
|
3694
|
+
large_trade_count: number | null;
|
|
3695
|
+
whale_trade_count: number | null;
|
|
3696
|
+
category_volume: number | null;
|
|
2903
3697
|
})[] | null;
|
|
2904
|
-
categories: Record<string, unknown>[] | null;
|
|
2905
3698
|
/** Counts of current grades for distinct Polymarket traders with at least one whale alert in the report's source date range. The grade is the current projection at snapshot materialization time, not a historical grade at trade time. Traders without a current ranking projection are omitted; a null grade entry means the active trader's current grade is unavailable. */
|
|
2906
|
-
grade_distribution:
|
|
3699
|
+
grade_distribution: ({
|
|
3700
|
+
grade: "S" | "A" | "B" | "C" | "D" | "F" | null;
|
|
3701
|
+
count: number | null;
|
|
3702
|
+
})[] | null;
|
|
2907
3703
|
/** Which markets the report counts. sports_and_esports for a period that ends on or after 2026-10-21: totals, categories, top trades and the grade cohort cover sports and esports markets only. all_markets for an earlier period, whose stored report keeps every Polymarket market it published. */
|
|
2908
3704
|
market_scope: "all_markets" | "sports_and_esports";
|
|
2909
3705
|
};
|
|
@@ -2927,6 +3723,60 @@ export type ReportSourceRange = {
|
|
|
2927
3723
|
end_date: string;
|
|
2928
3724
|
timezone: "UTC";
|
|
2929
3725
|
};
|
|
3726
|
+
export type ResolutionReport = {
|
|
3727
|
+
accuracy: number | null;
|
|
3728
|
+
all_wallets_accuracy: number | null;
|
|
3729
|
+
all_wallets_right: number | null;
|
|
3730
|
+
all_wallets_wrong: number | null;
|
|
3731
|
+
date: string | null;
|
|
3732
|
+
generated_at: string | null;
|
|
3733
|
+
grade_basis: "at_resolution" | "current" | null;
|
|
3734
|
+
market_scope: "all_markets" | "sports_and_esports";
|
|
3735
|
+
markets?: ({
|
|
3736
|
+
all_wallets_right: boolean | null;
|
|
3737
|
+
category: string | null;
|
|
3738
|
+
condition_id: string | null;
|
|
3739
|
+
confidence: number | null;
|
|
3740
|
+
event_slug: string | null;
|
|
3741
|
+
out_of_product_scope: boolean;
|
|
3742
|
+
outcome_no: string | null;
|
|
3743
|
+
outcome_yes: string | null;
|
|
3744
|
+
report_at: string;
|
|
3745
|
+
smart_consensus: string | null;
|
|
3746
|
+
smart_right: boolean | null;
|
|
3747
|
+
smart_trader_count: number | null;
|
|
3748
|
+
time_basis: "polymarket_gamma_closed_time" | "observed_resolution";
|
|
3749
|
+
title: string | null;
|
|
3750
|
+
total_smart_pnl: number | null;
|
|
3751
|
+
traders: ({
|
|
3752
|
+
address: string | null;
|
|
3753
|
+
correct: boolean | null;
|
|
3754
|
+
cost: number | null;
|
|
3755
|
+
grade: "S" | "A" | "B" | "C" | "D" | "F" | null;
|
|
3756
|
+
last_traded_at: string | null;
|
|
3757
|
+
pnl: number | null;
|
|
3758
|
+
side: string | null;
|
|
3759
|
+
username: string | null;
|
|
3760
|
+
})[];
|
|
3761
|
+
weighted_no: number | null;
|
|
3762
|
+
weighted_yes: number | null;
|
|
3763
|
+
winning_outcome: number | null;
|
|
3764
|
+
})[];
|
|
3765
|
+
markets_without_smart_positions: number | null;
|
|
3766
|
+
no_consensus: number | null;
|
|
3767
|
+
positions_grade_unknown: number | null;
|
|
3768
|
+
positions_without_side: number | null;
|
|
3769
|
+
smart_money_right: number | null;
|
|
3770
|
+
smart_money_wrong: number | null;
|
|
3771
|
+
source_updates_pending: boolean;
|
|
3772
|
+
time_basis_counts: {
|
|
3773
|
+
observed_resolution: number;
|
|
3774
|
+
polymarket_gamma_closed_time: number;
|
|
3775
|
+
} | null;
|
|
3776
|
+
total_resolved: number | null;
|
|
3777
|
+
total_smart_pnl: number | null;
|
|
3778
|
+
with_smart_positions: number | null;
|
|
3779
|
+
};
|
|
2930
3780
|
export type ResponseMeta = {
|
|
2931
3781
|
/** Unique request ID (req_ prefix). The same value as the X-Request-Id response header, the request's usage accounting row and its log lines. */
|
|
2932
3782
|
request_id: string;
|
|
@@ -3091,6 +3941,50 @@ export type SnapshotState = {
|
|
|
3091
3941
|
/** When this body's source read started, the clock finality is judged on. null for a body stored before that clock was recorded. */
|
|
3092
3942
|
source_read_started_at: string | null;
|
|
3093
3943
|
};
|
|
3944
|
+
export type SportLeaderboard = {
|
|
3945
|
+
as_of: string | null;
|
|
3946
|
+
category: string | null;
|
|
3947
|
+
edge_average: number | null;
|
|
3948
|
+
league: {
|
|
3949
|
+
name: string;
|
|
3950
|
+
ranked_traders: number;
|
|
3951
|
+
slug: string;
|
|
3952
|
+
} | null;
|
|
3953
|
+
limit: number;
|
|
3954
|
+
min_resolved: number;
|
|
3955
|
+
rows: ({
|
|
3956
|
+
address: string;
|
|
3957
|
+
cost: number | null;
|
|
3958
|
+
edge_hold: "category_loss" | "record_incomplete" | null;
|
|
3959
|
+
edge_skill: number | null;
|
|
3960
|
+
grade: "S" | "A" | "B" | "C" | "D" | "F" | null;
|
|
3961
|
+
id: string;
|
|
3962
|
+
last_category_trade_at: string | null;
|
|
3963
|
+
losses: number;
|
|
3964
|
+
n_resolved: number;
|
|
3965
|
+
platform: "polymarket";
|
|
3966
|
+
pnl: number | null;
|
|
3967
|
+
price_edge: {
|
|
3968
|
+
avg_price: number;
|
|
3969
|
+
edge: number;
|
|
3970
|
+
edge_lower: number;
|
|
3971
|
+
hit_rate: number;
|
|
3972
|
+
markets: number;
|
|
3973
|
+
status: "ranked" | "too_few_markets" | "sample_mismatch";
|
|
3974
|
+
} | null;
|
|
3975
|
+
rank: number;
|
|
3976
|
+
roi: number | null;
|
|
3977
|
+
username: string | null;
|
|
3978
|
+
volume: number | null;
|
|
3979
|
+
win_rate: number | null;
|
|
3980
|
+
win_rate_wilson_lb: number | null;
|
|
3981
|
+
wins: number;
|
|
3982
|
+
})[];
|
|
3983
|
+
sort: "edge" | "pnl" | "win_rate";
|
|
3984
|
+
sport: string;
|
|
3985
|
+
total_traders: number;
|
|
3986
|
+
volume_scope: "sports_and_esports";
|
|
3987
|
+
};
|
|
3094
3988
|
export type SuspiciousTrade = {
|
|
3095
3989
|
/** Prefixed ID (rf_...). */
|
|
3096
3990
|
id: string;
|
|
@@ -3145,7 +4039,7 @@ export type SuspiciousTradeFlaggedData = {
|
|
|
3145
4039
|
/** Fill price of the flagged trade. */
|
|
3146
4040
|
price: number;
|
|
3147
4041
|
};
|
|
3148
|
-
/** 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. New observations require corroborated identity, current set/games, and live state. Cached responses and replayed frames may still carry expired facts, so clients must enforce expires_at. */
|
|
4042
|
+
/** 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. 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. */
|
|
3149
4043
|
export type TennisPoints = {
|
|
3150
4044
|
source: "api_tennis";
|
|
3151
4045
|
/** API-Tennis match ID. This is not a Polymarket market or event ID. */
|
|
@@ -3162,10 +4056,12 @@ export type TennisPoints = {
|
|
|
3162
4056
|
observed_at: string;
|
|
3163
4057
|
/** Stop displaying the point group at this instant, even if the enclosing score remains fresh. The group expires 30 seconds after observed_at. */
|
|
3164
4058
|
expires_at: string;
|
|
3165
|
-
/** Current set number. Display points only while this matches the enclosing scoreboard. */
|
|
4059
|
+
/** Current set number. Display points only while this matches the enclosing scoreboard, unless set_games is present. */
|
|
3166
4060
|
set_number: number;
|
|
3167
|
-
/** Current-set games in first/second order. Display points only while these match the enclosing scoreboard. */
|
|
4061
|
+
/** Current-set games in first/second order. Display points only while these match the enclosing scoreboard, unless set_games is present. */
|
|
3168
4062
|
games: number[];
|
|
4063
|
+
/** API-Tennis games in every listed set, first set first, each in first/second order. Present only when Polymarket publishes no score for the match (tennis doubles): display these as the set score, and discard the group once live_score carries a nonzero game. A deciding match tie-break is listed as games, for example 9-5. Omitted for every other match. */
|
|
4064
|
+
set_games?: number[][];
|
|
3169
4065
|
};
|
|
3170
4066
|
/** 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. */
|
|
3171
4067
|
export type TennisRanking = {
|
|
@@ -3195,29 +4091,52 @@ export type Trader = {
|
|
|
3195
4091
|
forecast_evidence?: number;
|
|
3196
4092
|
rank?: number;
|
|
3197
4093
|
pnl: {
|
|
3198
|
-
/**
|
|
4094
|
+
/**
|
|
4095
|
+
* Deprecated since 2026-10-27 and never sent. It was Polymarket's all-time leaderboard P&L, which covered every Polymarket market of the wallet, and wallet figures cover sports and esports markets only (#29830). Read pnl.in_scope.realized_pnl.
|
|
4096
|
+
* @deprecated
|
|
4097
|
+
*/
|
|
3199
4098
|
total?: number;
|
|
3200
|
-
/**
|
|
4099
|
+
/**
|
|
4100
|
+
* Deprecated since 2026-10-27 and never sent. It was Polymarket's net total P&L over every Polymarket market of the wallet, and wallet figures cover sports and esports markets only (#29830). Read pnl.in_scope.realized_pnl.
|
|
4101
|
+
* @deprecated
|
|
4102
|
+
*/
|
|
3201
4103
|
net_total?: number;
|
|
3202
|
-
/**
|
|
4104
|
+
/**
|
|
4105
|
+
* Deprecated since 2026-10-27 and never sent. It was the neg-risk conversion correction to the wallet-wide pnl.net_total and pnl.realized (#29830). Its sports and esports part is inside pnl.in_scope.realized_pnl.
|
|
4106
|
+
* @deprecated
|
|
4107
|
+
*/
|
|
3203
4108
|
correction?: PnlCorrection;
|
|
3204
|
-
/** true while 0xinsider is still checking some of the wallet's converted neg-risk markets with a sports or esports event (not yet measured, measured and not yet checked for transfers, or its latest reads keep failing), so the correction may change, or arrive where none is published yet. Omitted otherwise. */
|
|
4109
|
+
/** true while 0xinsider is still checking some of the wallet's converted neg-risk markets with a sports or esports event (not yet measured, measured and not yet checked for transfers, or its latest reads keep failing), so the correction's part inside pnl.in_scope.realized_pnl may change, or arrive where none is published yet. Omitted otherwise. */
|
|
3205
4110
|
correction_pending?: boolean;
|
|
3206
|
-
/**
|
|
4111
|
+
/**
|
|
4112
|
+
* Deprecated since 2026-10-27 and never sent. It was native Polymarket realized P&L over every Polymarket market of the wallet, and wallet figures cover sports and esports markets only (#29830). Read pnl.in_scope.realized_pnl.
|
|
4113
|
+
* @deprecated
|
|
4114
|
+
*/
|
|
3207
4115
|
realized?: number;
|
|
4116
|
+
/** Unrealized P&L in USD of the wallet's open positions on its synced sports and esports markets, from the open-position aggregate (dated by the positions data_quality group). Each open position's market is judged when the aggregate is read (#32119), so a stored position on a market of another category (one that moved out of sports and esports, or one stored before its category was known) is left out. Before 2026-10-27 (#29366) it covered every Polymarket market. */
|
|
3208
4117
|
unrealized?: number;
|
|
3209
|
-
/**
|
|
4118
|
+
/**
|
|
4119
|
+
* Deprecated since 2026-10-27 and never sent: its one member was the lossless counterpart of the retired pnl.realized (#29830).
|
|
4120
|
+
* @deprecated
|
|
4121
|
+
*/
|
|
3210
4122
|
exact?: TraderPnlExact;
|
|
3211
|
-
/** Additive (#27311): the wallet's sports and esports record, the figure the 0xinsider profile headlines. Omitted until 0xinsider has computed the wallet's record; absent means not computed yet, never zero.
|
|
4123
|
+
/** Additive (#27311): the wallet's sports and esports record, the figure the 0xinsider profile headlines, dated by the sports_record data_quality group. Omitted until 0xinsider has computed the wallet's record; absent means not computed yet, never zero. Also omitted for a wallet that traded no sports or esports market, which never gets a record: then stats.markets_traded is 0 and the sports_record group is partial with owner traders.last_synced (since 2026-10-29, #30589, #30657). Also omitted for a wallet that trades only combos and holds no single sports or esports market: the record counts single markets, so it has none, stats.markets_traded and stats.win_rate are omitted, and the sports_record group is partial with owner traders.last_synced (since 2026-10-29, #30637). Since 2026-10-27 it is the wallet's only P&L figure besides pnl.unrealized (#29830). */
|
|
3212
4124
|
in_scope?: TraderPnlInScope;
|
|
3213
4125
|
};
|
|
4126
|
+
/** Sports and esports markets only since 2026-10-27 (#29830): markets_traded and win_rate come from the wallet's sports and esports record (pnl.in_scope), and total_volume from its stored trade days. A wallet that traded no sports or esports market never gets a record: markets_traded is 0 and win_rate is omitted (since 2026-10-29, #30589, #30657). A wallet that trades only combos has no record either: both are omitted (since 2026-10-29, #30637). */
|
|
3214
4127
|
stats: {
|
|
4128
|
+
/** Sports and esports markets the wallet traded, any status: pnl.in_scope.markets, dated by the sports_record data_quality group. Omitted until the record is computed. 0 for a wallet that traded no sports or esports market, which never gets a record: at its last completed sync Polymarket counted no market for it, or the sync read its Polymarket positions and found no sports or esports market; none is stored, and no Polymarket sports or esports board lists it; the sports_record group then carries the sync clock (since 2026-10-29, #30589; the second case since #30657). Omitted for a wallet that trades only combos and holds no single sports or esports market, which has no record (since 2026-10-29, #30637). Counted every Polymarket market before 2026-10-27. */
|
|
3215
4129
|
markets_traded?: number;
|
|
4130
|
+
/** Won over decided sports and esports markets, 0 to 1: pnl.in_scope.win_rate truncated to four places, dated by the sports_record data_quality group. Omitted until the record is computed, while the wallet has no decided sports or esports market, for a wallet that traded no sports or esports market (#30589, #30657), and for one that trades only combos (#30637). Counted every Polymarket market before 2026-10-27. */
|
|
3216
4131
|
win_rate?: number;
|
|
4132
|
+
/**
|
|
4133
|
+
* Deprecated since 2026-10-27 and never sent. It counted mark-to-market days over every Polymarket market of the wallet (#29830). Read stats.all.win_days and stats.all.loss_days from GET /api/v1/trader/{address}/pnl, which count sports and esports days.
|
|
4134
|
+
* @deprecated
|
|
4135
|
+
*/
|
|
3217
4136
|
daily_win_rate?: number;
|
|
3218
|
-
/**
|
|
4137
|
+
/** Sports and esports USD volume, all time: the sum of every stored trade day's in-scope volume (trader_trade_daily_rollups.in_scope_volume_total), the profile's Volume traded. Dated by the volume data_quality group, which carries the trader sync clock. 0 for a synced wallet with no stored trade day. Omitted before the wallet's first completed sync and while any stored day's in-scope volume is not computed yet, so a partial sum is never served. Polymarket's full-history wallet-wide volume before 2026-10-27 (#29830). */
|
|
3219
4138
|
total_volume?: number;
|
|
3220
|
-
/** Additive lossless counterpart to `total_volume
|
|
4139
|
+
/** Additive lossless counterpart to `total_volume`, present exactly when it is. */
|
|
3221
4140
|
exact?: TraderStatsExact;
|
|
3222
4141
|
};
|
|
3223
4142
|
strategy?: {
|
|
@@ -3228,7 +4147,10 @@ export type Trader = {
|
|
|
3228
4147
|
};
|
|
3229
4148
|
/** Per-category rank context when expand=categories is requested. Values include available rank, category totals, performance and record counts; scaled_total_pnl is a legacy alias of total_pnl. Its measurement basis and update timing differ from the plain record returned by GET /api/v1/trader/{address}/categories, so the two need not agree. Use this for rank context and that route for the plain record. Sports and esports only (#28761): keys are sports and esports categories, and a category outside them is omitted, as on that route. The inner key-set is intentionally unconstrained and may contain additional compatibility fields. */
|
|
3230
4149
|
category_strengths?: Record<string, unknown>;
|
|
3231
|
-
/**
|
|
4150
|
+
/**
|
|
4151
|
+
* Deprecated since 2026-10-27 and never sent. These advanced risk and performance metrics covered every Polymarket market of the wallet, and wallet figures cover sports and esports markets only (#29589). expand=quant_metrics is still accepted and adds nothing. For the sports and esports record read pnl.in_scope here, and GET /api/v1/trader/{address}/pnl for its daily series. The member shape below is what the object held before; it is kept so existing type declarations still compile.
|
|
4152
|
+
* @deprecated
|
|
4153
|
+
*/
|
|
3232
4154
|
quant_metrics?: {
|
|
3233
4155
|
/** Trader smart score on a 0..100 display scale; higher is stronger. Null when unavailable. */
|
|
3234
4156
|
smart_score: number | null;
|
|
@@ -3249,11 +4171,13 @@ export type Trader = {
|
|
|
3249
4171
|
/** Cross-sectional percentile rank of edge consistency versus all traders, 0-100. null when insufficient history. */
|
|
3250
4172
|
consistency_percentile: number | null;
|
|
3251
4173
|
};
|
|
4174
|
+
/** When the wallet last traded: its most recent recorded trade, the same value the leaderboard entry's last_active carries (which re-reads it hourly). A cached body (meta.cached true) can lag a new trade by up to 60 seconds. No data_quality group dates it: the value is itself a trade time. Since 2026-11-02 (#32324); before, it carried the time 0xinsider last synced the wallet, the same value as synced_at. Omitted when the wallet has no recorded trade. */
|
|
3252
4175
|
last_active?: string;
|
|
4176
|
+
/** When 0xinsider last completed a sync of the wallet (traders.last_synced), dated by the sync data_quality group. Not when the wallet traded: read last_active for that. */
|
|
3253
4177
|
synced_at?: string;
|
|
3254
4178
|
/** synced, unknown, or pending. */
|
|
3255
4179
|
sync_status?: string;
|
|
3256
|
-
/** Data age and coverage for this trader body. Always present. Its six groups are sync (traders.last_synced, covering
|
|
4180
|
+
/** Data age and coverage for this trader body. Always present. Its six groups are sync (traders.last_synced, covering synced_at and sync_status; it covered last_active until 2026-11-02, #32324, and no group covers last_active now, since the value is itself a trade time), sports_record (trader_product_scope_records.computed_at, covering pnl.in_scope, stats.markets_traded and stats.win_rate: unavailable until the wallet's sports and esports record is computed, partial while it has no decided sports or esports market; for a wallet that traded no sports or esports market, which never gets a record, partial with owner traders.last_synced, as of the completed sync that found none, stats.markets_traded 0 and pnl.in_scope and stats.win_rate omitted, since 2026-10-29, #30589, #30657; for a wallet that trades only combos and holds no single sports or esports market, partial with owner traders.last_synced and all three omitted, since 2026-10-29, #30637), ranking (trader_rankings.computed_at, covering grade, score, streak_tier, forecast_score and forecast_evidence), leaderboard_rank (leaderboard_rank_refresh_state.completed_at, the completion time of the latest fully completed global rank refresh, covering rank), volume (traders.last_synced, covering stats.total_volume, the sum of the trade days the sync stores: unavailable before the first completed sync and while a stored day's sports and esports volume is not computed) and positions (trader_position_snapshots.last_refreshed_at with traders.last_synced as fallback, covering pnl.unrealized, the open-position aggregate). Since 2026-10-27 (#29830) there is no leaderboard_pnl group, and volume is dated by the sync clock instead of trader_usd_volume.observed_at. The positions clock is the latest successful /positions snapshot when one exists, otherwise the last completed trader sync. A rank or position value remains unknown or unavailable when its clock or value is absent. For an unknown wallet every group is unavailable. If the open-position read itself fails, positions is unavailable with a reason that says so, pnl.unrealized is absent, and the body is answered fresh (meta.cached false) and is not kept for later callers. */
|
|
3257
4181
|
data_quality: DataQuality;
|
|
3258
4182
|
/** Field-level trust metadata. Present only when expand=trust or expand[]=trust is requested. */
|
|
3259
4183
|
trust?: TraderTrust;
|
|
@@ -3291,31 +4215,37 @@ export type TraderCategoryRecords = {
|
|
|
3291
4215
|
};
|
|
3292
4216
|
export type TraderContext = {
|
|
3293
4217
|
trader: Trader;
|
|
3294
|
-
/** Aggregate position and P&L coverage for the trader.
|
|
4218
|
+
/** Aggregate position and P&L coverage for the trader, over its synced markets. markets_open, unrealized_mtm and cost_basis_locked cover the open positions on sports and esports markets, each market judged when the summary is read (#32119). markets_synced, markets_resolved and the resolved win figures count every stored market: since 2026-10-27 (#29366) those are mostly sports and esports markets, but a market that moved out of sports and esports, or one stored before its category was known, stays in them, and sync_coverage counts every category on both sides. markets_total, total_realized_pnl and synced_realized_pnl still cover every Polymarket market of the wallet. Omitted entirely (key absent, never null) when the trader is not in the local database or native net economics is unavailable. Realized fields remain numbers when present, including a genuine zero. */
|
|
3295
4219
|
position_summary?: {
|
|
3296
|
-
/**
|
|
4220
|
+
/** Polymarket's count of the markets the wallet traded, every category, when known; null when the provider total is unavailable. */
|
|
3297
4221
|
markets_total: number | null;
|
|
3298
4222
|
/** Markets with locally synced position rows. */
|
|
3299
4223
|
markets_synced: number;
|
|
3300
|
-
/**
|
|
4224
|
+
/** Markets outside sports and esports that the wallet traded and whose synced rows 0xinsider deleted, counted when they were deleted (from 2026-10-27, #29366); 0 when none were. Not in markets_synced or any other count here; sync_coverage adds it to markets_synced so both sides of that ratio count every category. */
|
|
4225
|
+
markets_pruned: number;
|
|
4226
|
+
/** Markets outside sports and esports that the wallet first traded since 2026-10-26, which 0xinsider does not store, counted as the wallet syncs (#30165); 0 when none are. Not in markets_synced, markets_pruned or any other count here; sync_coverage adds it with markets_pruned to markets_synced. */
|
|
4227
|
+
markets_unstored: number;
|
|
4228
|
+
/** Combo markets the wallet traded, as maker or taker, counted from the combo fills 0xinsider indexes from the chain (#30218); 0 when it traded none. Polymarket counts each combo as one market in markets_total, and no position read lists one, so a combo is in no other count here; sync_coverage adds it with markets_pruned and markets_unstored to markets_synced. */
|
|
4229
|
+
markets_combo: number;
|
|
4230
|
+
/** Synced markets the wallet has settled: it closed its position by selling out, or the market resolved. Its P&L there is final. */
|
|
3301
4231
|
markets_resolved: number;
|
|
3302
|
-
/** Synced markets still open with residual value (open positions with current value > 0). */
|
|
4232
|
+
/** Synced sports and esports markets still open with residual value (open positions with current value > 0); a stored market of another category is left out (#32119). */
|
|
3303
4233
|
markets_open: number;
|
|
3304
|
-
/** markets_synced divided by markets_total when the provider total is known (capped at 1.0); 0.0-1.0. When markets_total is unknown or not positive (null, 0, or negative), this is 1.0 if
|
|
4234
|
+
/** markets_synced plus markets_pruned plus markets_unstored plus markets_combo, divided by markets_total when the provider total is known (capped at 1.0); 0.0-1.0. Both sides count every category: no Polymarket count of a wallet's sports and esports markets exists, so the ratio does not estimate one. When markets_total is unknown or not positive (null, 0, or negative), this is 1.0 if that sum is positive (else 0.0), so cross-check markets_total before treating 1.0 as full coverage. */
|
|
3305
4235
|
sync_coverage: number;
|
|
3306
|
-
/** Native net realized P&L (USD) including credited rebates, minus the stored realized component of open positions with positive current value. Rebates are credited to the account, not to a position, so every credited rebate stays in this figure. NUMERIC arithmetic precedes conversion to a JSON number. */
|
|
4236
|
+
/** Native net realized P&L (USD) over every Polymarket market of the wallet, including credited rebates, minus the stored realized component of synced open positions with positive current value. Rebates are credited to the account, not to a position, so every credited rebate stays in this figure. NUMERIC arithmetic precedes conversion to a JSON number. */
|
|
3307
4237
|
synced_realized_pnl: number;
|
|
3308
|
-
/** Native net realized P&L (USD) including credited rebates, read directly from the accounting snapshot. Position sync_coverage is separate from this accounting basis. */
|
|
4238
|
+
/** Native net realized P&L (USD) over every Polymarket market of the wallet, including credited rebates, read directly from the accounting snapshot. For the sports and esports figure read trader.pnl.in_scope.realized_pnl. Position sync_coverage is separate from this accounting basis. */
|
|
3309
4239
|
total_realized_pnl: number;
|
|
3310
|
-
/** Mark-to-market unrealized P&L (USD) on open positions. */
|
|
4240
|
+
/** Mark-to-market unrealized P&L (USD) on open positions in synced sports and esports markets (#32119). */
|
|
3311
4241
|
unrealized_mtm: number;
|
|
3312
|
-
/** Cost basis (USD) currently tied up in open positions. */
|
|
4242
|
+
/** Cost basis (USD) currently tied up in open positions in synced sports and esports markets (#32119). */
|
|
3313
4243
|
cost_basis_locked: number;
|
|
3314
|
-
/** Win rate as a percentage (0-100): resolved_wins over resolved_decided. A
|
|
4244
|
+
/** Win rate as a percentage (0-100): resolved_wins over resolved_decided. A settled market that closed at exactly zero realized P&L (a void, a refund, a fully hedged position) is neither a win nor a loss and is not in the denominator, the same rule the leaderboard applies; null when no resolved market was decided. It is the rule of trader.stats.win_rate, read from the synced rows at request time; stats.win_rate is the stored figure the profile shows, refreshed by each sync and a few minutes after a closed-history write. context.md prints one Market win rate, stats.win_rate. */
|
|
3315
4245
|
resolved_win_rate: number | null;
|
|
3316
|
-
/**
|
|
4246
|
+
/** Settled markets that closed at positive realized P&L: the win-rate numerator. Additive; null only on a summary cached before the field existed. */
|
|
3317
4247
|
resolved_wins: number | null;
|
|
3318
|
-
/**
|
|
4248
|
+
/** Settled markets that closed at a non-zero realized P&L: the win-rate denominator. At most markets_resolved; the difference is markets settled at exactly zero or with an unknown P&L. Additive; null only on a summary cached before the field existed. */
|
|
3319
4249
|
resolved_decided: number | null;
|
|
3320
4250
|
/** RFC3339 freshness of the served OPEN-position data: the trader's latest /positions snapshot, else the last completed sync. The snapshot advances ONLY open positions, so read this as the open-position freshness clock -- the resolved/closed aggregates on this same summary (markets_resolved, resolved_win_rate) advance only on a full sync. The value is the /positions snapshot instant when one exists, so it is typically at or just before the trader-level last sync on a normal sync, and can be AFTER it while the active-view loop refreshes open positions between full syncs. This clock does not establish native accounting freshness. Always present on the wire (serialized as JSON null when the trader has neither a snapshot nor a sync); never omitted. */
|
|
3321
4251
|
as_of: string | null;
|
|
@@ -3379,7 +4309,7 @@ export type TraderExportJob = {
|
|
|
3379
4309
|
object: "trader_export_job";
|
|
3380
4310
|
data: {
|
|
3381
4311
|
job_id: number;
|
|
3382
|
-
/** queued:
|
|
4312
|
+
/** queued: waiting for a worker. A running job reads queued again, with error saying why, when its worker restarts for a deploy (the next worker claims it within seconds) or stops without handing it back (requeued within a minute of its 30-minute lease lapsing); it starts again from the beginning. running: the worker is streaming rows. reconcile_required: the upload finished but the storage completion answer was lost; the reconciler reads the object back within a minute, retries a failed readback an hour later, and moves the job to ready or failed, and expires_at bounds the wait. ready: downloadable until expires_at. failed: terminal; error says why; submit a new export. expired: the retention window passed; the file is retired, the download route answers 410, submit a new export. cancel_requested: the owner cancelled a running job (POST /api/v1/trader/{address}/export/cancel); the worker stops at its next safe point and the job reads cancelled. cancelled: terminal; the owner cancelled the job and no file was published; submit a new export. A job that has not reached ready by expires_at reads failed with error 'export expired before completion'. failed, cancelled and expired rows stay readable for 48 hours, then the job answers 404. */
|
|
3383
4313
|
status: "queued" | "running" | "ready" | "failed" | "reconcile_required" | "expired" | "cancel_requested" | "cancelled";
|
|
3384
4314
|
format: "json" | "ndjson" | "csv";
|
|
3385
4315
|
/** Trade rows the file holds: trades in the wallet's sports and esports markets, counted in the file's own read snapshot. Null until the worker has read the snapshot (queued, and early in running); a job accepted before 2026-10-22 can carry the earlier all-markets estimate until its file is read. */
|
|
@@ -3410,7 +4340,7 @@ export type TraderExportJob = {
|
|
|
3410
4340
|
cancel_requested_at: string | null;
|
|
3411
4341
|
/** When the job reached cancelled; null until then. */
|
|
3412
4342
|
cancelled_at: string | null;
|
|
3413
|
-
/** Worker claims so far. */
|
|
4343
|
+
/** Worker claims so far. A claim handed back when its worker restarts for a deploy is not counted, so attempt steps back by one when the job reads queued again for that reason. */
|
|
3414
4344
|
attempt: number;
|
|
3415
4345
|
/** The job fails when attempt reaches this. */
|
|
3416
4346
|
max_attempts: number;
|
|
@@ -3444,7 +4374,7 @@ export type TraderExportPositionWatermark = {
|
|
|
3444
4374
|
};
|
|
3445
4375
|
export type TraderExportSnapshot = {
|
|
3446
4376
|
address: string;
|
|
3447
|
-
/** The markets the export file's trades and markets sections hold: sports and esports markets only. counts.exported_markets, counts.estimated_trade_rows, counts.estimated_size_mb, reconciliation.exported_market_cost_basis and source_range.latest_trade_at and latest_market_activity_at describe those markets, and reconciliation.exported_activity_volume is the cash the wallet traded in sports and esports markets.
|
|
4377
|
+
/** The markets the export file's trades and markets sections hold: sports and esports markets only. counts.exported_markets, counts.estimated_trade_rows, counts.estimated_size_mb, reconciliation.exported_market_cost_basis and source_range.latest_trade_at and latest_market_activity_at describe those markets, and reconciliation.exported_activity_volume is the cash the wallet traded in sports and esports markets. source_range.first_pnl_date, last_pnl_date and pnl_series_status and counts.pnl_days describe the file's pnl section, the wallet's sports and esports realized P&L by day. completeness.sync_coverage is the wallet's stored markets (its sports and esports markets since 2026-10-27, #29366) plus the markets of other categories whose rows were deleted and counted (position_summary.markets_pruned on the context) and those first traded since 2026-10-26, which are not stored and are counted as the wallet syncs (position_summary.markets_unstored, #30165) and its combo markets, which Polymarket counts and no position read lists (position_summary.markets_combo, #30218), over Polymarket's count of every market it traded: both sides count every category, so a fully synced wallet reads 1.0 and complete. A wallet with nothing stored and no pnl day is empty whatever its coverage. */
|
|
3448
4378
|
product_scope: "sports_esports_v1";
|
|
3449
4379
|
generated_at: string;
|
|
3450
4380
|
source_range: ExportSourceRange;
|
|
@@ -3525,11 +4455,11 @@ export type TraderPnl = {
|
|
|
3525
4455
|
drawdown: number | null;
|
|
3526
4456
|
} | null;
|
|
3527
4457
|
};
|
|
3528
|
-
/** RFC3339 served-freshness clock: when the wallet's sports and esports record, which this series is read from, was last computed; null while series_status is pending. Always present, so read it as a value that can be null rather than a key that can be missing. */
|
|
4458
|
+
/** RFC3339 served-freshness clock: when the wallet's sports and esports record, which this series is read from, was last computed, or, for a wallet that traded no sports or esports market (#30589, #30657) or trades only combos (#30637) and so has no record, its last completed sync; null while series_status is pending. Always present, so read it as a value that can be null rather than a key that can be missing. */
|
|
3529
4459
|
freshness_at: string | null;
|
|
3530
|
-
/** `ready` when the series is served; an empty one is a wallet with no sports or esports day. `pending` when the wallet's sports and esports record does not carry the daily series yet: every section is empty, realized is null, and the empty sections never mean zero. Retry later. */
|
|
4460
|
+
/** `ready` when the series is served; an empty one is a wallet with no sports or esports day, or one that traded no sports or esports market (#30589, #30657) or trades only combos (#30637). `pending` when the wallet's sports and esports record does not carry the daily series yet: every section is empty, realized is null, and the empty sections never mean zero. Retry later. */
|
|
3531
4461
|
series_status: "ready" | "pending";
|
|
3532
|
-
/** How the daily series adds up to the wallet's Sports P&L, full precision: dated_pnl + undated_pnl = realized_pnl. null while series_status is pending. */
|
|
4462
|
+
/** How the daily series adds up to the wallet's Sports P&L, full precision: dated_pnl + undated_pnl = realized_pnl. null while series_status is pending, and for a wallet that traded no sports or esports market or trades only combos, which has no record (#30589, #30657, #30637). */
|
|
3533
4463
|
realized: {
|
|
3534
4464
|
/** The rule behind realized_pnl, the same basis as pnl.in_scope.basis on GET /api/v1/trader/{address}. */
|
|
3535
4465
|
basis: "polymarket_sports_esports_v1" | "sports_esports_split_v1";
|
|
@@ -3545,7 +4475,7 @@ export type TraderPnl = {
|
|
|
3545
4475
|
date: string;
|
|
3546
4476
|
/** Sports and esports markets this wallet traded on this UTC day, counted from the fills 0xinsider stores for it. Omitted on a day whose stored fills include a market outside sports and esports (stored before October 2026), where the count would include it, and on a day above 20 times the wallet's median day. */
|
|
3547
4477
|
markets_traded?: number;
|
|
3548
|
-
/**
|
|
4478
|
+
/** Volume in USD this wallet traded on this UTC day in sports and esports markets, buys and sells: each fill's size times its price, fees excluded, the measure of Polymarket user-volume `volume_usdc`, summed from the fills 0xinsider stores for it. A day stored before 2026-10-27 counts the cash each fill moved, fee included, until it is recomputed. Not Polymarket's share count, and not the full-history stats.total_volume on GET /api/v1/trader/{address}, which covers every market. Omitted on a day with realized P&L and no stored sports or esports fill, and, with markets_traded, on a day above 20 times the wallet's median day. */
|
|
3549
4479
|
total_volume?: number;
|
|
3550
4480
|
/** Running sum of daily_change through this day. */
|
|
3551
4481
|
cumulative_profit?: number;
|
|
@@ -3629,12 +4559,12 @@ export type TraderPnl = {
|
|
|
3629
4559
|
drawdown: number;
|
|
3630
4560
|
}[];
|
|
3631
4561
|
};
|
|
3632
|
-
/**
|
|
4562
|
+
/** 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. */
|
|
3633
4563
|
export type TraderPnlExact = {
|
|
3634
4564
|
/** Native Polymarket realized P&L plus credited maker and taker rebates, with fees included, from the trusted matching `trader_trading_pnl.net_realized_pnl` snapshot. */
|
|
3635
4565
|
realized: ExactDecimal;
|
|
3636
4566
|
};
|
|
3637
|
-
/** 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
|
|
4567
|
+
/** 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. */
|
|
3638
4568
|
export type TraderPnlInScope = {
|
|
3639
4569
|
/** The rule behind realized_pnl: polymarket_sports_esports_v1 (Polymarket's sports and esports category figures plus apportioned rebates) or sports_esports_split_v1 (the published realized figure split by cost). A new value means the rule changed; compare figures only within one basis. */
|
|
3640
4570
|
basis: string;
|
|
@@ -3642,18 +4572,18 @@ export type TraderPnlInScope = {
|
|
|
3642
4572
|
realized_pnl: number | null;
|
|
3643
4573
|
/** Sports and esports markets the wallet has traded, any status. */
|
|
3644
4574
|
markets: number;
|
|
3645
|
-
/** Of those, the markets
|
|
4575
|
+
/** Of those, the settled markets: the wallet closed its position by selling out, or the market resolved. Its P&L there is final. */
|
|
3646
4576
|
markets_resolved: number;
|
|
3647
4577
|
/** Share of decided sports and esports markets the wallet won, 0 to 1. null with no decided market. */
|
|
3648
4578
|
win_rate: number | null;
|
|
3649
|
-
/** The wallet's markets outside sports and esports, which 0xinsider no longer lists. */
|
|
4579
|
+
/** The wallet's markets outside sports and esports, which 0xinsider no longer lists: those it still stores, those whose rows it deleted and counted, and those of other categories first traded since 2026-10-26, which it does not store and counts as the wallet syncs (#30165). */
|
|
3650
4580
|
markets_out_of_scope: number;
|
|
3651
4581
|
/** When the record behind these figures was computed. */
|
|
3652
4582
|
as_of: string;
|
|
3653
4583
|
};
|
|
3654
|
-
/** Lossless counterparts for trader statistics. The object is
|
|
4584
|
+
/** Lossless counterparts for trader statistics. The object is present exactly when stats.total_volume is. */
|
|
3655
4585
|
export type TraderStatsExact = {
|
|
3656
|
-
/** stats.total_volume as an exact decimal:
|
|
4586
|
+
/** stats.total_volume as an exact decimal: the sports and esports USD volume, the sum of every stored trade day's `trader_trade_daily_rollups.in_scope_volume_total` (#29830). Polymarket's full-history wallet-wide user volume before 2026-10-27. */
|
|
3657
4587
|
total_volume: ExactDecimal;
|
|
3658
4588
|
};
|
|
3659
4589
|
/** `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). */
|
|
@@ -3665,15 +4595,25 @@ export type TraderSyncedData = {
|
|
|
3665
4595
|
};
|
|
3666
4596
|
/** Field-level trust metadata returned only when GET /api/v1/trader/{address} includes expand=trust. */
|
|
3667
4597
|
export type TraderTrust = {
|
|
4598
|
+
/** Since 2026-10-27 always not_computed: pnl.total is retired and never sent (#29830). The key stays so the object keeps its shape. */
|
|
3668
4599
|
total_pnl: TrustMetadata;
|
|
4600
|
+
/** Since 2026-10-27 always not_computed: pnl.realized and pnl.exact are retired and never sent (#29830). The key stays so the object keeps its shape. */
|
|
3669
4601
|
realized_pnl: TrustMetadata;
|
|
4602
|
+
/** Since 2026-10-27 always not_computed: pnl.net_total is retired and never sent (#29830). The key stays so the object keeps its shape. */
|
|
3670
4603
|
net_total_pnl: TrustMetadata;
|
|
3671
|
-
/**
|
|
4604
|
+
/**
|
|
4605
|
+
* Deprecated since 2026-10-27 and never sent: it was present only with pnl.correction, which is retired (#29830).
|
|
4606
|
+
* @deprecated
|
|
4607
|
+
*/
|
|
3672
4608
|
pnl_correction?: TrustMetadata;
|
|
3673
4609
|
unrealized_pnl: TrustMetadata;
|
|
4610
|
+
/** Computed, owned by trader_product_scope_records (markets) and dated by the record's computed_at, since 2026-10-27 (#29830). For a wallet that traded no sports or esports market, which never gets a record, owned by traders (last_synced), the completed sync that found none, and dated by it, since 2026-10-29 (#30589, #30657; owned by traders (markets_traded) until #30657). */
|
|
3674
4611
|
markets_traded: TrustMetadata;
|
|
4612
|
+
/** Computed, owned by trader_product_scope_records (win_rate) and dated by the record's computed_at, since 2026-10-27 (#29830). */
|
|
3675
4613
|
win_rate: TrustMetadata;
|
|
4614
|
+
/** Since 2026-10-27 always not_computed: stats.daily_win_rate is retired and never sent (#29830). The key stays so the object keeps its shape. */
|
|
3676
4615
|
daily_win_rate: TrustMetadata;
|
|
4616
|
+
/** Computed, owned by trader_trade_daily_rollups (in_scope_volume_total) and dated by traders.last_synced, since 2026-10-27 (#29830). */
|
|
3677
4617
|
total_volume: TrustMetadata;
|
|
3678
4618
|
grade: TrustMetadata;
|
|
3679
4619
|
score: TrustMetadata;
|
|
@@ -3714,9 +4654,17 @@ export type TrendingWallet = {
|
|
|
3714
4654
|
grade?: "S" | "A" | "B" | "C" | "D" | "F";
|
|
3715
4655
|
/** Hot-streak tier (trailing-7d cross-sectional percentile). Omitted when there is no recent activity. */
|
|
3716
4656
|
streak_tier?: "hot" | "rising" | "neutral" | "cooling" | "cold";
|
|
3717
|
-
/**
|
|
4657
|
+
/** Additive (#29971): the wallet's sports and esports realized P&L in USD, the same figure as pnl.in_scope.realized_pnl on GET /api/v1/trader/{address} and the 0xinsider profile's Sports P&L, as of the board's last rebuild. Context only: it does not affect the ranking, which follows trending_pnl_usd. Omitted when the wallet is not in the 0xinsider database or has no sports and esports record yet: absent means not computed, never zero. */
|
|
4658
|
+
in_scope_realized_pnl?: number;
|
|
4659
|
+
/**
|
|
4660
|
+
* Deprecated since 2026-10-27 and never sent. It was Polymarket's net total P&L over every Polymarket market of the wallet, and wallet figures cover sports and esports markets only (#29971). Read in_scope_realized_pnl.
|
|
4661
|
+
* @deprecated
|
|
4662
|
+
*/
|
|
3718
4663
|
all_time_pnl_usd?: number;
|
|
3719
|
-
/**
|
|
4664
|
+
/**
|
|
4665
|
+
* Deprecated since 2026-10-27 and never sent. It was the neg-risk conversion correction to the wallet-wide all_time_pnl_usd (#29971). Its sports and esports part is inside in_scope_realized_pnl.
|
|
4666
|
+
* @deprecated
|
|
4667
|
+
*/
|
|
3720
4668
|
pnl_correction?: PnlCorrection;
|
|
3721
4669
|
all_time_score?: number;
|
|
3722
4670
|
last_synced?: string;
|
|
@@ -3984,7 +4932,7 @@ export type WhaleDatasetJob = {
|
|
|
3984
4932
|
object: "whale_dataset_job";
|
|
3985
4933
|
data: {
|
|
3986
4934
|
job_id: number;
|
|
3987
|
-
/** queued:
|
|
4935
|
+
/** queued: waiting for a worker. A running job reads queued again, with error saying why, when its worker restarts for a deploy (the next worker claims it within seconds) or stops without handing it back (requeued within a minute of its 30-minute lease lapsing); it starts again from the beginning. running: the worker is streaming rows. reconcile_required: the upload finished but the storage completion answer was lost; the reconciler reads the object back within a minute, retries a failed readback an hour later, and moves the job to ready or failed, and expires_at bounds the wait. ready: downloadable until expires_at. failed: terminal; error says why; submit a new export. expired: the retention window passed; the file is retired, the download route answers 410, submit a new export. cancel_requested: the owner cancelled a running job (POST /api/v1/trader/{address}/export/cancel); the worker stops at its next safe point and the job reads cancelled. cancelled: terminal; the owner cancelled the job and no file was published; submit a new export. A job that has not reached ready by expires_at reads failed with error 'export expired before completion'. failed, cancelled and expired rows stay readable for 48 hours, then the job answers 404. */
|
|
3988
4936
|
status: "queued" | "running" | "ready" | "failed" | "reconcile_required" | "expired" | "cancel_requested" | "cancelled";
|
|
3989
4937
|
format: "ndjson";
|
|
3990
4938
|
total_trades: number | null;
|
|
@@ -4013,7 +4961,7 @@ export type WhaleDatasetJob = {
|
|
|
4013
4961
|
cancel_requested_at: string | null;
|
|
4014
4962
|
/** When the job reached cancelled; null until then. */
|
|
4015
4963
|
cancelled_at: string | null;
|
|
4016
|
-
/** Worker claims so far. */
|
|
4964
|
+
/** Worker claims so far. A claim handed back when its worker restarts for a deploy is not counted, so attempt steps back by one when the job reads queued again for that reason. */
|
|
4017
4965
|
attempt: number;
|
|
4018
4966
|
/** The job fails when attempt reaches this. */
|
|
4019
4967
|
max_attempts: number;
|
|
@@ -4091,7 +5039,7 @@ export interface OperationData {
|
|
|
4091
5039
|
batchGetTraders: BatchTraderItem[];
|
|
4092
5040
|
cancelTraderExport: {
|
|
4093
5041
|
job_id: number;
|
|
4094
|
-
/** queued:
|
|
5042
|
+
/** queued: waiting for a worker. A running job reads queued again, with error saying why, when its worker restarts for a deploy (the next worker claims it within seconds) or stops without handing it back (requeued within a minute of its 30-minute lease lapsing); it starts again from the beginning. running: the worker is streaming rows. reconcile_required: the upload finished but the storage completion answer was lost; the reconciler reads the object back within a minute, retries a failed readback an hour later, and moves the job to ready or failed, and expires_at bounds the wait. ready: downloadable until expires_at. failed: terminal; error says why; submit a new export. expired: the retention window passed; the file is retired, the download route answers 410, submit a new export. cancel_requested: the owner cancelled a running job (POST /api/v1/trader/{address}/export/cancel); the worker stops at its next safe point and the job reads cancelled. cancelled: terminal; the owner cancelled the job and no file was published; submit a new export. A job that has not reached ready by expires_at reads failed with error 'export expired before completion'. failed, cancelled and expired rows stay readable for 48 hours, then the job answers 404. */
|
|
4095
5043
|
status: "queued" | "running" | "ready" | "failed" | "reconcile_required" | "expired" | "cancel_requested" | "cancelled";
|
|
4096
5044
|
format: "json" | "ndjson" | "csv";
|
|
4097
5045
|
/** Trade rows the file holds: trades in the wallet's sports and esports markets, counted in the file's own read snapshot. Null until the worker has read the snapshot (queued, and early in running); a job accepted before 2026-10-22 can carry the earlier all-markets estimate until its file is read. */
|
|
@@ -4122,7 +5070,7 @@ export interface OperationData {
|
|
|
4122
5070
|
cancel_requested_at: string | null;
|
|
4123
5071
|
/** When the job reached cancelled; null until then. */
|
|
4124
5072
|
cancelled_at: string | null;
|
|
4125
|
-
/** Worker claims so far. */
|
|
5073
|
+
/** Worker claims so far. A claim handed back when its worker restarts for a deploy is not counted, so attempt steps back by one when the job reads queued again for that reason. */
|
|
4126
5074
|
attempt: number;
|
|
4127
5075
|
/** The job fails when attempt reaches this. */
|
|
4128
5076
|
max_attempts: number;
|
|
@@ -4142,7 +5090,7 @@ export interface OperationData {
|
|
|
4142
5090
|
};
|
|
4143
5091
|
cancelWhaleDataset: {
|
|
4144
5092
|
job_id: number;
|
|
4145
|
-
/** queued:
|
|
5093
|
+
/** queued: waiting for a worker. A running job reads queued again, with error saying why, when its worker restarts for a deploy (the next worker claims it within seconds) or stops without handing it back (requeued within a minute of its 30-minute lease lapsing); it starts again from the beginning. running: the worker is streaming rows. reconcile_required: the upload finished but the storage completion answer was lost; the reconciler reads the object back within a minute, retries a failed readback an hour later, and moves the job to ready or failed, and expires_at bounds the wait. ready: downloadable until expires_at. failed: terminal; error says why; submit a new export. expired: the retention window passed; the file is retired, the download route answers 410, submit a new export. cancel_requested: the owner cancelled a running job (POST /api/v1/trader/{address}/export/cancel); the worker stops at its next safe point and the job reads cancelled. cancelled: terminal; the owner cancelled the job and no file was published; submit a new export. A job that has not reached ready by expires_at reads failed with error 'export expired before completion'. failed, cancelled and expired rows stay readable for 48 hours, then the job answers 404. */
|
|
4146
5094
|
status: "queued" | "running" | "ready" | "failed" | "reconcile_required" | "expired" | "cancel_requested" | "cancelled";
|
|
4147
5095
|
format: "ndjson";
|
|
4148
5096
|
total_trades: number | null;
|
|
@@ -4171,7 +5119,7 @@ export interface OperationData {
|
|
|
4171
5119
|
cancel_requested_at: string | null;
|
|
4172
5120
|
/** When the job reached cancelled; null until then. */
|
|
4173
5121
|
cancelled_at: string | null;
|
|
4174
|
-
/** Worker claims so far. */
|
|
5122
|
+
/** Worker claims so far. A claim handed back when its worker restarts for a deploy is not counted, so attempt steps back by one when the job reads queued again for that reason. */
|
|
4175
5123
|
attempt: number;
|
|
4176
5124
|
/** The job fails when attempt reaches this. */
|
|
4177
5125
|
max_attempts: number;
|
|
@@ -4208,7 +5156,8 @@ export interface OperationData {
|
|
|
4208
5156
|
getAccountIdentity: {
|
|
4209
5157
|
user_id: number;
|
|
4210
5158
|
credential_id: number;
|
|
4211
|
-
|
|
5159
|
+
/** The kind of credential that made the request: api_key is a full-access developer key, oauth_grant an OAuth access token, integration_key a named integration key with fixed scopes created on https://0xinsider.com/developers. Before integration_key was added, these keys reported oauth_grant. */
|
|
5160
|
+
credential_kind: "api_key" | "oauth_grant" | "integration_key";
|
|
4212
5161
|
/** The credential is currently valid; revoked, expired or unknown credentials are rejected. */
|
|
4213
5162
|
credential_status: "active";
|
|
4214
5163
|
entitlement: {
|
|
@@ -4216,10 +5165,11 @@ export interface OperationData {
|
|
|
4216
5165
|
/** When paid data access is lapsed, the caller should renew the subscription; otherwise null. */
|
|
4217
5166
|
recovery_action: "renew_subscription" | null;
|
|
4218
5167
|
};
|
|
4219
|
-
/**
|
|
5168
|
+
/** The scopes an OAuth grant or integration key carries; null for full developer-key access. */
|
|
4220
5169
|
scopes: string[] | null;
|
|
4221
5170
|
};
|
|
4222
5171
|
getApiDiscovery: ApiDiscovery;
|
|
5172
|
+
getCategoryLeaderboard: CategoryLeader[];
|
|
4223
5173
|
getCombo: ComboDetail;
|
|
4224
5174
|
getCombosSummary: CombosSummary;
|
|
4225
5175
|
getCoverage: Platforms;
|
|
@@ -4227,6 +5177,8 @@ export interface OperationData {
|
|
|
4227
5177
|
getEdgeHunter: EdgeHunterBoard | EdgeHunterRankedSignal[] | EdgeHunterObservation[];
|
|
4228
5178
|
getEventReplaySince: EventReplayEvent[];
|
|
4229
5179
|
getGame: Game;
|
|
5180
|
+
getGameHolders: BatchGameHoldersItem[];
|
|
5181
|
+
getGameSharpMoney: GameSharpMoney;
|
|
4230
5182
|
getHealth: {
|
|
4231
5183
|
status: "ok" | "degraded" | "down" | "maintenance";
|
|
4232
5184
|
db: boolean;
|
|
@@ -4257,15 +5209,20 @@ export interface OperationData {
|
|
|
4257
5209
|
getMarketHolders: MarketHolder[];
|
|
4258
5210
|
getMarketIntel: MarketFlow;
|
|
4259
5211
|
getMarketSnapshot: MarketSnapshot;
|
|
5212
|
+
getMarketTopHolders: MarketTopHolders;
|
|
5213
|
+
getMarketWalletsInOut: MarketWalletsInOut;
|
|
4260
5214
|
getMonthlyReportSnapshot: ReportSnapshot;
|
|
4261
5215
|
getPickOfTheDay: PickOfTheDay | PickOfTheDayNoEntitledPicks;
|
|
4262
5216
|
getPickOfTheDayArchive: PickOfTheDayArchive;
|
|
4263
5217
|
getPickOfTheDayLedger: PickOfTheDayLedger;
|
|
4264
5218
|
getPickOfTheDayLedgerEntry: PickOfTheDayLedgerEntry;
|
|
5219
|
+
getPickOfTheDayStats: PickOfTheDayStats;
|
|
4265
5220
|
getPlatforms: Platforms;
|
|
4266
5221
|
getPositionTimeline: PositionTimelineEvent[];
|
|
4267
5222
|
getPositionTimelineById: PositionTimelineEvent[];
|
|
4268
5223
|
getReports: ReportSnapshot;
|
|
5224
|
+
getResolutionReport: ResolutionReport;
|
|
5225
|
+
getSportLeaderboard: SportLeaderboard;
|
|
4269
5226
|
getStream: string;
|
|
4270
5227
|
getSuspiciousTrade: SuspiciousTrade;
|
|
4271
5228
|
getTrader: Trader;
|
|
@@ -4275,7 +5232,7 @@ export interface OperationData {
|
|
|
4275
5232
|
getTraderExportSnapshot: TraderExportSnapshot;
|
|
4276
5233
|
getTraderExportStatus: {
|
|
4277
5234
|
job_id: number;
|
|
4278
|
-
/** queued:
|
|
5235
|
+
/** queued: waiting for a worker. A running job reads queued again, with error saying why, when its worker restarts for a deploy (the next worker claims it within seconds) or stops without handing it back (requeued within a minute of its 30-minute lease lapsing); it starts again from the beginning. running: the worker is streaming rows. reconcile_required: the upload finished but the storage completion answer was lost; the reconciler reads the object back within a minute, retries a failed readback an hour later, and moves the job to ready or failed, and expires_at bounds the wait. ready: downloadable until expires_at. failed: terminal; error says why; submit a new export. expired: the retention window passed; the file is retired, the download route answers 410, submit a new export. cancel_requested: the owner cancelled a running job (POST /api/v1/trader/{address}/export/cancel); the worker stops at its next safe point and the job reads cancelled. cancelled: terminal; the owner cancelled the job and no file was published; submit a new export. A job that has not reached ready by expires_at reads failed with error 'export expired before completion'. failed, cancelled and expired rows stay readable for 48 hours, then the job answers 404. */
|
|
4279
5236
|
status: "queued" | "running" | "ready" | "failed" | "reconcile_required" | "expired" | "cancel_requested" | "cancelled";
|
|
4280
5237
|
format: "json" | "ndjson" | "csv";
|
|
4281
5238
|
/** Trade rows the file holds: trades in the wallet's sports and esports markets, counted in the file's own read snapshot. Null until the worker has read the snapshot (queued, and early in running); a job accepted before 2026-10-22 can carry the earlier all-markets estimate until its file is read. */
|
|
@@ -4306,7 +5263,7 @@ export interface OperationData {
|
|
|
4306
5263
|
cancel_requested_at: string | null;
|
|
4307
5264
|
/** When the job reached cancelled; null until then. */
|
|
4308
5265
|
cancelled_at: string | null;
|
|
4309
|
-
/** Worker claims so far. */
|
|
5266
|
+
/** Worker claims so far. A claim handed back when its worker restarts for a deploy is not counted, so attempt steps back by one when the job reads queued again for that reason. */
|
|
4310
5267
|
attempt: number;
|
|
4311
5268
|
/** The job fails when attempt reaches this. */
|
|
4312
5269
|
max_attempts: number;
|
|
@@ -4369,7 +5326,7 @@ export interface OperationData {
|
|
|
4369
5326
|
getWeeklyReportSnapshot: ReportSnapshot;
|
|
4370
5327
|
getWhaleDatasetStatus: {
|
|
4371
5328
|
job_id: number;
|
|
4372
|
-
/** queued:
|
|
5329
|
+
/** queued: waiting for a worker. A running job reads queued again, with error saying why, when its worker restarts for a deploy (the next worker claims it within seconds) or stops without handing it back (requeued within a minute of its 30-minute lease lapsing); it starts again from the beginning. running: the worker is streaming rows. reconcile_required: the upload finished but the storage completion answer was lost; the reconciler reads the object back within a minute, retries a failed readback an hour later, and moves the job to ready or failed, and expires_at bounds the wait. ready: downloadable until expires_at. failed: terminal; error says why; submit a new export. expired: the retention window passed; the file is retired, the download route answers 410, submit a new export. cancel_requested: the owner cancelled a running job (POST /api/v1/trader/{address}/export/cancel); the worker stops at its next safe point and the job reads cancelled. cancelled: terminal; the owner cancelled the job and no file was published; submit a new export. A job that has not reached ready by expires_at reads failed with error 'export expired before completion'. failed, cancelled and expired rows stay readable for 48 hours, then the job answers 404. */
|
|
4373
5330
|
status: "queued" | "running" | "ready" | "failed" | "reconcile_required" | "expired" | "cancel_requested" | "cancelled";
|
|
4374
5331
|
format: "ndjson";
|
|
4375
5332
|
total_trades: number | null;
|
|
@@ -4398,7 +5355,7 @@ export interface OperationData {
|
|
|
4398
5355
|
cancel_requested_at: string | null;
|
|
4399
5356
|
/** When the job reached cancelled; null until then. */
|
|
4400
5357
|
cancelled_at: string | null;
|
|
4401
|
-
/** Worker claims so far. */
|
|
5358
|
+
/** Worker claims so far. A claim handed back when its worker restarts for a deploy is not counted, so attempt steps back by one when the job reads queued again for that reason. */
|
|
4402
5359
|
attempt: number;
|
|
4403
5360
|
/** The job fails when attempt reaches this. */
|
|
4404
5361
|
max_attempts: number;
|
|
@@ -4418,8 +5375,43 @@ export interface OperationData {
|
|
|
4418
5375
|
filters: WhaleDatasetFilters;
|
|
4419
5376
|
};
|
|
4420
5377
|
getWhaleTrade: LargeTradeDetail;
|
|
5378
|
+
listCategoryLeaders: CategoryLeader[];
|
|
4421
5379
|
listComboFills: ComboFill[];
|
|
5380
|
+
listGameMarkets: ({
|
|
5381
|
+
condition_id: string;
|
|
5382
|
+
event_slug: string;
|
|
5383
|
+
group_item_title?: string;
|
|
5384
|
+
id: string;
|
|
5385
|
+
line?: number;
|
|
5386
|
+
line_outcome_index?: number;
|
|
5387
|
+
negative_risk?: boolean;
|
|
5388
|
+
outcomes: {
|
|
5389
|
+
index: number;
|
|
5390
|
+
label?: string;
|
|
5391
|
+
token_id?: string;
|
|
5392
|
+
}[];
|
|
5393
|
+
platform?: string;
|
|
5394
|
+
slug?: string;
|
|
5395
|
+
sports_market_type?: string;
|
|
5396
|
+
status: string;
|
|
5397
|
+
title?: string;
|
|
5398
|
+
sharp_money?: {
|
|
5399
|
+
money_as_of: string | null;
|
|
5400
|
+
outcomes: {
|
|
5401
|
+
index: number;
|
|
5402
|
+
usd: number;
|
|
5403
|
+
wallets: {
|
|
5404
|
+
a: number;
|
|
5405
|
+
b: number;
|
|
5406
|
+
s: number;
|
|
5407
|
+
};
|
|
5408
|
+
}[];
|
|
5409
|
+
status: "computed" | "not_computed" | "unavailable";
|
|
5410
|
+
trader_count: number | null;
|
|
5411
|
+
};
|
|
5412
|
+
})[];
|
|
4422
5413
|
listGames: Game[];
|
|
5414
|
+
listGameTrades: GameTrade[];
|
|
4423
5415
|
listInsiderRadar: SuspiciousTrade[];
|
|
4424
5416
|
listLargePositions: LargePosition[];
|
|
4425
5417
|
listLargeTradeCounterpartyExecutions: CounterpartyAnalysis;
|
|
@@ -4427,6 +5419,7 @@ export interface OperationData {
|
|
|
4427
5419
|
listLargeTradeHistory: LargeTrade[];
|
|
4428
5420
|
listLargeTrades: LargeTrade[];
|
|
4429
5421
|
listLeaderboard: LeaderboardEntry[];
|
|
5422
|
+
listLeaderboardLeagues: LeaderboardLeagues;
|
|
4430
5423
|
listPositions: Position[];
|
|
4431
5424
|
listSharpMoneyFlows: SmartMoneyFlowMarket[];
|
|
4432
5425
|
listSmartMoneyFlows: SmartMoneyFlowMarket[];
|
|
@@ -4448,7 +5441,7 @@ export interface OperationData {
|
|
|
4448
5441
|
searchMarkets: MarketSearchResult[];
|
|
4449
5442
|
submitTraderExport: {
|
|
4450
5443
|
job_id: number;
|
|
4451
|
-
/** queued:
|
|
5444
|
+
/** queued: waiting for a worker. A running job reads queued again, with error saying why, when its worker restarts for a deploy (the next worker claims it within seconds) or stops without handing it back (requeued within a minute of its 30-minute lease lapsing); it starts again from the beginning. running: the worker is streaming rows. reconcile_required: the upload finished but the storage completion answer was lost; the reconciler reads the object back within a minute, retries a failed readback an hour later, and moves the job to ready or failed, and expires_at bounds the wait. ready: downloadable until expires_at. failed: terminal; error says why; submit a new export. expired: the retention window passed; the file is retired, the download route answers 410, submit a new export. cancel_requested: the owner cancelled a running job (POST /api/v1/trader/{address}/export/cancel); the worker stops at its next safe point and the job reads cancelled. cancelled: terminal; the owner cancelled the job and no file was published; submit a new export. A job that has not reached ready by expires_at reads failed with error 'export expired before completion'. failed, cancelled and expired rows stay readable for 48 hours, then the job answers 404. */
|
|
4452
5445
|
status: "queued" | "running" | "ready" | "failed" | "reconcile_required" | "expired" | "cancel_requested" | "cancelled";
|
|
4453
5446
|
format: "json" | "ndjson" | "csv";
|
|
4454
5447
|
/** Trade rows the file holds: trades in the wallet's sports and esports markets, counted in the file's own read snapshot. Null until the worker has read the snapshot (queued, and early in running); a job accepted before 2026-10-22 can carry the earlier all-markets estimate until its file is read. */
|
|
@@ -4479,7 +5472,7 @@ export interface OperationData {
|
|
|
4479
5472
|
cancel_requested_at: string | null;
|
|
4480
5473
|
/** When the job reached cancelled; null until then. */
|
|
4481
5474
|
cancelled_at: string | null;
|
|
4482
|
-
/** Worker claims so far. */
|
|
5475
|
+
/** Worker claims so far. A claim handed back when its worker restarts for a deploy is not counted, so attempt steps back by one when the job reads queued again for that reason. */
|
|
4483
5476
|
attempt: number;
|
|
4484
5477
|
/** The job fails when attempt reaches this. */
|
|
4485
5478
|
max_attempts: number;
|
|
@@ -4499,7 +5492,7 @@ export interface OperationData {
|
|
|
4499
5492
|
};
|
|
4500
5493
|
submitWhaleDataset: {
|
|
4501
5494
|
job_id: number;
|
|
4502
|
-
/** queued:
|
|
5495
|
+
/** queued: waiting for a worker. A running job reads queued again, with error saying why, when its worker restarts for a deploy (the next worker claims it within seconds) or stops without handing it back (requeued within a minute of its 30-minute lease lapsing); it starts again from the beginning. running: the worker is streaming rows. reconcile_required: the upload finished but the storage completion answer was lost; the reconciler reads the object back within a minute, retries a failed readback an hour later, and moves the job to ready or failed, and expires_at bounds the wait. ready: downloadable until expires_at. failed: terminal; error says why; submit a new export. expired: the retention window passed; the file is retired, the download route answers 410, submit a new export. cancel_requested: the owner cancelled a running job (POST /api/v1/trader/{address}/export/cancel); the worker stops at its next safe point and the job reads cancelled. cancelled: terminal; the owner cancelled the job and no file was published; submit a new export. A job that has not reached ready by expires_at reads failed with error 'export expired before completion'. failed, cancelled and expired rows stay readable for 48 hours, then the job answers 404. */
|
|
4503
5496
|
status: "queued" | "running" | "ready" | "failed" | "reconcile_required" | "expired" | "cancel_requested" | "cancelled";
|
|
4504
5497
|
format: "ndjson";
|
|
4505
5498
|
total_trades: number | null;
|
|
@@ -4528,7 +5521,7 @@ export interface OperationData {
|
|
|
4528
5521
|
cancel_requested_at: string | null;
|
|
4529
5522
|
/** When the job reached cancelled; null until then. */
|
|
4530
5523
|
cancelled_at: string | null;
|
|
4531
|
-
/** Worker claims so far. */
|
|
5524
|
+
/** Worker claims so far. A claim handed back when its worker restarts for a deploy is not counted, so attempt steps back by one when the job reads queued again for that reason. */
|
|
4532
5525
|
attempt: number;
|
|
4533
5526
|
/** The job fails when attempt reaches this. */
|
|
4534
5527
|
max_attempts: number;
|
|
@@ -4583,6 +5576,16 @@ export interface OperationQuery {
|
|
|
4583
5576
|
};
|
|
4584
5577
|
getAccountIdentity: Record<string, never>;
|
|
4585
5578
|
getApiDiscovery: Record<string, never>;
|
|
5579
|
+
getCategoryLeaderboard: {
|
|
5580
|
+
/** Keep wallets that traded in the category within this window. all (the default) keeps every ranked wallet. */
|
|
5581
|
+
active_within?: "all" | "7d" | "30d" | "90d";
|
|
5582
|
+
/** Independent events a wallet needs in the category to be listed. The site offers 0, 50, 100 and 250. Clamped to 0..1000000. */
|
|
5583
|
+
min_events?: number;
|
|
5584
|
+
/** Maximum number of leaders to return. Out-of-range values are clamped to 1..100. */
|
|
5585
|
+
limit?: number;
|
|
5586
|
+
/** Opaque cel_ pagination cursor from a prior response. It binds the lower-bound/independent-event/wallet boundary to the committed category-skill ranking and to the slug, active_within and min_events of the request that issued it; a cursor from another filter is 400 on cursor, and one issued before the ranking refreshed is 400 with error.reason=cursor_expired. */
|
|
5587
|
+
cursor?: string;
|
|
5588
|
+
};
|
|
4586
5589
|
getCombo: Record<string, never>;
|
|
4587
5590
|
getCombosSummary: Record<string, never>;
|
|
4588
5591
|
getCoverage: Record<string, never>;
|
|
@@ -4595,9 +5598,9 @@ export interface OperationQuery {
|
|
|
4595
5598
|
view?: "board" | "signals" | "observations";
|
|
4596
5599
|
/** Legacy canonical bucket alias, now accepted in every view. Provider aliases canonicalize: NFL reaches Football and EPL reaches Soccer. Use leagues for a league-specific selection. An unmappable non-sport category returns an empty result and echoes category non_sport. Combines with other selection axes using AND. */
|
|
4597
5600
|
category?: string;
|
|
4598
|
-
/** Required for view=observations; wider_holder, in_play or emerging_pile. Rejected for board and signals. wider_holder covers pregame markets
|
|
5601
|
+
/** Required for view=observations; wider_holder, in_play or emerging_pile. Rejected for board and signals. wider_holder covers pregame markets that view=signals does not list at its widest selection (horizon_hours=48, min_grade=B, no selector), so until kickoff a market is read in one view or the other. A market view=signals lists leaves wider_holder as primary_slate_candidate, and is a wider_holder candidate again in the first refresh after view=signals stops listing it; signals_as_of names the view=signals snapshot each refresh read. Each refresh evaluates at most 8 markets per sport and cohort, wider_holder by soonest kickoff (most graded holders first among equal kickoffs) and in_play by most graded holders, so a market among a sport's 8 soonest stays evaluated until its game starts. wider_holder also evaluates up to 8 more markets per sport that kick off within 24 hours, most graded holders first, so the most-held markets appear up to a day before kickoff. Each of these keeps its place in later refreshes until its game starts while its holder page still shows a card or could not be read, so a more-held market waits for a free place instead of displacing it. Each row's admitted_by names its place, most_held or soonest_kickoff. The rest count in coverage.capacity_limited_markets. Emerging pile is a wider-holder projection with sharp_pct in [0.75,0.85), complete holder scans and future kickoff, not an independent population or arrival history. */
|
|
4599
5602
|
cohort?: "wider_holder" | "in_play" | "emerging_pile";
|
|
4600
|
-
/** Opt-in admission rule for view=observations with cohort=wider_holder; rejected for every other view and cohort. most_held_48h returns the most-held selection instead of the default one: per sport, up to 8 wider_holder markets kicking off within 48 hours, most graded holders first, then most volume, then soonest kickoff, at most 4 per event. It is recomputed every refresh and keeps no place, so a more-held market displaces a less-held one;
|
|
5603
|
+
/** Opt-in admission rule for view=observations with cohort=wider_holder; rejected for every other view and cohort. most_held_48h returns the most-held selection instead of the default one: per sport, up to 8 wider_holder markets kicking off within 48 hours, most graded holders first, then most volume, then soonest kickoff, at most 4 per event. It is recomputed every refresh and keeps no place, so a more-held market displaces a less-held one; markets view=signals lists stay excluded. Every row carries admitted_by most_held_48h, including a market the default selection also evaluates, and the response echoes admission. funnel, coverage, degraded and degradation_reasons describe this selection: a wider_holder candidate it did not take counts as capacity_limited. Its markets that no default place covers are read after every default market, at most once per 10 minutes, so a row can rest on a holder page up to 15 minutes old (holder_snapshot_at). Omit for the default selection. Cursors and ETags bind it. */
|
|
4601
5604
|
admission?: "most_held_48h";
|
|
4602
5605
|
/** Board and signals: S, A or B, default B. Requires a piled-side holder at the selected grade floor or better, without removing other holders. Rejected for observations. */
|
|
4603
5606
|
min_grade?: "S" | "A" | "B";
|
|
@@ -4641,6 +5644,13 @@ export interface OperationQuery {
|
|
|
4641
5644
|
expand?: "trade"[];
|
|
4642
5645
|
};
|
|
4643
5646
|
getGame: Record<string, never>;
|
|
5647
|
+
getGameHolders: {
|
|
5648
|
+
/** 1 to 25 condition_id values of this game's markets, comma-separated. The key may also repeat (condition_ids=a&condition_ids=b). A raw provider condition_id or the mkt_-prefixed market id. */
|
|
5649
|
+
condition_ids: string[];
|
|
5650
|
+
/** Holders per market. Out-of-range values are clamped to 1..100. */
|
|
5651
|
+
limit?: number;
|
|
5652
|
+
};
|
|
5653
|
+
getGameSharpMoney: Record<string, never>;
|
|
4644
5654
|
getHealth: Record<string, never>;
|
|
4645
5655
|
getInsiderRadarFlag: Record<string, never>;
|
|
4646
5656
|
getLargeTrade: Record<string, never>;
|
|
@@ -4677,14 +5687,26 @@ export interface OperationQuery {
|
|
|
4677
5687
|
/** Include trust metadata for current_price and spread_bps. Repeatable: trust. */
|
|
4678
5688
|
expand?: "trust"[];
|
|
4679
5689
|
};
|
|
5690
|
+
getMarketTopHolders: {
|
|
5691
|
+
/** Maximum holders per outcome. Out-of-range values are clamped to 1..100. `totals` covers the whole sample whatever the limit. */
|
|
5692
|
+
limit?: number;
|
|
5693
|
+
};
|
|
5694
|
+
getMarketWalletsInOut: {
|
|
5695
|
+
/** The window the nets are summed over, ending at the read's clock: 24h (the default) or 7d. */
|
|
5696
|
+
window?: "24h" | "7d";
|
|
5697
|
+
};
|
|
4680
5698
|
getMonthlyReportSnapshot: {
|
|
4681
5699
|
/** UTC report month in YYYY-MM format. A month that ends before 2024-03-01, the first day report data covers, or starts after tomorrow UTC returns 400 bad_request with error.param=month. */
|
|
4682
5700
|
month: string;
|
|
4683
5701
|
};
|
|
4684
|
-
getPickOfTheDay:
|
|
5702
|
+
getPickOfTheDay: {
|
|
5703
|
+
/** A product day (America/New_York) in YYYY-MM-DD format, on or before today. Omit it, or send today, for the current read. A past day with no published pick returns 404 not_found with error.param=date; a date after today, or a value that is not a date, returns 400 bad_request with error.param=date. */
|
|
5704
|
+
date?: string;
|
|
5705
|
+
};
|
|
4685
5706
|
getPickOfTheDayArchive: Record<string, never>;
|
|
4686
5707
|
getPickOfTheDayLedger: Record<string, never>;
|
|
4687
5708
|
getPickOfTheDayLedgerEntry: Record<string, never>;
|
|
5709
|
+
getPickOfTheDayStats: Record<string, never>;
|
|
4688
5710
|
getPlatforms: Record<string, never>;
|
|
4689
5711
|
getPositionTimeline: {
|
|
4690
5712
|
/** Market condition_id. One timeline per (trader, market). */
|
|
@@ -4708,6 +5730,20 @@ export interface OperationQuery {
|
|
|
4708
5730
|
/** Period token for the granularity. daily: UTC date YYYY-MM-DD. weekly: ISO week YYYY-WW for a durable canonical snapshot, or a from,to YYYY-MM-DD pair for an exact ephemeral range limited to 31 inclusive UTC days. A wider explicit range returns 400 invalid_query. monthly: UTC month YYYY-MM. A period that ends before 2024-03-01, the first day report data covers, or starts after tomorrow UTC returns 400 bad_request with error.param=period. */
|
|
4709
5731
|
period: string;
|
|
4710
5732
|
};
|
|
5733
|
+
getResolutionReport: {
|
|
5734
|
+
/** UTC report date in YYYY-MM-DD format, no later than today UTC. Any other value returns 400 bad_request with error.param=date. */
|
|
5735
|
+
date: string;
|
|
5736
|
+
/** `totals` returns the counts without `markets`. Any other value than full or totals returns 400 bad_request with error.param=view. */
|
|
5737
|
+
view?: "full" | "totals";
|
|
5738
|
+
};
|
|
5739
|
+
getSportLeaderboard: {
|
|
5740
|
+
/** A league slug of the sport, for example premier-league or cs2, from GET /api/v1/leaderboard/leagues. Omit it for the sport board. */
|
|
5741
|
+
league?: string;
|
|
5742
|
+
/** Ranking axis. Any other value returns 400 bad_request with error.param=sort. */
|
|
5743
|
+
sort?: "edge" | "pnl" | "win_rate";
|
|
5744
|
+
/** Rows to return from the top of the board. Out-of-range values are clamped to 1..100. */
|
|
5745
|
+
limit?: number;
|
|
5746
|
+
};
|
|
4711
5747
|
getStream: {
|
|
4712
5748
|
/** Query-string fallback for the Last-Event-ID resume cursor when the client cannot set the request header. Numeric cluster-shared sequence id; non-numeric or absent attaches live with no replay. A future or expired id emits resync. */
|
|
4713
5749
|
last_event_id?: string;
|
|
@@ -4726,9 +5762,9 @@ export interface OperationQuery {
|
|
|
4726
5762
|
};
|
|
4727
5763
|
getSuspiciousTrade: Record<string, never>;
|
|
4728
5764
|
getTrader: {
|
|
4729
|
-
/** Backward-compatible alias for expand. Repeatable: strategy, categories, quant_metrics
|
|
5765
|
+
/** Backward-compatible alias for expand. Repeatable: strategy, categories, trust. quant_metrics is accepted and returns nothing since 2026-10-27. */
|
|
4730
5766
|
"expand[]"?: ("strategy" | "categories" | "quant_metrics" | "trust")[];
|
|
4731
|
-
/** Include heavy fields and trust metadata. Repeatable: strategy, categories, quant_metrics
|
|
5767
|
+
/** Include heavy fields and trust metadata. Repeatable: strategy, categories, trust. quant_metrics is accepted and returns nothing since 2026-10-27. */
|
|
4732
5768
|
expand?: ("strategy" | "categories" | "quant_metrics" | "trust")[];
|
|
4733
5769
|
/** Opt into a whole-response freshness ceiling in seconds. The server returns 200 only when data_quality.status is fresh and data_quality.as_of is no older than this value; otherwise it returns 409 with error.reason=freshness_ceiling_unsatisfied. No refresh or alternate read is attempted. */
|
|
4734
5770
|
max_age_s?: number;
|
|
@@ -4771,6 +5807,7 @@ export interface OperationQuery {
|
|
|
4771
5807
|
};
|
|
4772
5808
|
getWhaleDatasetStatus: Record<string, never>;
|
|
4773
5809
|
getWhaleTrade: Record<string, never>;
|
|
5810
|
+
listCategoryLeaders: Record<string, never>;
|
|
4774
5811
|
listComboFills: {
|
|
4775
5812
|
/** CSV of pending, won, or lost; all clears the filter. Unknown results appear only in unfiltered lists. */
|
|
4776
5813
|
result?: string;
|
|
@@ -4795,21 +5832,45 @@ export interface OperationQuery {
|
|
|
4795
5832
|
/** Offset for ranked largest or payout ordering; use returned next_offset. */
|
|
4796
5833
|
offset?: number;
|
|
4797
5834
|
};
|
|
5835
|
+
listGameMarkets: {
|
|
5836
|
+
/** Comma-separated provider market types to keep, case-insensitive: spreads, totals, points, first_half_totals. Omitted keeps every type. An unknown type returns an empty page, not a 400; families lists the event's types. */
|
|
5837
|
+
sports_market_type?: string;
|
|
5838
|
+
/** active, closed or all. closed means the provider closed the market or it resolved. */
|
|
5839
|
+
status?: "active" | "closed" | "all";
|
|
5840
|
+
/** Page size. Out-of-range values are clamped to 1..100. */
|
|
5841
|
+
limit?: number;
|
|
5842
|
+
/** Opaque gmk_v1_ cursor from next_cursor, sent with the same filters. It pins the page position (sports_market_type, line, condition_id), not a snapshot. A cursor this endpoint did not issue returns 400 with error.param=cursor. */
|
|
5843
|
+
cursor?: string;
|
|
5844
|
+
/** sharp_money adds each row's sharp_money: the game page's per-line split, side USD and S, A and B wallet counts per outcome. One read for the event whatever the page size; the request costs 5 instead of 2. Pro and Max. Repeatable: sharp_money. */
|
|
5845
|
+
expand?: "sharp_money"[];
|
|
5846
|
+
/** Backward-compatible alias for expand. Repeatable: sharp_money. */
|
|
5847
|
+
"expand[]"?: "sharp_money"[];
|
|
5848
|
+
};
|
|
4798
5849
|
listGames: {
|
|
4799
5850
|
/** Canonical sport bucket, case-insensitive, with - and _ read as a space: table-tennis and Table Tennis are the same bucket. Omit for every covered sport. A bucket this deployment does not serve returns an empty page. */
|
|
4800
5851
|
sport?: string;
|
|
4801
|
-
/** League tag, case-insensitive, as coverage.leagues spells it: nfl, epl, cs2, euroleague. EuroLeague games use sport=Basketball and league=euroleague. Omit for every league inside the selected sports. */
|
|
5852
|
+
/** League tag, case-insensitive, as coverage.leagues spells it: nfl, epl, cs2, euroleague, cbb, cwbb. EuroLeague games use sport=Basketball and league=euroleague; NCAA men's and women's college basketball games use sport=Basketball with league=cbb and league=cwbb. Omit for every league inside the selected sports. */
|
|
4802
5853
|
league?: string;
|
|
4803
|
-
/** Keep only games in this state. A value outside the enum returns an empty page. */
|
|
5854
|
+
/** Keep only games in this state. ended, cancelled and postponed also list finished games that have left the live board, read from their stored records, for kickoffs within starts_after..starts_before (default: the 7 days before now). Without status, or with any other state, the list is the live and upcoming board. A value outside the enum returns an empty page. */
|
|
4804
5855
|
status?: "scheduled" | "live" | "paused" | "ended" | "postponed" | "cancelled" | "suspended" | "delayed" | "unknown";
|
|
4805
|
-
/** RFC 3339 instant. Keep only games whose kickoff is at or after it. Games with no published kickoff are excluded whenever either bound is set. */
|
|
5856
|
+
/** RFC 3339 instant. Keep only games whose kickoff is at or after it. Games with no published kickoff are excluded whenever either bound is set. With a finished status, the stored games' look-back starts here; omitted, it starts 7 days before starts_before, and nothing caps an earlier value. */
|
|
4806
5857
|
starts_after?: string;
|
|
4807
5858
|
/** RFC 3339 instant. Keep only games whose kickoff is at or before it. Must be at or after starts_after. */
|
|
4808
5859
|
starts_before?: string;
|
|
5860
|
+
/** Which games to read. all, the default, lists the whole covered catalog, which can start with games the provider still holds open weeks after kickoff. now lists what is on now: every game the provider reports in play (live or paused), plus any other game whose kickoff was at most 3 hours ago or is still to come; ended, postponed and cancelled games are left out, and a game with no published kickoff stays and sorts last. Combines with every other filter. A value other than all or now returns 400 invalid_query with error.param=window. */
|
|
5861
|
+
window?: "all" | "now";
|
|
4809
5862
|
/** Page size. Out-of-range values are clamped to 1..100. */
|
|
4810
5863
|
limit?: number;
|
|
4811
|
-
/** Opaque gms_v1_ cursor from next_cursor. It pins the page position (kickoff and event_slug), not a snapshot: the catalog is live, so a game added or removed between pages moves with it. A cursor this endpoint did not issue returns 400 with error.param=cursor. */
|
|
5864
|
+
/** Opaque gms_v1_ cursor from next_cursor. It pins the page position (kickoff and event_slug), not a snapshot: the catalog is live, so a game added or removed between pages moves with it. With a finished status, a page that spent its read budget carries a cursor past everything it read, which may be past the last game it returned. A cursor this endpoint did not issue returns 400 with error.param=cursor. */
|
|
4812
5865
|
cursor?: string;
|
|
5866
|
+
/** Backward-compatible alias for expand. Repeatable: sharp_money. */
|
|
5867
|
+
"expand[]"?: "sharp_money"[];
|
|
5868
|
+
/** sharp_money adds each game's sharp_money, the GameSharpMoney object GET /api/v1/games/{event_slug}/sharp-money returns, read from the sport board's cached aggregate: one board read per sport on the page, never a per-game compute. A game the board did not evaluate carries status not_computed (read the per-game route for it); a sport whose aggregate could not be read carries status unavailable while the rest of the page is served. Adds 3 to the request cost. Repeatable. */
|
|
5869
|
+
expand?: "sharp_money"[];
|
|
5870
|
+
};
|
|
5871
|
+
listGameTrades: {
|
|
5872
|
+
/** Newest fills to return. Out-of-range values are clamped to 1..200. */
|
|
5873
|
+
limit?: number;
|
|
4813
5874
|
};
|
|
4814
5875
|
listInsiderRadar: {
|
|
4815
5876
|
/** Maximum number of radar flags to return. Out-of-range values are clamped to 1..100. */
|
|
@@ -4832,7 +5893,7 @@ export interface OperationQuery {
|
|
|
4832
5893
|
min_size?: number;
|
|
4833
5894
|
/** One RFC 4180 CSV record of exact current provider-backed market_canonical.category values. Legacy unquoted lists such as NBA,WNBA remain valid; values containing commas, quotes, or newlines are CSV-quoted. Matching is case-insensitive. Malformed quoted input fails closed as one unknown exact category. A value outside sports and esports returns 400 bad_request with param=category (#27305), as on GET /api/v1/markets/explore. */
|
|
4834
5895
|
category?: string;
|
|
4835
|
-
/** Minimum trader grade. */
|
|
5896
|
+
/** Minimum trader grade. Matched against the trader.grade each row returns, the wallet's current grade, so every row listed shows a grade at or above this floor. */
|
|
4836
5897
|
min_grade?: "S" | "A" | "B" | "C" | "D" | "F";
|
|
4837
5898
|
/** Scope to one market. Accepts the raw provider condition_id or the mkt_-prefixed market id (round-trips a value from a list response). Must be 0x followed by 64 hexadecimal characters after any mkt_ prefix is stripped; any other value returns 400. Polymarket-only; an unknown but well-formed id returns []. A market outside sports and esports returns 404 not_found with error.reason=market_out_of_scope (#27305). */
|
|
4838
5899
|
condition_id?: string;
|
|
@@ -4880,6 +5941,8 @@ export interface OperationQuery {
|
|
|
4880
5941
|
min_market_volume_share?: number;
|
|
4881
5942
|
/** Order of the returned page. recent is newest first and is the default. market_volume_share ranks by each trade's share of its market's traded volume, biggest first, with a trade whose share is unavailable last. That ranking reads from, or the last 30 days when from is omitted, for the same reason. A cursor is bound to the order it was minted in, so a continuation cannot cross from one order into the other. */
|
|
4882
5943
|
sort?: "recent" | "market_volume_share";
|
|
5944
|
+
/** Only the large trades in one game: every market of the game behind this event slug, the moneyline, spreads, totals and props, as GET /api/v1/games/{event_slug}/trades reads them. Matched case-insensitively. Newest first only (sort=market_volume_share answers 400), and cannot be combined with condition_id (400). An unknown slug answers 404 not_found with error.param event_slug. */
|
|
5945
|
+
event_slug?: string;
|
|
4883
5946
|
};
|
|
4884
5947
|
listLargeTrades: {
|
|
4885
5948
|
/** Maximum number of recent large trades to return. Out-of-range values are clamped to 1..100. */
|
|
@@ -4900,17 +5963,28 @@ export interface OperationQuery {
|
|
|
4900
5963
|
sort?: "recent" | "market_volume_share";
|
|
4901
5964
|
/** Return only the trades recorded after this one. Pass the id of a large trade this API returned (wt_<n>, or the bare integer). The answer keeps the list shape and newest-first order, and next_cursor pages within it. After means commit order: a trade recorded late with an earlier traded_at is still returned, and a trade whose write has not committed yet is returned on a later poll, never skipped. To poll, send the id of the first trade on the first page of your last answer that had trades, with If-None-Match set to the ETag you last received; when nothing new was recorded the answer is 304 with an empty body. A late trade can come back once, so deduplicate on id. Only with sort=recent. An id that names no trade, or one more than 10000 trades behind the newest, answers 400 with error.param since; request the list without since and continue from its first trade. */
|
|
4902
5965
|
since?: string;
|
|
5966
|
+
/** Only this market's large trades: an exact raw provider condition_id. The page is read from the market's own index, newest first, and pages with cursor; it cannot be combined with since or with event_slug (400). An unknown market returns an empty list. */
|
|
5967
|
+
condition_id?: string;
|
|
5968
|
+
/** Only the large trades in one game: every market of the game behind this event slug, the moneyline, spreads, totals and props, as GET /api/v1/games/{event_slug}/trades reads them. Matched case-insensitively. Newest first only (sort=market_volume_share answers 400), pages with cursor, and cannot be combined with since or with condition_id (400). An unknown slug answers 404 not_found with error.param event_slug. */
|
|
5969
|
+
event_slug?: string;
|
|
4903
5970
|
};
|
|
4904
5971
|
listLeaderboard: {
|
|
4905
5972
|
/** Maximum number of ranked traders to return. Out-of-range values are clamped to 1..100. */
|
|
4906
5973
|
limit?: number;
|
|
4907
|
-
/** Opaque lbv1_ pagination cursor from a prior response. It binds the finite score/address boundary to the committed leaderboard generation and the effective category/strategy filters;
|
|
5974
|
+
/** Opaque lbv1_ pagination cursor from a prior response. It binds the finite score/address boundary to the committed leaderboard generation and the effective category/strategy filters, and on a sorted page to its sort, dir and activity. A cursor from another sort or dir is a 400 bad_request on cursor; one from another activity, category, strategy or generation is cursor_expired. Legacy, malformed, non-finite, and unsupported-version cursors are rejected. */
|
|
4908
5975
|
cursor?: string;
|
|
4909
5976
|
/** Filter by category: a sport or esports bucket. Values are matched to canonical category buckets: league values fold into their sport (NBA and NCAAB into Basketball, NFL into Football). Mapped buckets are case-insensitive; passthrough buckets (Cricket, Sports) match case-sensitively against the provider-native bucket key, so use exact casing. Sports and esports only (#27306): a category outside them returns 400 bad_request with param category and names the accepted buckets. */
|
|
4910
5977
|
category?: string;
|
|
4911
|
-
/** Filter by observed trading style. Current styles: two_sided, category_focused, high_activity, diversified, mixed, unclassified. Current styles count the wallet's sports and esports markets only. The
|
|
4912
|
-
strategy?: "
|
|
4913
|
-
|
|
5978
|
+
/** Filter by observed trading style. Current styles: two_sided, category_focused, high_activity, diversified, mixed, unclassified. Current styles count the wallet's sports and esports markets only. The ten archetype keys retired on 2026-10-01 (accumulator, algo_trader, arbitrageur, directional, event_driven, market_maker, momentum, scalper, speculator, swing_trader) are still accepted and match no wallet. Style describes recorded behavior; grade measures performance. */
|
|
5979
|
+
strategy?: "category_focused" | "diversified" | "high_activity" | "mixed" | "two_sided" | "unclassified";
|
|
5980
|
+
/** Order of the list, the sort columns of the site's leaderboard (/skill-leaderboard). rank (default) is the board's own order, the rank the site and the trader profile show. grade orders by score. volume orders by sports and esports USD volume, the figure GET /api/v1/trader/{address} serves as stats.total_volume. predictions orders by markets_traded. pnl orders by in_scope.realized_pnl. win_rate orders by win_rate among wallets with at least 5 decided sports and esports markets; a wallet with fewer sorts as having none. edge orders by price_edge.edge among wallets whose price_edge.status is ranked and that carry no price_edge.hold; any other wallet sorts as having none. The site's Edge column ranks those same wallets by their edge pulled toward the sports and esports average, a figure the API does not send, so the two orders can differ. A wallet without the value sorts as the lowest, so last in the natural direction and first with the direction reversed. Ties fall to address ascending. With ?category= a sort still orders by these whole-record figures; the category only decides which wallets are listed. Since 2026-11-02 (#32237; edge, #32270). */
|
|
5981
|
+
sort?: "rank" | "grade" | "volume" | "predictions" | "pnl" | "win_rate" | "edge";
|
|
5982
|
+
/** Direction of sort. Omitted, each sort reads in its natural direction: rank 1 first for rank (asc), largest first for every other sort (desc). The opposite value reverses the list. Since 2026-11-02 (#32237). */
|
|
5983
|
+
dir?: "asc" | "desc";
|
|
5984
|
+
/** Limit the list to wallets by recent trading, the site leaderboard's split. active: the wallet's last trade, as its current grade recorded it and aged to today, is 30 days old or less. inactive: older than 30 days, or no trade on record. all (default): every ranked wallet. Since 2026-11-02 (#32237). */
|
|
5985
|
+
activity?: "all" | "active" | "inactive";
|
|
5986
|
+
};
|
|
5987
|
+
listLeaderboardLeagues: Record<string, never>;
|
|
4914
5988
|
listPositions: {
|
|
4915
5989
|
/** Maximum number of current positions to return. Out-of-range values are clamped to 1..100. */
|
|
4916
5990
|
limit?: number;
|
|
@@ -4948,6 +6022,10 @@ export interface OperationQuery {
|
|
|
4948
6022
|
min_grade?: "S" | "A" | "B" | "C" | "D" | "F";
|
|
4949
6023
|
/** Optional post-aggregate flow direction filter. */
|
|
4950
6024
|
direction?: "YES" | "NO";
|
|
6025
|
+
/** Only this market's flow: an exact raw provider condition_id. Cannot be combined with event_slug (400). An unknown market returns an empty list. */
|
|
6026
|
+
condition_id?: string;
|
|
6027
|
+
/** Only the markets of one game: every market of the game behind this event slug, the moneyline, spreads, totals and props, as GET /api/v1/games/{event_slug}/trades reads them, ranked as the unfiltered list ranks. Matched case-insensitively; cannot be combined with condition_id (400). An unknown slug answers 404 not_found with error.param event_slug. */
|
|
6028
|
+
event_slug?: string;
|
|
4951
6029
|
};
|
|
4952
6030
|
listSmartMoneyFlows: {
|
|
4953
6031
|
/** Lookback window for grade-filtered whale flow aggregation. */
|
|
@@ -4964,6 +6042,10 @@ export interface OperationQuery {
|
|
|
4964
6042
|
min_grade?: "S" | "A" | "B" | "C" | "D" | "F";
|
|
4965
6043
|
/** Optional post-aggregate flow direction filter. */
|
|
4966
6044
|
direction?: "YES" | "NO";
|
|
6045
|
+
/** Only this market's flow: an exact raw provider condition_id. Cannot be combined with event_slug (400). An unknown market returns an empty list. */
|
|
6046
|
+
condition_id?: string;
|
|
6047
|
+
/** Only the markets of one game: every market of the game behind this event slug, the moneyline, spreads, totals and props, as GET /api/v1/games/{event_slug}/trades reads them, ranked as the unfiltered list ranks. Matched case-insensitively; cannot be combined with condition_id (400). An unknown slug answers 404 not_found with error.param event_slug. */
|
|
6048
|
+
event_slug?: string;
|
|
4967
6049
|
};
|
|
4968
6050
|
listSuspiciousTrades: {
|
|
4969
6051
|
/** Maximum number of suspicious trades to return. Out-of-range values are clamped to 1..100. */
|
|
@@ -5036,6 +6118,8 @@ export interface OperationQuery {
|
|
|
5036
6118
|
min_market_volume_share?: number;
|
|
5037
6119
|
/** Order of the returned page. recent is newest first and is the default. market_volume_share ranks by each trade's share of its market's traded volume, biggest first, with a trade whose share is unavailable last. That ranking reads from, or the last 30 days when from is omitted, for the same reason. A cursor is bound to the order it was minted in, so a continuation cannot cross from one order into the other. */
|
|
5038
6120
|
sort?: "recent" | "market_volume_share";
|
|
6121
|
+
/** Only the large trades in one game: every market of the game behind this event slug, the moneyline, spreads, totals and props, as GET /api/v1/games/{event_slug}/trades reads them. Matched case-insensitively. Newest first only (sort=market_volume_share answers 400), and cannot be combined with condition_id (400). An unknown slug answers 404 not_found with error.param event_slug. */
|
|
6122
|
+
event_slug?: string;
|
|
5039
6123
|
};
|
|
5040
6124
|
listWhaleTrades: {
|
|
5041
6125
|
/** Maximum number of recent large trades to return. Out-of-range values are clamped to 1..100. */
|
|
@@ -5056,6 +6140,10 @@ export interface OperationQuery {
|
|
|
5056
6140
|
sort?: "recent" | "market_volume_share";
|
|
5057
6141
|
/** Return only the trades recorded after this one. Pass the id of a large trade this API returned (wt_<n>, or the bare integer). The answer keeps the list shape and newest-first order, and next_cursor pages within it. After means commit order: a trade recorded late with an earlier traded_at is still returned, and a trade whose write has not committed yet is returned on a later poll, never skipped. To poll, send the id of the first trade on the first page of your last answer that had trades, with If-None-Match set to the ETag you last received; when nothing new was recorded the answer is 304 with an empty body. A late trade can come back once, so deduplicate on id. Only with sort=recent. An id that names no trade, or one more than 10000 trades behind the newest, answers 400 with error.param since; request the list without since and continue from its first trade. */
|
|
5058
6142
|
since?: string;
|
|
6143
|
+
/** Only this market's large trades: an exact raw provider condition_id. The page is read from the market's own index, newest first, and pages with cursor; it cannot be combined with since or with event_slug (400). An unknown market returns an empty list. */
|
|
6144
|
+
condition_id?: string;
|
|
6145
|
+
/** Only the large trades in one game: every market of the game behind this event slug, the moneyline, spreads, totals and props, as GET /api/v1/games/{event_slug}/trades reads them. Matched case-insensitively. Newest first only (sort=market_volume_share answers 400), pages with cursor, and cannot be combined with since or with condition_id (400). An unknown slug answers 404 not_found with error.param event_slug. */
|
|
6146
|
+
event_slug?: string;
|
|
5059
6147
|
};
|
|
5060
6148
|
prepareWebhookSecret: Record<string, never>;
|
|
5061
6149
|
redeliverWebhookDelivery: Record<string, never>;
|
|
@@ -5069,7 +6157,7 @@ export interface OperationQuery {
|
|
|
5069
6157
|
limit?: number;
|
|
5070
6158
|
};
|
|
5071
6159
|
searchMarkets: {
|
|
5072
|
-
/** Search query. Must be
|
|
6160
|
+
/** Search query. Must be 2-512 characters before whitespace trimming and hold at least 2 letters or digits after trimming; a query with fewer letters or digits (a, 7, ?) returns 400 bad_request with param q (#32309). */
|
|
5073
6161
|
q: string;
|
|
5074
6162
|
/** Maximum number of matching markets to return. Out-of-range values are clamped to 1..100. */
|
|
5075
6163
|
limit?: number;
|
|
@@ -5120,6 +6208,10 @@ export interface OperationPath {
|
|
|
5120
6208
|
exploreMarkets: Record<string, never>;
|
|
5121
6209
|
getAccountIdentity: Record<string, never>;
|
|
5122
6210
|
getApiDiscovery: Record<string, never>;
|
|
6211
|
+
getCategoryLeaderboard: {
|
|
6212
|
+
/** The category slug, for example soccer, basketball, tennis or esports, as GET /api/v1/leaderboard/categories lists it lowercased. Matched case-insensitively. */
|
|
6213
|
+
slug: string;
|
|
6214
|
+
};
|
|
5123
6215
|
getCombo: {
|
|
5124
6216
|
/** Combo identifier: 0x followed by 62 lowercase hex characters. This differs from a binary market condition ID. */
|
|
5125
6217
|
condition_id: string;
|
|
@@ -5133,6 +6225,14 @@ export interface OperationPath {
|
|
|
5133
6225
|
/** The game's event slug, for example nfl-buf-nyj-2026-09-22. Matched case-insensitively. */
|
|
5134
6226
|
event_slug: string;
|
|
5135
6227
|
};
|
|
6228
|
+
getGameHolders: {
|
|
6229
|
+
/** The game's event slug from GET /api/v1/games, for example nba-bos-orl-2026-11-01. Matched case-insensitively. */
|
|
6230
|
+
event_slug: string;
|
|
6231
|
+
};
|
|
6232
|
+
getGameSharpMoney: {
|
|
6233
|
+
/** The game's event slug, for example nba-bos-orl-2026-11-01. Matched case-insensitively; the response carries the canonical slug. */
|
|
6234
|
+
event_slug: string;
|
|
6235
|
+
};
|
|
5136
6236
|
getHealth: Record<string, never>;
|
|
5137
6237
|
getInsiderRadarFlag: {
|
|
5138
6238
|
/** Raw whale_alerts.id or rf_-prefixed radar flag id. */
|
|
@@ -5166,6 +6266,14 @@ export interface OperationPath {
|
|
|
5166
6266
|
/** Market condition ID. Accepts the raw provider-backed condition_id returned by /api/v1/markets/search or /api/v1/markets/explore, or the mkt_-prefixed market.id emitted by V1 responses. */
|
|
5167
6267
|
condition_id: string;
|
|
5168
6268
|
};
|
|
6269
|
+
getMarketTopHolders: {
|
|
6270
|
+
/** Market condition ID. Accepts the raw provider-backed condition_id returned by /api/v1/markets/search or the mkt_-prefixed market.id emitted by V1 responses. */
|
|
6271
|
+
condition_id: string;
|
|
6272
|
+
};
|
|
6273
|
+
getMarketWalletsInOut: {
|
|
6274
|
+
/** Market condition ID. Accepts the raw provider-backed condition_id returned by /api/v1/markets/search or /api/v1/markets/explore, or the mkt_-prefixed market.id emitted by V1 responses. */
|
|
6275
|
+
condition_id: string;
|
|
6276
|
+
};
|
|
5169
6277
|
getMonthlyReportSnapshot: Record<string, never>;
|
|
5170
6278
|
getPickOfTheDay: Record<string, never>;
|
|
5171
6279
|
getPickOfTheDayArchive: Record<string, never>;
|
|
@@ -5174,6 +6282,7 @@ export interface OperationPath {
|
|
|
5174
6282
|
/** Stable positive pick row id as canonical decimal text. */
|
|
5175
6283
|
pick_id: string;
|
|
5176
6284
|
};
|
|
6285
|
+
getPickOfTheDayStats: Record<string, never>;
|
|
5177
6286
|
getPlatforms: Record<string, never>;
|
|
5178
6287
|
getPositionTimeline: {
|
|
5179
6288
|
/** Trader identity: 0x... wallet address, username, trd_-prefixed trader id, bare integer traders.id, or @username. Resolved with precedence @username -> wallet -> trd_ -> integer -> username (a leading @ forces a username lookup, for all-digit usernames); wallet matching is case-insensitive. */
|
|
@@ -5184,6 +6293,11 @@ export interface OperationPath {
|
|
|
5184
6293
|
trader: string;
|
|
5185
6294
|
};
|
|
5186
6295
|
getReports: Record<string, never>;
|
|
6296
|
+
getResolutionReport: Record<string, never>;
|
|
6297
|
+
getSportLeaderboard: {
|
|
6298
|
+
/** The sport slug, for example soccer, basketball, football or esports. Matched case-insensitively. A league or title alias such as nba, epl or cs2 reads its sport's board, and the body's sport is that board's slug; pass league for one league's board. */
|
|
6299
|
+
sport: string;
|
|
6300
|
+
};
|
|
5187
6301
|
getStream: Record<string, never>;
|
|
5188
6302
|
getSuspiciousTrade: {
|
|
5189
6303
|
/** Raw whale_alerts.id or rf_-prefixed suspicious trade id. */
|
|
@@ -5241,8 +6355,17 @@ export interface OperationPath {
|
|
|
5241
6355
|
/** Raw whale_alerts.id or wt_-prefixed whale trade id. */
|
|
5242
6356
|
id: string;
|
|
5243
6357
|
};
|
|
6358
|
+
listCategoryLeaders: Record<string, never>;
|
|
5244
6359
|
listComboFills: Record<string, never>;
|
|
6360
|
+
listGameMarkets: {
|
|
6361
|
+
/** The event slug from GET /api/v1/games, GET /api/v1/games/{event_slug} or a markets/search result's event_slug, for example nba-bos-orl-2026-11-01. Matched case-insensitively. */
|
|
6362
|
+
event_slug: string;
|
|
6363
|
+
};
|
|
5245
6364
|
listGames: Record<string, never>;
|
|
6365
|
+
listGameTrades: {
|
|
6366
|
+
/** The game's event slug, for example nfl-buf-nyj-2026-09-22. Matched case-insensitively. */
|
|
6367
|
+
event_slug: string;
|
|
6368
|
+
};
|
|
5246
6369
|
listInsiderRadar: Record<string, never>;
|
|
5247
6370
|
listLargePositions: Record<string, never>;
|
|
5248
6371
|
listLargeTradeCounterpartyExecutions: {
|
|
@@ -5258,6 +6381,7 @@ export interface OperationPath {
|
|
|
5258
6381
|
listLargeTradeHistory: Record<string, never>;
|
|
5259
6382
|
listLargeTrades: Record<string, never>;
|
|
5260
6383
|
listLeaderboard: Record<string, never>;
|
|
6384
|
+
listLeaderboardLeagues: Record<string, never>;
|
|
5261
6385
|
listPositions: Record<string, never>;
|
|
5262
6386
|
listSharpMoneyFlows: Record<string, never>;
|
|
5263
6387
|
listSmartMoneyFlows: Record<string, never>;
|
|
@@ -5342,10 +6466,10 @@ export interface OperationBody {
|
|
|
5342
6466
|
createMcpJsonRpcResponse: {
|
|
5343
6467
|
/** JSON-RPC protocol version; this server accepts 2.0. */
|
|
5344
6468
|
jsonrpc: "2.0";
|
|
5345
|
-
/** Request identifier echoed exactly in one JSON-RPC response;
|
|
5346
|
-
id?: string | number
|
|
6469
|
+
/** Request identifier, a string or a number, echoed exactly in one JSON-RPC response; a notification omits it and receives an empty HTTP 202. A null id answers HTTP 400 with JSON-RPC error -32600. */
|
|
6470
|
+
id?: string | number;
|
|
5347
6471
|
/** MCP method to invoke. */
|
|
5348
|
-
method: "initialize" | "notifications/initialized" | "notifications/cancelled" | "ping" | "tools/list" | "tools/call";
|
|
6472
|
+
method: "initialize" | "notifications/initialized" | "notifications/cancelled" | "ping" | "tools/list" | "tools/call" | "server/discover";
|
|
5349
6473
|
/** Method-specific MCP parameters. */
|
|
5350
6474
|
params?: Record<string, unknown>;
|
|
5351
6475
|
};
|
|
@@ -5355,6 +6479,7 @@ export interface OperationBody {
|
|
|
5355
6479
|
exploreMarkets: never;
|
|
5356
6480
|
getAccountIdentity: never;
|
|
5357
6481
|
getApiDiscovery: never;
|
|
6482
|
+
getCategoryLeaderboard: never;
|
|
5358
6483
|
getCombo: never;
|
|
5359
6484
|
getCombosSummary: never;
|
|
5360
6485
|
getCoverage: never;
|
|
@@ -5362,6 +6487,8 @@ export interface OperationBody {
|
|
|
5362
6487
|
getEdgeHunter: never;
|
|
5363
6488
|
getEventReplaySince: never;
|
|
5364
6489
|
getGame: never;
|
|
6490
|
+
getGameHolders: never;
|
|
6491
|
+
getGameSharpMoney: never;
|
|
5365
6492
|
getHealth: never;
|
|
5366
6493
|
getInsiderRadarFlag: never;
|
|
5367
6494
|
getLargeTrade: never;
|
|
@@ -5371,15 +6498,20 @@ export interface OperationBody {
|
|
|
5371
6498
|
getMarketHolders: never;
|
|
5372
6499
|
getMarketIntel: never;
|
|
5373
6500
|
getMarketSnapshot: never;
|
|
6501
|
+
getMarketTopHolders: never;
|
|
6502
|
+
getMarketWalletsInOut: never;
|
|
5374
6503
|
getMonthlyReportSnapshot: never;
|
|
5375
6504
|
getPickOfTheDay: never;
|
|
5376
6505
|
getPickOfTheDayArchive: never;
|
|
5377
6506
|
getPickOfTheDayLedger: never;
|
|
5378
6507
|
getPickOfTheDayLedgerEntry: never;
|
|
6508
|
+
getPickOfTheDayStats: never;
|
|
5379
6509
|
getPlatforms: never;
|
|
5380
6510
|
getPositionTimeline: never;
|
|
5381
6511
|
getPositionTimelineById: never;
|
|
5382
6512
|
getReports: never;
|
|
6513
|
+
getResolutionReport: never;
|
|
6514
|
+
getSportLeaderboard: never;
|
|
5383
6515
|
getStream: never;
|
|
5384
6516
|
getSuspiciousTrade: never;
|
|
5385
6517
|
getTrader: never;
|
|
@@ -5396,8 +6528,11 @@ export interface OperationBody {
|
|
|
5396
6528
|
getWeeklyReportSnapshot: never;
|
|
5397
6529
|
getWhaleDatasetStatus: never;
|
|
5398
6530
|
getWhaleTrade: never;
|
|
6531
|
+
listCategoryLeaders: never;
|
|
5399
6532
|
listComboFills: never;
|
|
6533
|
+
listGameMarkets: never;
|
|
5400
6534
|
listGames: never;
|
|
6535
|
+
listGameTrades: never;
|
|
5401
6536
|
listInsiderRadar: never;
|
|
5402
6537
|
listLargePositions: never;
|
|
5403
6538
|
listLargeTradeCounterpartyExecutions: never;
|
|
@@ -5405,6 +6540,7 @@ export interface OperationBody {
|
|
|
5405
6540
|
listLargeTradeHistory: never;
|
|
5406
6541
|
listLargeTrades: never;
|
|
5407
6542
|
listLeaderboard: never;
|
|
6543
|
+
listLeaderboardLeagues: never;
|
|
5408
6544
|
listPositions: never;
|
|
5409
6545
|
listSharpMoneyFlows: never;
|
|
5410
6546
|
listSmartMoneyFlows: never;
|
|
@@ -5510,6 +6646,15 @@ export interface OperationResponse {
|
|
|
5510
6646
|
data: OperationData["getApiDiscovery"];
|
|
5511
6647
|
meta: ResponseMeta;
|
|
5512
6648
|
};
|
|
6649
|
+
getCategoryLeaderboard: {
|
|
6650
|
+
object: "list";
|
|
6651
|
+
data: OperationData["getCategoryLeaderboard"];
|
|
6652
|
+
has_more: boolean;
|
|
6653
|
+
next_cursor?: string;
|
|
6654
|
+
/** Wallets in the category whose edge lower bound is above zero, Wallets in the full walk across every page: those in the category, under this request's active_within and min_events, whose edge lower bound is above zero. The same on every page. */
|
|
6655
|
+
total?: number;
|
|
6656
|
+
meta: ResponseMeta;
|
|
6657
|
+
};
|
|
5513
6658
|
getCombo: ComboResponse;
|
|
5514
6659
|
getCombosSummary: CombosSummaryResponse;
|
|
5515
6660
|
getCoverage: {
|
|
@@ -5537,6 +6682,16 @@ export interface OperationResponse {
|
|
|
5537
6682
|
as_of: string;
|
|
5538
6683
|
meta: ResponseMeta;
|
|
5539
6684
|
};
|
|
6685
|
+
getGameHolders: {
|
|
6686
|
+
object: "game_holders_batch";
|
|
6687
|
+
data: OperationData["getGameHolders"];
|
|
6688
|
+
meta: BatchResponseMeta;
|
|
6689
|
+
};
|
|
6690
|
+
getGameSharpMoney: {
|
|
6691
|
+
object: "game_sharp_money";
|
|
6692
|
+
data: OperationData["getGameSharpMoney"];
|
|
6693
|
+
meta: ResponseMeta;
|
|
6694
|
+
};
|
|
5540
6695
|
getHealth: {
|
|
5541
6696
|
object: "health";
|
|
5542
6697
|
data: OperationData["getHealth"];
|
|
@@ -5586,6 +6741,16 @@ export interface OperationResponse {
|
|
|
5586
6741
|
data: OperationData["getMarketSnapshot"];
|
|
5587
6742
|
meta: ResponseMeta;
|
|
5588
6743
|
};
|
|
6744
|
+
getMarketTopHolders: {
|
|
6745
|
+
object: "market_top_holders";
|
|
6746
|
+
data: OperationData["getMarketTopHolders"];
|
|
6747
|
+
meta: ResponseMeta;
|
|
6748
|
+
};
|
|
6749
|
+
getMarketWalletsInOut: {
|
|
6750
|
+
object: "market_wallets_in_out";
|
|
6751
|
+
data: OperationData["getMarketWalletsInOut"];
|
|
6752
|
+
meta: ResponseMeta;
|
|
6753
|
+
};
|
|
5589
6754
|
getMonthlyReportSnapshot: {
|
|
5590
6755
|
object: "report_snapshot";
|
|
5591
6756
|
data: OperationData["getMonthlyReportSnapshot"];
|
|
@@ -5611,6 +6776,11 @@ export interface OperationResponse {
|
|
|
5611
6776
|
data: OperationData["getPickOfTheDayLedgerEntry"];
|
|
5612
6777
|
meta: ResponseMeta;
|
|
5613
6778
|
};
|
|
6779
|
+
getPickOfTheDayStats: {
|
|
6780
|
+
object: "pick_of_the_day_stats";
|
|
6781
|
+
data: OperationData["getPickOfTheDayStats"];
|
|
6782
|
+
meta: ResponseMeta;
|
|
6783
|
+
};
|
|
5614
6784
|
getPlatforms: {
|
|
5615
6785
|
object: "platforms";
|
|
5616
6786
|
data: OperationData["getPlatforms"];
|
|
@@ -5639,6 +6809,16 @@ export interface OperationResponse {
|
|
|
5639
6809
|
data: OperationData["getReports"];
|
|
5640
6810
|
meta: ResponseMeta;
|
|
5641
6811
|
};
|
|
6812
|
+
getResolutionReport: {
|
|
6813
|
+
object: "resolution_report";
|
|
6814
|
+
data: OperationData["getResolutionReport"];
|
|
6815
|
+
meta: ResponseMeta;
|
|
6816
|
+
};
|
|
6817
|
+
getSportLeaderboard: {
|
|
6818
|
+
object: "sport_leaderboard";
|
|
6819
|
+
data: OperationData["getSportLeaderboard"];
|
|
6820
|
+
meta: ResponseMeta;
|
|
6821
|
+
};
|
|
5642
6822
|
getStream: string;
|
|
5643
6823
|
getSuspiciousTrade: {
|
|
5644
6824
|
object: "suspicious_trade";
|
|
@@ -5699,18 +6879,52 @@ export interface OperationResponse {
|
|
|
5699
6879
|
data: OperationData["getWhaleTrade"];
|
|
5700
6880
|
meta: ResponseMeta;
|
|
5701
6881
|
};
|
|
6882
|
+
listCategoryLeaders: {
|
|
6883
|
+
object: "list";
|
|
6884
|
+
data: OperationData["listCategoryLeaders"];
|
|
6885
|
+
has_more: boolean;
|
|
6886
|
+
next_cursor?: string;
|
|
6887
|
+
/** Number of rows returned: up to three per category. */
|
|
6888
|
+
total?: number;
|
|
6889
|
+
meta: ResponseMeta;
|
|
6890
|
+
};
|
|
5702
6891
|
listComboFills: ComboFillsResponse;
|
|
6892
|
+
listGameMarkets: {
|
|
6893
|
+
data: OperationData["listGameMarkets"];
|
|
6894
|
+
event_slug: string;
|
|
6895
|
+
families: {
|
|
6896
|
+
active: number;
|
|
6897
|
+
markets: number;
|
|
6898
|
+
sports_market_type?: string;
|
|
6899
|
+
}[];
|
|
6900
|
+
has_more: boolean;
|
|
6901
|
+
meta: ResponseMeta;
|
|
6902
|
+
next_cursor?: string;
|
|
6903
|
+
object: string;
|
|
6904
|
+
};
|
|
5703
6905
|
listGames: {
|
|
5704
6906
|
object: "list";
|
|
5705
6907
|
data: OperationData["listGames"];
|
|
5706
6908
|
has_more: boolean;
|
|
5707
6909
|
/** Pass as cursor for the next page. Present only when has_more is true. */
|
|
5708
6910
|
next_cursor?: string;
|
|
5709
|
-
/** When this read assembled the catalog. Per-source vintage is on each game's freshness. */
|
|
6911
|
+
/** When this read assembled the catalog; with status ended, cancelled or postponed, when it read the stored records. Per-source vintage is on each game's freshness. */
|
|
5710
6912
|
as_of: string;
|
|
5711
6913
|
coverage: GamesCoverage;
|
|
5712
6914
|
meta: ResponseMeta;
|
|
5713
6915
|
};
|
|
6916
|
+
listGameTrades: {
|
|
6917
|
+
object: "list";
|
|
6918
|
+
/** Newest first. */
|
|
6919
|
+
data: OperationData["listGameTrades"];
|
|
6920
|
+
/** Always false: the list is the game's newest limit fills, not a walk. Poll again for newer fills. */
|
|
6921
|
+
has_more: boolean;
|
|
6922
|
+
/** The game the rows were read for, lowercased. */
|
|
6923
|
+
event_slug: string;
|
|
6924
|
+
/** true when the rows are the game's last complete read, served while its refresh runs. Read again in a few seconds for the live rows. */
|
|
6925
|
+
source_stale: boolean;
|
|
6926
|
+
meta: ResponseMeta;
|
|
6927
|
+
};
|
|
5714
6928
|
listInsiderRadar: {
|
|
5715
6929
|
object: "list";
|
|
5716
6930
|
data: OperationData["listInsiderRadar"];
|
|
@@ -5771,6 +6985,11 @@ export interface OperationResponse {
|
|
|
5771
6985
|
total?: number;
|
|
5772
6986
|
meta: ResponseMeta;
|
|
5773
6987
|
};
|
|
6988
|
+
listLeaderboardLeagues: {
|
|
6989
|
+
object: "leaderboard_leagues";
|
|
6990
|
+
data: OperationData["listLeaderboardLeagues"];
|
|
6991
|
+
meta: ResponseMeta;
|
|
6992
|
+
};
|
|
5774
6993
|
listPositions: {
|
|
5775
6994
|
object: "list";
|
|
5776
6995
|
data: OperationData["listPositions"];
|