Factor sparklines

Return compact multi-factor sparkline series with 1D through MAX summary windows for dashboard, sector, index, and model UIs.

get/v1/factors/sparklines

Request

  • Base URL: https://api.turos.app
  • URL: https://api.turos.app/v1/factors/sparklines
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer

Query parameters

factorsstring

Comma-separated canonical factor keys or supported public aliases. Alias normalization is explicit and does not broaden the selection.

keysstring

Alias for factors.

categorystring

Optional factor category filter such as style, sector, or industry.

range'1d' | '5d' | '10d' | '1m' | '3m' | '6m' | '1y' | 'ytd' | 'max'

Trailing observation window for the returned sparkline points. Defaults to 1y. YTD covers Jan 1 of the latest observation's year through the latest market date. MAX returns the full available history, which starts 2015-01-01, through the latest complete market date where coverage exists for each factor.

metric'scaled_return' | 'pure_return' | 'raw_return' | 'z_score'

Metric used for sparkline point values. Return metrics are cumulative over the selected range; z_score returns point-in-time z-scores.

pointsinteger

Maximum chart points per factor. The first and last observations are preserved when downsampling.

date_fromstring date

Optional inclusive ISO start date. Must be on or after 2015-01-01 and overrides range for returned sparkline bounds.

date_tostring date

Optional inclusive ISO end date. Must be on or after 2015-01-01 and on or before the latest complete XNYS market date.

format'json' | 'csv'

Return JSON by default or a table-ready CSV export with one row per factor/date sparkline point.

response_mode'compact' | 'standard' | 'verbose'

Response projection. compact is token-efficient for agents; standard returns the full operational shape; verbose preserves full trust metadata and drill-down context.

includestring

Comma-separated compact-mode expansions such as trust, metadata, series, diagnostics, exposures, position_views, position_exposures, optimizer_candidates, or drilldown. Use trust when an agent or report needs provenance, freshness, source-rights, methodology, revision, and degraded-state metadata; use diagnostics for regression details such as rSquared and tStat where supported.

Response

Successful response

object'list' required
hasMoreboolean required
nextCursorstring nullable required
responseMode'compact' | 'standard' | 'verbose'

Projection used for this resource. compact is token-efficient for agents; standard and verbose retain fuller operational context.

includestring[]
requestIdstring
traceparentstring

Changes

No recorded changes to this operation across all 1 revision of this API.