Market data

Get market history for charts

Per-asset day summary with sparklines, or a full close series for one symbol and range.

GET /api/market returns real market history for charts. With no symbol it returns a one-day change and sparkline for every asset. With a symbol it returns the full closing-price series for one range, plus asset-level metadata.

GET /api/market · public, no token required · 60 requests per 60 seconds per IP. Base URL, response envelope, and error shapes: conventions.

Parameters

Name	Type	Required	Default	Description
`symbol`	string	No	(none)	A ticker in the universe, for example `AAPL`. Omit it for the day summary of every asset.
`range`	string	No	`1M`	One of `1D`, `1W`, `1M`, `1Y`, `All`. Symbol mode only.

Response

Summary mode (no symbol): { summary, asOf }. summary maps each asset symbol to { dayChangePct, spark }, where spark is a downsampled 1-day close series (up to 20 points) for row sparklines. Assets with no live source have no entry.

Symbol mode: { series, timestamps, changePct, meta, asOf }.

Field	Type	Description
`series`	number[] \| null	Closing prices in USD, oldest to newest. `null` when no source exists or the upstream failed.
`timestamps`	number[] \| null	Unix seconds per close, aligned to `series`.
`changePct`	number \| null	Percent change across the range. `1D` is measured against the previous session close.
`meta`	object \| null	Asset facts: `fiftyTwoWeekHigh`, `fiftyTwoWeekLow`, `dayHigh`, `dayLow`, `volume`, `exchange`. Fields the source did not provide are omitted.
`asOf`	string	ISO timestamp of the response.

Example

# Day summary for every asset
curl "https://monvera.best/api/market"

# One-year series for Apple
curl "https://monvera.best/api/market?symbol=AAPL&range=1Y"

Summary mode:

{
  "summary": {
    "AAPL": { "dayChangePct": 0.82, "spark": [228.4, 228.9, 229.1, 230.2, 231.0] },
    "NVDA": { "dayChangePct": -1.14, "spark": [174.2, 173.6, 172.9, 172.1, 171.8] }
  },
  "asOf": "2026-07-08T14:03:11.204Z"
}

Symbol mode:

{
  "series": [188.4, 191.2, 195.7, 201.3, 231.0],
  "timestamps": [1720396800, 1723075200, 1725753600, 1728345600, 1751983200],
  "changePct": 22.61,
  "meta": {
    "fiftyTwoWeekHigh": 242.1,
    "fiftyTwoWeekLow": 169.2,
    "dayHigh": 231.4,
    "dayLow": 228.0,
    "volume": 41283900,
    "exchange": "NasdaqGS"
  },
  "asOf": "2026-07-08T14:03:11.204Z"
}

Errors

Status	Body	Cause
400	`{"error":"Unknown symbol."}`	`symbol` is not in the universe.
400	`{"error":"Unknown range."}`	`range` is not one of the five accepted values.