Skip to main content
POST
/
v1
/
swap-comments
Create Swap Comment
curl --request POST \
  --url https://api.clicker.xyz/v1/swap-comments \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "transactionHash": "<string>",
  "chain": "ethereum",
  "tokenAddress": "<string>",
  "commentText": "<string>",
  "signature": "<string>",
  "signerAddress": "0xa4e221aa5a7ba51b5d5c7d5c923bfb9bcebcb252"
}
'
{
  "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
          },
          "isNSFW": false,
          "externalId": "<string>"
        }
      },
      "timestamp": 123,
      "likeCount": 123,
      "isLikedByUser": true
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.clicker.xyz/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

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

Body

application/json
​
transactionHash
string
required

The transaction hash associated with the swap. For hyperliquid, you may pass a Hyperliquid order ID (oid) instead of a transaction hash.

Minimum string length: 1
​
chain
enum<string>
required
Available options:
ethereum,
optimism,
polygon,
arbitrum,
zora,
base,
zero,
solana,
hyperliquid
​
tokenAddress
string
required

The token address associated with the swap

​
commentText
string
required

The comment text. Must be between 1 and 9999 characters

Required string length: 1 - 9999
​
signature
string
required

The signature proving ownership of the signer address; the string to sign is:

Clicker Swap Comment:

Chain: <chain>
Token Address: <token_address>
Txn Hash: <txn_hash_or_oid>
Comment: <comment_text>

For the txn_hash field, use whatever value you passed as transactionHash (including a Hyperliquid oid if applicable).

​
signerAddress
string
default:0xa4e221aa5a7ba51b5d5c7d5c923bfb9bcebcb252
required

The address / public key.

Response

200

​
uid
string
required

Unique identifier for the comment

​
transactionHash
string
required

The transaction hash associated with the swap

​
chain
enum<string>
required
Available options:
ethereum,
optimism,
polygon,
arbitrum,
zora,
base,
zero,
solana,
hyperliquid
​
tokenAddress
string
required

The token address associated with the swap

​
commentText
string
required

The comment text

​
timestamp
number
required

Unix timestamp of when the comment was created

​
isAppUserComment
boolean
required

Whether the comment was created by a user of this partner's app

​
metrics
object
required
​
signerAddress
string

The Ethereum address of the comment author

​
replies
object[]

Replies to this comment, only included when fetching a single position