API ReferenceBundle Lifecycle & Markers
Planned

Bundle Lifecycle & Markers

A bundle’s life as a timeline of markers — detected → entered → started dumping → exited or rugged — plus per-leader reputation across every cluster a wallet has ever run. The marker stream is what you overlay on a chart to show when coordination turned into a dump.

⚠️

Standalone marker, execution-cluster, and leader-reputation endpoints are on the roadmap. Today the lifecycle is reflected in each bundle’s status and evidence on the Bundles endpoints; the dedicated timeline and reputation surfaces below are coming. The shapes are stable.

Lifecycle markers

Each marker is a point-in-time event on a bundle, suitable for charting.

MarkerMeaning
detectedThe bundle was first identified
entryThe cluster opened / added to its position
dump_startCoordinated selling began
deriskedThe cluster took enough off the table to de-risk
exitThe cluster fully exited
mergedTwo clusters were found to be the same actor and merged
ruggedThe token rugged while the cluster was in it
execution_clusterA same-slot / Jito execution cohort was marked

Execution-cluster drilldown

The execution lane exposes the per-wallet structural evidence behind same-slot and Jito cohorts — which wallets executed together, in which slots. It answers “show me the wallets that moved in lockstep,” distinct from the holdings-based bundle members.

Leader reputation

Per-leader-wallet reputation aggregated across every bundle that wallet has led — so you can tell a one-off from a serial operator.

FieldDescription
bundles_ledHow many bundles this wallet has led
tokens_involvedDistinct tokens it’s run clusters on
avg_sold_pctAverage share the clusters sold (dump tendency)
sum_realized_pnlTotal realized PnL extracted across all bundles
current_exposureOpen exposure right now

Leader reputation is the “is this wallet a serial rugger?” lookup — a high bundles_led with a high avg_sold_pct across many tokens_involved is the signature of a repeat operator.