Skip to main content
GET
/
v1
/
feed
/
actor
Get Feed for Profile
curl --request GET \
  --url https://api.clicker.xyz/v1/feed/actor \
  --header 'Authorization: Bearer <token>'
{
  "items": [
    {
      "totalCompletions": 123,
      "itemTitle": "<string>",
      "callToActions": [
        {
          "text": "<string>",
          "url": "<string>"
        }
      ],
      "metadata": {
        "tokenChain": "ethereum",
        "tokenSymbol": "<string>",
        "tokenName": "<string>",
        "tokenAddress": "<string>",
        "metadataType": "token",
        "totalSupply": "<string>",
        "positionAmount": 123,
        "positionStats": {
          "boughtUSD": 123,
          "soldUSD": 123,
          "realizedGainsUSD": 123,
          "holdingsCostBasisUSD": 123
        },
        "trades": [
          {
            "tokenAmount": 123,
            "usdCost": 123,
            "marketCap": 123,
            "timestamp": 123,
            "transactionHash": "<string>",
            "direction": "buy",
            "perpPositionType": "long",
            "perpLeverage": 123,
            "comments": [
              {
                "uid": "<string>",
                "transactionHash": "<string>",
                "chain": "ethereum",
                "tokenAddress": "<string>",
                "commentText": "<string>",
                "timestamp": 123,
                "isAppUserComment": true,
                "metrics": {
                  "copyCount": 123,
                  "copyVolume": "<string>"
                },
                "signerAddress": "<string>"
              }
            ]
          }
        ]
      },
      "insights": [
        {
          "text": "<string>"
        }
      ],
      "metrics": {
        "copyCount": 123,
        "copyVolume": "<string>",
        "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>",
            "pumpName": "<string>",
            "commentCount30d": 123,
            "pnl30d": 123,
            "winRate30d": 123,
            "tradeCount30d": 123,
            "roiPercent30d": 123
          }
        }
      },
      "imageUrl": "<string>",
      "forYouTrade": {
        "tokenAmount": 123,
        "usdCost": 123,
        "marketCap": 123,
        "timestamp": 123,
        "transactionHash": "<string>",
        "direction": "buy",
        "perpPositionType": "long",
        "perpLeverage": 123,
        "comments": [
          {
            "uid": "<string>",
            "transactionHash": "<string>",
            "chain": "ethereum",
            "tokenAddress": "<string>",
            "commentText": "<string>",
            "timestamp": 123,
            "isAppUserComment": true,
            "metrics": {
              "copyCount": 123,
              "copyVolume": "<string>"
            },
            "signerAddress": "<string>"
          }
        ],
        "alphaTags": {
          "big_entry": 198371.27
        },
        "maxAlphaScore": 123
      }
    }
  ],
  "pagination": {
    "olderCursor": "<string>",
    "olderItemsURL": "<string>",
    "newerCursor": "<string>",
    "newerItemsURL": "<string>"
  }
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

addresses
string[]
required
olderThan
string
newerThan
string
onlyWithComments
boolean
chains
enum<string>[]

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.

Available options:
ethereum,
optimism,
polygon,
arbitrum,
zora,
base,
zero,
solana,
hyperliquid,
all
limit
number

The total number of transactions to respond with. Defaults to 25.

injectForYou
boolean

When true, injects algorithmically-recommended For You trades into the feed as recommended content.

minTradeUsd
number

Filter to trades with absolute USD value >= this amount. Allowed values: 10, 100, 500, 1000

minMarketCap
number

Filter to trades with token market cap >= this amount. Allowed values: 100000, 1000000, 10000000

maxMarketCap
number

Filter to trades with token market cap < this amount. Allowed values: 100000, 1000000, 10000000

providedAddressesOnly
boolean

Response

200

items
object[]
required
pagination
object
required