@0xinsider/sdk 0.19.0 → 0.20.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/dist/schema.d.ts CHANGED
@@ -69,15 +69,15 @@ export type ApiError = {
69
69
  object: "error";
70
70
  error: {
71
71
  /** FROZEN: an existing value never changes meaning. request_timeout (408, #16146) was added the way insufficient_scope was: the handler did not answer inside the server's 30-second timeout. Retry-After and retry_at ride on it only for a safe method (GET, HEAD); a timed-out mutation may have completed, so check its state and reuse its Idempotency-Key. */
72
- code: "bad_request" | "invalid_api_key" | "subscription_required" | "forbidden" | "insufficient_scope" | "not_found" | "account_locked" | "rate_limited" | "rate_limit_unavailable" | "internal_error" | "request_timeout";
72
+ code: "bad_request" | "invalid_api_key" | "subscription_required" | "forbidden" | "insufficient_scope" | "not_found" | "account_locked" | "rate_limited" | "rate_limit_unavailable" | "internal_error" | "request_timeout" | "endpoint_retired";
73
73
  message: string;
74
74
  doc_url?: string;
75
75
  param?: string;
76
76
  /** The recommended next request instant (RFC3339), always in the future. Present on every retryable error: `pick_not_released`, `rate_limited`, `rate_limit_unavailable`, and `read_model_warming`. Omitted otherwise. The absolute twin of `Retry-After`; prefer the header for the sleep duration. For `pick_not_released`, the earliest of the next scheduled release, the next automatic selector attempt, the operating-window start, or about 60 seconds. See that response. */
77
77
  retry_at?: string;
78
78
  freshness?: FreshnessFailure;
79
- /** 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 outside the HOT/WARM sync tiers -- stop asking for this wallet. 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. */
80
- reason?: "cursor_expired" | "unknown_endpoint" | "pick_not_released" | "trader_not_tracked" | "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" | "export_expired" | "freshness_ceiling_unsatisfied";
79
+ /** 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. 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. 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. */
80
+ reason?: "cursor_expired" | "unknown_endpoint" | "pick_not_released" | "trader_not_tracked" | "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" | "export_expired" | "freshness_ceiling_unsatisfied" | "max_plan_required" | "endpoint_retired";
81
81
  };
82
82
  meta: ResponseMeta;
83
83
  };
@@ -90,8 +90,8 @@ export type ApiErrorBody = {
90
90
  /** The recommended next retry instant (RFC3339). Present on every retryable error (reason=pick_not_released, code=rate_limited including reason=monthly_quota_exceeded, code=rate_limit_unavailable, reason=read_model_warming) and omitted otherwise. Always in the future. For pick_not_released: before the 03:00 America/New_York operating-window start, before a selected pick's stored release, or after a skipped day, it names the automatic system's next boundary. While no candidate exists in the live window it normally names the persisted next automatic selector attempt. Every value is advisory and can change before release. When the automatic schedule is absent/due or a pick is overdue it degrades to ~60s. Schedule one request and do not poll. Prefer Retry-After for the duration because it is immune to client clock skew. */
91
91
  retry_at?: string;
92
92
  freshness?: FreshnessFailure;
93
- /** 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 outside the HOT/WARM sync tiers -- stop asking for this wallet. 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. */
94
- reason?: "cursor_expired" | "unknown_endpoint" | "pick_not_released" | "trader_not_tracked" | "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" | "export_expired" | "freshness_ceiling_unsatisfied";
93
+ /** 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. 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. 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/sports/pre-game-sides, GET /api/v1/sports/pre-game-side-observations and their deprecated aliases); 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. */
94
+ reason?: "cursor_expired" | "unknown_endpoint" | "pick_not_released" | "trader_not_tracked" | "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" | "export_expired" | "freshness_ceiling_unsatisfied" | "max_plan_required";
95
95
  };
96
96
  export type BatchMarketFlowItem = {
97
97
  /** Zero-based request index. Duplicate inputs keep separate result rows. */
@@ -470,6 +470,90 @@ export type DataQualityGroup = {
470
470
  /** Why the status is not fresh. Omitted when it is. */
471
471
  reason?: string;
472
472
  };
473
+ /** The full Edge Hunter board shown at https://0xinsider.com/sports/edge, for Max credentials. It covers all sports and esports with a fixed B grade floor and returns the first 30 ranked rows. No cursor or observation cohorts are exposed. */
474
+ export type EdgeHunterBoard = {
475
+ /** When the ranked snapshot was computed. Date current quotes with their own ts values. */
476
+ as_of: string;
477
+ horizon_hours: number;
478
+ min_grade: "B";
479
+ /** live uses the current graded holder pile; db_only is a weaker stored-data fallback. */
480
+ ranking_source: "live" | "db_only";
481
+ /** degraded means directional enrichment was unavailable. */
482
+ directional_source: "live" | "degraded";
483
+ cached_age_seconds: number | null;
484
+ viewer: "max";
485
+ /** Always null: Edge Hunter has no free signal slot. */
486
+ free_rank: number | null;
487
+ /** Ranked rows in this window before the 30-row cap. */
488
+ total: number;
489
+ rows: EdgeHunterRow[];
490
+ };
491
+ /** One provider outcome in YES/NO order. Null current_price means no verified current quote is available. */
492
+ export type EdgeHunterOutcome = {
493
+ index: 0 | 1;
494
+ label: string | null;
495
+ provider_id: number | null;
496
+ current_price: EdgeHunterPrice;
497
+ };
498
+ export type EdgeHunterParticipant = {
499
+ provider_id?: number;
500
+ logo?: string;
501
+ logo_mark_dark?: boolean;
502
+ color?: string;
503
+ headshot?: string;
504
+ headshot_revision?: number;
505
+ tour?: string;
506
+ name: string;
507
+ };
508
+ export type EdgeHunterPrice = {
509
+ /** Provider probability as a decimal string. Keep its precision until display. */
510
+ price: string;
511
+ basis: "midpoint" | "last_trade";
512
+ /** Source observation clock in epoch milliseconds, represented as a string. */
513
+ ts: string;
514
+ /** Backend validation clock in epoch milliseconds. Omitted when no current-source validation is available. */
515
+ validated_at?: string;
516
+ };
517
+ /** One full Max row from Edge Hunter. signal is populated on every row this endpoint returns. Identity and quotes preserve provider values; unknown values stay null. */
518
+ export type EdgeHunterRow = {
519
+ rank: number;
520
+ state: "full";
521
+ free: false;
522
+ condition_id: string;
523
+ event_slug: string | null;
524
+ title: string | null;
525
+ category: "Basketball" | "Football" | "Baseball" | "Hockey" | "MMA" | "Boxing" | "Soccer" | "Cricket" | "Golf" | "Tennis" | "Esports" | "Racing" | "Table Tennis" | "Pickleball" | null;
526
+ raw_category: string | null;
527
+ game_start_time: string | null;
528
+ /** Cumulative provider taker volume in shares, not cash in USD. Null when unavailable. */
529
+ volume: number | null;
530
+ participants: EdgeHunterParticipant[];
531
+ image: string | null;
532
+ outcomes: EdgeHunterOutcome[];
533
+ signal: EdgeHunterSignal;
534
+ };
535
+ /** Backed-side analytics from the ranked snapshot, plus a separately dated current quote. Scores rank attention; they are not probabilities or order instructions. */
536
+ export type EdgeHunterSignal = {
537
+ piled_side: string | null;
538
+ piled_outcome_index: 0 | 1;
539
+ /** Fraction of graded money on the backed side, not a percentage from 0 to 100. */
540
+ sharp_pct: number | null;
541
+ backed_sharp_usd: number;
542
+ s_count: number;
543
+ a_count: number;
544
+ b_count: number;
545
+ graded_holders: number;
546
+ top_grade: "S" | "A" | "B" | null;
547
+ smart_score: number | null;
548
+ net_side: string | null;
549
+ conviction_score: number;
550
+ one_way_holder_count: number | null;
551
+ hedged_holder_count: number | null;
552
+ one_way_graded_usd: number | null;
553
+ directional_confidence: number | null;
554
+ directional_rank_score: number;
555
+ current_price: EdgeHunterPrice;
556
+ };
473
557
  export type EventReplayEvent = {
474
558
  /** Opaque event identity: the ef_-encoded whale_alerts.id, stable across cursor formats. Deduplicate on this, never on cursor or sequence. */
475
559
  id: string;
@@ -581,6 +665,7 @@ export type ExploreGroup = {
581
665
  category: string | null;
582
666
  /** Markets in the event cluster, ranked by volume with condition_id as the tie-breaker. The selected representative is retained within the 12-market cap. */
583
667
  markets: ExploreMarket[];
668
+ /** The volume of the group's highest-volume market, which is markets[0]: the same figure as that market's volume, Polymarket's cumulative taker volume in shares rather than cash. Null when unavailable. */
584
669
  rep_volume: number | null;
585
670
  /** Canonical key since #16304; rep_whales is its deprecated spelling, emitted beside it with the same value. */
586
671
  rep_large_trades: number | null;
@@ -602,6 +687,7 @@ export type ExploreMarket = {
602
687
  platform: "polymarket" | null;
603
688
  /** 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. */
604
689
  status: "active" | "closed";
690
+ /** Polymarket's traded-volume figure for the market, as last stored: cumulative taker volume in shares, each counted at its $1 settlement value, not the cash that changed hands (100 shares bought at $0.40 add 100, not 40). It can lag Polymarket's current figure. sort=volume orders by it. Null when unavailable. */
605
691
  volume: number | null;
606
692
  liquidity: number | null;
607
693
  /** Canonical key since #16304 (Polymarket's noun is large trade); whale_trade_count is its deprecated spelling, emitted beside it with the same value. */
@@ -693,9 +779,12 @@ export type ExportSourceRange = {
693
779
  export type ExportVolumeReconciliation = {
694
780
  /** Verified full-history both-sides USD cash volume. Null without coverage; the local activity numerator may cover only a subset of history. */
695
781
  provider_lifetime_volume: number | null;
782
+ /** Cash in USD, buys and sells, summed over the daily P&L rows this export carries, from the fills 0xinsider has stored for the wallet. It can cover less history than provider_lifetime_volume; never Polymarket's share count. */
696
783
  exported_activity_volume: number;
697
784
  exported_market_cost_basis: number;
785
+ /** provider_lifetime_volume minus exported_activity_volume, in USD, rounded to cents. Null when provider_lifetime_volume is null. */
698
786
  provider_activity_volume_gap: number | null;
787
+ /** exported_activity_volume divided by provider_lifetime_volume, a fraction of the cash, not a percent. Null when provider_lifetime_volume is null or zero. */
699
788
  activity_volume_coverage: number | null;
700
789
  };
701
790
  export type FreshnessFailure = {
@@ -862,7 +951,7 @@ export type GameMarketProviderPrices = GameMarketPricePaired | GameMarketPriceIn
862
951
  export type GamesCoverage = {
863
952
  /** Canonical sport buckets served, sorted. */
864
953
  sports: string[];
865
- /** League tags served, sorted. */
954
+ /** League tags served, sorted. EuroLeague is euroleague under the Basketball sport bucket. */
866
955
  leagues: string[];
867
956
  /** Scopes whose source half was unavailable for this read, as <sport>:<half>. Empty means every scope answered. */
868
957
  sources_unavailable: string[];
@@ -1075,9 +1164,9 @@ export type LeaderboardEntry = {
1075
1164
  /** Hot-streak tier (trailing-7d cross-sectional percentile); a separate axis from the all-time grade. Omitted when there is no recent activity. */
1076
1165
  streak_tier?: "hot" | "rising" | "neutral" | "cooling" | "cold";
1077
1166
  score?: number;
1078
- /** Polymarket leaderboard all-time P&L in USD (traders.total_pnl), including unrealized open positions. Kept for back-compat. Not the profile's Total P&L, which GET /api/v1/trader/{address} serves as pnl.net_total; the two can differ by a wide margin. Prefer realized_pnl for the banked figure. */
1167
+ /** Polymarket's all-time leaderboard P&L in USD, from Polymarket's latest observation of this wallet on its all-time leaderboard (dated by the leaderboard_pnl data_quality group). Omitted when that leaderboard has no current observation ranking the wallet; 0xinsider requests one, and never serves an older stored figure in its place. Includes unrealized open positions. Kept for back-compat. Not the profile's Total P&L, which GET /api/v1/trader/{address} serves as pnl.net_total; the two can differ by a wide margin. Prefer realized_pnl for the banked figure. */
1079
1168
  pnl?: number;
1080
- /** Native realized P&L plus credited maker and taker rebates in USD, with fees already included. The exact numeric value is truncated toward zero to cents before JSON conversion. Wallets without a native snapshot retain their historical stored realized P&L. Omitted when the native snapshot has no net realized value. */
1169
+ /** Native realized P&L plus credited maker and taker rebates in USD, with fees already included. The exact numeric value is truncated toward zero to cents before JSON conversion. Omitted when the wallet has no native snapshot or the snapshot has no net realized value; never filled from another P&L basis. */
1081
1170
  realized_pnl?: number;
1082
1171
  /** Full-history both-sides USD cash volume from a verified Polymarket user-volume observation. Omitted without coverage. */
1083
1172
  volume?: number;
@@ -1090,7 +1179,7 @@ export type LeaderboardEntry = {
1090
1179
  platform: "polymarket";
1091
1180
  last_active?: string;
1092
1181
  };
1093
- /** Provider-first bucketed OHLC price candles for a market's outcome tokens, derived from the stored token_price_snapshots series (covers open and resolved markets). */
1182
+ /** Provider-first bucketed OHLC price candles for a market's outcome tokens, derived from our stored copy of the Polymarket CLOB prices-history series (covers open and resolved markets). */
1094
1183
  export type MarketCandles = {
1095
1184
  /** Market condition id the candles were read for. */
1096
1185
  condition_id: string;
@@ -1299,9 +1388,13 @@ export type MarketSnapshot = {
1299
1388
  })[];
1300
1389
  liquidity: {
1301
1390
  source: string;
1391
+ /** Polymarket's traded-volume figure for the market, as last stored: cumulative taker volume in shares, each counted at its $1 settlement value, not the cash that changed hands (100 shares bought at $0.40 add 100, not 40). It can lag Polymarket's current figure. The name ends in _usd because Polymarket prints this figure with a dollar sign; it is a share count. Null when unavailable. */
1302
1392
  volume_usd: number | null;
1303
1393
  liquidity_usd: number | null;
1394
+ /** Polymarket's taker volume over the 24 hours before volume_24h_as_of, in shares, each counted at its $1 settlement value, not the cash that changed hands (100 shares bought at $0.40 add 100, not 40). The name ends in _usd because Polymarket prints volume with a dollar sign; it is a share count. Null when Polymarket does not report one: it omits the figure on closed markets and on open markets with no trades in the last 24 hours. */
1304
1395
  volume_24h_usd: number | null;
1396
+ /** When 0xinsider read volume_24h_usd from Polymarket; the figure covers the 24 hours before this time. Null exactly when volume_24h_usd is null. */
1397
+ volume_24h_as_of: string | null;
1305
1398
  /** Always null. Polymarket snapshot prices come from outcome top-of-book midpoints. */
1306
1399
  last_price: number | null;
1307
1400
  };
@@ -2079,7 +2172,7 @@ export type Position = {
2079
2172
  address: string;
2080
2173
  username?: string;
2081
2174
  grade?: "S" | "A" | "B" | "C" | "D" | "F";
2082
- /** Percentage 0-100. */
2175
+ /** Win rate as a ratio from 0 to 1 (0.62 means 62%), the same scale as stats.win_rate on GET /api/v1/trader/{address}. Absent when unknown. */
2083
2176
  win_rate?: number;
2084
2177
  /** The wallet's Total P&L in USD, the figure its 0xinsider profile shows: native Polymarket position P&L across all markets, fees included, plus credited maker and taker rebates (trader_trading_pnl.net_total_pnl). Not the Polymarket leaderboard figure, which GET /api/v1/trader/{address} still serves as pnl.total. Omitted when the wallet has no native accounting snapshot; the leaderboard figure is never substituted. */
2085
2178
  pnl?: number;
@@ -2118,7 +2211,7 @@ export type PositionTimelineEvent = {
2118
2211
  id: string;
2119
2212
  /** ISO 8601 timestamp of the on-chain fill. */
2120
2213
  event_timestamp: string;
2121
- /** From the taker's perspective. */
2214
+ /** The wallet's own side of this fill: buy or sell. */
2122
2215
  action: "buy" | "sell";
2123
2216
  outcome_side: "yes" | "no";
2124
2217
  /** The Polymarket CLOB token id (ERC1155 asset id, decimal string) for this outcome; null when unavailable (e.g. unsynced markets). */
@@ -2159,214 +2252,6 @@ export type PotdEntryAuthorization = {
2159
2252
  /** Original authorization expiry at the earlier requested or provider kickoff; never extended. An expired authorization cannot authorize a new automated entry. */
2160
2253
  expires_at: string;
2161
2254
  };
2162
- /** One ranked pre-game sports market where graded sharp money is piled on one side, with required-status shadow category evidence from partial forward-observed Polymarket fills. */
2163
- export type PreGameSide = {
2164
- /** The side profitable wallets hold, as a provider-backed display label. Canonical spelling of piled_side (#16310), same value: when provider group context is unavailable it may remain a bare Yes/No/Over/Under, so do not use it alone as participant identity. */
2165
- side: string | null;
2166
- /** UTC time at which the snapshot that ranked this row was computed. Canonical spelling of signal_created_at (#16310), same value. */
2167
- ranked_at: string;
2168
- /** Recorded side backing score; higher values indicate stronger backing. */
2169
- backing_score: number;
2170
- /** Signed share of graded money on the side, (yes_usd - no_usd)/(yes_usd + no_usd) in [-1, 1] (side-yes positive, side-no negative). Canonical spelling of smart_score (#16309, #16310), same value. */
2171
- side_share: number | null;
2172
- /** Polymarket condition id. */
2173
- condition_id: string;
2174
- /**
2175
- * UTC time at which the immutable signal snapshot was computed. Every row from one snapshot shares this value; it is not provider market creation time and is not rewritten at request time. Deprecated (#16310): `ranked_at` is the canonical spelling and carries the same value; this key stays on the wire.
2176
- * @deprecated
2177
- */
2178
- signal_created_at: string;
2179
- /** Polymarket CLOB token id (ERC1155 asset id, decimal string) for the PILED outcome; null when unavailable. */
2180
- token_id: string | null;
2181
- /** Canonical sport bucket (e.g. Basketball, Tennis); null when the raw category has no canonical mapping. */
2182
- category: string | null;
2183
- /** Raw provider category as stored (e.g. NBA, EPL). */
2184
- raw_category: string | null;
2185
- title: string | null;
2186
- event_slug: string | null;
2187
- /** Kickoff (UTC). In the future at SNAPSHOT time and within the requested horizon; because the response is served from a shared snapshot cached up to the ~180s TTL, a served kickoff can be up to ~180s in the past relative to the response time. Not a live guarantee that the game has not yet started. */
2188
- game_start_time: string | null;
2189
- /**
2190
- * Nullable provider-backed piled-outcome display label. When provider group context is unavailable, it may remain a bare Yes/No/Over/Under; do not use it alone as participant identity. Deprecated (#16310): `side` is the canonical spelling and carries the same value; this key stays on the wire.
2191
- * @deprecated
2192
- */
2193
- piled_side: string | null;
2194
- /** Provider binary-column selector: 0 selects outcome_yes/token_id_yes; 1 selects outcome_no/token_id_no. It does not identify home/away or a participant. Use piled_side together with title/event context for display. */
2195
- piled_outcome_index: number;
2196
- /** Piled-side dollar concentration backed_usd / (yes_usd + no_usd), in (0.5, 1] for a real pile; null when there is no sharp USD. */
2197
- sharp_pct: number | null;
2198
- /** Raw piled-side sharp-money USD. */
2199
- backed_sharp_usd: number;
2200
- /** S-grade graded holders on the piled side. */
2201
- s_count: number;
2202
- /** A-grade graded holders on the piled side. */
2203
- a_count: number;
2204
- /** B-grade graded holders on the piled side. */
2205
- b_count: number;
2206
- /** Piled-side graded holder count (s_count + a_count + b_count). */
2207
- graded_holders: number;
2208
- /** Best grade present on the piled side; null when none. */
2209
- top_grade: "S" | "A" | "B" | null;
2210
- /**
2211
- * Canonical sharp-money score (yes_usd - no_usd)/(yes_usd + no_usd) in [-1, 1] (piled-yes positive, piled-no negative). Deprecated (#16310): `side_share` is the canonical spelling and carries the same value; this key stays on the wire.
2212
- * @deprecated
2213
- */
2214
- smart_score: number | null;
2215
- /** Market volume (USD). */
2216
- volume: number | null;
2217
- /** Aggregate recent flow direction on the market; null when unavailable. */
2218
- net_side: "BUY" | "SELL" | null;
2219
- /**
2220
- * Recorded conviction score; higher values indicate stronger conviction.
2221
- * @deprecated
2222
- */
2223
- conviction_score: number;
2224
- /** Piled-side graded holders read one-way: their fresh open legs across the signal game's markets (cross-market within the one game; moneyline+spread family only) all back the same team, or, when the market's holder scan was complete, Polymarket's currentValue shows no opposite leg on this market worth 10% of the backed leg and no fresh leg opposes it. Null when the directional read was not computed (no groupable game, no holder-level data on this ranking path, or the enrichment read failed) or classified nobody. */
2225
- one_way_holder_count: number | null;
2226
- /** Piled-side graded holders classified HEDGED across the game by fresh legs (they back two or more distinct teams). A wallet long both outcomes of this market is not one-way and not counted here. Null when the directional read was not computed or classified nobody. */
2227
- hedged_holder_count: number | null;
2228
- /** Piled-side graded USD held by one-way wallets (share-weighted allocation of backed_sharp_usd). Null when the directional read was not computed or classified nobody. */
2229
- one_way_graded_usd: number | null;
2230
- /** One-way fraction of the piled graded dollars, in [0, 1] -- the metric orthogonal to sharp_pct. Stale, unknown, hedged, and two-sided dollars dilute it toward zero (conservative). Null when the directional read was not computed or classified nobody. */
2231
- directional_confidence: number | null;
2232
- /** Recorded side ordering score; higher values sort first. */
2233
- directional_rank_score: number;
2234
- category_skill: PreGameSideCategorySkill;
2235
- /** 1-based rank within the (min_grade-filtered) ranked result. */
2236
- rank: number;
2237
- };
2238
- /** Shadow-only category evidence over the full uncapped piled-side S/A/B holder allocation. It never changes signal membership, ordering, routing, or sizing. */
2239
- export type PreGameSideCategorySkill = {
2240
- status: "live" | "insufficient" | "stale" | "unknown" | "degraded";
2241
- model_version: string;
2242
- taxonomy_version: string | null;
2243
- platform: "polymarket";
2244
- scope: "observed_goldsky_primary_taker_fill";
2245
- source_coverage: "partial_whale_threshold_fills" | "graded_wallet_fills";
2246
- observation_started_at: string;
2247
- as_of: string;
2248
- canonical_category: string | null;
2249
- eligible_holders: number;
2250
- covered_holders: number;
2251
- backed_sharp_usd: number | null;
2252
- covered_backed_usd: number | null;
2253
- coverage_pct: number | null;
2254
- weighted_edge_mean: number | null;
2255
- weighted_holder_lower_mean: number | null;
2256
- specialist_backed_usd: number | null;
2257
- specialist_backed_usd_pct: number | null;
2258
- largest_holder_backed_usd_pct: number | null;
2259
- minimum_holder_event_count: number | null;
2260
- };
2261
- /** Per-sport accountable funnel for the full observation snapshot, returned on every page. */
2262
- export type PreGameSideFunnelReport = {
2263
- sports: PreGameSideSportFunnelReport[];
2264
- };
2265
- /** One explicitly observation-only holder-pile measurement. It is evidence for cohort evaluation, not an execution instruction, and is isolated from the funded sports-edge-signals route. */
2266
- export type PreGameSideObservation = {
2267
- /** The side profitable wallets hold, as a provider-backed display label. Canonical spelling of piled_side (#16310), same value: when provider group context is unavailable it may remain a bare Yes/No/Over/Under, so do not use it alone as participant identity. */
2268
- side: string | null;
2269
- /** Recorded side backing score; higher values indicate stronger backing. */
2270
- backing_score: number;
2271
- /** Signed share of graded money on the side, in [-1, 1]. Canonical spelling of smart_score (#16309, #16310), same value. */
2272
- side_share: number;
2273
- /** Raw Polymarket condition id. */
2274
- condition_id: string;
2275
- /** Provider-backed Polymarket CLOB token id for the piled outcome. Rows without a verified token terminate before emission. */
2276
- token_id: string;
2277
- /** Canonical sport bucket. */
2278
- category: "Basketball" | "Football" | "Baseball" | "Hockey" | "MMA" | "Boxing" | "Soccer" | "Cricket" | "Golf" | "Tennis" | "Esports" | "Racing" | "Table Tennis" | "Pickleball";
2279
- /** Raw provider category as stored. */
2280
- raw_category: string | null;
2281
- /** Provider-backed market title. */
2282
- title: string;
2283
- event_slug: string | null;
2284
- /** Provider event id when available. */
2285
- event_id: string | null;
2286
- /** Provider parent-event id used as the first event-cap identity when available. */
2287
- parent_event_id: string | null;
2288
- /** Provider-backed kickoff time in UTC. */
2289
- game_start_time: string;
2290
- /** UTC instant when this row finished provider/holder evaluation. */
2291
- observed_at: string;
2292
- /** Source cohort or additive projection view. emerging_pile is projected from wider_holder after source computation, overlaps its funnel denominator, and uses the source row's directional evidence. */
2293
- cohort: "wider_holder" | "in_play" | "emerging_pile";
2294
- /** Always true. This row must not be routed to an order executor. */
2295
- observation_only: true;
2296
- /**
2297
- * Nullable provider-backed piled-outcome display label. When provider group context is unavailable, it may remain a bare Yes/No/Over/Under; do not use it alone as participant identity. Deprecated (#16310): `side` is the canonical spelling and carries the same value; this key stays on the wire.
2298
- * @deprecated
2299
- */
2300
- piled_side: string | null;
2301
- /** Provider binary-column selector: 0 selects outcome_yes/token_id_yes; 1 selects outcome_no/token_id_no. It does not identify home/away or a participant. Use piled_side together with title/event context for display. */
2302
- piled_outcome_index: 0 | 1;
2303
- /** Provider-backed implied price for the piled outcome at observation time. */
2304
- backed_price: number;
2305
- /** Piled-side graded-holder dollar concentration. */
2306
- sharp_pct: number;
2307
- /** Raw graded-holder USD on the piled outcome. */
2308
- backed_sharp_usd: number;
2309
- s_count: number;
2310
- a_count: number;
2311
- b_count: number;
2312
- /** Piled-side S/A/B holder count. */
2313
- graded_holders: number;
2314
- top_grade: "S" | "A" | "B";
2315
- /**
2316
- * Canonical signed holder-pile score. Deprecated (#16310): `side_share` is the canonical spelling and carries the same value; this key stays on the wire.
2317
- * @deprecated
2318
- */
2319
- smart_score: number;
2320
- /** Strictly positive stored market volume in USD. Missing, zero, or non-finite volume terminates as invalid_market and is never emitted as an observation. */
2321
- volume: number;
2322
- /**
2323
- * Recorded conviction score; higher values indicate stronger conviction.
2324
- * @deprecated
2325
- */
2326
- conviction_score: number;
2327
- /** Whether the provider holder page came from the shared cache or a live provider read. */
2328
- provider_read_source: "cached" | "live";
2329
- /** True only when neither provider outcome holder page hit the top-100 scan bound. False means the pile is a positive lower bound and cannot satisfy a future capital-promotion gate. */
2330
- holder_scan_complete: boolean;
2331
- /** Proven provider holder observation time. A warm cache hit uses only the original provider completion time from its companion metadata, never cache-read time. Null, malformed, future, or stale holder time fails in-play closed. */
2332
- holder_snapshot_at: string | null;
2333
- /** 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. */
2334
- directional_status: "available" | "unknown_ungrouped" | "unknown_stale" | "unavailable";
2335
- one_way_holder_count: number | null;
2336
- hedged_holder_count: number | null;
2337
- one_way_graded_usd: number | null;
2338
- directional_confidence: number | null;
2339
- /** Recorded side ordering score; higher values sort first. */
2340
- directional_rank_score: number;
2341
- /** 1-based rank within this observation cohort and snapshot. */
2342
- rank: number;
2343
- };
2344
- /** Closed 25-value terminal-reason vocabulary for the accountable sports-edge 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 an attempted holder-provider failure; holder_deadline_unavailable is holder cache/provider absolute-deadline exhaustion. */
2345
- export type PreGameSideObservationTerminalReason = "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";
2346
- /** Independent sports-board supply plus stored-universe terminal accounting for one canonical sport. */
2347
- export type PreGameSideSportFunnelReport = {
2348
- sport: "Basketball" | "Football" | "Baseball" | "Hockey" | "MMA" | "Boxing" | "Soccer" | "Cricket" | "Golf" | "Tennis" | "Esports" | "Racing" | "Table Tennis" | "Pickleball";
2349
- /** Unique condition ids independently visible on the provider-first sports board. */
2350
- board_input: number;
2351
- /** Whether the always-applicable live-board source completed as available. False can mean a completed source failure (board_source_unavailable) or live-board work missing an internal configured-scope deadline or the outer fair-wave deadline (board_deadline_unavailable); inspect terminals to distinguish them. */
2352
- board_live_available: boolean;
2353
- /** Whether a provider-backed upcoming-board source is configured and applicable for this sport. False means not applicable, not provider failure. */
2354
- board_upcoming_configured: boolean;
2355
- /** 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 (it reads unknown, i.e. no recorded cause, only on a snapshot cached before that field existed, which self-clears within one TTL): 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. */
2356
- board_upcoming_available: boolean;
2357
- /** 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 NCAAB and 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 3,000 rows or 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: exactly one cause -- a snapshot cached before this field existed whose legacy flags recorded an unavailable-but-configured half without saying why. Every freshly computed snapshot reports a concrete status, and a legacy available or not-configured row is reconstructed exactly, so unknown self-clears within one TTL. board_upcoming_available is exactly board_upcoming_status == available. */
2358
- board_upcoming_status: "unknown" | "not_configured" | "available" | "capacity_limited" | "source_unavailable" | "cold_unavailable" | "deadline_unavailable";
2359
- /** Configured upcoming scopes that did not complete as available. Values are category, a provider league tag slug (nfl, cfb, nba, wnba, 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. */
2360
- board_upcoming_unavailable_scopes: ("category" | "nfl" | "cfb" | "nba" | "wnba" | "nhl" | "mls" | "valorant" | "league-of-legends" | "counter-strike-2" | "dota-2" | "registry" | "union" | "wave")[];
2361
- /** Stored-universe rows plus provider-board rows missing from storage. */
2362
- input: number;
2363
- /** 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 exact admission by the funded route's raw shared signals query before provider/holder enrichment; recent-flow rows rejected by its event, bucket, or total caps remain eligible for wider_holder measurement. 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 an attempted holder-provider read failed; holder_deadline_unavailable means holder cache/provider work missed the absolute request deadline; holder_computation_unavailable means post-holder provider or DB-backed price/metadata evaluation was unavailable. */
2364
- terminals: Record<string, number>;
2365
- /** Sum of every sparse terminal count. */
2366
- terminal_total: number;
2367
- /** True exactly when input equals terminal_total. */
2368
- reconciled: boolean;
2369
- };
2370
2255
  /** One PUBLISHED same-day pick whose holder proof is not readable yet: its stable slot rank, the release and kickoff instants, and the instant before which a retry cannot succeed. Every item in `picks` carries its full required shape, so a pick that cannot meet it is listed here instead of being served with missing fields or a synthetic zero. */
2371
2256
  export type ProofPendingPickSlot = {
2372
2257
  /**
@@ -2491,9 +2376,9 @@ export type ResponseMeta = {
2491
2376
  ranking_generation?: number;
2492
2377
  /** Authoritative RFC3339 timestamp from cache_generations.updated_at for ranking_generation. It is read in the same repeatable-read snapshot as the leaderboard rows and is not request time, cache write time, or row insertion order. */
2493
2378
  ranking_as_of?: string;
2494
- /** Which path produced the team-directional read on this response. Only present on endpoints that compute one (today: GET /api/v1/sports-edge-signals). "live" means the read RAN. "degraded" means it FAILED, so nothing was measured and the ranking fell back to raw conviction. The flag describes the READ, not its consequence: a read that ran and found nothing groupable also leaves the directional fields null, and that is honestly "live" -- the per-signal nulls already say "nothing to enrich here", so this snapshot-level flag carries only what they cannot, namely whether the read ran at all. A degraded response is cached on the shorter degraded TTL so it self-heals. Reported SEPARATELY from ranking_source because the two degradations are independent -- a sharp-money DB miss weakens the ranking DATA, a directional failure removes a ranking WEIGHT -- and a consumer down-weighting a degraded response needs to know which input it lost. Omitted on endpoints that compute no directional read. */
2379
+ /** Which path produced the team-directional read on this response. Only present on endpoints that compute one (today: GET /api/v1/edge-hunter). "live" means the read RAN. "degraded" means it FAILED, so nothing was measured and the ranking fell back to raw conviction. The flag describes the READ, not its consequence: a read that ran and found nothing groupable also leaves the directional fields null, and that is honestly "live" -- the per-signal nulls already say "nothing to enrich here", so this snapshot-level flag carries only what they cannot, namely whether the read ran at all. A degraded response is cached on the shorter degraded TTL so it self-heals. Reported SEPARATELY from ranking_source because the two degradations are independent -- a sharp-money DB miss weakens the ranking DATA, a directional failure removes a ranking WEIGHT -- and a consumer down-weighting a degraded response needs to know which input it lost. Omitted on endpoints that compute no directional read. */
2495
2380
  directional_source?: "live" | "degraded";
2496
- /** Which ranking-data path produced this response. Only present on endpoints that can degrade a ranking (today: GET /api/v1/sports-edge-signals). "live" is the normal path (the current holder pile from the provider batch); "db_only" is the degraded fallback (a truthful but weaker trader_markets ranking) served when the live sharp-money ranking batch is unavailable (a sharp-money DB read failure, not a Polymarket outage) and cached on a shorter TTL, so a consumer can down-weight or skip it. Omitted on endpoints that never degrade. */
2381
+ /** Which ranking-data path produced this response. Only present on endpoints that can degrade a ranking (today: GET /api/v1/edge-hunter). "live" is the normal path (the current holder pile from the provider batch); "db_only" is the degraded fallback (a truthful but weaker trader_markets ranking) served when the live sharp-money ranking batch is unavailable (a sharp-money DB read failure, not a Polymarket outage) and cached on a shorter TTL, so a consumer can down-weight or skip it. Omitted on endpoints that never degrade. */
2497
2382
  ranking_source?: "live" | "db_only";
2498
2383
  /** Whole filtered snapshot category-evidence status before pagination. Operational live always remains partial source coverage. */
2499
2384
  category_skill_source?: "live" | "partial" | "degraded" | "unavailable";
@@ -2503,7 +2388,7 @@ export type ResponseMeta = {
2503
2388
  category_skill_scope?: "observed_goldsky_primary_taker_fill";
2504
2389
  category_skill_source_coverage?: "partial_whale_threshold_fills" | "graded_wallet_fills";
2505
2390
  category_skill_observation_started_at?: string;
2506
- /** Whole-model operational readiness captured with the category model snapshot. Present on category-enriched responses even when the filtered signal list is empty. When true, category_skill_source is degraded and sports-edge-signals uses the shorter degraded cache TTL. */
2391
+ /** Whole-model operational readiness captured with the category model snapshot. Present on category-enriched responses even when the filtered signal list is empty. When true, category_skill_source is degraded and the ranked sports snapshot uses the shorter degraded cache TTL. */
2507
2392
  category_skill_model_operationally_degraded?: boolean;
2508
2393
  category_skill_status_counts?: {
2509
2394
  live: number;
@@ -2514,7 +2399,7 @@ export type ResponseMeta = {
2514
2399
  };
2515
2400
  /** SHA-256 of the funded signal membership/order/rank/cursor vector immediately before category-skill enrichment. Sports-edge-signals only. */
2516
2401
  category_skill_base_payload_hash?: string;
2517
- /** Independent SHA-256 recomputation over the same base fields immediately after category-skill enrichment. Equality with category_skill_base_payload_hash proves shadow enrichment did not change funded inputs. Sports-edge-signals only. */
2402
+ /** Independent SHA-256 recomputation over the same base fields immediately after category-skill enrichment. Equality with category_skill_base_payload_hash proves category-skill enrichment did not change funded inputs. Sports-edge-signals only. */
2518
2403
  category_skill_enriched_base_payload_hash?: string;
2519
2404
  };
2520
2405
  /** An entitled same-day pick selected but not yet released: stable rank and backend-owned release/kickoff instants. No matchup, category, platform, side, price, or holder fields appear before release. Unauthorized scheduled ranks appear only in locked_picks. */
@@ -2694,7 +2579,7 @@ export type Trader = {
2694
2579
  forecast_evidence?: number;
2695
2580
  rank?: number;
2696
2581
  pnl: {
2697
- /** Polymarket leaderboard all-time P&L in USD (traders.total_pnl), kept for provider parity and back-compat. Not the profile's Total P&L and not realized plus unrealized: it can differ from net_total by a wide margin. Read net_total for the figure the 0xinsider profile shows. */
2582
+ /** Polymarket's all-time leaderboard P&L in USD, from Polymarket's latest observation of this wallet on its all-time leaderboard (dated by the leaderboard_pnl data_quality group). Omitted when that leaderboard has no current observation ranking the wallet; 0xinsider requests one, and never serves an older stored figure in its place. Kept for provider parity and back-compat. Not the profile's Total P&L and not realized plus unrealized: it can differ from net_total by a wide margin. Read net_total for the figure the 0xinsider profile shows. */
2698
2583
  total?: number;
2699
2584
  /** The profile's Total P&L in USD: native Polymarket position P&L, with fees already included, plus credited maker and taker rebates (trader_trading_pnl.net_total_pnl). The same figure the 0xinsider profile, search, live feed, portfolio and watchlist show. Truncated toward zero to cents before conversion to a JSON number. Omitted when the wallet has no native accounting snapshot; pnl.total is never substituted. */
2700
2585
  net_total?: number;
@@ -2729,7 +2614,7 @@ export type Trader = {
2729
2614
  quant_metrics?: {
2730
2615
  /** Trader smart score on a 0..100 display scale; higher is stronger. Null when unavailable. */
2731
2616
  smart_score: number | null;
2732
- /** Copyability score, 0-100. Same base as smart_score minus penalties for traits that make a strategy hard to replicate: -20 if fewer than 50 markets traded, -15 if positions are highly concentrated, -15 if position sizing exceeds about 2x Kelly, -10 if the worst single-trade loss exceeds 30%, -10 if edge is inconsistent; result clamped to 0-100. Higher means easier to follow. null when insufficient history. */
2617
+ /** Copyability score, 0-100. Same base as smart_score minus penalties for traits that make a strategy hard to replicate: -20 if fewer than 50 markets traded, -15 if positions are highly concentrated, -15 if position sizing exceeds about 2x Kelly, -10 if the largest loss on one settled market exceeds 30% of the capital the wallet deployed across all its positions, -10 if edge is inconsistent; result clamped to 0-100. Higher means easier to follow. null when insufficient history. */
2733
2618
  copy_score: number | null;
2734
2619
  /** Sharpe ratio over the trailing 30 days (risk-adjusted return; higher is better). Magnitude can be large for small samples. null when insufficient history. */
2735
2620
  sharpe_30d: number | null;
@@ -2750,7 +2635,7 @@ export type Trader = {
2750
2635
  synced_at?: string;
2751
2636
  /** synced, unknown, or pending. */
2752
2637
  sync_status?: string;
2753
- /** Data age and coverage for this trader body. Always present. Its five groups are sync (traders.last_synced, covering pnl.total, pnl.net_total, pnl.realized, stats.markets_traded, stats.win_rate, stats.daily_win_rate, last_active, synced_at and sync_status), 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 (trader_usd_volume.observed_at, covering stats.total_volume) and positions (trader_position_snapshots.last_refreshed_at with traders.last_synced as fallback, covering pnl.unrealized, the open-position aggregate). The positions clock is the latest successful /positions snapshot when one exists, otherwise the last completed trader sync; it does not date closed or native accounting values. 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. */
2638
+ /** Data age and coverage for this trader body. Always present. Its six groups are sync (traders.last_synced, covering pnl.net_total, pnl.realized, stats.markets_traded, stats.win_rate, stats.daily_win_rate, last_active, synced_at and sync_status), 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 (trader_usd_volume.observed_at, covering stats.total_volume) and positions (trader_position_snapshots.last_refreshed_at with traders.last_synced as fallback, covering pnl.unrealized, the open-position aggregate) and leaderboard_pnl (trader_profile_provider_snapshots.observed_at, covering pnl.total: unavailable when Polymarket's all-time leaderboard has no current observation ranking the wallet). The positions clock is the latest successful /positions snapshot when one exists, otherwise the last completed trader sync; it does not date closed or native accounting values. 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. */
2754
2639
  data_quality: DataQuality;
2755
2640
  /** Field-level trust metadata. Present only when expand=trust or expand[]=trust is requested. */
2756
2641
  trust?: TraderTrust;
@@ -2808,7 +2693,7 @@ export type TraderContext = {
2808
2693
  unrealized_mtm: number;
2809
2694
  /** Cost basis (USD) currently tied up in open positions. */
2810
2695
  cost_basis_locked: number;
2811
- /** Win rate as a percentage (0-100): resolved_wins over resolved_decided. A resolved market that settled 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. */
2696
+ /** Win rate as a percentage (0-100): resolved_wins over resolved_decided. A resolved market that settled 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: this one when position_summary is present, else stats.win_rate. */
2812
2697
  resolved_win_rate: number | null;
2813
2698
  /** Resolved markets that settled at positive realized P&L: the win-rate numerator. Additive; null only on a summary cached before the field existed. */
2814
2699
  resolved_wins: number | null;
@@ -2819,7 +2704,7 @@ export type TraderContext = {
2819
2704
  };
2820
2705
  /** RFC3339 freshness of the OPEN-position-level data: when a position_summary is present this mirrors its as_of byte-for-byte (latest /positions snapshot, else last completed sync) -- the open-position freshness clock, since the snapshot advances only open positions; otherwise the trader's last completed sync, even if an unserved position snapshot exists. Null when the selected clock is unavailable; a missing breakdown does not establish position or accounting freshness. */
2821
2706
  data_as_of: string | null;
2822
- /** Human-readable statement of the point-in-time snapshot semantics (data_as_of is the open-position clock -- the latest /positions snapshot, else the last completed sync; the snapshot advances only open positions, so resolved counts and win rate date to the last full sync; native realized P&L follows its accounting snapshot -- not a live feed; re-fetch for fresher data). */
2707
+ /** Human-readable statement of the point-in-time snapshot semantics (data_as_of is the open-position clock -- the latest /positions snapshot, else the last completed sync; the snapshot advances only open positions, so resolved counts and win rate can include settled markets recorded after the last full sync; native realized P&L follows its accounting snapshot -- not a live feed; re-fetch for fresher data). */
2823
2708
  freshness_note: string;
2824
2709
  };
2825
2710
  export type TraderEsportsGameRecord = {
@@ -3020,6 +2905,7 @@ export type TraderPnl = {
3020
2905
  entries?: {
3021
2906
  date: string;
3022
2907
  markets_traded?: number;
2908
+ /** Cash in USD this wallet traded on this UTC day, buys and sells, summed from the fills 0xinsider has stored for it. Not Polymarket's share count, and not the full-history stats.total_volume on GET /api/v1/trader/{address}. Omitted, with markets_traded, on a day above 20 times the wallet's median day. */
3023
2909
  total_volume?: number;
3024
2910
  cumulative_profit?: number;
3025
2911
  total_pnl?: number;
@@ -3106,7 +2992,7 @@ export type TraderPnlExact = {
3106
2992
  };
3107
2993
  /** Lossless counterparts for trader statistics. The object is omitted when the verified provider observation is unavailable. */
3108
2994
  export type TraderStatsExact = {
3109
- /** Full-history both-sides Polymarket user-volume atom from the verified `trader_usd_volume` observation. */
2995
+ /** stats.total_volume as an exact decimal: full-history both-sides cash volume in USD, Polymarket user-volume `volume_usdc`, from the verified `trader_usd_volume` observation. Never Polymarket's share count. */
3110
2996
  total_volume: ExactDecimal;
3111
2997
  };
3112
2998
  /** Field-level trust metadata returned only when GET /api/v1/trader/{address} includes expand=trust. */
@@ -3619,6 +3505,7 @@ export interface OperationData {
3619
3505
  getCombosSummary: CombosSummary;
3620
3506
  getCoverage: Platforms;
3621
3507
  getDailyReportSnapshot: ReportSnapshot;
3508
+ getEdgeHunter: EdgeHunterBoard;
3622
3509
  getEventReplaySince: EventReplayEvent[];
3623
3510
  getGame: Game;
3624
3511
  getHealth: {
@@ -3819,12 +3706,8 @@ export interface OperationData {
3819
3706
  listLargeTrades: LargeTrade[];
3820
3707
  listLeaderboard: LeaderboardEntry[];
3821
3708
  listPositions: Position[];
3822
- listPreGameSideObservations: PreGameSideObservation[];
3823
- listPreGameSides: PreGameSide[];
3824
3709
  listSharpMoneyFlows: SmartMoneyFlowMarket[];
3825
3710
  listSmartMoneyFlows: SmartMoneyFlowMarket[];
3826
- listSportsEdgeObservations: PreGameSideObservation[];
3827
- listSportsEdgeSignals: PreGameSide[];
3828
3711
  listSuspiciousTrades: SuspiciousTrade[];
3829
3712
  listTrendingWallets: TrendingWallet[];
3830
3713
  listWebhookDeliveries: WebhookDelivery[];
@@ -3983,6 +3866,10 @@ export interface OperationQuery {
3983
3866
  /** UTC report date in YYYY-MM-DD format, from 2024-03-01 (the first day report data covers) through tomorrow UTC. Any other date returns 400 bad_request with error.param=date. */
3984
3867
  date: string;
3985
3868
  };
3869
+ getEdgeHunter: {
3870
+ /** Kickoff window in hours from the snapshot anchor. Defaults to 48; integer values below 1 or above 48 are clamped to 1 or 48. */
3871
+ horizon_hours?: number;
3872
+ };
3986
3873
  getEventReplaySince: {
3987
3874
  /** Opaque event replay cursor returned as next_cursor by a prior response. The cursor maps to the global (whale_alerts.inserted_xid, whale_alerts.id) commit-order position, is valid across backend replicas, and is bound to the filter set the walk ran with (trader, condition_id, min_grade, min_size): presenting it under different filters answers 400 bad_request with error.reason cursor_expired, and the walk restarts without a cursor. Cursors issued before 2026-09-22 (id-only) stay accepted and are bound to no filters. Omit to fetch the latest durable public suffix. */
3988
3875
  cursor?: string;
@@ -4159,7 +4046,7 @@ export interface OperationQuery {
4159
4046
  listGames: {
4160
4047
  /** 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. */
4161
4048
  sport?: string;
4162
- /** League tag, case-insensitive, as coverage.leagues spells it: nfl, epl, cs2. Omit for every league inside the selected sports. */
4049
+ /** 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. */
4163
4050
  league?: string;
4164
4051
  /** Keep only games in this state. A value outside the enum returns an empty page. */
4165
4052
  status?: "scheduled" | "live" | "paused" | "ended" | "postponed" | "cancelled" | "suspended" | "delayed" | "unknown";
@@ -4283,7 +4170,7 @@ export interface OperationQuery {
4283
4170
  min_size?: number;
4284
4171
  /** Exact match against provider-backed market_canonical.category. */
4285
4172
  category?: string;
4286
- /** Scope to one market. Accepts the raw provider condition_id or the mkt_-prefixed market id emitted by V1 responses. Combine with min_size=0 for every reconciled position in that market; an unknown id returns []. */
4173
+ /** Scope to one market. Accepts the raw provider condition_id or the mkt_-prefixed market id emitted by V1 responses. Combine with min_size=0 for every reconciled position in that market; an unknown id or a resolved market returns []. */
4287
4174
  condition_id?: string;
4288
4175
  /** Scope to one wallet or a book of wallets (repeatable, up to 25 per request; comma-separated values inside one occurrence also work). Each value is a wallet address, a known username, or a trd_-prefixed trader id, resolved like /api/v1/trader/{address}. The response keeps the board's order and cursor, so pages of a book interleave wallets by current_value_usd. An address this API has never tracked returns its mirror rows or an empty list; a username or trader id that resolves to nothing is a 404 naming wallet; more than 25 values is a 400. min_size defaults to 0 when wallet is present. */
4289
4176
  wallet?: string[];
@@ -4294,28 +4181,6 @@ export interface OperationQuery {
4294
4181
  /** Filter by the binary outcome side. `yes` maps to outcome_index=0, `no` to outcome_index=1. */
4295
4182
  side?: "yes" | "no";
4296
4183
  };
4297
- listPreGameSideObservations: {
4298
- /** Observation cohort. wider_holder measures pre-game holder piles outside the funded route's exact raw signals admission. in_play admits only provider-confirmed live games and excludes stale or unavailable provider live-board, holder, or directional evidence. emerging_pile is a post-compute wider_holder projection for finite sharp_pct in [0.75, 0.85) with holder_scan_complete=true and a kickoff after its pinned projection cutoff; it overlaps wider_holder, is not an independent denominator, and is not arrival history. */
4299
- cohort: "wider_holder" | "in_play" | "emerging_pile";
4300
- /** Optional canonical sport bucket. Omitted or blank selects all registered sports. Raw provider categories resolve through the canonical taxonomy, including table-tennis or table tennis to Table Tennis and pickleball to Pickleball; a non-sport category returns an empty list. */
4301
- category?: string;
4302
- /** Page size. Out-of-range values are clamped to 1..100. */
4303
- limit?: number;
4304
- /** Server-authenticated opaque seo_v2_ cursor from next_cursor. Pins snapshot_as_of, cohort, rank, and condition_id; pre-deploy unsigned seo_ cursors are rejected, so clients must request the first page after this contract ships; emerging_pile cursors also pin the first-page projection_now cutoff so kickoff filtering cannot renumber continuation pages. Client edits fail closed; it cannot cross cohorts; a refreshed snapshot invalidates it with 400. */
4305
- cursor?: string;
4306
- };
4307
- listPreGameSides: {
4308
- /** Optional canonical sport bucket filter (e.g. Basketball, Tennis, Soccer). A raw provider value (NBA) resolves to its canonical bucket. A non-sport category returns an empty list. */
4309
- category?: string;
4310
- /** Page size. Out-of-range values are clamped to 1..100. */
4311
- limit?: number;
4312
- /** Opaque cursor from a previous response's next_cursor. Encodes the snapshot anchor plus the last row's directional_rank_score, conviction_score, smart_score and condition_id. A cursor from an expired snapshot returns 400. */
4313
- cursor?: string;
4314
- /** Kickoff ceiling in hours from now; the floor is now (only games not yet started). Clamped to 1..48. */
4315
- horizon_hours?: number;
4316
- /** Minimum trader grade required on the piled side. Only S, A, B are accepted (the piled-side grade distribution is S/A/B only; C, D, F return 400). Default B means at least one S/A/B holder is piled; S requires an S holder, A requires an S or A holder. */
4317
- min_grade?: "S" | "A" | "B";
4318
- };
4319
4184
  listSharpMoneyFlows: {
4320
4185
  /** Lookback window for grade-filtered whale flow aggregation. */
4321
4186
  timeframe?: "1h" | "4h" | "24h" | "7d";
@@ -4348,28 +4213,6 @@ export interface OperationQuery {
4348
4213
  /** Optional post-aggregate flow direction filter. */
4349
4214
  direction?: "YES" | "NO";
4350
4215
  };
4351
- listSportsEdgeObservations: {
4352
- /** Observation cohort. wider_holder measures pre-game holder piles outside the funded route's exact raw signals admission. in_play admits only provider-confirmed live games and excludes stale or unavailable provider live-board, holder, or directional evidence. emerging_pile is a post-compute wider_holder projection for finite sharp_pct in [0.75, 0.85) with holder_scan_complete=true and a kickoff after its pinned projection cutoff; it overlaps wider_holder, is not an independent denominator, and is not arrival history. */
4353
- cohort: "wider_holder" | "in_play" | "emerging_pile";
4354
- /** Optional canonical sport bucket. Omitted or blank selects all registered sports. Raw provider categories resolve through the canonical taxonomy, including table-tennis or table tennis to Table Tennis and pickleball to Pickleball; a non-sport category returns an empty list. */
4355
- category?: string;
4356
- /** Page size. Out-of-range values are clamped to 1..100. */
4357
- limit?: number;
4358
- /** Server-authenticated opaque seo_v2_ cursor from next_cursor. Pins snapshot_as_of, cohort, rank, and condition_id; pre-deploy unsigned seo_ cursors are rejected, so clients must request the first page after this contract ships; emerging_pile cursors also pin the first-page projection_now cutoff so kickoff filtering cannot renumber continuation pages. Client edits fail closed; it cannot cross cohorts; a refreshed snapshot invalidates it with 400. */
4359
- cursor?: string;
4360
- };
4361
- listSportsEdgeSignals: {
4362
- /** Optional canonical sport bucket filter (e.g. Basketball, Tennis, Soccer). A raw provider value (NBA) resolves to its canonical bucket. A non-sport category returns an empty list. */
4363
- category?: string;
4364
- /** Page size. Out-of-range values are clamped to 1..100. */
4365
- limit?: number;
4366
- /** Opaque cursor from a previous response's next_cursor. Encodes the snapshot anchor plus the last row's directional_rank_score, conviction_score, smart_score and condition_id. A cursor from an expired snapshot returns 400. */
4367
- cursor?: string;
4368
- /** Kickoff ceiling in hours from now; the floor is now (only games not yet started). Clamped to 1..48. */
4369
- horizon_hours?: number;
4370
- /** Minimum trader grade required on the piled side. Only S, A, B are accepted (the piled-side grade distribution is S/A/B only; C, D, F return 400). Default B means at least one S/A/B holder is piled; S requires an S holder, A requires an S or A holder. */
4371
- min_grade?: "S" | "A" | "B";
4372
- };
4373
4216
  listSuspiciousTrades: {
4374
4217
  /** Maximum number of suspicious trades to return. Out-of-range values are clamped to 1..100. */
4375
4218
  limit?: number;
@@ -4532,6 +4375,7 @@ export interface OperationPath {
4532
4375
  getCombosSummary: Record<string, never>;
4533
4376
  getCoverage: Record<string, never>;
4534
4377
  getDailyReportSnapshot: Record<string, never>;
4378
+ getEdgeHunter: Record<string, never>;
4535
4379
  getEventReplaySince: Record<string, never>;
4536
4380
  getGame: {
4537
4381
  /** The game's event slug, for example nfl-buf-nyj-2026-09-22. Matched case-insensitively. */
@@ -4663,12 +4507,8 @@ export interface OperationPath {
4663
4507
  listLargeTrades: Record<string, never>;
4664
4508
  listLeaderboard: Record<string, never>;
4665
4509
  listPositions: Record<string, never>;
4666
- listPreGameSideObservations: Record<string, never>;
4667
- listPreGameSides: Record<string, never>;
4668
4510
  listSharpMoneyFlows: Record<string, never>;
4669
4511
  listSmartMoneyFlows: Record<string, never>;
4670
- listSportsEdgeObservations: Record<string, never>;
4671
- listSportsEdgeSignals: Record<string, never>;
4672
4512
  listSuspiciousTrades: Record<string, never>;
4673
4513
  listTrendingWallets: Record<string, never>;
4674
4514
  listWebhookDeliveries: {
@@ -4767,6 +4607,7 @@ export interface OperationBody {
4767
4607
  getCombosSummary: never;
4768
4608
  getCoverage: never;
4769
4609
  getDailyReportSnapshot: never;
4610
+ getEdgeHunter: never;
4770
4611
  getEventReplaySince: never;
4771
4612
  getGame: never;
4772
4613
  getHealth: never;
@@ -4813,12 +4654,8 @@ export interface OperationBody {
4813
4654
  listLargeTrades: never;
4814
4655
  listLeaderboard: never;
4815
4656
  listPositions: never;
4816
- listPreGameSideObservations: never;
4817
- listPreGameSides: never;
4818
4657
  listSharpMoneyFlows: never;
4819
4658
  listSmartMoneyFlows: never;
4820
- listSportsEdgeObservations: never;
4821
- listSportsEdgeSignals: never;
4822
4659
  listSuspiciousTrades: never;
4823
4660
  listTrendingWallets: never;
4824
4661
  listWebhookDeliveries: never;
@@ -4931,6 +4768,11 @@ export interface OperationResponse {
4931
4768
  data: OperationData["getDailyReportSnapshot"];
4932
4769
  meta: ResponseMeta;
4933
4770
  };
4771
+ getEdgeHunter: {
4772
+ object: "edge_hunter";
4773
+ data: OperationData["getEdgeHunter"];
4774
+ meta: ResponseMeta;
4775
+ };
4934
4776
  getEventReplaySince: {
4935
4777
  object: "event_replay";
4936
4778
  data: OperationData["getEventReplaySince"];
@@ -5196,27 +5038,6 @@ export interface OperationResponse {
5196
5038
  };
5197
5039
  meta: ResponseMeta;
5198
5040
  };
5199
- listPreGameSideObservations: {
5200
- object: "list";
5201
- data: OperationData["listPreGameSideObservations"];
5202
- has_more: boolean;
5203
- /** Pass as cursor for the next page. Always sent; null on the last page. */
5204
- next_cursor: string | null;
5205
- /** Completion time of the shared observation snapshot pinned by the cursor. */
5206
- snapshot_as_of: string;
5207
- /** True when an operational failure or unknown provider-board, holder, directional, reconciliation, or internal completeness state made this snapshot partial. This is snapshot-wide and can retain degradation that the funnel's one-terminal-per-input accounting cannot represent. Intentional bounded capacity_limited rows remain fully accounted in the funnel and do not by themselves set this field. */
5208
- degraded: boolean;
5209
- funnel: PreGameSideFunnelReport;
5210
- meta: ResponseMeta;
5211
- };
5212
- listPreGameSides: {
5213
- object: "list";
5214
- data: OperationData["listPreGameSides"];
5215
- has_more: boolean;
5216
- next_cursor?: string;
5217
- total?: number;
5218
- meta: ResponseMeta;
5219
- };
5220
5041
  listSharpMoneyFlows: {
5221
5042
  object: "list";
5222
5043
  data: OperationData["listSharpMoneyFlows"];
@@ -5233,27 +5054,6 @@ export interface OperationResponse {
5233
5054
  total?: number;
5234
5055
  meta: ResponseMeta;
5235
5056
  };
5236
- listSportsEdgeObservations: {
5237
- object: "list";
5238
- data: OperationData["listSportsEdgeObservations"];
5239
- has_more: boolean;
5240
- /** Pass as cursor for the next page. Always sent; null on the last page. */
5241
- next_cursor: string | null;
5242
- /** Completion time of the shared observation snapshot pinned by the cursor. */
5243
- snapshot_as_of: string;
5244
- /** True when an operational failure or unknown provider-board, holder, directional, reconciliation, or internal completeness state made this snapshot partial. This is snapshot-wide and can retain degradation that the funnel's one-terminal-per-input accounting cannot represent. Intentional bounded capacity_limited rows remain fully accounted in the funnel and do not by themselves set this field. */
5245
- degraded: boolean;
5246
- funnel: PreGameSideFunnelReport;
5247
- meta: ResponseMeta;
5248
- };
5249
- listSportsEdgeSignals: {
5250
- object: "list";
5251
- data: OperationData["listSportsEdgeSignals"];
5252
- has_more: boolean;
5253
- next_cursor?: string;
5254
- total?: number;
5255
- meta: ResponseMeta;
5256
- };
5257
5057
  listSuspiciousTrades: {
5258
5058
  object: "list";
5259
5059
  data: OperationData["listSuspiciousTrades"];