Skip to main content
When your webhook endpoint receives a POST request, the body will contain an events array with one or more event objects: 
{
  "events": [WebhookEvent, ...]
}

​
Common Fields

Each event object in the events array includes these fields:
FieldTypeDescription
eventIdstringUnique identifier for this event
eventTypestringThe type of event (see sections below)
walletAddressesstring[]The audience for this event

​
new-feed-item

Triggered when an actor trades a token. 
{
  "eventId": "string",
  "eventType": "new-feed-item",
  "reason": "first-buy",
  "walletAddresses": ["0x..."],
  "feedItem": HydratedPosition
}

​
Fields

FieldTypeDescription
reason"first-buy" | "repeat-buy" | "aped-in"Why this buy was considered noteworthy
walletAddressesstring[]Addresses that follow the trader
feedItemHydratedPositionThe position card for this trade
externalIdsstring[]External IDs for the audience (optional, only present if set)

​
Reasons

new-feed-item webhooks are generated for noteworthy buys. Sells do not generate new-feed-item follower webhooks.
ReasonMeaning
first-buyThe trader’s first buy of this token within Clicker’s notification counter window. The counter is keyed by trader address and token address.
repeat-buyThis buy caused the trader’s cumulative buy amount for this token to cross the notification threshold. The current threshold is $1,000.
aped-inThis buy was significantly larger than the trader’s average buy for this token. The current rule is current buy > 1.4x average buy size.
The notification counter window is two weeks and is extended on each evaluated buy. If a trader buys, sells, then buys the same token again within that window, the second buy is not a first-buy, but it can still generate a webhook if it qualifies as repeat-buy or aped-in.

​
comment-created

Triggered when an actor comments on their trade. 
{
  "eventId": "string",
  "eventType": "comment-created",
  "walletAddresses": ["0x..."],
  "feedItem": HydratedPosition,
  "comment": SwapCommentResponse
}

​
Fields

FieldTypeDescription
walletAddressesstring[]Addresses that follow the commenter
feedItemHydratedPositionThe position card for this trade
commentSwapCommentResponseThe actor’s comment
externalIdsstring[]External IDs for the audience (optional, only present if set)

​
copyswap

Triggered when an actor copies the subscriber’s trade. 
{
  "eventId": "string",
  "eventType": "copyswap",
  "walletAddresses": ["0x..."],
  "feedItem": HydratedPosition,
  "comment": SwapCommentResponse,
  "copyswapActor": FeedActor,
  "copyswapTrade": Trade
}

​
Fields

FieldTypeDescription
walletAddressesstring[]The comment author’s address (whose trade was copied)
feedItemHydratedPositionThe original position that was copied
commentSwapCommentResponseThe comment associated with the copytrade
copyswapActorFeedActorThe profile of the user who copied the trade
copyswapTradeTradeThe trade details of the copy (same shape as a trade in the feed)