0xinsider · Schema

LargeTrade

SportsEsportsAnalyticsFinance

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
View JSON Schema on GitHub

JSON Schema

0xinsider-com-large-trade-schema.json Raw ↑
{
  "$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.
All 92 tools →

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.