Thematic similarity pack

Return a custom thematic similarity pack that combines factor-overlap peers with deterministic filing/news signatures and naming workflow metadata.

get/v1/factors/similarity-pack

Request

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

Query parameters

symbolstring required

Anchor ticker symbol. ticker is accepted as an alias; symbols can also provide the anchor as its first item.

symbolsstring

Comma-separated anchor and optional candidate symbols. The first symbol is used as the anchor when symbol is omitted.

candidatesstring

Optional comma-separated candidate universe.

lookbackstring

Exposure and context lookback window.

limitinteger

Maximum peers to return.

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

dataAsOfstring
freshnessStatus'fresh' | 'stale' | 'degraded' | 'unknown'
methodologyVersionstring
materializationVersionstring
object'factor_similarity_pack' required
responseMode'compact' | 'standard' | 'verbose'

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

idstring required
symbolstring required
asOfstring date-time required
anchorThemestring required
themeLabelsstring[]
factorKeySuggestionstring required
discoveryMode'factor_overlap_plus_filing_news_signature' required
evidenceobject[]
summaryMdstring required
disclosuresstring[]

Short product/legal disclosures for research-scenario outputs. Omitted on low-risk compact responses.

requestIdstring
traceparentstring

Changes

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