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 |
JSON Schema
{
"$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.
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.