Bulk factor returns

Return available factor returns data in bulk with daily series for commercial plan bulk-download workflows.

get/v1/factors/bulk-download

Request

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

Query parameters

factorsstring

Required unless category is provided. Comma-separated factor keys or aliases.

keysstring

Alias for factors. Required unless category is provided.

categorystring

Required unless factors or keys is provided. Optional factor category filter.

windowstring

Return window for summary fields.

lookbackstring

History lookback for returned series.

format'json' | 'csv'

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

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.