Builder Heatmap
builder_heatmapReveal a builder's trading volume, fees, and fills across every hour and weekday over the trailing 12 weeks, identifying peak activity times and whether patterns look bot-driven or human.
Instructions
When a builder's attributed flow actually trades (takes only the 0x-hex builder address — no other parameters): a 7x24 weekday-by-hour grid as days[], always 7 entries Sunday first with weekday 0 = Sunday through 6 = Saturday, each carrying hours[], always 24 entries with hour 0 first, and every cell reporting hour, volumeUsd, feesUsd and fills totalled over the whole window; zero-activity cells are zero-valued, never omitted. No period parameter and no per-week averaging — windowDays is fixed at 84, the trailing 12 weeks, so every weekday is sampled exactly 12 times — and both weekday and hour are UTC, never local time. Attributed fills slightly undercount versus ledger revenue (trigger-order stop/TP fills not yet attributed — see the response's dataNotes). Use for 'what hours does builder X's volume peak, is it bot-like around the clock or human trading hours, and when is it safe to ship?'. Requires Pro tier. The first call for a builder can take up to ~90 seconds while the API computes it; the result is then cached, so repeat the call if it times out.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| builder | Yes | Builder address (0x...) | |
| useToonFormat | No | Return data in compact toon format (default: true). Set to false for standard JSON. |