0xinsider · Schema

Position

SportsEsportsAnalyticsFinance

Properties

Name Type Description
id string Composite prefixed ID `pos_::`.
platform string Provider discriminator. Polymarket only.
wallet string Lowercased proxy wallet address.
side string Binary outcome side. Non-binary positions are not surfaced on V1.
token_id stringnull The Polymarket CLOB token id (ERC1155 asset id, decimal string) for this outcome; null when unavailable (e.g. unsynced markets).
shares number Live share count from the wallet_positions mirror.
avg_price number Volume-weighted entry price for this leg.
current_value_usd number Current mark-to-market value in USD (always non-null on V1 — pre-reconcile rows are excluded).
initial_value_usd number
cash_pnl number Unrealized P&L for the open position (Polymarket `cashPnl`).
realized_pnl number Closed-leg P&L rolled up (Polymarket `realizedPnl`).
exact object Additive lossless source atoms for the display-safe position fields. Parse every `value` with decimal-safe arithmetic; never recover exact values from the numeric twins.
last_reconciled_at string Max updated_at across mirror legs for this pair.
freshness string Backend-computed staleness bucket derived from last_reconciled_at.
trader object
market object
View JSON Schema on GitHub

JSON Schema

0xinsider-com-position-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/0xinsider-com/json-schema/0xinsider-com-position-schema.json",
  "title": "Position",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/0xinsider-com-positions-api-openapi.yml#/components/schemas/Position",
  "type": "object",
  "required": [
    "id",
    "platform",
    "wallet",
    "side",
    "token_id",
    "shares",
    "current_value_usd",
    "freshness",
    "trader",
    "market"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Composite prefixed ID `pos_<wallet>:<condition_id>:<outcome_index>`."
    },
    "platform": {
      "type": "string",
      "enum": [
        "polymarket"
      ],
      "description": "Provider discriminator. Polymarket only."
    },
    "wallet": {
      "type": "string",
      "description": "Lowercased proxy wallet address."
    },
    "side": {
      "type": "string",
      "enum": [
        "YES",
        "NO"
      ],
      "description": "Binary outcome side. Non-binary positions are not surfaced on V1."
    },
    "token_id": {
      "type": [
        "string",
        "null"
      ],
      "description": "The Polymarket CLOB token id (ERC1155 asset id, decimal string) for this outcome; null when unavailable (e.g. unsynced markets)."
    },
    "shares": {
      "type": "number",
      "description": "Live share count from the wallet_positions mirror."
    },
    "avg_price": {
      "type": "number",
      "description": "Volume-weighted entry price for this leg."
    },
    "current_value_usd": {
      "type": "number",
      "description": "Current mark-to-market value in USD (always non-null on V1 — pre-reconcile rows are excluded)."
    },
    "initial_value_usd": {
      "type": "number"
    },
    "cash_pnl": {
      "type": "number",
      "description": "Unrealized P&L for the open position (Polymarket `cashPnl`)."
    },
    "realized_pnl": {
      "type": "number",
      "description": "Closed-leg P&L rolled up (Polymarket `realizedPnl`)."
    },
    "exact": {
      "$ref": "#/$defs/PositionExact",
      "description": "Additive lossless source atoms for the display-safe position fields. Parse every `value` with decimal-safe arithmetic; never recover exact values from the numeric twins."
    },
    "last_reconciled_at": {
      "type": "string",
      "format": "date-time",
      "description": "Max updated_at across mirror legs for this pair."
    },
    "freshness": {
      "type": "string",
      "enum": [
        "fresh",
        "refreshing",
        "stale",
        "unknown"
      ],
      "description": "Backend-computed staleness bucket derived from last_reconciled_at."
    },
    "trader": {
      "type": "object",
      "required": [
        "id",
        "address",
        "is_new_wallet"
      ],
      "properties": {
        "id": {
          "type": "string",
          "description": "Prefixed ID (`trd_...`)."
        },
        "address": {
          "type": "string"
        },
        "username": {
          "type": "string"
        },
        "grade": {
          "type": "string",
          "enum": [
            "S",
            "A",
            "B",
            "C",
            "D",
            "F"
          ]
        },
        "win_rate": {
          "type": "number",
          "description": "Sports and esports win rate as a ratio from 0 to 1 (0.62 means 62%): wins over the decided sports and esports markets on the wallet's record, the same figure as pnl.in_scope.win_rate and stats.win_rate on GET /api/v1/trader/{address}. Since 2026-10-27 it no longer counts other markets (#29953). Absent when the wallet has no record or no decided market."
        },
        "pnl": {
          "type": "number",
          "deprecated": true,
          "x-never-sent": true,
          "description": "Deprecated since 2026-10-27 and never sent. It was Polymarket's net total P&L over every Polymarket market of the wallet, and wallet figures cover sports and esports markets only (#29953). Read trader.in_scope_realized_pnl."
        },
        "in_scope_realized_pnl": {
          "type": "number",
          "description": "The wallet's realized P&L in USD on sports and esports markets, the figure the 0xinsider profile shows: the record behind pnl.in_scope.realized_pnl on GET /api/v1/trader/{address}, to cents. For a graded wallet it is read from the latest grading pass, so it can trail that figure until the next pass. Omitted until 0xinsider has computed the wallet's record (#29953)."
        },
        "markets": {
          "type": "integer",
          "description": "Sports and esports markets on the wallet's record, pnl.in_scope.markets on GET /api/v1/trader/{address}. Since 2026-10-27 it no longer counts other markets (#29953). Absent when the wallet has no record."
        },
        "wallet_age_days": {
          "type": "number",
          "description": "Days since the wallet's first-seen time. For a wallet 0xinsider first recorded on or after March 21, 2026, that is when 0xinsider recorded it. For a wallet recorded earlier, it is usually the wallet's first Polymarket activity, so the age can run to years. It is not the wallet's on-chain age or the time of its first trade. Absent when the first-seen time is unknown."
        },
        "is_new_wallet": {
          "type": "boolean",
          "description": "True when wallet_age_days is under the new-wallet threshold (30 days), which means 0xinsider first recorded the wallet in the last 30 days. False when wallet_age_days is absent. This public V1 field is first-seen recency, not the wallet's on-chain age."
        }
      }
    },
    "market": {
      "type": "object",
      "required": [
        "id",
        "condition_id",
        "title"
      ],
      "properties": {
        "id": {
          "type": "string",
          "description": "Prefixed ID (`mkt_...`)."
        },
        "condition_id": {
          "type": "string"
        },
        "title": {
          "type": "string"
        },
        "slug": {
          "type": "string"
        },
        "event_slug": {
          "type": "string"
        },
        "category": {
          "type": "string",
          "description": "Provider-backed market_canonical category."
        },
        "outcome_label": {
          "type": "string",
          "description": "Provider-reported outcome label (e.g. team name for sports). Separate from `side` because provider labels can diverge from the binary Yes/No axis."
        },
        "end_date": {
          "type": "string",
          "format": "date-time"
        }
      }
    }
  },
  "$defs": {
    "ExactDecimal": {
      "type": "object",
      "required": [
        "value",
        "unit",
        "scale",
        "basis"
      ],
      "description": "A lossless decimal atom rendered from the canonical NUMERIC or provider value. The value is a decimal string and must be parsed with a decimal library; it is never a display string and must not be converted through a binary float. `scale` is the source decimal scale. The field is omitted when its source is unavailable.",
      "properties": {
        "value": {
          "type": "string",
          "description": "Plain decimal text at full source precision, including a minus sign for negative values and trailing zeros when the source scale carries them. Parse as an arbitrary-precision decimal.",
          "pattern": "^-?(0|[1-9][0-9]*)(\\.[0-9]+)?$"
        },
        "unit": {
          "type": "string",
          "description": "Unit of the value, such as `USD`, `USD/share`, or `shares`."
        },
        "scale": {
          "type": "integer",
          "minimum": 0,
          "description": "Number of digits after the decimal point in `value`'s source atom."
        },
        "basis": {
          "type": "string",
          "description": "Backend-owned source or derivation basis. Treat it as provenance, not as a display label."
        }
      }
    },
    "PositionExact": {
      "type": "object",
      "required": [
        "shares",
        "current_value_usd"
      ],
      "description": "Lossless position atoms from `wallet_positions`. `shares` and `current_value_usd` are required when this object is present; other source values are omitted when the mirror has no verified value.",
      "properties": {
        "shares": {
          "$ref": "#/$defs/ExactDecimal"
        },
        "cost_basis_usd": {
          "$ref": "#/$defs/ExactDecimal"
        },
        "avg_price": {
          "$ref": "#/$defs/ExactDecimal",
          "description": "Exact derived price: `wallet_positions.cost_basis_usd / wallet_positions.shares`."
        },
        "current_value_usd": {
          "$ref": "#/$defs/ExactDecimal"
        },
        "initial_value_usd": {
          "$ref": "#/$defs/ExactDecimal"
        },
        "cash_pnl": {
          "$ref": "#/$defs/ExactDecimal"
        },
        "realized_pnl": {
          "$ref": "#/$defs/ExactDecimal"
        }
      }
    }
  }
}

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-position"
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.