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