Skip to main content
GET
Get an asset's discount history

Path Parameters

symbol
string
required

Asset symbol — case-insensitive

Query Parameters

bucket
string

raw (default) samples directly from discount_snapshots; 1m reads the 1-minute continuous aggregate so longer ranges stay cheap. Any other value is rejected with 400 rather than silently falling back to raw (QA B-020).

from
string<date-time>

Inclusive lower bound on ts. Defaults to now − 24 hours.

to
string<date-time>

Inclusive upper bound on ts. Defaults to now.

limit
integer<int64>

Page size, clamped to [1, 5000]. Default 500.

Response

Time series of discount values, newest first

List envelope: { ok, generated_at, count, data: [...] }.

count
integer
required

Number of items in data.

Required range: x >= 0
data
object[]
required
generated_at
string
required

RFC3339 (UTC, millisecond, Z) build time of this response.

ok
boolean
required

Always true on a 2xx; errors use the {error, message} envelope instead.