Skip to main content
When your webhook endpoint receives a POST request, the body will contain one of the following payload shapes depending on the event type.

​
Common Fields

All webhook payloads include 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",
  "walletAddresses": ["0x..."],
  "feedItem": FeedResponse
}

​
Fields

FieldTypeDescription
walletAddressesstring[]Addresses that follow the trader
feedItemFeedResponseThe info of this trade

​
comment-created

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

​
Fields

FieldTypeDescription
walletAddressesstring[]Addresses that follow the commenter
feedItemFeedResponseThe info of this trade
commentSwapCommentResponseThe actor’s comment

​
copyswap

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

​
Fields

FieldTypeDescription
walletAddressesstring[]The comment author’s address (whose trade was copied)
feedItemFeedResponseThe original trade 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 FeedResponse’s trade field)