Every wallet that holds (or has held) a position in a single market, grouped by outcome and sorted by P&L. The ‘who’s making money on this market’ feed.
GET
/
v1
/
markets
/
{id}
/
positions
Market positions & P&L
curl --request GET \ --url https://api.polynode.dev/v1/markets/{id}/positions \ --header 'x-api-key: <api-key>'
Returns every wallet with a position in a single market, broken out by outcome (e.g. Up/Down or Yes/No) and ranked by P&L. The natural feed for “top traders on this market” leaderboards, top-X-by-PnL widgets, and per-market trader audits.Path accepts either the market slug (e.g. btc-updown-5m-1777179000) or the condition_id (e.g. 0xa7ae8a41...). It does not accept an outcome token id — pass the market identifier, not the side.
Field shape is camelCase (avgPrice, realizedPnl, etc.) — distinct from polynode’s V2 onchain endpoints which use snake_case. Different schemas, different use cases. Default cap is 50 rows per outcome; configurable up to 500.
Drop positions with size < min_size from each outcome. Use min_size=0.0001 to filter to current holders only (excludes historical participants who closed out to zero).
includeTrades
boolean
query
When true, adds firstTradeAt / lastTradeAt (unix seconds) per row. Heavy — separate 20 req/min rate limit per key.
user
string
query
Filter to a single wallet, or up to 20 wallets comma-separated, scoped to this market.
TOTAL_PNL and REALIZED_PNL are sorted by Polymarket’s data-api directly. CURRENT_VALUE, SIZE, and INITIAL_VALUE are sorted in-process after the fetch (and after min_size if set), so they pair cleanly with the holder-filtering use case.
Default cap of 50 rows per outcome unless limit is set higher (max 500). On very large markets with deep tail traders, paginate with offset.
Sort ties on equal P&L are non-deterministic — two wallets at the same totalPnl may swap positions between calls. Use proxyWallet as a stable secondary key on the client side if you need consistent ordering.
size = 0 is normal on closed positions, redeemed positions, or fully-exited positions. Use realizedPnl and totalBought to detect history.
firstTradeAt / lastTradeAt require ?includeTrades=true and trip a separate heavy-endpoint rate limit (20 req/min per key). Don’t request it on every refresh — fetch once and cache.
Enrich each position with firstTradeAt and lastTradeAt timestamps. Responses will be slower. Default false. Rate limited to 60 requests per minute per key (separate from your standard rate limit).
Filter to specific wallet address(es). Accepts a single address or multiple comma-separated addresses (max 20). Returns only those wallets' positions in this market.
Response
Market positions grouped by outcome token
Holder positions for a market, grouped by outcome token.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"PolyNode","colors":{"primary":"#3b82f6","light":"#60a5fa","dark":"#2563eb"},"logo":{"light":"https://mintcdn.com/polynode/zluszUOhqmSDk1RK/images/logo-light.png?fit=max\u0026auto=format\u0026n=zluszUOhqmSDk1RK\u0026q=85\u0026s=fc49b798da5a361cb76f4733f13230dd","dark":"https://mintcdn.com/polynode/zluszUOhqmSDk1RK/images/logo-dark.png?fit=max\u0026auto=format\u0026n=zluszUOhqmSDk1RK\u0026q=85\u0026s=6d316edd9113e88a6c4e2973cc12438d"},"favicon":"https://mintcdn.com/polynode/zluszUOhqmSDk1RK/images/favicon.png?fit=max\u0026auto=format\u0026n=zluszUOhqmSDk1RK\u0026q=85\u0026s=0bf4f722dd9d5dddb849158b764adad4","api":{"playground":{}},"navbar":{"links":[{"href":"https://api.polynode.dev/v1/status","label":"API Status"}],"primary":{"type":"button","label":"Get API Key","href":"https://polynode.dev"}},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"polynode","hasAudioNarration":false,"actualSubdomain":"polynode","customDomains":["docs.polynode.dev"],"gitSource":{"type":"github","owner":"joinquantish","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{},"buildId":"6aec02b5baf429d562e676ed","clientVersion":"0.0.4094","searchFilterCounts":[{"language":"default","tag":"API Reference","count":245},{"language":"default","tag":"Query Catalog","count":67},{"language":"default","tag":"SDKs","count":51},{"language":"default","tag":"Guides","count":35},{"language":"default","tag":"Webhooks","count":26},{"language":"default","tag":"Changelog","count":23},{"language":"default","tag":"Archive","count":22},{"language":"default","tag":"WebSocket","count":21},{"language":"default","tag":"Perps Market Data","count":16},{"language":"default","tag":"Event Types","count":16}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/wallets/market-positions","slug":"/api-reference/wallets/market-positions","pageMetadata":{"title":"Top Traders (Market)","description":"Every wallet that holds (or has held) a position in a single market, grouped by outcome and sorted by P\u0026L. The 'who's making money on this market' feed.","openapi":"GET /v1/markets/{id}/positions","href":"/api-reference/wallets/market-positions"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Every wallet that holds (or has held) a position in a single market, grouped by outcome and sorted by P\u0026L. The ‘who’s making money on this market’ feed.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Note,Table}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Returns every wallet with a position in a single market, broken out by outcome (e.g. Up/Down or Yes/No) and ranked by P\u0026L. The natural feed for “top traders on this market” leaderboards, top-X-by-PnL widgets, and per-market trader audits.`}),`\n`,_jsxs(_components.p,{children:[`Path accepts either the `,_jsx(_components.strong,{children:`market slug`}),` (e.g. `,_jsx(_components.code,{children:`btc-updown-5m-1777179000`}),`) or the `,_jsx(_components.strong,{children:`condition_id`}),` (e.g. `,_jsx(_components.code,{children:`0xa7ae8a41...`}),`). It does `,_jsx(_components.strong,{children:`not`}),` accept an outcome token id — pass the market identifier, not the side.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Field shape is camelCase (`,_jsx(_components.code,{children:`avgPrice`}),`, `,_jsx(_components.code,{children:`realizedPnl`}),`, etc.) — distinct from polynode’s V2 onchain endpoints which use snake_case. Different schemas, different use cases. Default cap is 50 rows per outcome; configurable up to 500.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`request`,children:`Request`}),`\n`,_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`GET /v1/markets/{slug-or-condition-id}/positions`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Parameter`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Location`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`id`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`path`}),_jsxs(_components.td,{children:[`Market slug or condition_id (`,_jsx(_components.code,{children:`0x…`}),`). `,_jsx(_components.strong,{children:`Not`}),` an outcome token id.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`limit`})}),_jsx(_components.td,{children:`integer`}),_jsx(_components.td,{children:`query`}),_jsxs(_components.td,{children:[`Max rows per outcome. Default `,_jsx(_components.code,{children:`50`}),`, max `,_jsx(_components.code,{children:`500`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`offset`})}),_jsx(_components.td,{children:`integer`}),_jsx(_components.td,{children:`query`}),_jsx(_components.td,{children:`Skip first N rows.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`sortBy`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`query`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`TOTAL_PNL`}),` (default), `,_jsx(_components.code,{children:`REALIZED_PNL`}),`, `,_jsx(_components.code,{children:`CURRENT_VALUE`}),`, `,_jsx(_components.code,{children:`SIZE`}),`, `,_jsx(_components.code,{children:`INITIAL_VALUE`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`sortDirection`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`query`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`DESC`}),` (default) or `,_jsx(_components.code,{children:`ASC`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`status`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`query`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`OPEN`}),`, `,_jsx(_components.code,{children:`CLOSED`}),`, or `,_jsx(_components.code,{children:`ALL`}),` (default).`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`min_size`})}),_jsx(_components.td,{children:`number`}),_jsx(_components.td,{children:`query`}),_jsxs(_components.td,{children:[`Drop positions with `,_jsx(_components.code,{children:`size \u003c min_size`}),` from each outcome. Use `,_jsx(_components.code,{children:`min_size=0.0001`}),` to filter to current holders only (excludes historical participants who closed out to zero).`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`includeTrades`})}),_jsx(_components.td,{children:`boolean`}),_jsx(_components.td,{children:`query`}),_jsxs(_components.td,{children:[`When `,_jsx(_components.code,{children:`true`}),`, adds `,_jsx(_components.code,{children:`firstTradeAt`}),` / `,_jsx(_components.code,{children:`lastTradeAt`}),` (unix seconds) per row. Heavy — separate 20 req/min rate limit per key.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`user`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`query`}),_jsx(_components.td,{children:`Filter to a single wallet, or up to 20 wallets comma-separated, scoped to this market.`})]})]})]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`TOTAL_PNL`}),` and `,_jsx(_components.code,{children:`REALIZED_PNL`}),` are sorted by Polymarket’s data-api directly. `,_jsx(_components.code,{children:`CURRENT_VALUE`}),`, `,_jsx(_components.code,{children:`SIZE`}),`, and `,_jsx(_components.code,{children:`INITIAL_VALUE`}),` are sorted in-process after the fetch (and after `,_jsx(_components.code,{children:`min_size`}),` if set), so they pair cleanly with the holder-filtering use case.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`35`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`35`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"condition_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"0xa7ae8a4119fe00f231e693ed717339dd1e13da4617c79f3b1522ab1aee3965b6\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"market_title\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Bitcoin Up or Down - April 26, 12:50AM-12:55AM ET\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"slug\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"btc-updown-5m-1777179000\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"image\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://polymarket-upload.s3.us-east-2.amazonaws.com/BTC+fullsize.png\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"outcome_names\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Up\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Down\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`],`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"outcomes\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"token\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"90684694382683135738693577247532961739938461809085935450142382916430459093778\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"positions\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"proxyWallet\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"0x9a1d392572d0e6bfefbf9302101b9e44c8ee86d6\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"kq9000\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"profileImage\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"verified\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"asset\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"90684694382683135738693577247532961739938461809085935450142382916430459093778\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"conditionId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"0xa7ae8a4119fe00f231e693ed717339dd1e13da4617c79f3b1522ab1aee3965b6\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"outcome\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Up\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"outcomeIndex\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"size\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"avgPrice\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0.4592`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"currPrice\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"currentValue\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"totalBought\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1633.1987`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"realizedPnl\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`812.5754`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"cashPnl\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"totalPnl\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`812.5754`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"firstTradeAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1777179030`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"lastTradeAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1777179152`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"token\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"96824…\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"positions\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [ `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"…\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ] }`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`top-level-fields`,children:`Top-level fields`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`condition_id`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Market condition id`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`market_title`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Human-readable market question`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`slug`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Market slug`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`image`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Market image URL`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`outcome_names`})}),_jsx(_components.td,{children:`string[]`}),_jsxs(_components.td,{children:[`Ordered outcome labels (`,_jsx(_components.code,{children:`[\"Up\",\"Down\"]`}),`, `,_jsx(_components.code,{children:`[\"Yes\",\"No\"]`}),`, etc.)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`outcomes[]`})}),_jsx(_components.td,{children:`array`}),_jsxs(_components.td,{children:[`One entry per outcome — each holds a `,_jsx(_components.code,{children:`positions`}),` array`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`outcomes[].token`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Outcome token id`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`outcomes[].positions[]`})}),_jsx(_components.td,{children:`array`}),_jsxs(_components.td,{children:[`Traders with positions in this outcome, sorted by `,_jsx(_components.code,{children:`sortBy`})]})]})]})]}),`\n`,_jsxs(Heading,{level:`3`,id:`per-trader-fields-outcomes-positions`,children:[`Per-trader fields (`,_jsx(_components.code,{children:`outcomes[].positions[]`}),`)`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`proxyWallet`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Trader address (Gnosis Safe proxy)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`name`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Display name (often empty or auto-generated)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`profileImage`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Profile image URL (often empty)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`verified`})}),_jsx(_components.td,{children:`boolean`}),_jsx(_components.td,{children:`Verified flag`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`asset`})}),_jsx(_components.td,{children:`string`}),_jsxs(_components.td,{children:[`Outcome token id (same as `,_jsx(_components.code,{children:`outcomes[].token`}),`)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`conditionId`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Market condition id`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`outcome`})}),_jsx(_components.td,{children:`string`}),_jsxs(_components.td,{children:[`Outcome label (`,_jsx(_components.code,{children:`\"Up\"`}),`, `,_jsx(_components.code,{children:`\"No\"`}),`, etc.)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`outcomeIndex`})}),_jsx(_components.td,{children:`number`}),_jsxs(_components.td,{children:[`0-based position in `,_jsx(_components.code,{children:`outcome_names`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`size`})}),_jsx(_components.td,{children:`number`}),_jsxs(_components.td,{children:[`Current token balance. `,_jsx(_components.code,{children:`0`}),` = fully exited or never held.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`avgPrice`})}),_jsx(_components.td,{children:`number`}),_jsx(_components.td,{children:`Volume-weighted average entry price`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`currPrice`})}),_jsx(_components.td,{children:`number`}),_jsxs(_components.td,{children:[`Current market price (or terminal `,_jsx(_components.code,{children:`1.0`}),`/`,_jsx(_components.code,{children:`0.0`}),` for resolved markets)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`currentValue`})}),_jsx(_components.td,{children:`number`}),_jsxs(_components.td,{children:[`Mark-to-market value of remaining shares (`,_jsx(_components.code,{children:`size × currPrice`}),`)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`totalBought`})}),_jsx(_components.td,{children:`number`}),_jsx(_components.td,{children:`Lifetime tokens acquired`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`realizedPnl`})}),_jsx(_components.td,{children:`number`}),_jsx(_components.td,{children:`Realized P\u0026L from sells + redemptions, in USDC`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`cashPnl`})}),_jsx(_components.td,{children:`number`}),_jsx(_components.td,{children:`P\u0026L from cash flows (separate accounting axis)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`totalPnl`})}),_jsx(_components.td,{children:`number`}),_jsx(_components.td,{children:`Net portfolio P\u0026L for this position`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`firstTradeAt`})}),_jsx(_components.td,{children:`number`}),_jsxs(_components.td,{children:[`Unix seconds — only with `,_jsx(_components.code,{children:`?includeTrades=true`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`lastTradeAt`})}),_jsx(_components.td,{children:`number`}),_jsxs(_components.td,{children:[`Unix seconds — only with `,_jsx(_components.code,{children:`?includeTrades=true`})]})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`examples`,children:`Examples`}),`\n`,_jsx(Heading,{level:`3`,id:`top-10-traders-on-a-market-by-total-p\u0026l`,children:`Top 10 traders on a market by total P\u0026L`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.polynode.dev/v1/markets/btc-updown-5m-1777179000/positions?limit=10\u0026sortBy=TOTAL_PNL\u0026sortDirection=DESC\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"x-api-key: YOUR_KEY\"`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`by-condition_id-with-first/last-trade-timestamps`,children:`By condition_id, with first/last trade timestamps`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.polynode.dev/v1/markets/0xa7ae8a4119fe00f231e693ed717339dd1e13da4617c79f3b1522ab1aee3965b6/positions?includeTrades=true\u0026limit=20\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"x-api-key: YOUR_KEY\"`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`drill-into-specific-wallets-within-a-market`,children:`Drill into specific wallets within a market`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.polynode.dev/v1/markets/btc-updown-5m-1777179000/positions?user=0x9a1d392572d0e6bfefbf9302101b9e44c8ee86d6,0x44bd2993a69d8b569859ed8c0bf0b946f733f71a\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"x-api-key: YOUR_KEY\"`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`closed-positions-only`,children:`Closed positions only`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.polynode.dev/v1/markets/btc-updown-5m-1777179000/positions?status=CLOSED\u0026sortBy=REALIZED_PNL\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"x-api-key: YOUR_KEY\"`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`notes`,children:`Notes`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Default cap of 50 rows`}),` per outcome unless `,_jsx(_components.code,{children:`limit`}),` is set higher (max 500). On very large markets with deep tail traders, paginate with `,_jsx(_components.code,{children:`offset`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Sort ties on equal P\u0026L are non-deterministic`}),` — two wallets at the same `,_jsx(_components.code,{children:`totalPnl`}),` may swap positions between calls. Use `,_jsx(_components.code,{children:`proxyWallet`}),` as a stable secondary key on the client side if you need consistent ordering.`]}),`\n`,_jsxs(_components.li,{children:[_jsxs(_components.strong,{children:[_jsx(_components.code,{children:`size = 0`}),` is normal`]}),` on closed positions, redeemed positions, or fully-exited positions. Use `,_jsx(_components.code,{children:`realizedPnl`}),` and `,_jsx(_components.code,{children:`totalBought`}),` to detect history.`]}),`\n`,_jsxs(_components.li,{children:[_jsxs(_components.strong,{children:[_jsx(_components.code,{children:`firstTradeAt`}),` / `,_jsx(_components.code,{children:`lastTradeAt`}),` require `,_jsx(_components.code,{children:`?includeTrades=true`})]}),` and trip a separate heavy-endpoint rate limit (20 req/min per key). Don’t request it on every refresh — fetch once and cache.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`when-to-use-this-vs-other-position-endpoints`,children:`When to use this vs. other position endpoints`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`If you want`}),_jsx(_components.th,{children:`Use`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Top traders ranked on a single market`}),_jsx(_components.td,{children:_jsx(_components.strong,{children:`This endpoint`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`One wallet’s positions across all markets`}),_jsx(_components.td,{children:_jsx(_components.a,{href:`/api-reference/wallets/onchain-positions`,children:_jsx(_components.code,{children:`GET /v2/wallets/{addr}/positions/onchain`})})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`All trades on a market (chronological fill feed)`}),_jsx(_components.td,{children:_jsx(_components.a,{href:`/api-reference/onchain/market-trades`,children:_jsx(_components.code,{children:`GET /v2/onchain/markets/{tokenId}/trades`})})})]})]})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Top Traders (Market)","description":"Every wallet that holds (or has held) a position in a single market, grouped by outcome and sorted by P\u0026L. The 'who's making money on this market' feed.","openapi":"GET /v1/markets/{id}/positions","href":"/api-reference/wallets/market-positions"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Request","slug":"request","depth":2,"children":[]},{"title":"Response","slug":"response","depth":2,"children":[{"title":"Top-level fields","slug":"top-level-fields","depth":3,"children":[]},{"title":"Per-trader fields (outcomes[].positions[])","slug":"per-trader-fields-outcomes-positions","depth":3,"children":[]}]},{"title":"Examples","slug":"examples","depth":2,"children":[{"title":"Top 10 traders on a market by total P\u0026L","slug":"top-10-traders-on-a-market-by-total-p\u0026l","depth":3,"children":[]},{"title":"By condition_id, with first/last trade timestamps","slug":"by-condition_id-with-first/last-trade-timestamps","depth":3,"children":[]},{"title":"Drill into specific wallets within a market","slug":"drill-into-specific-wallets-within-a-market","depth":3,"children":[]},{"title":"Closed positions only","slug":"closed-positions-only","depth":3,"children":[]}]},{"title":"Notes","slug":"notes","depth":2,"children":[]},{"title":"When to use this vs. other position endpoints","slug":"when-to-use-this-vs-other-position-endpoints","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/polynode/0d40c5db9faacad8/slug-calculator.js"],"openApiReferenceData":{"operation":{"tags":["Wallets"],"summary":"Market positions \u0026 P\u0026L","description":"Every wallet that holds (or has held) a position in a single market, grouped by outcome and sorted by P\u0026L. The 'who's making money on this market' feed.","operationId":"get_market_positions","parameters":["52d570fb-dc5a-4229-b43c-d065a7c9f171","0a67fedf-4b6c-4029-856d-a173eadfce05","fe2872e2-50ac-4a7e-a02f-4c5b5033398e","6804ac74-1b3d-4261-8513-710e982d16a6","7c09ef07-bc95-4f2e-81ce-6764fcbe90e2","7716c1f0-53d6-4e63-ac61-bb28fb36baf6","ba1f6d58-1e79-4be3-98c9-5cb1287dad9f","8764b34b-98e3-4cee-9e14-5b42cef5cb4b"],"responses":{"200":"68808589-8a35-4d7b-a297-20741551009f","401":"1802ebb3-2fe1-4434-88b9-037182d3b546","404":"820f9945-ee58-4d5f-9c76-0394944eea9f","429":"880259fc-283e-4293-8e7a-a3e04ba5461d","502":"4dcdec1a-c49b-4f42-8bde-98b2730e2a3e"},"security":["de14e97d-ccc5-4f9c-a3c5-0648f0104b6f"],"method":"get","type":"path","servers":["0de2ff18-6d1a-4993-ac05-606e277c043e"],"path":"/v1/markets/{id}/positions","baseUrlOptions":["https://api.polynode.dev"],"title":"Market positions \u0026 P\u0026L","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"52d570fb-dc5a-4229-b43c-d065a7c9f171":{"name":"id","in":"path","description":"Condition ID (0x-prefixed) or market slug","required":true,"schema":{"type":"string","isRequired":true,"description":"Condition ID (0x-prefixed) or market slug","uniqueKey":"","typeLabel":"string"}},"0a67fedf-4b6c-4029-856d-a173eadfce05":{"name":"limit","in":"query","description":"Maximum holders per outcome token (default 50, max 500)","schema":{"type":"integer","default":50,"minimum":1,"maximum":500,"description":"Maximum holders per outcome token (default 50, max 500)","uniqueKey":"","typeLabel":"integer"}},"fe2872e2-50ac-4a7e-a02f-4c5b5033398e":{"name":"offset","in":"query","description":"Pagination offset (default 0)","schema":{"type":"integer","default":0,"minimum":0,"description":"Pagination offset (default 0)","uniqueKey":"","typeLabel":"integer"}},"6804ac74-1b3d-4261-8513-710e982d16a6":{"name":"sortBy","in":"query","description":"Sort holders by field","schema":{"type":"string","enum":["TOKENS","CASH_PNL","REALIZED_PNL","TOTAL_PNL"],"default":"TOTAL_PNL","description":"Sort holders by field","uniqueKey":"","typeLabel":"enum\u003cstring>"}},"7c09ef07-bc95-4f2e-81ce-6764fcbe90e2":{"name":"sortDirection","in":"query","description":"Sort direction","schema":{"type":"string","enum":["ASC","DESC"],"default":"DESC","description":"Sort direction","uniqueKey":"","typeLabel":"enum\u003cstring>"}},"7716c1f0-53d6-4e63-ac61-bb28fb36baf6":{"name":"status","in":"query","description":"Filter by position status","schema":{"type":"string","enum":["OPEN","CLOSED","ALL"],"default":"ALL","description":"Filter by position status","uniqueKey":"","typeLabel":"enum\u003cstring>"}},"ba1f6d58-1e79-4be3-98c9-5cb1287dad9f":{"name":"includeTrades","in":"query","description":"Enrich each position with `firstTradeAt` and `lastTradeAt` timestamps. Responses will be slower. Default false. **Rate limited to 60 requests per minute per key** (separate from your standard rate limit).","schema":{"type":"boolean","default":false,"description":"Enrich each position with `firstTradeAt` and `lastTradeAt` timestamps. Responses will be slower. Default false. **Rate limited to 60 requests per minute per key** (separate from your standard rate limit).","uniqueKey":"","typeLabel":"boolean"}},"8764b34b-98e3-4cee-9e14-5b42cef5cb4b":{"name":"user","in":"query","description":"Filter to specific wallet address(es). Accepts a single address or multiple comma-separated addresses (max 20). Returns only those wallets' positions in this market.","schema":{"type":"string","description":"Filter to specific wallet address(es). Accepts a single address or multiple comma-separated addresses (max 20). Returns only those wallets' positions in this market.","uniqueKey":"","typeLabel":"string"}}},"responses":{"68808589-8a35-4d7b-a297-20741551009f":{"description":"Market positions grouped by outcome token","content":{"application/json":{"schema":{"type":"object","description":"Holder positions for a market, grouped by outcome token.","required":["condition_id","outcomes"],"properties":{"condition_id":{"type":"string","description":"Market condition ID.","isRequired":true,"uniqueKey":"condition_id","typeLabel":"string"},"outcomes":{"type":"array","description":"Array of outcome tokens, each containing a list of holder positions.","items":{"type":"object","properties":{"token":{"type":"string","description":"Token ID for this outcome.","uniqueKey":"outcomes.items.[INDEX].token","typeLabel":"string"},"positions":{"type":"array","items":{"type":"object","description":"A single holder's position in a market outcome.","properties":{"proxyWallet":{"type":"string","description":"Holder's wallet address.","uniqueKey":"outcomes.items.[INDEX].positions.items.[INDEX].proxyWallet","typeLabel":"string"},"name":{"type":"string","description":"Polymarket username (if set).","uniqueKey":"outcomes.items.[INDEX].positions.items.[INDEX].name","typeLabel":"string"},"outcome":{"type":"string","description":"Outcome name.","uniqueKey":"outcomes.items.[INDEX].positions.items.[INDEX].outcome","typeLabel":"string"},"outcomeIndex":{"type":"integer","description":"Outcome index (0 or 1).","uniqueKey":"outcomes.items.[INDEX].positions.items.[INDEX].outcomeIndex","typeLabel":"integer"},"size":{"type":"number","description":"Position size in outcome tokens.","uniqueKey":"outcomes.items.[INDEX].positions.items.[INDEX].size","typeLabel":"number"},"avgPrice":{"type":"number","description":"Average entry price.","uniqueKey":"outcomes.items.[INDEX].positions.items.[INDEX].avgPrice","typeLabel":"number"},"currPrice":{"type":"number","description":"Current market price.","uniqueKey":"outcomes.items.[INDEX].positions.items.[INDEX].currPrice","typeLabel":"number"},"currentValue":{"type":"number","description":"Current market value.","uniqueKey":"outcomes.items.[INDEX].positions.items.[INDEX].currentValue","typeLabel":"number"},"cashPnl":{"type":"number","description":"Unrealized cash P\u0026L.","uniqueKey":"outcomes.items.[INDEX].positions.items.[INDEX].cashPnl","typeLabel":"number"},"realizedPnl":{"type":"number","description":"Realized P\u0026L from closed portions.","uniqueKey":"outcomes.items.[INDEX].positions.items.[INDEX].realizedPnl","typeLabel":"number"},"totalPnl":{"type":"number","description":"Total P\u0026L (cash + realized).","uniqueKey":"outcomes.items.[INDEX].positions.items.[INDEX].totalPnl","typeLabel":"number"},"totalBought":{"type":"number","description":"Total tokens bought.","uniqueKey":"outcomes.items.[INDEX].positions.items.[INDEX].totalBought","typeLabel":"number"},"firstTradeAt":{"type":"integer","description":"Unix timestamp of the holder's first trade on this market. Only present when `includeTrades=true`.","uniqueKey":"outcomes.items.[INDEX].positions.items.[INDEX].firstTradeAt","typeLabel":"integer"},"lastTradeAt":{"type":"integer","description":"Unix timestamp of the holder's most recent trade on this market. Only present when `includeTrades=true`.","uniqueKey":"outcomes.items.[INDEX].positions.items.[INDEX].lastTradeAt","typeLabel":"integer"}},"uniqueKey":"outcomes.items.[INDEX].positions.items.[INDEX]","typeLabel":"object"},"uniqueKey":"outcomes.items.[INDEX].positions","typeLabel":"object[]"}},"uniqueKey":"outcomes.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"outcomes","typeLabel":"object[]"},"market_title":{"type":"string","description":"Market title (enriched by PolyNode).","uniqueKey":"market_title","typeLabel":"string"},"slug":{"type":"string","description":"Market slug (enriched by PolyNode).","uniqueKey":"slug","typeLabel":"string"},"outcome_names":{"type":"array","items":{"type":"string","uniqueKey":"outcome_names.items.[INDEX]","typeLabel":"string"},"description":"Outcome names (e.g. [\"Yes\", \"No\"]).","uniqueKey":"outcome_names","typeLabel":"string[]"}},"uniqueKey":"","typeLabel":"object"},"example":{"condition_id":"0x895e01dbf3e6a33cd9a44ca0f8cdb5df1bd2b0b6ebed5300d28f8da7145145e4","market_title":"Will Donald Trump win the 2028 Republican presidential nomination?","slug":"will-donald-trump-win-the-2028-republican-presidential-nomination","outcome_names":["Yes","No"],"outcomes":[{"token":"3039641309958397001906153616677074061284510636203465131156925998487819889437","positions":[{"proxyWallet":"0xa5ef39c3d3e10d0b270233af41cac69796b12966","name":"","outcome":"No","outcomeIndex":1,"size":1735573.72,"avgPrice":0,"currPrice":0.9835,"currentValue":1706936.75,"cashPnl":1706936.75,"realizedPnl":0,"totalPnl":1706936.75},{"proxyWallet":"0xc2e7800b5af46e6093872b177b7a5e7f0563be51","name":"beachboy4","outcome":"Yes","outcomeIndex":0,"size":248651.26,"avgPrice":0.040276,"currPrice":0.0165,"currentValue":4102.75,"cashPnl":-5911.93,"realizedPnl":0,"totalPnl":-5911.93,"firstTradeAt":1753016057,"lastTradeAt":1765034355}]}]},"examples":{"Example":{"title":"Example","value":{"condition_id":"0x895e01dbf3e6a33cd9a44ca0f8cdb5df1bd2b0b6ebed5300d28f8da7145145e4","market_title":"Will Donald Trump win the 2028 Republican presidential nomination?","slug":"will-donald-trump-win-the-2028-republican-presidential-nomination","outcome_names":["Yes","No"],"outcomes":[{"token":"3039641309958397001906153616677074061284510636203465131156925998487819889437","positions":[{"proxyWallet":"0xa5ef39c3d3e10d0b270233af41cac69796b12966","name":"","outcome":"No","outcomeIndex":1,"size":1735573.72,"avgPrice":0,"currPrice":0.9835,"currentValue":1706936.75,"cashPnl":1706936.75,"realizedPnl":0,"totalPnl":1706936.75},{"proxyWallet":"0xc2e7800b5af46e6093872b177b7a5e7f0563be51","name":"beachboy4","outcome":"Yes","outcomeIndex":0,"size":248651.26,"avgPrice":0.040276,"currPrice":0.0165,"currentValue":4102.75,"cashPnl":-5911.93,"realizedPnl":0,"totalPnl":-5911.93,"firstTradeAt":1753016057,"lastTradeAt":1765034355}]}]}}},"exampleType":"examples"}},"exampleType":"examples"},"1802ebb3-2fe1-4434-88b9-037182d3b546":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"820f9945-ee58-4d5f-9c76-0394944eea9f":{"description":"Market not found for the given slug","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"880259fc-283e-4293-8e7a-a3e04ba5461d":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"4dcdec1a-c49b-4f42-8bde-98b2730e2a3e":{"description":"Upstream data source unavailable","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"de14e97d-ccc5-4f9c-a3c5-0648f0104b6f":{"api_key":{"type":"apiKey","in":"header","name":"x-api-key","scopes":[],"schemeName":"api_key"}}},"servers":{"0de2ff18-6d1a-4993-ac05-606e277c043e":{"url":"https://api.polynode.dev","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-api-key","scopes":[],"schemeName":"api_key"},"schema":{"title":"x-api-key","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"api_key","name":"x-api-key"}],"title":"api_key"}]},"originalFileLocation":"openapi.json"},"subdomain":"polynode","siteName":"PolyNode","title":"Top Traders (Market) - PolyNode","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-04-27T04:25:31.417Z","originalFileLocation":"api-reference/wallets/market-positions.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Every wallet that holds (or has held) a position in a single market, grouped by outcome and sorted by P\u0026amp;L. The \u0026#x27;who\u0026#x27;s making money on this market\u0026#x27; feed.\">\u003cmeta data-mint-head name=\"application-name\" content=\"PolyNode\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/polynode/nh0EcUVk_uYhjcGA/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/polynode/nh0EcUVk_uYhjcGA/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/polynode/nh0EcUVk_uYhjcGA/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/polynode/nh0EcUVk_uYhjcGA/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/polynode/nh0EcUVk_uYhjcGA/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/polynode/nh0EcUVk_uYhjcGA/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/polynode/nh0EcUVk_uYhjcGA/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/polynode/nh0EcUVk_uYhjcGA/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/polynode/nh0EcUVk_uYhjcGA/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Top Traders (Market) - PolyNode\">\u003cmeta data-mint-head property=\"og:description\" content=\"Every wallet that holds (or has held) a position in a single market, grouped by outcome and sorted by P\u0026amp;L. The \u0026#x27;who\u0026#x27;s making money on this market\u0026#x27; feed.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"PolyNode\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.polynode.dev/api-reference/wallets/market-positions\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://polynode.mintlify.site/_mintlify/api/og/v2?division=Onchain+V2+%28legacy%29\u0026amp;title=Top+Traders+%28Market%29\u0026amp;description=Every+wallet+that+holds+%28or+has+held%29+a+position+in+a+single+market%2C+grouped+by+outcome+and+sorted+by+P%26L.+The+%27who%27s+making+money+on+this+market%27+feed.\u0026amp;theme=121c1386b08658be3ccff004\u0026amp;signature=943b4fc6cb826459040da4f0755cac618da634130217d66e6b7823d318658db6\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Top Traders (Market) - PolyNode\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Every wallet that holds (or has held) a position in a single market, grouped by outcome and sorted by P\u0026amp;L. The \u0026#x27;who\u0026#x27;s making money on this market\u0026#x27; feed.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://polynode.mintlify.site/_mintlify/api/og/v2?division=Onchain+V2+%28legacy%29\u0026amp;title=Top+Traders+%28Market%29\u0026amp;description=Every+wallet+that+holds+%28or+has+held%29+a+position+in+a+single+market%2C+grouped+by+outcome+and+sorted+by+P%26L.+The+%27who%27s+making+money+on+this+market%27+feed.\u0026amp;theme=121c1386b08658be3ccff004\u0026amp;signature=943b4fc6cb826459040da4f0755cac618da634130217d66e6b7823d318658db6\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/polynode/nh0EcUVk_uYhjcGA/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"PolyNode\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#3b82f6\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.polynode.dev/api-reference/wallets/market-positions\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/wallets/market-positions.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.polynode.dev/#organization\",\"name\":\"PolyNode\",\"url\":\"https://docs.polynode.dev\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/polynode/zluszUOhqmSDk1RK/images/logo-light.png?fit=max\u0026auto=format\u0026n=zluszUOhqmSDk1RK\u0026q=85\u0026s=fc49b798da5a361cb76f4733f13230dd\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.polynode.dev#website\",\"name\":\"PolyNode\",\"url\":\"https://docs.polynode.dev\",\"publisher\":{\"@id\":\"https://docs.polynode.dev/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.polynode.dev/api-reference/wallets/market-positions#webpage\",\"url\":\"https://docs.polynode.dev/api-reference/wallets/market-positions\",\"name\":\"Top Traders (Market)\",\"description\":\"Every wallet that holds (or has held) a position in a single market, grouped by outcome and sorted by P\u0026L. The 'who's making money on this market' feed.\",\"dateModified\":\"2026-04-27T04:25:31.417Z\",\"isPartOf\":{\"@id\":\"https://docs.polynode.dev#website\"},\"breadcrumb\":{\"@id\":\"https://docs.polynode.dev/api-reference/wallets/market-positions#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.polynode.dev/api-reference/wallets/market-positions#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Onchain V2 (legacy)\",\"item\":\"https://docs.polynode.dev/api-reference/onchain/trades\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Top Traders (Market)\",\"item\":\"https://docs.polynode.dev/api-reference/wallets/market-positions\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.polynode.dev/api-reference/wallets/market-positions#apireference\",\"headline\":\"Top Traders (Market)\",\"name\":\"Top Traders (Market)\",\"description\":\"Every wallet that holds (or has held) a position in a single market, grouped by outcome and sorted by P\u0026L. The 'who's making money on this market' feed.\",\"url\":\"https://docs.polynode.dev/api-reference/wallets/market-positions\",\"mainEntityOfPage\":{\"@id\":\"https://docs.polynode.dev/api-reference/wallets/market-positions#webpage\"},\"dateModified\":\"2026-04-27T04:25:31.417Z\",\"publisher\":{\"@id\":\"https://docs.polynode.dev/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.polynode.dev#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"PolyNode\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"PolyNode","nav":{"global":null,"tabs":[{"tab":"WebSocket","pages":[{"title":"WebSocket","href":"/websocket/overview"}]},{"tab":"Webhooks","pages":[{"title":"Webhooks","href":"/webhooks/overview"}]},{"tab":"API Reference","groups":[{"group":"Overview","pages":[{"title":"API Reference","href":"/api-reference/overview"}]},{"group":"V3 Data API","pages":[{"title":"API Overview","href":"/data/overview"}]},{"group":"Query Catalog","root":{"title":"Query Catalog","href":"/data/query-catalog/overview"},"tag":"Start Here","pages":[{"title":"Trades Query Catalog","href":"/data/query-catalog/trades"},{"title":"All Trades","href":"/data/query-catalog/trades/all-trades"},{"title":"Trades by Wallet","href":"/data/query-catalog/trades/by-wallet"},{"title":"Trades by Order Hash","href":"/data/query-catalog/trades/by-order-hash"},{"title":"Trades by Market Token","href":"/data/query-catalog/trades/by-market-token"},{"title":"Trades by Market Slug","href":"/data/query-catalog/trades/by-market-slug"},{"title":"Wallet Trades by Condition","href":"/data/query-catalog/trades/wallet-by-condition"},{"title":"Wallet Trades Grouped by Order","href":"/data/query-catalog/trades/wallet-grouped-by-order"},{"title":"Builder Trades","href":"/data/query-catalog/trades/by-builder"},{"title":"Combo Wallet Trades","href":"/data/query-catalog/trades/combo-wallet-trades"},{"title":"Positions Query Catalog","href":"/data/query-catalog/positions"},{"title":"Positions by Wallet","href":"/data/query-catalog/positions/by-wallet"},{"title":"Open Wallet Positions","href":"/data/query-catalog/positions/open-wallet-positions"},{"title":"Global Positions","href":"/data/query-catalog/positions/global-positions"},{"title":"Positions by Market Token","href":"/data/query-catalog/positions/by-market-token"},{"title":"Positions by Condition","href":"/data/query-catalog/positions/by-condition"},{"title":"Positions by Market Slug","href":"/data/query-catalog/positions/by-market-slug"},{"title":"Combo Positions","href":"/data/query-catalog/positions/combo-positions"},{"title":"P\u0026L Query Catalog","href":"/data/query-catalog/pnl"},{"title":"Wallet All-Time P\u0026L","href":"/data/query-catalog/pnl/wallet-all-time"},{"title":"Wallet Time-Windowed P\u0026L","href":"/data/query-catalog/pnl/wallet-time-window"},{"title":"Wallet P\u0026L by Tag","href":"/data/query-catalog/pnl/wallet-by-tag"},{"title":"Wallet P\u0026L by Market","href":"/data/query-catalog/pnl/wallet-by-market"},{"title":"Wallet P\u0026L Events","href":"/data/query-catalog/pnl/wallet-events"},{"title":"Batch Wallet P\u0026L","href":"/data/query-catalog/pnl/batch-wallet-pnl"},{"title":"Global P\u0026L Leaderboard","href":"/data/query-catalog/pnl/global-leaderboard"},{"title":"Tag P\u0026L Leaderboard","href":"/data/query-catalog/pnl/tag-leaderboard"},{"title":"Markets Query Catalog","href":"/data/query-catalog/markets"},{"title":"Search Markets","href":"/data/query-catalog/markets/search-markets"},{"title":"Market by Condition","href":"/data/query-catalog/markets/by-condition"},{"title":"Condition Detail","href":"/data/query-catalog/markets/condition-detail"},{"title":"Trades and Positions by Slug","href":"/data/query-catalog/markets/by-slug"},{"title":"Token Info","href":"/data/query-catalog/markets/token-info"},{"title":"Token Price","href":"/data/query-catalog/markets/token-price"},{"title":"Market Candles","href":"/data/query-catalog/markets/candles"},{"title":"Tags and Markets by Tag","href":"/data/query-catalog/markets/tags"},{"title":"Market Resolutions","href":"/data/query-catalog/markets/resolutions"},{"title":"Wallet Activity Query Catalog","href":"/data/query-catalog/wallet-activity"},{"title":"Unified Wallet Activity","href":"/data/query-catalog/wallets/unified-activity"},{"title":"Wallet Splits","href":"/data/query-catalog/wallets/splits"},{"title":"Wallet Merges","href":"/data/query-catalog/wallets/merges"},{"title":"Wallet Redemptions","href":"/data/query-catalog/wallets/redemptions"},{"title":"Neg-Risk Conversions","href":"/data/query-catalog/wallets/neg-risk-conversions"},{"title":"PolyUSD Flows","href":"/data/query-catalog/wallets/polyusd-flows"},{"title":"Wallet Fees Paid","href":"/data/query-catalog/wallets/fees-paid"},{"title":"Wallet Rebates and Rewards","href":"/data/query-catalog/wallets/rebates-rewards"},{"title":"Builders Query Catalog","href":"/data/query-catalog/builders"},{"title":"Builder Leaderboard","href":"/data/query-catalog/builders/leaderboard"},{"title":"Builder Detail","href":"/data/query-catalog/builders/detail"},{"title":"Builder Trader Leaderboard","href":"/data/query-catalog/builders/trader-leaderboard"},{"title":"Builder Daily Activity","href":"/data/query-catalog/builders/daily-activity"},{"title":"Compare Builder Daily Activity","href":"/data/query-catalog/builders/activity-comparison"},{"title":"Builder Trades","href":"/data/query-catalog/builders/trades"},{"title":"Builder Trades by Market","href":"/data/query-catalog/builders/trades-by-market"},{"title":"Builder Trades by Tag or Category","href":"/data/query-catalog/builders/trades-by-tag-category"},{"title":"Builder Trades by Side and Size","href":"/data/query-catalog/builders/trades-by-side-size"},{"title":"Tags and Categories Query Catalog","href":"/data/query-catalog/tags-categories"},{"title":"Combos Query Catalog","href":"/data/query-catalog/combos"},{"title":"Combo Markets","href":"/data/query-catalog/combos/markets"},{"title":"Combo Activity","href":"/data/query-catalog/combos/activity"},{"title":"Combo Redemptions","href":"/data/query-catalog/combos/redemptions"},{"title":"Wallet Combo Summary","href":"/data/query-catalog/combos/wallet-summary"},{"title":"Wallet Combo Positions","href":"/data/query-catalog/combos/wallet-positions"},{"title":"Wallet Combo Trades","href":"/data/query-catalog/combos/wallet-trades"},{"title":"Wallet Combo Activity","href":"/data/query-catalog/combos/wallet-activity"},{"title":"Wallet Combo Redemptions","href":"/data/query-catalog/combos/wallet-redemptions"},{"title":"Include Combos in Wallet Views","href":"/data/query-catalog/combos/include-combos"}]},{"group":"Wallet P\u0026L","pages":[{"title":"Resolve Wallet","openapi":"GET /v1/resolve/{query}","href":"/api-reference/wallets/resolve"},{"title":"Wallet Summary","openapi":"GET /v3/wallets/{address}","href":"/data/wallets/summary"},{"title":"Wallet P\u0026L","openapi":"GET /v3/wallets/{address}/pnl","href":"/data/wallets/pnl"},{"title":"Wallet P\u0026L Time Series","openapi":"GET /v3/wallets/{address}/pnl/events","href":"/data/wallets/pnl-events"},{"title":"Batch Wallet P\u0026L","openapi":"POST /v3/wallets/batch","href":"/data/wallets/batch"},{"title":"Wallet Positions","openapi":"GET /v3/wallets/{address}/positions","href":"/data/wallets/positions"}]},{"group":"Wallet Activity","pages":[{"title":"Wallet Trades","openapi":"GET /v3/wallets/{address}/trades","href":"/data/wallets/trades"},{"title":"Copy PnL","openapi":"GET /v3/wallets/{address}/copy-pnl","href":"/data/wallets/copy-pnl"},{"title":"Copy PnL Batch","openapi":"POST /v3/copy-pnl/batch","href":"/data/wallets/copy-pnl-batch"},{"title":"Wallet Fees Paid","openapi":"GET /v3/wallets/{address}/fees-paid","href":"/data/wallets/fees-paid"},{"title":"Wallet PolyUSD Flows","openapi":"GET /v3/wallets/{address}/polyusd-flows","href":"/data/wallets/polyusd-flows"},{"title":"Wallet Maker Rebates","openapi":"GET /v3/wallets/{address}/rebates","href":"/data/wallets/rebates"},{"title":"Wallet Redemptions","openapi":"GET /v3/wallets/{address}/redemptions","href":"/data/wallets/redemptions"},{"title":"Wallet Splits","openapi":"GET /v3/wallets/{address}/splits","href":"/data/wallets/splits"},{"title":"Wallet Merges","openapi":"GET /v3/wallets/{address}/merges","href":"/data/wallets/merges"},{"title":"Wallet NRC","openapi":"GET /v3/wallets/{address}/nrc","href":"/data/wallets/nrc"},{"title":"Wallet Activity","openapi":"GET /v3/wallets/{address}/activity","href":"/data/wallets/activity"}]},{"group":"Credits","pages":[{"title":"Credits Overview","href":"/credits/overview"},{"title":"Liquidity Rewards","href":"/credits/rewards"},{"title":"Yield","href":"/credits/yield"},{"group":"Rebates","pages":[{"title":"Maker Rebates","href":"/credits/maker-rebates"},{"title":"Taker Rebates","href":"/credits/taker-rebates"}]},{"title":"Referral Rewards","href":"/credits/referral-rewards"},{"group":"Credits API Reference","pages":[{"title":"Wallet Credit Totals","openapi":"GET /v3/wallets/{addr}/credits/totals","href":"/credits/wallet-totals"},{"title":"Wallet Credit Events","openapi":"GET /v3/wallets/{addr}/credits","href":"/credits/wallet-events"},{"title":"Wallet Credit Series","openapi":"GET /v3/wallets/{addr}/credits/series","href":"/credits/wallet-series"},{"title":"Credits Leaderboard","openapi":"GET /v3/credits/leaderboard","href":"/credits/leaderboard"},{"title":"Global Credit Stats","openapi":"GET /v3/credits/stats","href":"/credits/stats"},{"title":"Global Credit Feed","openapi":"GET /v3/credits/events","href":"/credits/feed"},{"title":"Credit Distributors","openapi":"GET /v3/credits/distributors","href":"/credits/distributors"},{"title":"Decode Payout Transaction","openapi":"GET /v3/credits/txs/{hash}","href":"/credits/tx"},{"title":"Recipient Growth","openapi":"GET /v3/credits/recipients/stats","href":"/credits/recipients"}]}]},{"group":"Identity","pages":[{"title":"Batch Resolve","openapi":"POST /v3/identities/batch","href":"/identities/batch-resolve"},{"title":"Username Search","openapi":"GET /v3/identities/search","href":"/identities/search"},{"title":"Identity Lookup","openapi":"GET /v3/identities/{addr}","href":"/identities/lookup"}]},{"group":"Fees","pages":[{"title":"Fees Overview","href":"/data/fees/overview"},{"title":"Wallet Fees Paid","href":"/data/fees/wallet-fees-paid"},{"title":"Global Fee Events","href":"/data/fees/global-fees"},{"title":"Fees by Receiver","href":"/data/fees/fees-by-receiver"},{"title":"Builder Fees","href":"/data/fees/builder-fees"},{"title":"Maker Rebates","href":"/data/fees/maker-rebates"},{"title":"Reward Market Configs","href":"/data/fees/reward-market-configs"}]},{"group":"Combos","tag":"New","pages":[{"title":"Combos Overview","href":"/data/combos/overview"},{"title":"Combo Markets","openapi":"GET /v3/combos/markets","href":"/data/combos/markets"},{"title":"Combo Activity","openapi":"GET /v3/combos/activity","href":"/data/combos/activity"},{"title":"Combo Daily Activity","openapi":"GET /v3/combos/activity/daily","href":"/data/combos/daily-activity"},{"title":"Combo P\u0026L Leaderboard","openapi":"GET /v3/combos/leaderboard","href":"/data/combos/leaderboard"},{"title":"Combo Redemptions","openapi":"GET /v3/combos/redemptions","href":"/data/combos/redemptions"},{"title":"Wallet Combo Summary","openapi":"GET /v3/wallets/{address}/combos/summary","href":"/data/combos/wallet-summary"},{"title":"Wallet Combo Positions","openapi":"GET /v3/wallets/{address}/combos/positions","href":"/data/combos/wallet-positions"},{"title":"Wallet Combo Trades","openapi":"GET /v3/wallets/{address}/combos/trades","href":"/data/combos/wallet-trades"},{"title":"Wallet Combo Activity","openapi":"GET /v3/wallets/{address}/combos/activity","href":"/data/combos/wallet-activity"},{"title":"Wallet Combo Redemptions","openapi":"GET /v3/wallets/{address}/combos/redemptions","href":"/data/combos/wallet-redemptions"}]},{"group":"Rewards","pages":[{"title":"Reward Markets","openapi":"GET /v3/rewards/markets","href":"/data/rewards/markets"},{"title":"Reward Market Detail","openapi":"GET /v3/rewards/markets/{condition_id}","href":"/data/rewards/market"}]},{"group":"Markets \u0026 Search","pages":[{"title":"Market Catalog","openapi":"GET /v3/markets","href":"/data/markets/catalog"},{"title":"Market Catalog Stats","openapi":"GET /v3/markets/stats","href":"/data/markets/catalog-stats"},{"title":"Event Catalog","openapi":"GET /v3/events","href":"/data/events/catalog"},{"title":"Event Catalog Stats","openapi":"GET /v3/events/stats","href":"/data/events/catalog-stats"},{"title":"Search Markets","openapi":"GET /v3/markets/search","href":"/data/markets/search"},{"title":"Market by Condition","openapi":"GET /v3/markets/condition/{condition_id}","href":"/data/markets/by-condition"},{"title":"Market Positions (Condition)","openapi":"GET /v3/markets/condition/{condition_id}/positions","href":"/data/markets/condition-positions"},{"title":"Market Trades","openapi":"GET /v3/markets/{token_id}/trades","href":"/data/markets/trades"},{"title":"Market Positions (Token)","openapi":"GET /v3/markets/{token_id}/positions","href":"/data/markets/positions"},{"title":"Token Price","openapi":"GET /v3/markets/{token_id}/price","href":"/data/markets/price"},{"title":"Market Candles","href":"/data/markets/candles"},{"title":"Market by Slug","openapi":"GET /v3/markets/slug/{slug}/trades","href":"/data/markets/by-slug"}]},{"group":"Orderbook","pages":[{"title":"Order Book","openapi":"GET /v1/orderbook/{token_id}","href":"/api-reference/orderbook/order-book"},{"title":"Midpoint Price","openapi":"GET /v1/midpoint/{token_id}","href":"/api-reference/orderbook/midpoint"},{"title":"Bid-Ask Spread","openapi":"GET /v1/spread/{token_id}","href":"/api-reference/orderbook/spread"}]},{"group":"Leaderboard \u0026 Tags","pages":[{"title":"Leaderboard","openapi":"GET /v3/leaderboard","href":"/data/leaderboard/global"},{"title":"Leaderboard Scopes","openapi":"GET /v3/leaderboard/scopes","href":"/data/leaderboard/scopes"},{"title":"Tags","openapi":"GET /v3/tags","href":"/data/leaderboard/tags"},{"title":"Tag Markets","openapi":"GET /v3/tags/{slug}","href":"/data/leaderboard/tag-markets"},{"title":"Tag Leaderboard","openapi":"GET /v3/tags/{slug}/leaderboard","href":"/data/leaderboard/tag-leaderboard"}]},{"group":"Builders","pages":[{"title":"Builder Leaderboard","openapi":"GET /v3/builders","href":"/data/builders/list"},{"title":"Builder Detail","openapi":"GET /v3/builders/{code}","href":"/data/builders/detail"},{"title":"Builder Trader P\u0026L Leaderboard","openapi":"GET /v3/builders/{code}/leaderboard","href":"/data/builders/trader-leaderboard"},{"title":"Builder Daily Activity","href":"/data/builders/daily-activity"},{"title":"Compare Builder Daily Activity","href":"/data/builders/activity-comparison"},{"title":"Builder Trades","openapi":"GET /v3/builders/{code}/trades","href":"/data/builders/trades"}]},{"group":"Polymarket Profiles","tag":"Beta","pages":[{"title":"Polymarket Profiles","href":"/api-reference/polymarket-profiles/overview"},{"title":"Check Username Availability","openapi":"GET /v3/polymarket/profiles/username-available","href":"/api-reference/polymarket-profiles/username-available"},{"title":"Create Username Challenge","openapi":"POST /v3/polymarket/profiles/username/challenge","href":"/api-reference/polymarket-profiles/create-challenge"},{"title":"Complete Username Action","openapi":"POST /v3/polymarket/profiles/username/complete","href":"/api-reference/polymarket-profiles/complete-username"},{"title":"Get Public Profile","openapi":"GET /v3/polymarket/profiles/{address}","href":"/api-reference/polymarket-profiles/get-profile"}]},{"group":"Global","pages":[{"title":"Platform Stats","openapi":"GET /v3/stats","href":"/data/global/stats"},{"title":"Global Trades","openapi":"GET /v3/trades","href":"/data/global/trades"},{"title":"Global Positions","openapi":"GET /v3/positions","href":"/data/global/positions"},{"title":"Fee Events","openapi":"GET /v3/fees","href":"/data/global/fees"},{"title":"Market Resolutions","openapi":"GET /v3/resolutions","href":"/data/global/resolutions"},{"title":"Condition Detail","openapi":"GET /v3/conditions/{condition_id}","href":"/data/global/conditions"}]},{"group":"Tokens","pages":[{"title":"Token Info","openapi":"GET /v3/tokens/{token_id}","href":"/data/tokens/info"}]},{"group":"Perps","pages":[{"title":"Perps Overview","href":"/perps/overview"},{"title":"Quickstart","href":"/perps/quickstart"},{"title":"Wallet Mapping","href":"/perps/wallet-mapping"},{"title":"Rate Limits","href":"/perps/rate-limits"}]},{"group":"Perps Market Data","pages":[{"title":"Instruments","openapi":"GET /v3/perps/instruments","href":"/perps/market-data/instruments"},{"title":"Tickers","openapi":"GET /v3/perps/tickers/{instrument}","href":"/perps/market-data/tickers"},{"title":"Screener","openapi":"GET /v3/perps/screener","href":"/perps/market-data/screener"},{"title":"Best Bid/Offer","openapi":"GET /v3/perps/bbo/{instrument}","href":"/perps/market-data/bbo"},{"title":"Orderbook","openapi":"GET /v3/perps/book/{instrument}","href":"/perps/market-data/book"},{"title":"Trades","openapi":"GET /v3/perps/trades/{instrument}","href":"/perps/market-data/trades"},{"title":"24h Statistics","openapi":"GET /v3/perps/statistics/{instrument}","href":"/perps/market-data/statistics"},{"title":"Klines (OHLCV)","openapi":"GET /v3/perps/klines/{instrument}","href":"/perps/market-data/klines"},{"title":"Funding Rates","openapi":"GET /v3/perps/funding/{instrument}","href":"/perps/market-data/funding"},{"title":"Open Interest History","openapi":"GET /v3/perps/oi/{instrument}","href":"/perps/market-data/open-interest"},{"title":"Volume History","openapi":"GET /v3/perps/volume/{instrument}","href":"/perps/market-data/volume"},{"title":"Perps Daily Activity","openapi":"GET /v3/perps/activity/daily","href":"/perps/market-data/daily-activity"},{"title":"Fees \u0026 Exchange Meta","href":"/perps/market-data/meta"},{"title":"Basis History","openapi":"GET /v3/perps/basis/{instrument}","href":"/perps/market-data/basis"},{"title":"Trade Flow / CVD","openapi":"GET /v3/perps/flow/{instrument}","href":"/perps/market-data/flow"},{"title":"Cumulative Funding","openapi":"GET /v3/perps/funding-pnl/{instrument}","href":"/perps/market-data/funding-pnl"}]},{"group":"Perps Wallets","pages":[{"title":"Wallet Overview","openapi":"GET /v3/perps/wallets/{address}","href":"/perps/wallets/overview"},{"title":"Portfolio","openapi":"GET /v3/perps/wallets/{address}/portfolio","href":"/perps/wallets/portfolio"},{"title":"Registered","openapi":"GET /v3/perps/wallets/{address}/registered","href":"/perps/wallets/registered"},{"title":"Registered (batch)","openapi":"GET /v3/perps/wallets/registered","href":"/perps/wallets/batch-registered"},{"title":"Portfolios (batch)","openapi":"GET /v3/perps/wallets/portfolios","href":"/perps/wallets/batch-portfolios"}]},{"group":"Perps Analytics","pages":[{"title":"Perps Analytics","href":"/perps/analytics/overview"},{"title":"Whale Leaderboard","openapi":"GET /v3/perps/leaderboard","href":"/perps/analytics/leaderboard"},{"title":"Positioning","openapi":"GET /v3/perps/positioning/{instrument}","href":"/perps/analytics/positioning"},{"title":"Large Positions","openapi":"GET /v3/perps/positions/large","href":"/perps/analytics/large-positions"},{"title":"Position History","openapi":"GET /v3/perps/wallets/{address}/positions/history","href":"/perps/analytics/position-history"},{"title":"Smart Money","openapi":"GET /v3/perps/traders","href":"/perps/analytics/traders"},{"title":"Position Events","openapi":"GET /v3/perps/events","href":"/perps/analytics/events"},{"title":"Liquidations","openapi":"GET /v3/perps/liquidations","href":"/perps/analytics/liquidations"},{"title":"Coverage","openapi":"GET /v3/perps/coverage","href":"/perps/analytics/coverage"}]},{"group":"Perps On-Chain","pages":[{"title":"TVL \u0026 Collateral","openapi":"GET /v3/perps/tvl","href":"/perps/onchain/tvl"},{"title":"Top Depositors","openapi":"GET /v3/perps/depositors","href":"/perps/onchain/depositors"},{"title":"Top Withdrawers","openapi":"GET /v3/perps/withdrawers","href":"/perps/onchain/withdrawers"},{"title":"Deposits Feed","openapi":"GET /v3/perps/deposits","href":"/perps/onchain/deposits"},{"title":"Withdrawals Feed","openapi":"GET /v3/perps/withdrawals","href":"/perps/onchain/withdrawals"},{"title":"Wallet Flows","openapi":"GET /v3/perps/wallets/{address}/flows","href":"/perps/onchain/flows"}]},{"group":"Perps Streaming","pages":[{"title":"Perps WebSocket","href":"/perps/websocket/overview"},{"title":"Channels","href":"/perps/websocket/channels"}]},{"group":"Crypto","pages":[{"title":"Crypto Markets","openapi":"GET /v1/crypto/markets","href":"/api-reference/crypto/markets"},{"title":"Oracle Candles","openapi":"GET /v1/crypto/candles","href":"/api-reference/crypto/candles"},{"title":"Historical Price Ticks","openapi":"GET /v1/crypto/ticks","href":"/api-reference/crypto/ticks"},{"title":"Price to Beat","openapi":"GET /v1/crypto/price","href":"/api-reference/crypto/price"},{"title":"Active 5-Minute Markets","openapi":"GET /v1/crypto/active","href":"/api-reference/crypto/active"},{"title":"Crypto Series","openapi":"GET /v1/crypto/series","href":"/api-reference/crypto/series"}]},{"group":"Sports","pages":[{"title":"Sports Markets","href":"/api-reference/sports/sports-markets"}]},{"group":"BYOL","pages":[{"title":"BYOL Overview","href":"/api-reference/byol/overview"},{"title":"Get Leaderboard","openapi":"GET /v2/leaderboard/custom","href":"/api-reference/byol/get-leaderboard"},{"title":"Add Wallets","openapi":"POST /v2/leaderboard/wallets","href":"/api-reference/byol/add-wallets"},{"title":"Remove Wallets","openapi":"DELETE /v2/leaderboard/wallets","href":"/api-reference/byol/remove-wallets"},{"title":"List Wallets","openapi":"GET /v2/leaderboard/wallets","href":"/api-reference/byol/list-wallets"}]},{"group":"Backtesting","pages":[{"title":"Backtesting Overview","href":"/api-reference/backtesting/overview"},{"title":"Deprecated: Backtest Copy PnL","openapi":"GET /v2/copy-pnl/{wallet}","href":"/api-reference/backtesting/copy-pnl"},{"title":"Deprecated: Backtest Copy PnL — Batch","openapi":"POST /v2/copy-pnl/batch","href":"/api-reference/backtesting/batch"},{"title":"BYOB — Add Wallets","openapi":"POST /v2/copy-pnl/wallets","href":"/api-reference/backtesting/byob-add-wallets"},{"title":"BYOB — Remove Wallets","openapi":"DELETE /v2/copy-pnl/wallets","href":"/api-reference/backtesting/byob-remove-wallets"},{"title":"BYOB — List Wallets","openapi":"GET /v2/copy-pnl/wallets","href":"/api-reference/backtesting/byob-list-wallets"},{"title":"BYOB — Leaderboard","openapi":"GET /v2/copy-pnl/leaderboard","href":"/api-reference/backtesting/byob-leaderboard"},{"title":"BYOB — Snapshot","openapi":"GET /v2/copy-pnl/snapshot","href":"/api-reference/backtesting/byob-snapshot"}]},{"group":"Market Card","pages":[{"title":"Market Card","sidebarTitle":"Market Card","openapi":"GET /v1/stats/{token_id}","href":"/api-reference/pricing/market-statistics"}]},{"group":"System","pages":[{"title":"System Status","openapi":"GET /v1/status","href":"/api-reference/system/system-status"},{"title":"Generate API Key","openapi":"POST /v1/keys","href":"/api-reference/system/generate-api-key"},{"title":"Health Check","openapi":"GET /healthz","href":"/api-reference/system/health-check"},{"title":"Readiness Check","openapi":"GET /readyz","href":"/api-reference/system/readiness-check"}]},{"group":"Search \u0026 Context","tag":"BETA","pages":[{"title":"Online Search API","sidebarTitle":"Online Search","openapi":"GET /v2/search/online","icon":"search","tag":"BETA","href":"/api-reference/search-online"},{"title":"X Search API","sidebarTitle":"X Search API","openapi":"GET /v2/x/search","icon":"magnifying-glass","tag":"BETA","href":"/api-reference/x-search"}]},{"group":"Onchain V2 (legacy)","pages":[{"title":"Trade History (All)","openapi":"GET /v2/onchain/trades","href":"/api-reference/onchain/trades"},{"title":"Positions (All)","openapi":"GET /v2/onchain/positions","href":"/api-reference/onchain/positions"},{"title":"Positions \u0026 P\u0026L (Wallet)","openapi":"GET /v2/wallets/{address}/positions/onchain","href":"/api-reference/wallets/onchain-positions"},{"title":"Trade History (Wallet)","openapi":"GET /v2/onchain/wallets/{address}/trades","href":"/api-reference/onchain/wallet-trades"},{"title":"Trade History (Wallet) — Bulk","openapi":"GET /v2/onchain/wallets/{address}/trades/all","href":"/api-reference/onchain/wallet-trades-all"},{"title":"Wallet Redemptions","openapi":"GET /v2/onchain/wallets/{address}/redemptions","href":"/api-reference/onchain/wallet-redemptions"},{"title":"Wallet Activity","openapi":"GET /v2/onchain/wallets/{address}/activity","href":"/api-reference/onchain/wallet-activity"},{"title":"Trade History (Market)","openapi":"GET /v2/onchain/markets/{token_id}/trades","href":"/api-reference/onchain/market-trades"},{"title":"Trade History (Market) — Bulk","description":"Return every trade for a market token in a single response. Growth plan or above.","openapi":"GET /v2/onchain/markets/{token_id}/trades/all","href":"/api-reference/onchain/market-trades-all"},{"title":"Top Traders (Market)","openapi":"GET /v1/markets/{id}/positions","href":"/api-reference/wallets/market-positions"},{"title":"Candles (Trade-Indexed OHLCV)","description":"Server-built OHLCV candles from real onchain trades. Anchor-based pagination with buy/sell volume split, VWAP, and trade counts. Resolutions from 1m to 1d.","openapi":"GET /v2/onchain/candles/{token_id}","href":"/api-reference/onchain/candles"},{"title":"Market Volume","openapi":"GET /v2/onchain/markets/{token_id}/volume","href":"/api-reference/onchain/market-volume"},{"title":"Market Open Interest","openapi":"GET /v2/onchain/markets/{condition_id}/oi","href":"/api-reference/onchain/market-oi"},{"title":"Global Open Interest","openapi":"GET /v2/onchain/oi","href":"/api-reference/onchain/global-oi"}]}]},{"tab":"Crypto Prices","pages":[{"title":"Crypto Prices","href":"/crypto/overview"}]},{"tab":"Orderbook","pages":[{"title":"Orderbook","href":"/orderbook/overview"}]},{"tab":"RPC","pages":[{"title":"RPC","href":"/rpc/overview"}]},{"tab":"CLI","pages":[{"title":"CLI","href":"/cli/overview"}]},{"tab":"Trading","pages":[{"title":"Trading","href":"/sdks/trading"}]},{"tab":"SDKs","pages":[{"title":"SDKs","href":"/sdks/overview"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]},{"tab":"Guides","pages":[{"title":"Guides","href":"/introduction"}]},{"tab":"Case Studies","pages":[{"title":"Case Studies","href":"/case-studies/overview"}]}]},"basePath":"","title":"Top Traders (Market) - PolyNode","buildId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","deploymentId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C-hEh3I2.js","utils-CnF4QiUD.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C7PVNbel.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-8ytevL2A.js","snippetPresets-BT1alx3v.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BLXC0i_W.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CyLIGI9_.js","shallow-DC0lGVIW.js","getApiPlaygroundDisplay-CgDQ85tN.js","CodeSnippet-6-I-Gpv9.js","CodeSnippets-BAk1kDdu.js","Page-C945cI-W.js","getPastedJson-B276RuWN.js","icon-BqP8etTm.js","MethodPill-DM6sbxG1.js","DuplicateIcon-PyJglOaE.js","createIcon-CMeOMAc_.js","DynamicMarkdown-BoyYAA8K.js","SectionHeading-DAYv3gvZ.js","axios-vUo_bRtp.js","Markdown-BhTTmazV.js","clsx-CR-RHrVC.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CBUH0-zX.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BmARFYNC.js"]}