Skip to main content
POST
/
v1
/
swap-comments
Create Swap Comment
curl --request POST \
  --url https://api.clicker.xyz/v1/swap-comments \
  --header 'Content-Type: application/json' \
  --data '
{
  "transactionHash": "<string>",
  "txnHash": "<string>",
  "chain": "ethereum",
  "tokenAddress": "<string>",
  "commentText": "<string>",
  "signature": "<string>",
  "signerAddress": "0xa4e221aa5a7ba51b5d5c7d5c923bfb9bcebcb252"
}
'
{
  "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>"
  }
}

Authorizations

Authorization
string
header
required

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

Body

application/json
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>
Comment: <comment_text>
signerAddress
string
default:0xa4e221aa5a7ba51b5d5c7d5c923bfb9bcebcb252
required

The address / public key.

transactionHash
string

The transaction hash associated with the swap

txnHash
string

DEPRECATED; use transactionHash

Response

200

uid
string
required

Unique identifier for the comment

transactionHash
string
required

The transaction hash associated with the swap

txnHash
string
required

DEPRECATED; use transactionHash

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

createdAt
string
required

DEPRECATED; use timestamp

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