Skip to main content
GET
Batch Get Spot DEX Protocol timeseries

Authorizations

X-Blockworks-API-Key
string
header
required

API key sent in the X-Blockworks-API-Key header; x-messari-api-key is accepted for existing integrations. The catalog endpoints and models open to everyone need no key.

Path Parameters

granularity
enum<string>
required

Data granularity.

Available options:
1d

Query Parameters

series
string

Comma-separated Project ID values naming the series to return (up to 10). Omit it to get every Spot DEX Protocol as a series in one response.

timeframe
string

Time window, one of: to-date (ytd, qtd, mtd, dtd, htd); relative, followed by m, h, d or w (30d, 12h, 4w; 1y and 1M are not accepted, use 365d, 52w, ytd or a calendar year); a calendar day (YYYY-MM-DD), month (YYYY-MM) or year (YYYY); or an RFC3339 instant, which runs from then to now. Mutually exclusive with start/end. Optional: with no window at all the query runs from the beginning of the data to now, which is only served where it fits the cap of 9000 points of the requested granularity, so a window is in practice required at fine granularities.

start
string

Window start, inclusive (RFC3339, unix seconds, or YYYY-MM-DD). Optional; defaults to the beginning of the data.

end
string

Window end, exclusive (RFC3339, unix seconds, or YYYY-MM-DD). Optional; defaults to now.

bounds
boolean

If true, return only the first and last point of the resolved time window instead of every point in it. A bounds request is exempt from the 9000-point maximum, since it returns at most two points per series however wide the window is.

selections
enum<string>[]

Comma-separated metric fields to return; defaults to every metric. A point always leads with its timestamp, and the values that follow are described by point_schema in catalog order regardless of the order requested here.

Available options:
volume-usd,
correlated-volume-usd,
trade-count,
aggregator-volume-usd,
platform-volume-usd,
aggregator-trade-count,
platform-trade-count,
category-nativestablecoin-volume-usd,
category-chaintoken-volume-usd,
category-foreigntoken-volume-usd,
category-stablecoinswaps-volume-usd,
category-lstswaps-volume-usd,
category-composites-volume-usd,
category-tokenizedassets-volume-usd,
category-projecttokens-volume-usd,
category-memes-volume-usd,
memecoin-volume-share,
pair-bitcoin-usd-volume-usd,
pair-ethereum-usd-volume-usd,
pair-solana-usd-volume-usd,
pair-avalanche-usd-volume-usd,
pair-bnb-usd-volume-usd,
pair-bitcoin-ethereum-volume-usd,
pair-bitcoin-solana-volume-usd,
pair-ethereum-solana-volume-usd,
pair-fx-volume-usd,
pair-eur-usd-volume-usd
acceptFormat
enum<string>
default:json

Response format, overriding the Accept header: json (default), csv, or jsonl (NDJSON). csv and jsonl return the rows as a downloadable file.

Available options:
json,
csv,
jsonl

Response

Timeseries points for each series.

data
object
required
error
string | null