GET /api/events/{eventId}/follow-trades

Returns the bubbles overlay for the event chart. Joins identity.market_trades × identity.follows for the requesting user, groups trades by (date_trunc(interval, filled_at), venue, marketId, side, outcome) and ranks the top-N traders per bucket by size. Bubble timestamps snap to the same candle x-coordinate as /history so frontends can render the overlay without coordination. Polymarket markets work end-to-end; Kalshi/DFlow trades are anonymous in the public data feed (see backend caveat in modules/kalshiIngest.ts) so Kalshi bubbles will be empty until a Helius webhook is wired.

curl -X GET "https://api.pear.trade/api/events/string/follow-trades"