Properties
| Name | Type | Description |
|---|---|---|
| id | string | Prefixed ID (wt_...). |
| traded_at | string | |
| size_usd | number | |
| side | string | |
| outcome | stringnull | 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 |
| token_id | stringnull | 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 wh |
| price | number | |
| review_score | number | 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 unav |
| signal_score | number | 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 | numbernull | 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, becaus |
| recorded_signal_score | numbernull | 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 |
| suspicion_score | integernull | Persisted live suspicion score from the scorer. Null when the row has no persisted score. |
| suspicion_track | stringnull | Persisted scorer track. Null when a legacy row has no stored track label. |
| market_volume_share | number | 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 obser |
| trader | object | |
| market | object |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/0xinsider-com/json-schema/0xinsider-com-large-trade-schema.json",
"title": "LargeTrade",
"x-generated": "2026-11-10",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/0xinsider-com-large-trades-api-openapi.yml#/components/schemas/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-large-trade"
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.