Skip to main content
GET
KOL realized-PnL heatmap calendar

Authorizations

X-API-Key
string
header
required

Preferred for swaps-api endpoints (/swaps/*, /stats/*, /trending, /pool-events).

Query Parameters

from
string

Inclusive start date (UTC, YYYY-MM-DD). Defaults to to−30d.

to
string

Inclusive end date (UTC, YYYY-MM-DD). Defaults to today UTC.

pnl_mode
enum<string>
default:adjusted

PnL accounting mode. strict (FIFO) and adjusted (weighted-avg cost) are realized-PnL figures; raw is net cash-flow (Σ sells − Σ buys), not realized PnL. Unknown values fall back to adjusted.

Available options:
raw,
strict,
adjusted
top_n
integer
default:20

Number of KOL rows.

Required range: 1 <= x <= 30

Response

Calendar heatmap

scope
enum<string>
Available options:
kols
pnl_mode
string
from
string
to
string
top_n
integer
days
string[]

Full inclusive [from, to] day column header.

rows
object[]