curl --request GET \
--url https://api.clicker.xyz/v1/position/{id} \
--header 'Authorization: Bearer <token>'{
"totalCompletions": 123,
"itemTitle": "<string>",
"callToActions": [
{
"text": "<string>",
"url": "<string>"
}
],
"metadata": {
"tokenChain": "ethereum",
"tokenSymbol": "<string>",
"tokenName": "<string>",
"tokenAddress": "<string>",
"metadataType": "token",
"totalSupply": "<string>",
"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": "<string>",
"direction": "buy",
"classification": "spot",
"intent": "enter",
"perpPositionType": "long",
"perpLeverage": 123,
"comments": [
{
"uid": "<string>",
"transactionHash": "<string>",
"chain": "ethereum",
"tokenAddress": "<string>",
"commentText": "<string>",
"timestamp": 123,
"isAppUserComment": true,
"metrics": {
"copyCount": 123,
"copyVolume": "<string>",
"likeCount": 123,
"isLikedByUser": true
},
"signerAddress": "<string>",
"replies": [
{
"id": "<string>",
"text": "<string>",
"author": {
"type": "user",
"address": "<string>",
"name": "<string>",
"images": {
"raw": "<string>",
"xs": "<string>",
"sm": "<string>"
},
"profile": {
"id": "<string>",
"name": "<string>",
"images": {
"raw": "<string>",
"xs": "<string>",
"sm": "<string>"
},
"addresses": [
"<string>"
],
"metadata": {
"farcasterUsername": "<string>",
"farcasterId": 123,
"lensHandle": "<string>",
"ensName": "<string>",
"twitterHandle": "<string>",
"debankName": "<string>",
"hlName": "<string>",
"commentCount30d": 123,
"pnl30d": 123,
"winRate30d": 123,
"tradeCount30d": 123,
"roiPercent30d": 123,
"pnl7d": 123,
"winRate7d": 123,
"tradeCount7d": 123,
"roiPercent7d": 123,
"medianHoldingTimeMinutes": 123
},
"externalId": "<string>"
}
},
"timestamp": 123
}
]
}
]
}
],
"positionAmountWithLeverage": 123
},
"insights": [
{
"text": "<string>"
}
],
"metrics": {
"copyCount": 123,
"copyVolume": "<string>",
"likeCount": 123,
"isLikedByUser": true,
"replyCount": 123,
"commentCount": 123
},
"itemId": "<string>",
"transactionHash": "<string>",
"timestamp": 123,
"cardLatestTradeAt": 123,
"actor": {
"type": "user",
"address": "<string>",
"name": "<string>",
"images": {
"raw": "<string>",
"xs": "<string>",
"sm": "<string>"
},
"profile": {
"id": "<string>",
"name": "<string>",
"images": {
"raw": "<string>",
"xs": "<string>",
"sm": "<string>"
},
"addresses": [
"<string>"
],
"metadata": {
"farcasterUsername": "<string>",
"farcasterId": 123,
"lensHandle": "<string>",
"ensName": "<string>",
"twitterHandle": "<string>",
"debankName": "<string>",
"hlName": "<string>",
"commentCount30d": 123,
"pnl30d": 123,
"winRate30d": 123,
"tradeCount30d": 123,
"roiPercent30d": 123,
"pnl7d": 123,
"winRate7d": 123,
"tradeCount7d": 123,
"roiPercent7d": 123,
"medianHoldingTimeMinutes": 123
},
"externalId": "<string>"
}
},
"imageUrl": "<string>"
}Given a position ID, get a single position with its trades and comments.
curl --request GET \
--url https://api.clicker.xyz/v1/position/{id} \
--header 'Authorization: Bearer <token>'{
"totalCompletions": 123,
"itemTitle": "<string>",
"callToActions": [
{
"text": "<string>",
"url": "<string>"
}
],
"metadata": {
"tokenChain": "ethereum",
"tokenSymbol": "<string>",
"tokenName": "<string>",
"tokenAddress": "<string>",
"metadataType": "token",
"totalSupply": "<string>",
"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": "<string>",
"direction": "buy",
"classification": "spot",
"intent": "enter",
"perpPositionType": "long",
"perpLeverage": 123,
"comments": [
{
"uid": "<string>",
"transactionHash": "<string>",
"chain": "ethereum",
"tokenAddress": "<string>",
"commentText": "<string>",
"timestamp": 123,
"isAppUserComment": true,
"metrics": {
"copyCount": 123,
"copyVolume": "<string>",
"likeCount": 123,
"isLikedByUser": true
},
"signerAddress": "<string>",
"replies": [
{
"id": "<string>",
"text": "<string>",
"author": {
"type": "user",
"address": "<string>",
"name": "<string>",
"images": {
"raw": "<string>",
"xs": "<string>",
"sm": "<string>"
},
"profile": {
"id": "<string>",
"name": "<string>",
"images": {
"raw": "<string>",
"xs": "<string>",
"sm": "<string>"
},
"addresses": [
"<string>"
],
"metadata": {
"farcasterUsername": "<string>",
"farcasterId": 123,
"lensHandle": "<string>",
"ensName": "<string>",
"twitterHandle": "<string>",
"debankName": "<string>",
"hlName": "<string>",
"commentCount30d": 123,
"pnl30d": 123,
"winRate30d": 123,
"tradeCount30d": 123,
"roiPercent30d": 123,
"pnl7d": 123,
"winRate7d": 123,
"tradeCount7d": 123,
"roiPercent7d": 123,
"medianHoldingTimeMinutes": 123
},
"externalId": "<string>"
}
},
"timestamp": 123
}
]
}
]
}
],
"positionAmountWithLeverage": 123
},
"insights": [
{
"text": "<string>"
}
],
"metrics": {
"copyCount": 123,
"copyVolume": "<string>",
"likeCount": 123,
"isLikedByUser": true,
"replyCount": 123,
"commentCount": 123
},
"itemId": "<string>",
"transactionHash": "<string>",
"timestamp": 123,
"cardLatestTradeAt": 123,
"actor": {
"type": "user",
"address": "<string>",
"name": "<string>",
"images": {
"raw": "<string>",
"xs": "<string>",
"sm": "<string>"
},
"profile": {
"id": "<string>",
"name": "<string>",
"images": {
"raw": "<string>",
"xs": "<string>",
"sm": "<string>"
},
"addresses": [
"<string>"
],
"metadata": {
"farcasterUsername": "<string>",
"farcasterId": 123,
"lensHandle": "<string>",
"ensName": "<string>",
"twitterHandle": "<string>",
"debankName": "<string>",
"hlName": "<string>",
"commentCount30d": 123,
"pnl30d": 123,
"winRate30d": 123,
"tradeCount30d": 123,
"roiPercent30d": 123,
"pnl7d": 123,
"winRate7d": 123,
"tradeCount7d": 123,
"roiPercent7d": 123,
"medianHoldingTimeMinutes": 123
},
"externalId": "<string>"
}
},
"imageUrl": "<string>"
}Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Optional viewer address(es) to populate isLikedByUser on comments and replies. Accepts a single address or an array of the viewer’s linked wallets (additional addresses beyond 10 are ignored).
200
A group of trades of a single token by a single actor comprising a position. Contains full trade history, position stats, and engagement metrics.
Number of unique addresses that purchased this token in the last 24 hours
Display title for the position (typically profile name)
Action buttons/links for this position
Show child attributes
Token details and position statistics including all trades
Show child attributes
AI-generated insights and metrics about this position
Show child attributes
Engagement metrics: copytrade count and volume, reply count, comment count
Show child attributes
Unique identifier for this feed card (position)
Transaction hash of the most recent trade in this position
Unix timestamp of the most recent trade in this position
Unix timestamp of the most recent trade in this position. Used for "latest" sort ordering.
Profile information of the trader who holds/held this position
Show child attributes
Profile avatar image URL of the actor