0xinsider · Schema

EventReplayEvent

SportsEsportsAnalyticsFinance

Properties

Name Type Description
id string Opaque event identity: the ef_-encoded whale_alerts.id, stable across cursor formats. Deduplicate on this, never on cursor or sequence.
type string
cursor string Cursor positioned at this event: its (inserted_xid, id) commit-order position. Store the page's next_cursor to continue; this one resumes from exactly this event.
sequence integer whale_alerts.id of the event. Not monotonic across a replay: events arrive in commit order, so a lower id can follow a higher one when its write finished later. Order and resume by cursor, deduplicate
published_at string
payload object What the event announces. Every field is present on every event; a field added later is additive, so a client tolerates keys it does not know.
trade object Present only with expand=trade: the base trade fields for this row, read at request time from one query per page. GET /api/v1/large-trades/{id} adds counterparty_analysis; replay does not include it.
source object
freshness object
View JSON Schema on GitHub

JSON Schema

0xinsider-com-event-replay-event-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/0xinsider-com/json-schema/0xinsider-com-event-replay-event-schema.json",
  "title": "EventReplayEvent",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/0xinsider-com-events-api-openapi.yml#/components/schemas/EventReplayEvent",
  "type": "object",
  "required": [
    "id",
    "type",
    "cursor",
    "sequence",
    "published_at",
    "payload",
    "source",
    "freshness"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Opaque event identity: the ef_-encoded whale_alerts.id, stable across cursor formats. Deduplicate on this, never on cursor or sequence."
    },
    "type": {
      "type": "string",
      "enum": [
        "whale_trades_inserted"
      ]
    },
    "cursor": {
      "type": "string",
      "description": "Cursor positioned at this event: its (inserted_xid, id) commit-order position. Store the page's next_cursor to continue; this one resumes from exactly this event."
    },
    "sequence": {
      "type": "integer",
      "minimum": 1,
      "description": "whale_alerts.id of the event. Not monotonic across a replay: events arrive in commit order, so a lower id can follow a higher one when its write finished later. Order and resume by cursor, deduplicate by id."
    },
    "published_at": {
      "type": "string",
      "format": "date-time"
    },
    "payload": {
      "type": "object",
      "description": "What the event announces. Every field is present on every event; a field added later is additive, so a client tolerates keys it does not know.",
      "required": [
        "count",
        "whale_alert_id",
        "condition_id",
        "trader_id",
        "platform"
      ],
      "properties": {
        "count": {
          "type": "integer",
          "minimum": 1,
          "description": "Whale trades this event announces. One event is minted per stored whale trade, so this is 1."
        },
        "whale_alert_id": {
          "type": "integer",
          "minimum": 1,
          "description": "The raw whale_alerts.id of the trade, the same number as sequence. GET /api/v1/whale-trades/{id} accepts it and returns the trade with its wallet, grade, size, price and market."
        },
        "condition_id": {
          "type": "string",
          "description": "The Polymarket condition id of the market the trade was in."
        },
        "trader_id": {
          "type": "integer",
          "description": "0xinsider's numeric id for the wallet's trader row. It is not the trd_ id, which is derived from the address; read the address and grade from the whale trade."
        },
        "platform": {
          "type": "string",
          "enum": [
            "polymarket"
          ],
          "description": "Provider discriminator. Polymarket only."
        }
      },
      "additionalProperties": true
    },
    "trade": {
      "oneOf": [
        {
          "$ref": "#/$defs/LargeTrade"
        },
        {
          "type": "null"
        }
      ],
      "description": "Present only with expand=trade: the base trade fields for this row, read at request time from one query per page. GET /api/v1/large-trades/{id} adds counterparty_analysis; replay does not include it. traded_at, side, size_usd, price, outcome, token_id, recorded_signal_score and trader.grade_at_trade with its status are the row's event-time facts; trader.grade, trader.username, signal_score, suspicion_score, suspicion_track and market title/slug/category are enrichment that can move after the event. null when that route would answer 404 for the row (its trader or market is not synced yet)."
    },
    "source": {
      "$ref": "#/$defs/EventReplaySource"
    },
    "freshness": {
      "$ref": "#/$defs/EventReplayFreshness"
    }
  },
  "$defs": {
    "EventReplayFreshness": {
      "type": "object",
      "required": [
        "status",
        "observed_at"
      ],
      "properties": {
        "status": {
          "type": "string",
          "const": "observed"
        },
        "observed_at": {
          "type": "string",
          "format": "date-time"
        }
      }
    },
    "EventReplaySource": {
      "type": "object",
      "required": [
        "kind",
        "producer_family",
        "owner",
        "provider_fetch_at_request_time"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "const": "local_durable_replay"
        },
        "producer_family": {
          "type": "string",
          "enum": [
            "whale_trades"
          ]
        },
        "owner": {
          "type": "string",
          "const": "whale_alerts"
        },
        "provider_fetch_at_request_time": {
          "type": "boolean",
          "const": false
        }
      }
    },
    "LargeTrade": {
      "type": "object",
      "required": [
        "id",
        "traded_at",
        "size_usd",
        "side",
        "outcome",
        "token_id",
        "price",
        "review_score",
        "signal_score",
        "recorded_review_score",
        "recorded_signal_score",
        "suspicion_score",
        "suspicion_track",
        "trader",
        "market"
      ],
      "properties": {
        "id": {
          "type": "string",
          "description": "Prefixed ID (wt_...)."
        },
        "traded_at": {
          "type": "string",
          "format": "date-time"
        },
        "size_usd": {
          "type": "number"
        },
        "side": {
          "type": "string",
          "enum": [
            "BUY",
            "SELL"
          ]
        },
        "outcome": {
          "type": [
            "string",
            "null"
          ],
          "description": "Traded outcome label (e.g. \"Yes\"/\"No\"/team name), resolved provider-first from the trade's outcome_index against market_canonical (index 0 -> yes, 1 -> no). Distinct axis from side (BUY/SELL): side is the trade direction, outcome is which leg was traded. null for multi-outcome (outcome_index >= 2) or unsynced markets, and for a Polymarket trade recorded before 2026-04-02T00:00:00Z unless its stored outcome_index was verified against the fill's own trade records (before that date the stored index was wrong for a large share of trades; an unverified side is unknown, not defaulted)."
        },
        "token_id": {
          "type": [
            "string",
            "null"
          ],
          "description": "The Polymarket CLOB token id (ERC1155 asset id, decimal string) for the traded outcome; null when unavailable (e.g. unsynced markets) and for a Polymarket trade recorded before 2026-04-02T00:00:00Z whose traded side is not verified (the same rule as outcome)."
        },
        "price": {
          "type": "number"
        },
        "review_score": {
          "type": "number",
          "description": "Current trade review score on a 0..1 scale; higher values indicate a stronger review signal. This is the current response value and can differ from the recorded score. Missing measurements remain unavailable."
        },
        "signal_score": {
          "deprecated": true,
          "type": "number",
          "description": "Deprecated alias of review_score with the same current value and 0..1 scale. Sunset 2027-02-01 (#29352): removed from V1 on that date; read review_score."
        },
        "recorded_review_score": {
          "type": [
            "number",
            "null"
          ],
          "description": "0.0–1.0 review score written once when the trade row is inserted, from the trader's statistics at that moment. Populated from 2026-08-03T11:59Z; older rows return null and are never backfilled, because a backfill could only read today's statistics. If a trade is added later, its time-sensitive recorded score reflects that delay. Canonical since #16311; recorded_signal_score carries the same value."
        },
        "recorded_signal_score": {
          "deprecated": true,
          "type": [
            "number",
            "null"
          ],
          "description": "0.0–1.0 review score written once when the trade row is inserted; null before 2026-08-03T11:59Z. Deprecated (#16311): `recorded_review_score` is the canonical spelling and carries the same value; this key stays on the wire until its sunset on 2027-02-01 (#29352), when it is removed."
        },
        "suspicion_score": {
          "type": [
            "integer",
            "null"
          ],
          "minimum": 0,
          "maximum": 100,
          "description": "Persisted live suspicion score from the scorer. Null when the row has no persisted score."
        },
        "suspicion_track": {
          "type": [
            "string",
            "null"
          ],
          "enum": [
            "whale",
            "fresh_conviction",
            "sliced_position",
            null
          ],
          "description": "Persisted scorer track. Null when a legacy row has no stored track label."
        },
        "market_volume_share": {
          "type": "number",
          "minimum": 0,
          "maximum": 1,
          "description": "This fill's size relative to its market: its share count (size_usd / price) divided by the shares the market has traded, Polymarket's recorded volume, which counts shares rather than dollars, as observed at or after the trade, so the value always falls between 0 and 1 inclusive. A 20,000-share fill is 0.00005 of a market that has traded 400M shares and 0.125 of one that has traded 160,000, which size_usd alone cannot distinguish. Absent when no volume figure recorded at or after the trade is available, or when that figure is smaller than the fill; never 0 as a stand-in and never capped at 1, because a denominator we cannot trust publishes nothing rather than a trimmed number. A market's volume keeps growing, so the same trade reports a smaller share as the market trades on."
        },
        "trader": {
          "type": "object",
          "required": [
            "id",
            "address",
            "grade_at_trade",
            "grade_at_trade_status"
          ],
          "properties": {
            "id": {
              "type": "string"
            },
            "address": {
              "type": "string"
            },
            "username": {
              "type": "string"
            },
            "grade": {
              "type": "string",
              "description": "The trader's grade today, on every row however old. For what the grade was when the trade happened, read grade_at_trade."
            },
            "grade_at_trade": {
              "type": [
                "string",
                "null"
              ],
              "enum": [
                "S",
                "A",
                "B",
                "C",
                "D",
                "F",
                null
              ],
              "description": "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."
            },
            "grade_at_trade_status": {
              "type": "string",
              "enum": [
                "graded",
                "ungraded",
                "unknown"
              ],
              "description": "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."
            }
          }
        },
        "market": {
          "type": "object",
          "required": [
            "id",
            "condition_id",
            "title"
          ],
          "properties": {
            "id": {
              "type": "string"
            },
            "condition_id": {
              "type": "string"
            },
            "title": {
              "type": "string"
            },
            "slug": {
              "type": "string"
            },
            "category": {
              "type": "string",
              "description": "Provider-backed market_canonical category."
            }
          }
        }
      }
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/0xinsider-com-event-replay-event"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.