Properties
| Name | Type | Description |
|---|---|---|
| kind | string | |
| generated_at | string | |
| source_range | object | |
| snapshot | object | |
| completeness | object | |
| reconciliation | object | |
| report | object |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/0xinsider-com/json-schema/0xinsider-com-report-snapshot-schema.json",
"title": "ReportSnapshot",
"x-generated": "2026-11-10",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/0xinsider-com-reports-api-openapi.yml#/components/schemas/ReportSnapshot",
"type": "object",
"required": [
"kind",
"generated_at",
"source_range",
"snapshot",
"completeness",
"reconciliation",
"report"
],
"properties": {
"kind": {
"type": "string",
"enum": [
"daily",
"weekly",
"monthly"
]
},
"generated_at": {
"type": "string",
"format": "date-time"
},
"source_range": {
"$ref": "#/$defs/ReportSourceRange"
},
"snapshot": {
"$ref": "#/$defs/SnapshotState"
},
"completeness": {
"$ref": "#/$defs/SnapshotCompleteness"
},
"reconciliation": {
"$ref": "#/$defs/ReportReconciliation"
},
"report": {
"$ref": "#/$defs/ReportPayload"
}
},
"$defs": {
"ReportPayload": {
"type": "object",
"required": [
"total_large_trades",
"total_whale_trades",
"total_large_trade_volume",
"total_whale_volume",
"biggest_trade_size",
"active_traders",
"top_large_trades",
"top_whale_trades",
"categories",
"grade_distribution",
"market_scope"
],
"properties": {
"total_large_trades": {
"description": "Canonical key since #16304; total_whale_trades is its deprecated spelling, emitted beside it with the same value until its sunset on 2027-02-01 (#29352).",
"type": [
"integer",
"null"
]
},
"total_whale_trades": {
"type": [
"integer",
"null"
]
},
"total_large_trade_volume": {
"description": "Canonical key since #16304; total_whale_volume is its deprecated spelling, emitted beside it with the same value until its sunset on 2027-02-01 (#29352).",
"type": [
"number",
"null"
]
},
"total_whale_volume": {
"type": [
"number",
"null"
]
},
"biggest_trade_size": {
"type": [
"number",
"null"
]
},
"active_traders": {
"type": [
"integer",
"null"
]
},
"top_large_trades": {
"description": "Canonical key since #16304; top_whale_trades is its deprecated spelling, emitted beside it with the same value until its sunset on 2027-02-01 (#29352).",
"type": [
"array",
"null"
],
"items": {
"type": "object",
"required": [
"outcome",
"side",
"title",
"size",
"price",
"token_id",
"id",
"trade_time",
"market_category",
"platform",
"name",
"pseudonym",
"trader_grade"
],
"properties": {
"outcome": {
"type": [
"string",
"null"
],
"description": "Provider outcome label for the traded side."
},
"side": {
"type": [
"string",
"null"
],
"description": "Trade direction (BUY or SELL), not the outcome side."
},
"title": {
"type": [
"string",
"null"
],
"description": "Market title."
},
"size": {
"type": [
"number",
"null"
],
"description": "Trade size in USD."
},
"price": {
"type": [
"number",
"null"
],
"description": "Trade price in provider [0, 1] units."
},
"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)."
},
"id": {
"type": [
"integer",
"null"
],
"format": "int64",
"description": "Whale trade id."
},
"trade_time": {
"type": [
"string",
"null"
],
"format": "date-time",
"description": "Trade timestamp (UTC)."
},
"market_category": {
"type": [
"string",
"null"
],
"description": "Provider market category."
},
"platform": {
"type": [
"string",
"null"
],
"enum": [
"polymarket",
null
],
"description": "Always polymarket, or null when the row carries no stored value."
},
"name": {
"type": [
"string",
"null"
],
"description": "Trader display name, when known."
},
"pseudonym": {
"type": [
"string",
"null"
],
"description": "Trader pseudonym, when no display name is known."
},
"trader_grade": {
"type": [
"string",
"null"
],
"description": "Trader grade (S-F) at snapshot time."
}
}
}
},
"top_whale_trades": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"required": [
"outcome",
"side",
"title",
"size",
"price",
"token_id",
"id",
"trade_time",
"market_category",
"platform",
"name",
"pseudonym",
"trader_grade"
],
"properties": {
"outcome": {
"type": [
"string",
"null"
],
"description": "Provider outcome label for the traded side."
},
"side": {
"type": [
"string",
"null"
],
"description": "Trade direction (BUY or SELL), not the outcome side."
},
"title": {
"type": [
"string",
"null"
],
"description": "Market title."
},
"size": {
"type": [
"number",
"null"
],
"description": "Trade size in USD."
},
"price": {
"type": [
"number",
"null"
],
"description": "Trade price in provider [0, 1] units."
},
"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)."
},
"id": {
"type": [
"integer",
"null"
],
"format": "int64",
"description": "Whale trade id."
},
"trade_time": {
"type": [
"string",
"null"
],
"format": "date-time",
"description": "Trade timestamp (UTC)."
},
"market_category": {
"type": [
"string",
"null"
],
"description": "Provider market category."
},
"platform": {
"type": [
"string",
"null"
],
"enum": [
"polymarket",
null
],
"description": "Always polymarket, or null when the row carries no stored value."
},
"name": {
"type": [
"string",
"null"
],
"description": "Trader display name, when known."
},
"pseudonym": {
"type": [
"string",
"null"
],
"description": "Trader pseudonym, when no display name is known."
},
"trader_grade": {
"type": [
"string",
"null"
],
"description": "Trader grade (S-F) at snapshot time."
}
}
}
},
"categories": {
"type": [
"array",
"null"
],
"items": {
"type": "object"
}
},
"grade_distribution": {
"type": [
"array",
"null"
],
"items": {
"type": "object"
},
"description": "Counts of current grades for distinct Polymarket traders with at least one whale alert in the report's source date range. The grade is the current projection at snapshot materialization time, not a historical grade at trade time. Traders without a current ranking projection are omitted; a null grade entry means the active trader's current grade is unavailable."
},
"market_scope": {
"type": "string",
"enum": [
"all_markets",
"sports_and_esports"
],
"description": "Which markets the report counts. sports_and_esports for a period that ends on or after 2026-10-21: totals, categories, top trades and the grade cohort cover sports and esports markets only. all_markets for an earlier period, whose stored report keeps every Polymarket market it published."
}
}
},
"ReportReconciliation": {
"type": "object",
"required": [
"volume_kind",
"whale_volume_source",
"notes"
],
"properties": {
"volume_kind": {
"type": "string",
"const": "local_whale_activity_volume"
},
"whale_volume_source": {
"type": "string",
"description": "Where the whale volume in this report is read from: the column name `whale_alerts.usdc_notional_num`, followed in parentheses by the reconciliation note the server attaches to it. The server has always sent the note with the name, so this is not a bare constant; match on the prefix, not the whole string."
},
"notes": {
"type": "string"
}
}
},
"ReportSourceRange": {
"type": "object",
"required": [
"start_date",
"end_date",
"timezone"
],
"properties": {
"start_date": {
"type": "string",
"format": "date"
},
"end_date": {
"type": "string",
"format": "date"
},
"timezone": {
"type": "string",
"const": "UTC"
}
}
},
"SnapshotCompleteness": {
"type": "object",
"required": [
"status",
"reason",
"expected_days",
"covered_days_with_large_trade_activity",
"covered_days_with_whale_activity"
],
"properties": {
"status": {
"type": "string",
"enum": [
"complete",
"partial",
"empty"
],
"description": "complete only on a final body (snapshot.status final). partial for a live range and for a closed range whose body was read before final_after; reason says which. empty when the range has no whale activity."
},
"reason": {
"type": "string"
},
"expected_days": {
"type": "integer"
},
"covered_days_with_large_trade_activity": {
"description": "Canonical key since #16304; covered_days_with_whale_activity is its deprecated spelling, emitted beside it with the same value until its sunset on 2027-02-01 (#29352).",
"type": "integer"
},
"covered_days_with_whale_activity": {
"deprecated": true,
"description": "Deprecated spelling of covered_days_with_large_trade_activity, emitted beside it with the same value. Sunset 2027-02-01 (#29352): removed from V1 on that date; read covered_days_with_large_trade_activity.",
"type": "integer"
}
}
},
"SnapshotState": {
"type": "object",
"required": [
"version",
"storage",
"status",
"generated_at",
"mutable_until",
"period_closed",
"final_after",
"source_read_started_at"
],
"properties": {
"version": {
"type": "integer",
"format": "int64",
"description": "Immutable content version for a durable report identity; 0 for an ephemeral explicit weekly from/to range."
},
"storage": {
"type": "string",
"enum": [
"durable",
"ephemeral"
],
"description": "durable for canonical daily, ISO-week, and monthly snapshot identities; ephemeral for explicit weekly from/to ranges, which are recomputed within a bounded 31-day window and never persisted."
},
"status": {
"type": "string",
"enum": [
"final",
"rolling"
],
"description": "final only for a body whose source read started at or after final_after (the UTC close of the range plus the whale-trade ingestion budget). rolling for a live range and for a closed range still inside that budget: such a body refreshes every five minutes, is rebuilt once after final_after, and is then frozen. Before 2026-09-22 a closed range read final from the calendar alone, even for a body built before the range ended (#16225)."
},
"generated_at": {
"type": "string",
"format": "date-time"
},
"mutable_until": {
"type": [
"string",
"null"
],
"format": "date",
"description": "For a rolling body, the UTC date on which a final body can first be built (the date of final_after); null once final."
},
"period_closed": {
"type": "boolean",
"description": "Whether the source range has ended on the UTC calendar. Closing is not finality: a closed range is rolling until final_after."
},
"final_after": {
"type": "string",
"format": "date-time",
"description": "The instant a source read must start at or after to produce a final body: the range's UTC close plus 7,530 s, the whale-trade ingestion budget (p95 block lag gate plus the projection retry budget)."
},
"source_read_started_at": {
"type": [
"string",
"null"
],
"format": "date-time",
"description": "When this body's source read started, the clock finality is judged on. null for a body stored before that clock was recorded."
}
}
}
}
}
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-report-snapshot"
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.