Skip to main content

index/interfaces/TradeExecutedEvent.md

Emitted when a trade is executed on a bonding curve (buy/sell). Broadcast to token room. High-frequency event - may be throttled (1 per second per token).

Since​

7.1.0 - Extended with holderDelta and holderCount for real-time holdings support

Properties​

PropertyTypeDescription
candle?objectOptional 1-minute candle data for price tracking
candle.closenumberClosing price at end of minute
candle.highnumberHighest price during the minute
candle.lownumberLowest price during the minute
candle.opennumberOpening price during the minute
candle.resolutionnumberCandle resolution in seconds (60 for 1-minute)
candle.startTimenumberUnix timestamp of candle start (seconds)
candle.volumenumberTrading volume during the minute
holderCount?numberOptional current total holder count for the token
holderDelta?objectOptional holder rank information including balance and rank change
holderDelta.balancestringNew balance after the trade
holderDelta.previousRank?numberPrevious rank before this trade (undefined if new holder)
holderDelta.ranknumberCurrent rank among all holders (1 = largest holder)
holderDelta.type"NEW_HOLDER" | "EXITED_HOLDER" | "BALANCE_CHANGED"Type of holder change: NEW_HOLDER, EXITED_HOLDER, or BALANCE_CHANGED
holderDelta.userAddressstringWallet address of the holder whose position changed
icon?stringThe token's icon URL (sent with symbol)
inputAmountstring | numberAmount of input currency (string or number)
newMarketCap?stringOptional new market cap after the trade
newPrice?stringOptional new token price after the trade
outputAmountstring | numberAmount of output currency (string or number)
symbol?stringThe token's symbol (sent so a listing can update without a refetch)
timestampstringISO 8601 timestamp of when the trade occurred
tokenNamestringToken name for which the trade occurred
tradeType"BUY" | "SELL"Trade type: BUY or SELL
txnId?stringOptional transaction ID
userAddressstringWallet address of the trader