Skip to main content

Sparkline price-ratio time series

POST 
/v1/data/sparklines

Returns price-ratio time series for the cross product of currencies × quotes over a configurable lookback window (default 24h).

Request body: { currencies: string[], quotes: string[], windowHours?: number } where each ID is either a shorthand ("usd", "eth") or "{chainId}-{address}". See the SparklineRequest schema.

Response: { windowHours, count, result }. Each result[i] has { currency, quote, data } where data is an array of { time, value } points and value = price(currency) / price(quote). Pairs with no data are omitted from result (so count ≤ currencies.length × quotes.length).

Useful for rendering small inline charts (token cards, asset selectors) without hitting the heavier snapshot endpoints.

Plain-text reference — POST /v1/data/sparklines

Request body

FieldTypeRequiredDescription
currenciesstring[]yesCurrency identifiers. Use shorthand ("usd", "eth") or "{chainId}-{address}" format.
quotesstring[]yesQuote identifiers (same format as currencies)
windowHoursnumbernoLookback window in hours

Response 200

FieldTypeDescription
successTrue
dataobject
data.windowHoursnumber
data.countintegerNumber of non-empty sparkline pairs
data.resultobject[]
data.result[].currencystring
data.result[].quotestring
data.result[].dataobject[]Informational payload. null when the endpoint only builds calldata.
data.result[].data[].valuenumberPrice ratio (currency / quote)
data.result[].data[].timestring
actionsnull

Example response

{
  "success": true,
  "data": {
    "windowHours": 1.0,
    "count": 1,
    "result": [
      {
        "currency": "string",
        "quote": "string",
        "data": [
          {
            "value": 1.0,
            "time": "2026-01-01T00:00:00Z"
          }
        ]
      }
    ]
  }
}

Request​

Responses​

Sparkline data