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