Skip to main content
GET
/
v1
/
feed
/
actor
Get Feed for Profile
curl --request GET \
  --url https://api.clicker.xyz/v1/feed/actor
{
  "items": [
    {
      "totalCompletions": 123,
      "imageUrl": "<string>",
      "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,
          "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>",
                "txnHash": "<string>",
                "chain": "ethereum",
                "tokenAddress": "<string>",
                "commentText": "<string>",
                "signerAddress": "<string>",
                "timestamp": 123,
                "createdAt": "<string>",
                "isAppUserComment": true,
                "metrics": {
                  "copyCount": 123,
                  "copyVolume": "<string>",
                  "earningsETH": "<string>",
                  "earningsSOL": "<string>"
                }
              }
            ]
          }
        ]
      },
      "insights": [
        {
          "text": "<string>"
        }
      ],
      "metrics": {
        "copyCount": 123,
        "copyVolume": "<string>",
        "earningsETH": "<string>",
        "earningsSOL": "<string>",
        "replyCount": 123,
        "commentCount": 123
      },
      "itemId": "<string>",
      "transactionHash": "<string>",
      "timestamp": 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,
            "farcasterDisplayName": "<string>",
            "lensHandle": "<string>",
            "ensName": "<string>",
            "twitterHandle": "<string>",
            "debankName": "<string>",
            "pumpName": "<string>",
            "commentCount30d": 123,
            "pnl30d": 123,
            "winRate30d": 123,
            "tradeCount30d": 123,
            "roiPercent30d": 123,
            "perAddressPnl30d": {},
            "perAddressRoiPercent30d": {}
          }
        }
      },
      "forYouTrade": {
        "tokenAmount": 123,
        "usdCost": 123,
        "marketCap": 123,
        "timestamp": 123,
        "transactionHash": "<string>",
        "direction": "buy",
        "perpPositionType": "long",
        "perpLeverage": 123,
        "comments": [
          {
            "uid": "<string>",
            "transactionHash": "<string>",
            "txnHash": "<string>",
            "chain": "ethereum",
            "tokenAddress": "<string>",
            "commentText": "<string>",
            "signerAddress": "<string>",
            "timestamp": 123,
            "createdAt": "<string>",
            "isAppUserComment": true,
            "metrics": {
              "copyCount": 123,
              "copyVolume": "<string>",
              "earningsETH": "<string>",
              "earningsSOL": "<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.

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.

providedAddressesOnly
boolean

Response

200

items
object[]
required
pagination
object
required