Returns positions for a specific token across all traders. Open positions are those with remaining value >= $1; closed positions have remaining value < $1 (fully exited or dust). The metadata.trades array is only populated with trades which were commented on.
Returns open or closed positions for a specific token across named traders. Use this to enrich token detail pages with social trading context — showing which traders have conviction in a token and how their positions are performing.
Perps positions on Hyperliquid use the same endpoint — just pass hyperliquid as the chain. For example, to get open ETH perps positions:
GET /v1/tokens/hyperliquid/0x0000000000000000000000000000000000000000/positions/open
Perps positions include additional fields like perpPositionType, perpLeverage, and positionAmountWithLeverage. See the Perps Positions guide for how to handle these fields in your integration.
The response includes several USD value fields that serve different purposes:positionAmount is the base token quantity held. For perps, this is the margin amount (un-leveraged).positionAmountWithLeverage (perps only) is the token amount multiplied by leverage — the notional exposure.positionStats.holdingsCostBasisUSD is the USD cost basis of the current holdings. For spot, this is what the trader paid for tokens they still hold. For perps, this is the margin posted.positionStats.realizedGainsUSD is the all-time realized PnL for the position.To compute unrealized PnL, you need a current price from your own pricing source:
// SpotunrealizedPnL = (positionAmount * currentPrice) - holdingsCostBasisUSD// Perps (see the Perps guide for long vs short)unrealizedPnL = (positionAmountWithLeverage * currentPrice) - holdingsCostBasisUSDWithLeverage
Clicker provides the position data and cost basis. Your app provides the real-time price.
Sorting method. "value" (default): sorts by realized gains for closed positions, 30-day sell cost basis for open. "latest": sorts by close date for closed positions, open date for open.
If included, only include transactions with actions on the provided chains. Defaults to base, ethereum, solana. Pass all to see transactions on all supported chains.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Clicker - Feed API","colors":{"primary":"#06C933","light":"#06C933","dark":"#06C933"},"logo":{"light":"https://mintcdn.com/daylight/NfKjeKiEPHohvQ-j/logo/light.svg?fit=max\u0026auto=format\u0026n=NfKjeKiEPHohvQ-j\u0026q=85\u0026s=28d8534629d647d18445ec4441e0529a","dark":"https://mintcdn.com/daylight/NfKjeKiEPHohvQ-j/logo/dark.svg?fit=max\u0026auto=format\u0026n=NfKjeKiEPHohvQ-j\u0026q=85\u0026s=ae8f0c37277958111f03229ce64a39ac"},"favicon":"https://mintcdn.com/daylight/NfKjeKiEPHohvQ-j/favicon.svg?fit=max\u0026auto=format\u0026n=NfKjeKiEPHohvQ-j\u0026q=85\u0026s=7de76a696022797b0407b62319c8a248","navbar":{"links":[{"href":"https://clicker.xyz","label":"Website"},{"href":"https://careers.clicker.xyz","label":"Careers"},{"href":"mailto:hello@clicker.xyz","label":"Support"}]},"footer":{"socials":{"x":"https://x.com/clicker"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"daylight","hasAudioNarration":false,"actualSubdomain":"daylight","customDomains":["docs.clicker.xyz"],"gitSource":{"type":"github","owner":"daylightxyz","repo":"docs-feed","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ae9266c728655795468de11:success","clientVersion":"0.0.4102","searchFilterCounts":[{"language":"default","tag":"API Reference","count":42},{"language":"default","tag":"Guides","count":22},{"language":"default","tag":"Profiles","count":9},{"language":"default","tag":"Response Types","count":9},{"language":"default","tag":"Webhooks","count":8},{"language":"default","tag":"Comments","count":6},{"language":"default","tag":"Positions","count":4},{"language":"default","tag":"Feed","count":2},{"language":"default","tag":"Leaderboard","count":2}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","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}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/token-positions","slug":"/api-reference/token-positions","pageMetadata":{"title":"Token Positions","openapi":"GET /v1/tokens/{chain}/{contractAddress}/positions/{status}","description":"Returns positions for a specific token across all traders. Open positions are those with remaining value >= \\$1; closed positions have remaining value \u003c \\$1 (fully exited or dust). The metadata.trades array is only populated with trades which were commented on.","href":"/api-reference/token-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: \"Returns positions for a specific token across all traders. Open positions are those with remaining value >= $1; closed positions have remaining value \u003c $1 (fully exited or dust). The metadata.trades array is only populated with trades which were commented on.\"\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,Table}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Returns open or closed positions for a specific token across named traders. Use this to enrich token detail pages with social trading context — showing which traders have conviction in a token and how their positions are performing.`}),`\n`,_jsx(Heading,{level:`2`,id:`path-parameters`,children:`Path Parameters`}),`\n`,_jsx(Heading,{level:`3`,id:`chain`,children:_jsx(_components.code,{children:`chain`})}),`\n`,_jsx(_components.p,{children:`The blockchain the token is on. Supported chains:`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Chain`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`base`})}),_jsx(_components.td,{children:`Base (Coinbase L2)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`solana`})}),_jsx(_components.td,{children:`Solana`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ethereum`})}),_jsx(_components.td,{children:`Ethereum mainnet`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`hyperliquid`})}),_jsx(_components.td,{children:`Hyperliquid (perps)`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`contractaddress`,children:_jsx(_components.code,{children:`contractAddress`})}),`\n`,_jsx(_components.p,{children:`The token’s contract address on the given chain.`}),`\n`,_jsx(Heading,{level:`3`,id:`status`,children:_jsx(_components.code,{children:`status`})}),`\n`,_jsxs(_components.p,{children:[`Either `,_jsx(_components.code,{children:`open`}),` or `,_jsx(_components.code,{children:`closed`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`sorting`,children:`Sorting`}),`\n`,_jsxs(_components.p,{children:[`The default sort is `,_jsx(_components.code,{children:`value`}),`, which orders positions by size:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Open positions`}),` are sorted by `,_jsx(_components.strong,{children:`holding amount`}),` (largest current holdings first).`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Closed positions`}),` are sorted by `,_jsx(_components.strong,{children:`all-time realized PnL`}),` (highest profit first).`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`You can pass `,_jsx(_components.code,{children:`sort=latest`}),` to sort by most recent trade activity instead.`]}),`\n`,_jsx(Heading,{level:`2`,id:`calling-this-endpoint-for-perps`,children:`Calling This Endpoint for Perps`}),`\n`,_jsxs(_components.p,{children:[`Perps positions on Hyperliquid use the same endpoint — just pass `,_jsx(_components.code,{children:`hyperliquid`}),` as the chain. For example, to get open ETH perps positions:`]}),`\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/tokens/hyperliquid/0x0000000000000000000000000000000000000000/positions/open`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsxs(_components.p,{children:[`Perps positions include additional fields like `,_jsx(_components.code,{children:`perpPositionType`}),`, `,_jsx(_components.code,{children:`perpLeverage`}),`, and `,_jsx(_components.code,{children:`positionAmountWithLeverage`}),`. See the `,_jsx(_components.a,{href:`/guides/perps`,children:`Perps Positions guide`}),` for how to handle these fields in your integration.`]}),`\n`,_jsx(Heading,{level:`2`,id:`understanding-position-values`,children:`Understanding Position Values`}),`\n`,_jsx(_components.p,{children:`The response includes several USD value fields that serve different purposes:`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:_jsx(_components.code,{children:`positionAmount`})}),` is the base token quantity held. For perps, this is the margin amount (un-leveraged).`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:_jsx(_components.code,{children:`positionAmountWithLeverage`})}),` (perps only) is the token amount multiplied by leverage — the notional exposure.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:_jsx(_components.code,{children:`positionStats.holdingsCostBasisUSD`})}),` is the USD cost basis of the current holdings. For spot, this is what the trader paid for tokens they still hold. For perps, this is the margin posted.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:_jsx(_components.code,{children:`positionStats.realizedGainsUSD`})}),` is the all-time realized PnL for the position.`]}),`\n`,_jsxs(_components.p,{children:[`To compute `,_jsx(_components.strong,{children:`unrealized PnL`}),`, you need a current price from your own pricing source:`]}),`\n`,_jsx(CodeBlock,{numberOfLines:`6`,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:`6`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`// Spot`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`unrealizedPnL = (positionAmount * currentPrice) - holdingsCostBasisUSD`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`// Perps (see the Perps guide for long vs short)`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`unrealizedPnL = (positionAmountWithLeverage * currentPrice) - holdingsCostBasisUSDWithLeverage`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(_components.p,{children:`Clicker provides the position data and cost basis. Your app provides the real-time price.`})]})}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":"Token Positions","openapi":"GET /v1/tokens/{chain}/{contractAddress}/positions/{status}","description":"Returns positions for a specific token across all traders. Open positions are those with remaining value >= \\$1; closed positions have remaining value \u003c \\$1 (fully exited or dust). The metadata.trades array is only populated with trades which were commented on.","href":"/api-reference/token-positions"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Path Parameters","slug":"path-parameters","depth":2,"children":[{"title":"chain","slug":"chain","depth":3,"children":[]},{"title":"contractAddress","slug":"contractaddress","depth":3,"children":[]},{"title":"status","slug":"status","depth":3,"children":[]}]},{"title":"Sorting","slug":"sorting","depth":2,"children":[]},{"title":"Calling This Endpoint for Perps","slug":"calling-this-endpoint-for-perps","depth":2,"children":[]},{"title":"Understanding Position Values","slug":"understanding-position-values","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Social - Feed, Profiles and Discovery"],"summary":"Get Token Positions","description":"Returns positions for a specific token across all traders. Open positions are those with remaining value >= \\$1; closed positions have remaining value \u003c \\$1 (fully exited or dust). The metadata.trades array is only populated with trades which were commented on.","parameters":["4ba8aead-490e-4c96-b871-ea428f1717fd","909c5547-37eb-44f1-9537-ad658948657b","3dbda601-5a18-4f58-be9e-7e37c5de9c19","d3df8ad6-d00d-4178-a082-3fb34a6ba40e","480a16fa-2b82-4043-a081-6cf37d96c31d","35d6116f-dcfe-40f6-a6e0-978b43056552","913e6924-aafc-426e-9f20-81e7b84eb924"],"responses":{"200":"53267817-d433-43b5-bb57-468a87c2a4d5","400":"bd192f89-8094-4c99-899b-0445960f6cac","404":"f0ce4f06-b2a6-4659-8ea5-620cd01a55d9"},"method":"get","type":"path","servers":["f6ded4c7-7bfc-4cf0-8a45-8d43f8eaebfd"],"security":["bc315f11-e29a-4b76-ba86-745626fb709e","bece3007-41f0-48d6-a865-7d147eb74847"],"path":"/v1/tokens/{chain}/{contractAddress}/positions/{status}","baseUrlOptions":["https://api.clicker.xyz"],"title":"Get Token Positions","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"4ba8aead-490e-4c96-b871-ea428f1717fd":{"schema":{"type":"string","enum":["ethereum","optimism","polygon","arbitrum","zora","base","zero","solana","hyperliquid"],"isRequired":true,"uniqueKey":"","typeLabel":"enum\u003cstring>"},"required":true,"name":"chain","in":"path"},"909c5547-37eb-44f1-9537-ad658948657b":{"schema":{"type":"string","default":"0x5180db8f5c931aae63c74266b211f580155ecac8","description":"The contract / token address.","isRequired":true,"uniqueKey":"","typeLabel":"string"},"required":true,"name":"contractAddress","in":"path"},"3dbda601-5a18-4f58-be9e-7e37c5de9c19":{"schema":{"type":"string","enum":["open","closed"],"description":"Position status filter. \"open\" = currently held (>= \\$1 value), \"closed\" = fully exited or dust (\u003c \\$1 value).","example":"closed","isRequired":true,"uniqueKey":"","typeLabel":"enum\u003cstring>"},"required":true,"name":"status","in":"path"},"d3df8ad6-d00d-4178-a082-3fb34a6ba40e":{"schema":{"type":"string","enum":["value","latest"],"default":"value","description":"Sorting method. \"value\" (default): sorts by realized gains for closed positions, 30-day sell cost basis for open. \"latest\": sorts by close date for closed positions, open date for open.","isRequired":false,"uniqueKey":"","typeLabel":"enum\u003cstring>"},"required":false,"name":"sort","in":"query"},"480a16fa-2b82-4043-a081-6cf37d96c31d":{"schema":{"type":"array","description":"If included, only include transactions with actions on the provided chains. Defaults to `base`, `ethereum`, `solana`. Pass `all` to see transactions on all supported chains.","items":{"enum":["ethereum","optimism","polygon","arbitrum","zora","base","zero","solana","hyperliquid","all"],"type":"string","uniqueKey":"items.[INDEX]","typeLabel":"enum\u003cstring>"},"readOnly":true,"isRequired":false,"uniqueKey":"","typeLabel":"enum\u003cstring>[]"},"required":false,"name":"chains","in":"query"},"35d6116f-dcfe-40f6-a6e0-978b43056552":{"schema":{"type":"number","minimum":1,"default":1,"description":"Page number for pagination (1-based)","isRequired":false,"uniqueKey":"","typeLabel":"number"},"required":false,"name":"page","in":"query"},"913e6924-aafc-426e-9f20-81e7b84eb924":{"schema":{"type":"number","minimum":1,"maximum":100,"default":20,"description":"Number of positions per page (max 100)","isRequired":false,"uniqueKey":"","typeLabel":"number"},"required":false,"name":"limit","in":"query"}},"responses":{"53267817-d433-43b5-bb57-468a87c2a4d5":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"totalCompletions":{"type":"number","description":"Number of unique addresses that purchased this token in the last 24 hours","isRequired":true,"uniqueKey":"items.[INDEX].totalCompletions","typeLabel":"number"},"itemTitle":{"type":"string","description":"Display title for the position (typically profile name)","isRequired":true,"uniqueKey":"items.[INDEX].itemTitle","typeLabel":"string"},"callToActions":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","isRequired":true,"uniqueKey":"items.[INDEX].callToActions.items.[INDEX].text","typeLabel":"string"},"url":{"type":"string","isRequired":true,"uniqueKey":"items.[INDEX].callToActions.items.[INDEX].url","typeLabel":"string"}},"required":["text","url"],"uniqueKey":"items.[INDEX].callToActions.items.[INDEX]","typeLabel":"object"},"description":"Action buttons/links for this position","isRequired":true,"uniqueKey":"items.[INDEX].callToActions","typeLabel":"object[]"},"metadata":{"type":"object","properties":{"tokenChain":{"type":"string","enum":["ethereum","optimism","polygon","arbitrum","zora","base","zero","solana","hyperliquid"],"description":"Blockchain network (e.g., ethereum, solana, base)","isRequired":true,"uniqueKey":"items.[INDEX].metadata.tokenChain","typeLabel":"enum\u003cstring>"},"tokenSymbol":{"type":"string","description":"Token ticker symbol","isRequired":true,"uniqueKey":"items.[INDEX].metadata.tokenSymbol","typeLabel":"string"},"tokenName":{"type":"string","description":"Human-readable token name","isRequired":true,"uniqueKey":"items.[INDEX].metadata.tokenName","typeLabel":"string"},"tokenAddress":{"type":"string","description":"Contract address of the token","isRequired":true,"uniqueKey":"items.[INDEX].metadata.tokenAddress","typeLabel":"string"},"metadataType":{"type":"string","enum":["token"],"isRequired":true,"uniqueKey":"items.[INDEX].metadata.metadataType","typeLabel":"enum\u003cstring>"},"totalSupply":{"oneOf":[{"type":"string","description":"Total token supply if known","isRequired":true,"uniqueKey":"items.[INDEX].metadata.totalSupply.oneOf.0","typeLabel":"string"},{"type":"null","description":"Total token supply if known","isRequired":true,"uniqueKey":"items.[INDEX].metadata.totalSupply.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].metadata.totalSupply","typeLabel":"string | null"},"perpPositionType":{"oneOf":[{"type":"string","enum":["long","short"],"description":"For perp positions, whether this is a 'long' or 'short' position. Null for spot positions.","isRequired":true,"uniqueKey":"items.[INDEX].metadata.perpPositionType.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["long","short"],"description":"For perp positions, whether this is a 'long' or 'short' position. Null for spot positions.","isRequired":true,"uniqueKey":"items.[INDEX].metadata.perpPositionType.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].metadata.perpPositionType","typeLabel":"enum\u003cstring> | null"},"perpLeverage":{"oneOf":[{"type":"number","description":"For perp positions, the leverage multiplier (e.g., 5 for 5x leverage). Null for spot positions.","isRequired":true,"uniqueKey":"items.[INDEX].metadata.perpLeverage.oneOf.0","typeLabel":"number"},{"type":"null","description":"For perp positions, the leverage multiplier (e.g., 5 for 5x leverage). Null for spot positions.","isRequired":true,"uniqueKey":"items.[INDEX].metadata.perpLeverage.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].metadata.perpLeverage","typeLabel":"number | null"},"positionAmount":{"type":"number","description":"Current token balance held. A value >= 0.0001 indicates an open position; \u003c 0.0001 indicates closed. For perps, this is the un-leveraged amount.","isRequired":true,"uniqueKey":"items.[INDEX].metadata.positionAmount","typeLabel":"number"},"positionStats":{"type":"object","properties":{"boughtUSD":{"type":"number","description":"Total USD spent buying this token (all-time). For perps, this is the un-leveraged amount.","isRequired":true,"uniqueKey":"items.[INDEX].metadata.positionStats.boughtUSD","typeLabel":"number"},"soldUSD":{"type":"number","description":"Total USD received from selling this token (all-time). For perps, this is the un-leveraged amount.","isRequired":true,"uniqueKey":"items.[INDEX].metadata.positionStats.soldUSD","typeLabel":"number"},"realizedGainsUSD":{"type":"number","description":"Realized profit/loss in USD (sold value minus cost basis of sold tokens)","isRequired":true,"uniqueKey":"items.[INDEX].metadata.positionStats.realizedGainsUSD","typeLabel":"number"},"holdingsCostBasisUSD":{"type":"number","description":"USD cost basis of tokens currently held (for unrealized P\u0026L calculation). For perps, this is the un-leveraged amount.","isRequired":true,"uniqueKey":"items.[INDEX].metadata.positionStats.holdingsCostBasisUSD","typeLabel":"number"},"receivedCostBasisUSD":{"type":"number","description":"Total USD value of tokens received via airdrops/transfers (all-time)","isRequired":true,"uniqueKey":"items.[INDEX].metadata.positionStats.receivedCostBasisUSD","typeLabel":"number"},"holdingReceivedCostBasisUSD":{"type":"number","description":"USD cost basis of currently held received tokens","isRequired":true,"uniqueKey":"items.[INDEX].metadata.positionStats.holdingReceivedCostBasisUSD","typeLabel":"number"},"isOpen":{"type":"boolean","description":"Whether this position is currently open","isRequired":true,"uniqueKey":"items.[INDEX].metadata.positionStats.isOpen","typeLabel":"boolean"},"boughtUSDWithLeverage":{"type":"number","description":"For leveraged perp positions, total USD spent multiplied by leverage. Only present for hyperliquid.","uniqueKey":"items.[INDEX].metadata.positionStats.boughtUSDWithLeverage","typeLabel":"number"},"soldUSDWithLeverage":{"type":"number","description":"For leveraged perp positions, total USD received multiplied by leverage. Only present for hyperliquid.","uniqueKey":"items.[INDEX].metadata.positionStats.soldUSDWithLeverage","typeLabel":"number"},"holdingsCostBasisUSDWithLeverage":{"type":"number","description":"For leveraged perp positions, cost basis of held tokens multiplied by leverage. Only present for hyperliquid.","uniqueKey":"items.[INDEX].metadata.positionStats.holdingsCostBasisUSDWithLeverage","typeLabel":"number"},"unavailable":{"type":"boolean","enum":[true],"description":"True when position metrics could not be computed","uniqueKey":"items.[INDEX].metadata.positionStats.unavailable","typeLabel":"enum\u003cboolean>"}},"required":["boughtUSD","soldUSD","realizedGainsUSD","holdingsCostBasisUSD","receivedCostBasisUSD","holdingReceivedCostBasisUSD","isOpen"],"description":"Aggregated trading statistics for this position","isRequired":true,"uniqueKey":"items.[INDEX].metadata.positionStats","typeLabel":"object"},"trades":{"type":"array","items":{"type":"object","properties":{"tokenAmount":{"type":"number","description":"The amount of tokens traded. Negative for sells.","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].tokenAmount","typeLabel":"number"},"usdCost":{"type":"number","description":"The USD cost traded for all tokens. Negative for sells.","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].usdCost","typeLabel":"number"},"marketCap":{"oneOf":[{"type":"number","description":"The market cap of the token at the time of this trade","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].marketCap.oneOf.0","typeLabel":"number"},{"type":"null","description":"The market cap of the token at the time of this trade","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].marketCap.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].marketCap","typeLabel":"number | null"},"timestamp":{"type":"number","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].timestamp","typeLabel":"number"},"transactionHash":{"type":"string","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].transactionHash","typeLabel":"string"},"direction":{"type":"string","enum":["buy","sell"],"isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].direction","typeLabel":"enum\u003cstring>"},"classification":{"oneOf":[{"type":"string","enum":["spot","perp","send","receive"],"description":"High-level trade classification: 'spot' for spot trades, 'perp' for perpetual futures, 'send' for outgoing transfers, 'receive' for airdrops/incoming transfers. Null for legacy trades.","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].classification.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["spot","perp","send","receive"],"description":"High-level trade classification: 'spot' for spot trades, 'perp' for perpetual futures, 'send' for outgoing transfers, 'receive' for airdrops/incoming transfers. Null for legacy trades.","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].classification.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].classification","typeLabel":"enum\u003cstring> | null"},"intent":{"type":"string","enum":["enter","exit"],"description":"Whether this trade is entering or exiting a position. For spot trades, 'enter' = buy and 'exit' = sell. For perps, direction depends on position type (e.g., opening a short is 'enter' even though the trade side is 'sell').","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].intent","typeLabel":"enum\u003cstring>"},"perpPositionType":{"oneOf":[{"type":"string","enum":["long","short"],"description":"For perps positions, whether this is a 'long' or 'short' position. Null for spot trades.","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].perpPositionType.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["long","short"],"description":"For perps positions, whether this is a 'long' or 'short' position. Null for spot trades.","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].perpPositionType.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].perpPositionType","typeLabel":"enum\u003cstring> | null"},"perpLeverage":{"oneOf":[{"type":"number","description":"For perps positions, the leverage multiplier (e.g., 5 for 5x leverage). Null for spot trades.","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].perpLeverage.oneOf.0","typeLabel":"number"},{"type":"null","description":"For perps positions, the leverage multiplier (e.g., 5 for 5x leverage). Null for spot trades.","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].perpLeverage.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].perpLeverage","typeLabel":"number | null"},"comments":{"type":"array","items":{"type":"object","properties":{"uid":{"type":"string","description":"Unique identifier for the comment","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].uid","typeLabel":"string"},"transactionHash":{"type":"string","description":"The transaction hash associated with the swap","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].transactionHash","typeLabel":"string"},"chain":{"type":"string","enum":["ethereum","optimism","polygon","arbitrum","zora","base","zero","solana","hyperliquid"],"isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].chain","typeLabel":"enum\u003cstring>"},"tokenAddress":{"type":"string","description":"The token address associated with the swap","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].tokenAddress","typeLabel":"string"},"commentText":{"type":"string","description":"The comment text","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].commentText","typeLabel":"string"},"timestamp":{"type":"number","description":"Unix timestamp of when the comment was created","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].timestamp","typeLabel":"number"},"isAppUserComment":{"type":"boolean","description":"Whether the comment was created by a user of this partner's app","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].isAppUserComment","typeLabel":"boolean"},"metrics":{"type":"object","properties":{"copyCount":{"type":"number","description":"The number of times the comment has been copied","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].metrics.copyCount","typeLabel":"number"},"copyVolume":{"type":"string","description":"The volume of the comment in USD","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].metrics.copyVolume","typeLabel":"string"},"likeCount":{"type":"number","description":"The number of likes on this comment","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].metrics.likeCount","typeLabel":"number"},"isLikedByUser":{"type":"boolean","description":"Whether the requesting user has liked this comment","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].metrics.isLikedByUser","typeLabel":"boolean"}},"required":["copyCount","copyVolume","likeCount","isLikedByUser"],"isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].metrics","typeLabel":"object"},"signerAddress":{"type":"string","description":"The Ethereum address of the comment author","uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].signerAddress","typeLabel":"string"},"replies":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Unique identifier for the reply","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].id","typeLabel":"string"},"text":{"type":"string","description":"The reply text","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].text","typeLabel":"string"},"author":{"type":"object","properties":{"type":{"type":"string","enum":["user"],"isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.type","typeLabel":"enum\u003cstring>"},"address":{"type":"string","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.address","typeLabel":"string"},"name":{"type":"string","description":"The name of the feed actor. Use this field for maximum forward compatibility.","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.name","typeLabel":"string"},"images":{"type":"object","properties":{"raw":{"oneOf":[{"type":"string","description":"The full-sized image","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.images.raw.oneOf.0","typeLabel":"string"},{"type":"null","description":"The full-sized image","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.images.raw.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.images.raw","typeLabel":"string | null"},"xs":{"oneOf":[{"type":"string","description":"75x75","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.images.xs.oneOf.0","typeLabel":"string"},{"type":"null","description":"75x75","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.images.xs.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.images.xs","typeLabel":"string | null"},"sm":{"oneOf":[{"type":"string","description":"300x300","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.images.sm.oneOf.0","typeLabel":"string"},{"type":"null","description":"300x300","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.images.sm.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.images.sm","typeLabel":"string | null"}},"required":["raw","xs","sm"],"description":"An image of the feed actor. Use this field for maximum forward compatibility.","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.images","typeLabel":"object"},"profile":{"type":"object","properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.id","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.name","typeLabel":"string"},"images":{"type":"object","properties":{"raw":{"oneOf":[{"type":"string","description":"The full-sized image","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.images.raw.oneOf.0","typeLabel":"string"},{"type":"null","description":"The full-sized image","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.images.raw.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.images.raw","typeLabel":"string | null"},"xs":{"oneOf":[{"type":"string","description":"75x75","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.images.xs.oneOf.0","typeLabel":"string"},{"type":"null","description":"75x75","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.images.xs.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.images.xs","typeLabel":"string | null"},"sm":{"oneOf":[{"type":"string","description":"300x300","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.images.sm.oneOf.0","typeLabel":"string"},{"type":"null","description":"300x300","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.images.sm.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.images.sm","typeLabel":"string | null"}},"required":["raw","xs","sm"],"description":"URLs for different size squares.","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.images","typeLabel":"object"},"addresses":{"type":"array","items":{"type":"string","uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.addresses.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.addresses","typeLabel":"string[]"},"metadata":{"type":"object","properties":{"farcasterUsername":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.metadata.farcasterUsername.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.metadata.farcasterUsername.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.metadata.farcasterUsername","typeLabel":"string | null"},"farcasterId":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.metadata.farcasterId.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.metadata.farcasterId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.metadata.farcasterId","typeLabel":"number | null"},"lensHandle":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.metadata.lensHandle.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.metadata.lensHandle.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.metadata.lensHandle","typeLabel":"string | null"},"ensName":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.metadata.ensName.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.metadata.ensName.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.metadata.ensName","typeLabel":"string | null"},"twitterHandle":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.metadata.twitterHandle.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.metadata.twitterHandle.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.metadata.twitterHandle","typeLabel":"string | null"},"debankName":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.metadata.debankName.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.metadata.debankName.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.metadata.debankName","typeLabel":"string | null"},"hlName":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.metadata.hlName.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.metadata.hlName.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.metadata.hlName","typeLabel":"string | null"},"commentCount30d":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.metadata.commentCount30d.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.metadata.commentCount30d.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.metadata.commentCount30d","typeLabel":"number | null"},"pnl30d":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.metadata.pnl30d.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.metadata.pnl30d.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.metadata.pnl30d","typeLabel":"number | null"},"winRate30d":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.metadata.winRate30d.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.metadata.winRate30d.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.metadata.winRate30d","typeLabel":"number | null"},"tradeCount30d":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.metadata.tradeCount30d.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.metadata.tradeCount30d.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.metadata.tradeCount30d","typeLabel":"number | null"},"roiPercent30d":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.metadata.roiPercent30d.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.metadata.roiPercent30d.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.metadata.roiPercent30d","typeLabel":"number | null"},"pnl7d":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.metadata.pnl7d.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.metadata.pnl7d.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.metadata.pnl7d","typeLabel":"number | null"},"winRate7d":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.metadata.winRate7d.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.metadata.winRate7d.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.metadata.winRate7d","typeLabel":"number | null"},"tradeCount7d":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.metadata.tradeCount7d.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.metadata.tradeCount7d.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.metadata.tradeCount7d","typeLabel":"number | null"},"roiPercent7d":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.metadata.roiPercent7d.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.metadata.roiPercent7d.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.metadata.roiPercent7d","typeLabel":"number | null"},"medianHoldingTimeMinutes":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.metadata.medianHoldingTimeMinutes.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.metadata.medianHoldingTimeMinutes.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.metadata.medianHoldingTimeMinutes","typeLabel":"number | null"}},"required":["farcasterUsername","farcasterId","lensHandle","ensName","twitterHandle","debankName","hlName","commentCount30d","pnl30d","winRate30d","tradeCount30d","roiPercent30d","pnl7d","winRate7d","tradeCount7d","roiPercent7d","medianHoldingTimeMinutes"],"isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.metadata","typeLabel":"object"},"isNSFW":{"oneOf":[{"type":"boolean","description":"`false` when the profile is clean. Otherwise an object with `nsfwImage` and `nsfwText` booleans indicating which axes the scanner flagged. Clients decide whether to render, censor, or hide the underlying content.","enum":[false],"isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.isNSFW.oneOf.0","typeLabel":"enum\u003cboolean>"},{"type":"object","description":"`false` when the profile is clean. Otherwise an object with `nsfwImage` and `nsfwText` booleans indicating which axes the scanner flagged. Clients decide whether to render, censor, or hide the underlying content.","required":["nsfwImage","nsfwText"],"properties":{"nsfwImage":{"type":"boolean","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.isNSFW.oneOf.1.nsfwImage","typeLabel":"boolean"},"nsfwText":{"type":"boolean","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.isNSFW.oneOf.1.nsfwText","typeLabel":"boolean"}},"isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.isNSFW.oneOf.1","typeLabel":"object"}],"isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.isNSFW","typeLabel":"enum\u003cboolean> | object"},"externalId":{"type":"string","uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile.externalId","typeLabel":"string"}},"required":["id","name","images","addresses","metadata","isNSFW"],"description":"Profile of the user (including additional known addresses and extra metadata). Use this field to tailor your UI specifically.","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author.profile","typeLabel":"object"}},"required":["type","address","name","images","profile"],"description":"The actor that completed an action to create a feed item.","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].author","typeLabel":"object"},"timestamp":{"type":"number","description":"Unix timestamp of when the reply was created","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].timestamp","typeLabel":"number"},"likeCount":{"type":"number","description":"The number of likes on this reply","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].likeCount","typeLabel":"number"},"isLikedByUser":{"type":"boolean","description":"Whether the requesting user has liked this reply","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX].isLikedByUser","typeLabel":"boolean"}},"required":["id","text","author","timestamp","likeCount","isLikedByUser"],"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies.items.[INDEX]","typeLabel":"object"},"description":"Replies to this comment, only included when fetching a single position","uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX].replies","typeLabel":"object[]"}},"required":["uid","transactionHash","chain","tokenAddress","commentText","timestamp","isAppUserComment","metrics"],"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX].comments","typeLabel":"object[]"}},"required":["tokenAmount","usdCost","marketCap","timestamp","transactionHash","direction","classification","intent","perpPositionType","perpLeverage","comments"],"uniqueKey":"items.[INDEX].metadata.trades.items.[INDEX]","typeLabel":"object"},"description":"Complete list of all buy/sell transactions for this token by this actor, ordered by timestamp descending","isRequired":true,"uniqueKey":"items.[INDEX].metadata.trades","typeLabel":"object[]"},"positionAmountWithLeverage":{"type":"number","description":"For leveraged perp positions, the position amount multiplied by leverage (capital at risk). Only present for hyperliquid.","uniqueKey":"items.[INDEX].metadata.positionAmountWithLeverage","typeLabel":"number"}},"required":["tokenChain","tokenSymbol","tokenName","tokenAddress","metadataType","totalSupply","perpPositionType","perpLeverage","positionAmount","positionStats","trades"],"description":"Token details and position statistics including all trades","isRequired":true,"uniqueKey":"items.[INDEX].metadata","typeLabel":"object"},"insights":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","isRequired":true,"uniqueKey":"items.[INDEX].insights.items.[INDEX].text","typeLabel":"string"}},"required":["text"],"uniqueKey":"items.[INDEX].insights.items.[INDEX]","typeLabel":"object"},"description":"AI-generated insights and metrics about this position","isRequired":true,"uniqueKey":"items.[INDEX].insights","typeLabel":"object[]"},"metrics":{"type":"object","properties":{"copyCount":{"type":"number","description":"The number of times the comment has been copied","isRequired":true,"uniqueKey":"items.[INDEX].metrics.copyCount","typeLabel":"number"},"copyVolume":{"type":"string","description":"The volume of the comment in USD","isRequired":true,"uniqueKey":"items.[INDEX].metrics.copyVolume","typeLabel":"string"},"likeCount":{"type":"number","description":"The number of likes on this comment","isRequired":true,"uniqueKey":"items.[INDEX].metrics.likeCount","typeLabel":"number"},"isLikedByUser":{"type":"boolean","description":"Whether the requesting user has liked this comment","isRequired":true,"uniqueKey":"items.[INDEX].metrics.isLikedByUser","typeLabel":"boolean"},"replyCount":{"type":"number","description":"Number of replies on this position","isRequired":true,"uniqueKey":"items.[INDEX].metrics.replyCount","typeLabel":"number"},"commentCount":{"type":"number","description":"The number of author comments on this position","isRequired":true,"uniqueKey":"items.[INDEX].metrics.commentCount","typeLabel":"number"}},"required":["copyCount","copyVolume","likeCount","isLikedByUser","replyCount","commentCount"],"description":"Engagement metrics: copytrade count and volume, reply count, comment count","isRequired":true,"uniqueKey":"items.[INDEX].metrics","typeLabel":"object"},"itemId":{"type":"string","description":"Unique identifier for this feed card (position)","isRequired":true,"uniqueKey":"items.[INDEX].itemId","typeLabel":"string"},"timestamp":{"type":"number","description":"Unix timestamp of the most recent trade in this position","isRequired":true,"uniqueKey":"items.[INDEX].timestamp","typeLabel":"number"},"cardLatestTradeAt":{"type":"number","description":"Unix timestamp of the most recent trade in this position. Used for \"latest\" sort ordering.","isRequired":true,"uniqueKey":"items.[INDEX].cardLatestTradeAt","typeLabel":"number"},"actor":{"type":"object","properties":{"type":{"type":"string","enum":["user"],"isRequired":true,"uniqueKey":"items.[INDEX].actor.type","typeLabel":"enum\u003cstring>"},"address":{"type":"string","isRequired":true,"uniqueKey":"items.[INDEX].actor.address","typeLabel":"string"},"name":{"type":"string","description":"The name of the feed actor. Use this field for maximum forward compatibility.","isRequired":true,"uniqueKey":"items.[INDEX].actor.name","typeLabel":"string"},"images":{"type":"object","properties":{"raw":{"oneOf":[{"type":"string","description":"The full-sized image","isRequired":true,"uniqueKey":"items.[INDEX].actor.images.raw.oneOf.0","typeLabel":"string"},{"type":"null","description":"The full-sized image","isRequired":true,"uniqueKey":"items.[INDEX].actor.images.raw.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].actor.images.raw","typeLabel":"string | null"},"xs":{"oneOf":[{"type":"string","description":"75x75","isRequired":true,"uniqueKey":"items.[INDEX].actor.images.xs.oneOf.0","typeLabel":"string"},{"type":"null","description":"75x75","isRequired":true,"uniqueKey":"items.[INDEX].actor.images.xs.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].actor.images.xs","typeLabel":"string | null"},"sm":{"oneOf":[{"type":"string","description":"300x300","isRequired":true,"uniqueKey":"items.[INDEX].actor.images.sm.oneOf.0","typeLabel":"string"},{"type":"null","description":"300x300","isRequired":true,"uniqueKey":"items.[INDEX].actor.images.sm.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].actor.images.sm","typeLabel":"string | null"}},"required":["raw","xs","sm"],"description":"An image of the feed actor. Use this field for maximum forward compatibility.","isRequired":true,"uniqueKey":"items.[INDEX].actor.images","typeLabel":"object"},"profile":{"type":"object","properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.id","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.name","typeLabel":"string"},"images":{"type":"object","properties":{"raw":{"oneOf":[{"type":"string","description":"The full-sized image","isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.images.raw.oneOf.0","typeLabel":"string"},{"type":"null","description":"The full-sized image","isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.images.raw.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.images.raw","typeLabel":"string | null"},"xs":{"oneOf":[{"type":"string","description":"75x75","isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.images.xs.oneOf.0","typeLabel":"string"},{"type":"null","description":"75x75","isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.images.xs.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.images.xs","typeLabel":"string | null"},"sm":{"oneOf":[{"type":"string","description":"300x300","isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.images.sm.oneOf.0","typeLabel":"string"},{"type":"null","description":"300x300","isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.images.sm.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.images.sm","typeLabel":"string | null"}},"required":["raw","xs","sm"],"description":"URLs for different size squares.","isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.images","typeLabel":"object"},"addresses":{"type":"array","items":{"type":"string","uniqueKey":"items.[INDEX].actor.profile.addresses.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.addresses","typeLabel":"string[]"},"metadata":{"type":"object","properties":{"farcasterUsername":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.metadata.farcasterUsername.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.metadata.farcasterUsername.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.metadata.farcasterUsername","typeLabel":"string | null"},"farcasterId":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.metadata.farcasterId.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.metadata.farcasterId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.metadata.farcasterId","typeLabel":"number | null"},"lensHandle":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.metadata.lensHandle.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.metadata.lensHandle.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.metadata.lensHandle","typeLabel":"string | null"},"ensName":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.metadata.ensName.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.metadata.ensName.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.metadata.ensName","typeLabel":"string | null"},"twitterHandle":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.metadata.twitterHandle.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.metadata.twitterHandle.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.metadata.twitterHandle","typeLabel":"string | null"},"debankName":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.metadata.debankName.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.metadata.debankName.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.metadata.debankName","typeLabel":"string | null"},"hlName":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.metadata.hlName.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.metadata.hlName.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.metadata.hlName","typeLabel":"string | null"},"commentCount30d":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.metadata.commentCount30d.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.metadata.commentCount30d.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.metadata.commentCount30d","typeLabel":"number | null"},"pnl30d":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.metadata.pnl30d.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.metadata.pnl30d.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.metadata.pnl30d","typeLabel":"number | null"},"winRate30d":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.metadata.winRate30d.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.metadata.winRate30d.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.metadata.winRate30d","typeLabel":"number | null"},"tradeCount30d":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.metadata.tradeCount30d.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.metadata.tradeCount30d.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.metadata.tradeCount30d","typeLabel":"number | null"},"roiPercent30d":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.metadata.roiPercent30d.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.metadata.roiPercent30d.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.metadata.roiPercent30d","typeLabel":"number | null"},"pnl7d":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.metadata.pnl7d.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.metadata.pnl7d.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.metadata.pnl7d","typeLabel":"number | null"},"winRate7d":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.metadata.winRate7d.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.metadata.winRate7d.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.metadata.winRate7d","typeLabel":"number | null"},"tradeCount7d":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.metadata.tradeCount7d.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.metadata.tradeCount7d.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.metadata.tradeCount7d","typeLabel":"number | null"},"roiPercent7d":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.metadata.roiPercent7d.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.metadata.roiPercent7d.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.metadata.roiPercent7d","typeLabel":"number | null"},"medianHoldingTimeMinutes":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.metadata.medianHoldingTimeMinutes.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.metadata.medianHoldingTimeMinutes.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.metadata.medianHoldingTimeMinutes","typeLabel":"number | null"}},"required":["farcasterUsername","farcasterId","lensHandle","ensName","twitterHandle","debankName","hlName","commentCount30d","pnl30d","winRate30d","tradeCount30d","roiPercent30d","pnl7d","winRate7d","tradeCount7d","roiPercent7d","medianHoldingTimeMinutes"],"isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.metadata","typeLabel":"object"},"isNSFW":{"oneOf":[{"type":"boolean","description":"`false` when the profile is clean. Otherwise an object with `nsfwImage` and `nsfwText` booleans indicating which axes the scanner flagged. Clients decide whether to render, censor, or hide the underlying content.","enum":[false],"isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.isNSFW.oneOf.0","typeLabel":"enum\u003cboolean>"},{"type":"object","description":"`false` when the profile is clean. Otherwise an object with `nsfwImage` and `nsfwText` booleans indicating which axes the scanner flagged. Clients decide whether to render, censor, or hide the underlying content.","required":["nsfwImage","nsfwText"],"properties":{"nsfwImage":{"type":"boolean","isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.isNSFW.oneOf.1.nsfwImage","typeLabel":"boolean"},"nsfwText":{"type":"boolean","isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.isNSFW.oneOf.1.nsfwText","typeLabel":"boolean"}},"isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.isNSFW.oneOf.1","typeLabel":"object"}],"isRequired":true,"uniqueKey":"items.[INDEX].actor.profile.isNSFW","typeLabel":"enum\u003cboolean> | object"},"externalId":{"type":"string","uniqueKey":"items.[INDEX].actor.profile.externalId","typeLabel":"string"}},"required":["id","name","images","addresses","metadata","isNSFW"],"description":"Profile of the user (including additional known addresses and extra metadata). Use this field to tailor your UI specifically.","isRequired":true,"uniqueKey":"items.[INDEX].actor.profile","typeLabel":"object"}},"required":["type","address","name","images","profile"],"description":"Profile information of the trader who holds/held this position","isRequired":true,"uniqueKey":"items.[INDEX].actor","typeLabel":"object"},"imageUrl":{"type":"string","description":"Profile avatar image URL of the actor","uniqueKey":"items.[INDEX].imageUrl","typeLabel":"string"}},"required":["totalCompletions","itemTitle","callToActions","metadata","insights","metrics","itemId","timestamp","cardLatestTradeAt","actor"],"uniqueKey":"items.[INDEX]","typeLabel":"object"},"uniqueKey":"","typeLabel":"object[]"},"examples":{"Example":{"title":"Example","value":[{"totalCompletions":123,"itemTitle":"\u003cstring>","callToActions":[{"text":"\u003cstring>","url":"\u003cstring>"}],"metadata":{"tokenChain":"ethereum","tokenSymbol":"\u003cstring>","tokenName":"\u003cstring>","tokenAddress":"\u003cstring>","metadataType":"token","totalSupply":"\u003cstring>","perpPositionType":"long","perpLeverage":123,"positionAmount":123,"positionStats":{"boughtUSD":123,"soldUSD":123,"realizedGainsUSD":123,"holdingsCostBasisUSD":123,"receivedCostBasisUSD":123,"holdingReceivedCostBasisUSD":123,"isOpen":true,"boughtUSDWithLeverage":123,"soldUSDWithLeverage":123,"holdingsCostBasisUSDWithLeverage":123,"unavailable":true},"trades":[{"tokenAmount":123,"usdCost":123,"marketCap":123,"timestamp":123,"transactionHash":"\u003cstring>","direction":"buy","classification":"spot","intent":"enter","perpPositionType":"long","perpLeverage":123,"comments":[{"uid":"\u003cstring>","transactionHash":"\u003cstring>","chain":"ethereum","tokenAddress":"\u003cstring>","commentText":"\u003cstring>","timestamp":123,"isAppUserComment":true,"metrics":{"copyCount":123,"copyVolume":"\u003cstring>","likeCount":123,"isLikedByUser":true},"signerAddress":"\u003cstring>","replies":[{"id":"\u003cstring>","text":"\u003cstring>","author":{"type":"user","address":"\u003cstring>","name":"\u003cstring>","images":{"raw":"\u003cstring>","xs":"\u003cstring>","sm":"\u003cstring>"},"profile":{"id":"\u003cstring>","name":"\u003cstring>","images":{"raw":"\u003cstring>","xs":"\u003cstring>","sm":"\u003cstring>"},"addresses":["\u003cstring>"],"metadata":{"farcasterUsername":"\u003cstring>","farcasterId":123,"lensHandle":"\u003cstring>","ensName":"\u003cstring>","twitterHandle":"\u003cstring>","debankName":"\u003cstring>","hlName":"\u003cstring>","commentCount30d":123,"pnl30d":123,"winRate30d":123,"tradeCount30d":123,"roiPercent30d":123,"pnl7d":123,"winRate7d":123,"tradeCount7d":123,"roiPercent7d":123,"medianHoldingTimeMinutes":123},"isNSFW":false,"externalId":"\u003cstring>"}},"timestamp":123,"likeCount":123,"isLikedByUser":true}]}]}],"positionAmountWithLeverage":123},"insights":[{"text":"\u003cstring>"}],"metrics":{"copyCount":123,"copyVolume":"\u003cstring>","likeCount":123,"isLikedByUser":true,"replyCount":123,"commentCount":123},"itemId":"\u003cstring>","timestamp":123,"cardLatestTradeAt":123,"actor":{"type":"user","address":"\u003cstring>","name":"\u003cstring>","images":{"raw":"\u003cstring>","xs":"\u003cstring>","sm":"\u003cstring>"},"profile":{"id":"\u003cstring>","name":"\u003cstring>","images":{"raw":"\u003cstring>","xs":"\u003cstring>","sm":"\u003cstring>"},"addresses":["\u003cstring>"],"metadata":{"farcasterUsername":"\u003cstring>","farcasterId":123,"lensHandle":"\u003cstring>","ensName":"\u003cstring>","twitterHandle":"\u003cstring>","debankName":"\u003cstring>","hlName":"\u003cstring>","commentCount30d":123,"pnl30d":123,"winRate30d":123,"tradeCount30d":123,"roiPercent30d":123,"pnl7d":123,"winRate7d":123,"tradeCount7d":123,"roiPercent7d":123,"medianHoldingTimeMinutes":123},"isNSFW":false,"externalId":"\u003cstring>"}},"imageUrl":"\u003cstring>"}]}},"exampleType":"generated"}},"exampleType":"generated"},"bd192f89-8094-4c99-899b-0445960f6cac":{"description":"The request payload or query string parameter you passed was not valid","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"f0ce4f06-b2a6-4659-8ea5-620cd01a55d9":{"description":"The item you requested could not be found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"bc315f11-e29a-4b76-ba86-745626fb709e":{},"bece3007-41f0-48d6-a865-7d147eb74847":{"bearerAuth":{"type":"http","scheme":"bearer","scopes":[]}}},"servers":{"f6ded4c7-7bfc-4cf0-8a45-8d43f8eaebfd":{"url":"https://api.clicker.xyz"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1"},"subdomain":"daylight","siteName":"Clicker - Feed API","title":"Token Positions - Clicker - Feed API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-03-30T21:52:53.029Z","originalFileLocation":"api-reference/token-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=\"Returns positions for a specific token across all traders. Open positions are those with remaining value \u0026gt;= \\$1; closed positions have remaining value \u0026lt; \\$1 (fully exited or dust). The metadata.trades array is only populated with trades which were commented on.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Clicker - Feed API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/daylight/CMCTfNiN3WU3NsB4/_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/daylight/CMCTfNiN3WU3NsB4/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/daylight/CMCTfNiN3WU3NsB4/_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/daylight/CMCTfNiN3WU3NsB4/_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/daylight/CMCTfNiN3WU3NsB4/_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/daylight/CMCTfNiN3WU3NsB4/_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/daylight/CMCTfNiN3WU3NsB4/_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/daylight/CMCTfNiN3WU3NsB4/_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/daylight/CMCTfNiN3WU3NsB4/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Token Positions - Clicker - Feed API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Returns positions for a specific token across all traders. Open positions are those with remaining value \u0026gt;= \\$1; closed positions have remaining value \u0026lt; \\$1 (fully exited or dust). The metadata.trades array is only populated with trades which were commented on.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Clicker - Feed API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.clicker.xyz/api-reference/token-positions\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://daylight.mintlify.site/_mintlify/api/og/v2?division=Positions\u0026amp;title=Token+Positions\u0026amp;description=Returns+positions+for+a+specific+token+across+all+traders.+Open+positions+are+those+with+remaining+value+%3E%3D+%5C%241%3B+closed+positions+have+remaining+value+%3C+%5C%241+%28fu\u0026amp;theme=9f63d7a21bc52507fa13c54b\u0026amp;signature=e87784fcba1d0f6425076da8c69fbd18e24af60faa8a372f5b863c751a01be6e\">\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=\"Token Positions - Clicker - Feed API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Returns positions for a specific token across all traders. Open positions are those with remaining value \u0026gt;= \\$1; closed positions have remaining value \u0026lt; \\$1 (fully exited or dust). The metadata.trades array is only populated with trades which were commented on.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://daylight.mintlify.site/_mintlify/api/og/v2?division=Positions\u0026amp;title=Token+Positions\u0026amp;description=Returns+positions+for+a+specific+token+across+all+traders.+Open+positions+are+those+with+remaining+value+%3E%3D+%5C%241%3B+closed+positions+have+remaining+value+%3C+%5C%241+%28fu\u0026amp;theme=9f63d7a21bc52507fa13c54b\u0026amp;signature=e87784fcba1d0f6425076da8c69fbd18e24af60faa8a372f5b863c751a01be6e\">\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/daylight/CMCTfNiN3WU3NsB4/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Clicker - Feed API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#06C933\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.clicker.xyz/api-reference/token-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/token-positions.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.clicker.xyz/#organization\",\"name\":\"Clicker - Feed API\",\"url\":\"https://docs.clicker.xyz\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/daylight/NfKjeKiEPHohvQ-j/logo/light.svg?fit=max\u0026auto=format\u0026n=NfKjeKiEPHohvQ-j\u0026q=85\u0026s=28d8534629d647d18445ec4441e0529a\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.clicker.xyz#website\",\"name\":\"Clicker - Feed API\",\"url\":\"https://docs.clicker.xyz\",\"publisher\":{\"@id\":\"https://docs.clicker.xyz/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.clicker.xyz/api-reference/token-positions#webpage\",\"url\":\"https://docs.clicker.xyz/api-reference/token-positions\",\"name\":\"Token Positions\",\"description\":\"Returns positions for a specific token across all traders. Open positions are those with remaining value >= \\\\$1; closed positions have remaining value \\u003c \\\\$1 (fully exited or dust). The metadata.trades array is only populated with trades which were commented on.\",\"dateModified\":\"2026-03-30T21:52:53.029Z\",\"isPartOf\":{\"@id\":\"https://docs.clicker.xyz#website\"},\"breadcrumb\":{\"@id\":\"https://docs.clicker.xyz/api-reference/token-positions#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.clicker.xyz/api-reference/token-positions#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Positions\",\"item\":\"https://docs.clicker.xyz/api-reference/position\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Token Positions\",\"item\":\"https://docs.clicker.xyz/api-reference/token-positions\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.clicker.xyz/api-reference/token-positions#apireference\",\"headline\":\"Token Positions\",\"name\":\"Token Positions\",\"description\":\"Returns positions for a specific token across all traders. Open positions are those with remaining value >= \\\\$1; closed positions have remaining value \\u003c \\\\$1 (fully exited or dust). The metadata.trades array is only populated with trades which were commented on.\",\"url\":\"https://docs.clicker.xyz/api-reference/token-positions\",\"mainEntityOfPage\":{\"@id\":\"https://docs.clicker.xyz/api-reference/token-positions#webpage\"},\"dateModified\":\"2026-03-30T21:52:53.029Z\",\"publisher\":{\"@id\":\"https://docs.clicker.xyz/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.clicker.xyz#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Clicker - Feed API\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Clicker - Feed API\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/token-positions.md","siteName":"Clicker - Feed API","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/guides/what-is-clicker"}]},{"tab":"API Reference","groups":[{"group":"API Reference","pages":[{"title":"Request API Key","href":"/about/request-api-key"}]},{"group":"OpenAPI (Hidden)","hidden":true,"pages":[{"group":"hidden","pages":[{"title":"Retrieve active communities matching a string","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 get /v1/communities/search","href":"/api-reference/hidden/retrieve-active-communities-matching-a-string"},{"title":"Retrieve all active community slugs","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 get /v1/communities/slugs","href":"/api-reference/hidden/retrieve-all-active-community-slugs"},{"title":"Retrieve a community","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 get /v1/communities/{contractAddress}","href":"/api-reference/hidden/retrieve-a-community"},{"title":"Retrieve a token","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 get /v1/tokens/{chain}/{contractAddress}","href":"/api-reference/hidden/retrieve-a-token"},{"title":"Retrieve all partners","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 get /v1/partners","href":"/api-reference/hidden/retrieve-all-partners"},{"title":"Submit a partner","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 post /v1/partners","href":"/api-reference/hidden/submit-a-partner"},{"title":"Remove a partner","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 delete /v1/partners/{partnerId}","href":"/api-reference/hidden/remove-a-partner"},{"title":"Request refresh of social info for a single wallet","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 post /v1/moderation/wallet-social/{address}/refresh","href":"/api-reference/hidden/request-refresh-of-social-info-for-a-single-wallet"},{"title":"Add a validated address to an existing profile","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 post /v1/profiles/merge","href":"/api-reference/hidden/add-a-validated-address-to-an-existing-profile"},{"title":"Remove address(es) a profile.","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 delete /v1/profiles/{profileUid}/addresses","href":"/api-reference/hidden/remove-addresses-a-profile"},{"title":"Update Twitter username (and optional image) for a profile. Username is required, but imageUrl is optional (and can be null to remove the image).","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 post /v1/addresses/{identifier}/profile/metadata","href":"/api-reference/hidden/update-twitter-username-and-optional-image-for-a-profile-username-is-required-but-imageurl-is-optional-and-can-be-null-to-remove-the-image"},{"title":"Search","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 get /v1/search","href":"/api-reference/hidden/search"}]},{"group":"Social - Feed, Profiles and Discovery","pages":[{"title":"Get a feed of token positions with recent comments for each","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 get /v1/tokens/feed","href":"/api-reference/social--feed-profiles-and-discovery/get-a-feed-of-token-positions-with-recent-comments-for-each"},{"title":"Get Token Positions","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 get /v1/tokens/{chain}/{contractAddress}/positions/{status}","href":"/api-reference/social--feed-profiles-and-discovery/get-token-positions"},{"title":"Return all comments, sorted by most recent first, for a particular contract and chain pair","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 get /v1/tokens/{chain}/{contractAddress}/comments","href":"/api-reference/social--feed-profiles-and-discovery/return-all-comments-sorted-by-most-recent-first-for-a-particular-contract-and-chain-pair"},{"title":"Regsiter a Feed Webhook","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 post /v1/webhooks/feed","href":"/api-reference/social--feed-profiles-and-discovery/regsiter-a-feed-webhook"},{"title":"Validate Feed Webhook Destination","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 post /v1/webhooks/feed/{uid}/validate","href":"/api-reference/social--feed-profiles-and-discovery/validate-feed-webhook-destination"},{"title":"Update Feed Webhook","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 put /v1/webhooks/feed/{uid}","href":"/api-reference/social--feed-profiles-and-discovery/update-feed-webhook"},{"title":"Remove Feed Webhook","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 delete /v1/webhooks/feed/{uid}","href":"/api-reference/social--feed-profiles-and-discovery/remove-feed-webhook"},{"title":"Get Addresses Subscribed To Feed Webhook","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 get /v1/webhooks/feed/{uid}/addresses","href":"/api-reference/social--feed-profiles-and-discovery/get-addresses-subscribed-to-feed-webhook"},{"title":"Get Feed for Profile","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 get /v1/feed/actor","href":"/api-reference/social--feed-profiles-and-discovery/get-feed-for-profile"},{"title":"Get Feed","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 get /v1/feed","href":"/api-reference/social--feed-profiles-and-discovery/get-feed"},{"title":"Get Position","deprecated":true,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 get /v1/feed/item/{id}","href":"/api-reference/social--feed-profiles-and-discovery/get-position"},{"title":"Get Feed Item","deprecated":true,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 get /v1/feed/item/{address}/{chain}/{contract}","href":"/api-reference/social--feed-profiles-and-discovery/get-feed-item"},{"title":"Position by Actor / Token / Timestamp","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 get /v1/positions/{address}/{chain}/{contract}/{timestamp}","href":"/api-reference/social--feed-profiles-and-discovery/position-by-actor-token-timestamp"},{"title":"Get Position","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 get /v1/position/{id}","href":"/api-reference/social--feed-profiles-and-discovery/get-position-1"},{"title":"Get For You Feed","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 get /v1/for-you-feed","href":"/api-reference/social--feed-profiles-and-discovery/get-for-you-feed"},{"title":"Follow an address","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 put /v1/addresses/{addressOrUid}/follow","href":"/api-reference/social--feed-profiles-and-discovery/follow-an-address"},{"title":"Unfollow an address","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 delete /v1/addresses/{addressOrUid}/follow","href":"/api-reference/social--feed-profiles-and-discovery/unfollow-an-address"},{"title":"Bulk follow addresses","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 post /v1/addresses/follow/bulk","href":"/api-reference/social--feed-profiles-and-discovery/bulk-follow-addresses"},{"title":"Get addresses associated with a Farcaster profile","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 get /v1/addresses/from-farcaster/{username}","href":"/api-reference/social--feed-profiles-and-discovery/get-addresses-associated-with-a-farcaster-profile"},{"title":"Get User Leaderboard Rankings","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 get /v1/leaderboard/ranking","href":"/api-reference/social--feed-profiles-and-discovery/get-user-leaderboard-rankings"},{"title":"Get Available Leaderboard Sections","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 get /v1/leaderboard/sections","href":"/api-reference/social--feed-profiles-and-discovery/get-available-leaderboard-sections"},{"title":"Get PnL Leaderboards","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 get /v1/leaderboard","href":"/api-reference/social--feed-profiles-and-discovery/get-pnl-leaderboards"},{"title":"Get PnL Leaderboard (V2)","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 get /v2/leaderboard","href":"/api-reference/social--feed-profiles-and-discovery/get-pnl-leaderboard-v2"},{"title":"Get User Leaderboard Ranking (V2)","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 get /v2/leaderboard/ranking","href":"/api-reference/social--feed-profiles-and-discovery/get-user-leaderboard-ranking-v2"},{"title":"Get Leaderboard Snapshot by Date","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 get /v1/leaderboard-snapshots/{date}","href":"/api-reference/social--feed-profiles-and-discovery/get-leaderboard-snapshot-by-date"},{"title":"Get Profile Positions","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 get /v1/addresses/{identifier}/positions/{status}","href":"/api-reference/social--feed-profiles-and-discovery/get-profile-positions"},{"title":"Get Profile","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 get /v1/addresses/{identifier}/profile","href":"/api-reference/social--feed-profiles-and-discovery/get-profile"},{"title":"Get Profile by Farcaster Username","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 get /v1/farcaster/{username}/profile","href":"/api-reference/social--feed-profiles-and-discovery/get-profile-by-farcaster-username"},{"title":"Get Profile PnL","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 get /v1/addresses/{identifier}/pnl","href":"/api-reference/social--feed-profiles-and-discovery/get-profile-pnl"},{"title":"Provide a name and avatar for this profile.","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 put /v1/profiles/{identifier}/name","href":"/api-reference/social--feed-profiles-and-discovery/provide-a-name-and-avatar-for-this-profile"},{"title":"Delete the name and avatar for this profile.","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 delete /v1/profiles/{identifier}/name","href":"/api-reference/social--feed-profiles-and-discovery/delete-the-name-and-avatar-for-this-profile"},{"title":"Get Address’s Followers","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 get /v1/addresses/{identifier}/followers","href":"/api-reference/social--feed-profiles-and-discovery/get-address’s-followers"},{"title":"Get Address's Follows","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 get /v1/addresses/{identifier}/follows","href":"/api-reference/social--feed-profiles-and-discovery/get-addresss-follows"},{"title":"Get Feed Card Replies (Deprecated)","deprecated":true,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 get /v1/feed/item/{address}/{chain}/{contract}/replies","href":"/api-reference/social--feed-profiles-and-discovery/get-feed-card-replies-deprecated"},{"title":"Get Position Replies","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 get /v1/position/{id}/replies","href":"/api-reference/social--feed-profiles-and-discovery/get-position-replies"},{"title":"Get Position Replies","deprecated":true,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 get /v1/feed/item/{id}/replies","href":"/api-reference/social--feed-profiles-and-discovery/get-position-replies-1"},{"title":"Get partner payment information","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 get /v1/payments/partner","href":"/api-reference/social--feed-profiles-and-discovery/get-partner-payment-information"},{"title":"Get creator payment information","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 get /v1/payments/creator/{creatorIdentifier}","href":"/api-reference/social--feed-profiles-and-discovery/get-creator-payment-information"},{"title":"Top Positions from Commenters","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 get /v1/top-positions/commenters","href":"/api-reference/social--feed-profiles-and-discovery/top-positions-from-commenters"},{"title":"Top Commented Positions","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 get /v1/top-positions/commented","href":"/api-reference/social--feed-profiles-and-discovery/top-commented-positions"}]},{"group":"Sending Notifications","pages":[{"title":"Get Registered Webhooks","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 get /v1/webhooks/feed","href":"/api-reference/sending-notifications/get-registered-webhooks"},{"title":"Get Registered Webhooks","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 get /v1/webhooks","href":"/api-reference/sending-notifications/get-registered-webhooks-1"},{"title":"Register Webhook","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 post /v1/webhooks","href":"/api-reference/sending-notifications/register-webhook"},{"title":"Validate Webhook Destination","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 post /v1/webhooks/{uid}/validate","href":"/api-reference/sending-notifications/validate-webhook-destination"},{"title":"Update Webhook","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 put /v1/webhooks/{uid}","href":"/api-reference/sending-notifications/update-webhook"},{"title":"Remove Webhook","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 delete /v1/webhooks/{uid}","href":"/api-reference/sending-notifications/remove-webhook"},{"title":"Get Addresses Subscribed To Webhook","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 get /v1/webhooks/{uid}/addresses","href":"/api-reference/sending-notifications/get-addresses-subscribed-to-webhook"}]},{"group":"Displaying Transactions","pages":[{"title":"Get Copytrades for Position","deprecated":true,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 get /v1/feed/item/{id}/copytrades","href":"/api-reference/displaying-transactions/get-copytrades-for-position"},{"title":"Get Comment Author’s Copytrades by Token","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 get /v1/feed/item/{address}/{chain}/{contract}/copytrades","href":"/api-reference/displaying-transactions/get-comment-author’s-copytrades-by-token"},{"title":"Get Copytrades for Position","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 get /v1/position/{id}/copytrades","href":"/api-reference/displaying-transactions/get-copytrades-for-position-1"},{"title":"Get Swap Comments","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 get /v1/swap-comments","href":"/api-reference/displaying-transactions/get-swap-comments"},{"title":"Get Swap Comment by ID","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 get /v1/swap-comment/{id}","href":"/api-reference/displaying-transactions/get-swap-comment-by-id"},{"title":"Get Comment Likes","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 get /v1/swap-comment/{id}/likes","href":"/api-reference/displaying-transactions/get-comment-likes"},{"title":"Get Reply Likes","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 get /v1/comment-reply/{id}/likes","href":"/api-reference/displaying-transactions/get-reply-likes"}]},{"group":"Submitting Transactions","pages":[{"title":"Create Swap Comment","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 post /v1/swap-comments","href":"/api-reference/submitting-transactions/create-swap-comment"},{"title":"Create Copyswap Intent","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 post /v1/swap-comment/{id}/copyswap","href":"/api-reference/submitting-transactions/create-copyswap-intent"},{"title":"Create Reply on Comment","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 post /v1/swap-comment/{id}/replies","href":"/api-reference/submitting-transactions/create-reply-on-comment"},{"title":"Create Position Reply","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 post /v1/position/{id}/replies","href":"/api-reference/submitting-transactions/create-position-reply"},{"title":"Create Position Reply","deprecated":true,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 post /v1/feed/item/{id}/replies","href":"/api-reference/submitting-transactions/create-position-reply-1"},{"title":"Like a Comment","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 post /v1/swap-comment/{id}/like","href":"/api-reference/submitting-transactions/like-a-comment"},{"title":"Unlike a Comment","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 delete /v1/swap-comment/{id}/like","href":"/api-reference/submitting-transactions/unlike-a-comment"},{"title":"Like a Reply","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 post /v1/comment-reply/{id}/like","href":"/api-reference/submitting-transactions/like-a-reply"},{"title":"Unlike a Reply","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 delete /v1/comment-reply/{id}/like","href":"/api-reference/submitting-transactions/unlike-a-reply"},{"title":"Block Comment","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 post /v1/feed/block-comment","href":"/api-reference/submitting-transactions/block-comment"},{"title":"Block Reply","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 post /v1/feed/block-reply","href":"/api-reference/submitting-transactions/block-reply"},{"title":"Block User","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 post /v1/feed/block-user","href":"/api-reference/submitting-transactions/block-user"},{"title":"Block Token","deprecated":null,"version":null,"openapi":"https://api.clicker.xyz/internal-documentation/openapi.json?v=1 post /v1/feed/block-token","href":"/api-reference/submitting-transactions/block-token"}]}]},{"group":"Profiles","pages":[{"title":"About Profiles","href":"/about/profiles"},{"title":"Profile","openapi":"GET /v1/addresses/{identifier}/profile","href":"/api-reference/profile"},{"title":"Address Follows","openapi":"GET /v1/addresses/{identifier}/follows","href":"/api-reference/profile-follows"},{"title":"Address Followers","openapi":"GET /v1/addresses/{identifier}/followers","href":"/api-reference/profile-followers"},{"title":"Follow Address","openapi":"PUT /v1/addresses/{addressOrUid}/follow","href":"/api-reference/follow"},{"title":"Unfollow Address","openapi":"DELETE /v1/addresses/{addressOrUid}/follow","href":"/api-reference/unfollow"},{"title":"Bulk Follow/Unfollow Addresses","openapi":"POST /v1/addresses/follow/bulk","href":"/api-reference/follow-bulk"},{"title":"Profile Name","openapi":"PUT /v1/profiles/{identifier}/name","href":"/api-reference/profile-set-name"},{"title":"Profile Name","openapi":"DELETE /v1/profiles/{identifier}/name","href":"/api-reference/profile-delete-name"}]},{"group":"Positions","pages":[{"title":"Position by ID","openapi":"GET /v1/position/{id}","href":"/api-reference/position"},{"title":"Position by Details","openapi":"GET /v1/positions/{address}/{chain}/{contract}/{timestamp}","description":"Find a position (actor address, chain, token address) by the UNIX timestamp. Can be used to find a position for a user's specific swap transaction.","href":"/api-reference/position-by-timestamp"},{"title":"Token Positions","openapi":"GET /v1/tokens/{chain}/{contractAddress}/positions/{status}","href":"/api-reference/token-positions"},{"title":"Profile Positions","openapi":"GET /v1/addresses/{identifier}/positions/{status}","description":"\nReturns token positions for a profile containing full trade history.\n\n**Position status:**\n- `open`: Tokens currently held (remaining position value >= \\$1)\n- `closed`: Tokens fully exited or dust remaining (remaining position value \u003c \\$1)\n\nEach position includes:\n- Token metadata (chain, symbol, name, address, image)\n- Position stats (bought/sold USD, realized gains, current holdings cost basis)\n- All individual trades for that token with timestamps and comments\n- Engagement metrics (copytrade count/volume, comments, replies)\n\n**Sorting options:**\n- `value` (default): For closed positions, sorted by realized gains descending (with zero-sell positions pushed to bottom). For open positions, sorted by 30-day sell cost basis.\n- `latest`: For closed positions, sorted by close date. For open positions, sorted by open date.\n\n**Aggregation:**\nBy default, returns aggregated positions across all addresses in the profile. Set `providedAddressesOnly=true` to scope to just the provided wallet address.\n","href":"/api-reference/profile-positions"}]},{"group":"Leaderboard","pages":[{"title":"Leaderboard","openapi":"GET /v2/leaderboard","href":"/api-reference/leaderboard-v2"},{"title":"Leaderboard Ranking","openapi":"GET /v2/leaderboard/ranking","href":"/api-reference/leaderboard-v2-ranking"}]},{"group":"Comments","pages":[{"title":"Signing Comments","href":"/signing-comments"},{"title":"Tokens Feed","openapi":"GET /v1/tokens/feed","href":"/api-reference/tokens-feed"},{"title":"Post Comment","openapi":"POST /v1/swap-comments","href":"/api-reference/post-comment"},{"title":"Token Comments","openapi":"GET /v1/tokens/{chain}/{contractAddress}/comments","href":"/api-reference/token-comments"},{"title":"Retrieve Comments","openapi":"GET /v1/swap-comments","href":"/api-reference/retrieve-comment"},{"title":"Copyswap Intent","openapi":"POST /v1/swap-comment/{id}/copyswap","href":"/api-reference/copy-intent"}]},{"group":"Webhooks","pages":[{"title":"Integration Guide","href":"/api-reference/webhook-integration"},{"title":"Webhook Payloads","href":"/api-reference/webhook-payloads"},{"title":"Verifying Webhooks","href":"/api-reference/verifying-webhooks"},{"title":"Registered Webhooks","openapi":"GET /v1/webhooks/feed","href":"/api-reference/webhook"},{"title":"Register Webhook","openapi":"POST /v1/webhooks/feed","href":"/api-reference/webhook-register"},{"title":"Validate Destination","openapi":"POST /v1/webhooks/feed/{uid}/validate","href":"/api-reference/webhook-validate"},{"title":"Update Webhook","openapi":"PUT /v1/webhooks/feed/{uid}","href":"/api-reference/webhook-update"},{"title":"Webhook Addresses","openapi":"GET /v1/webhooks/feed/{uid}/addresses","href":"/api-reference/webhook-addresses"}]},{"group":"Feed","pages":[{"title":"Feed","openapi":"GET /v1/feed","href":"/api-reference/feed"},{"title":"Feed, Specific Addresses","openapi":"GET /v1/feed/actor","href":"/api-reference/feed-actor"}]},{"group":"Response Types","pages":[{"title":"Profile","href":"/response-types/profile-extended"},{"title":"ProfileWithMetrics","href":"/response-types/profile-with-metrics"},{"title":"FeedActor","href":"/response-types/feed-actor"},{"title":"Feed","href":"/response-types/feed-response"},{"title":"HydratedPosition","href":"/response-types/hydrated-position"},{"title":"Trader","href":"/response-types/trader-v2"},{"title":"Leaderboard","href":"/response-types/leaderboard-v2-response"},{"title":"SwapComment","href":"/response-types/swap-comment-response"},{"title":"WebhookConfig","href":"/response-types/webhook-response"}]}]}]},"basePath":"","title":"Token Positions - Clicker - Feed API","buildId":"dpl_596ePT575z4qnAFksq1biRW97aLY","deploymentId":"dpl_596ePT575z4qnAFksq1biRW97aLY","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C9Wu0MeN.js","utils-jWgu-6Qf.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DBD8f9qn.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-BGuX1ui5.js","snippetPresets-Evy63nQB.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BQHO1lnV.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-B6C8m-t_.js","shallow-BG4cT0fH.js","getApiPlaygroundDisplay-CgEPrE-D.js","CodeSnippet-CU8JyZ9N.js","CodeSnippets-BnxHU32T.js","Page-D6S0Yh6q.js","getPastedJson-CwiYOonh.js","icon-DYDpWmDf.js","MethodPill-C-J-l7_c.js","DuplicateIcon-B6ARwg9w.js","createIcon-Dsv4MtDq.js","DynamicMarkdown-CtasenyM.js","SectionHeading-YNcgYwjB.js","axios-vUo_bRtp.js","Markdown-CwLx6PAg.js","clsx-C3kuh_dz.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CmKHfscc.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-U3mI6Ljh.js"]}