Skip to main content
GET
/
v1
/
feed
Get Feed
curl --request GET \
  --url https://api.clicker.xyz/v1/feed \
  --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>",
        "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",
            "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>"
                },
                "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>",
                          "commentCount30d": 123,
                          "pnl30d": 123,
                          "winRate30d": 123,
                          "tradeCount30d": 123,
                          "roiPercent30d": 123
                        }
                      }
                    },
                    "timestamp": 123
                  }
                ]
              }
            ]
          }
        ],
        "positionAmountWithLeverage": 123
      },
      "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>",
            "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",
        "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>"
            },
            "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>",
                      "commentCount30d": 123,
                      "pnl30d": 123,
                      "winRate30d": 123,
                      "tradeCount30d": 123,
                      "roiPercent30d": 123
                    }
                  }
                },
                "timestamp": 123
              }
            ]
          }
        ],
        "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

Response

200

​
items
object[]
required
​
pagination
object
required