Skip to main content
GET
/
v1
/
tokens
/
{chain}
/
{contractAddress}
/
comments
Return all comments, sorted by most recent first, for a particular contract and chain pair
curl --request GET \
  --url https://api.clicker.xyz/v1/tokens/{chain}/{contractAddress}/comments \
  --header 'Authorization: Bearer <token>'
[
  {
    "itemId": "<string>",
    "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
        }
      }
    },
    "timestamp": 123,
    "comment": {
      "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
        }
      ]
    },
    "trade": {
      "tokenAmount": 123,
      "usdCost": 123,
      "marketCap": 123,
      "timestamp": 123,
      "transactionHash": "<string>",
      "direction": "buy",
      "intent": "enter",
      "perpPositionType": "long",
      "perpLeverage": 123
    },
    "positionDetails": {
      "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
      },
      "positionAmountWithLeverage": 123
    },
    "token": {
      "chain": "ethereum",
      "symbol": "<string>",
      "name": "<string>",
      "address": "<string>",
      "commentCount": 123
    }
  }
]

Authorizations

Authorization
string
header
required

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

Path Parameters

chain
enum<string>
required
Available options:
ethereum,
optimism,
polygon,
arbitrum,
zora,
base,
zero,
solana,
hyperliquid
contractAddress
string
default:0x5180db8f5c931aae63c74266b211f580155ecac8
required

The contract / token address.

Query Parameters

limit
number

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

Response

200

itemId
string
required
actor
object
required

The actor that completed an action to create a feed item.

timestamp
number
required
comment
object
required
trade
object
required
positionDetails
object
required
token
object
required