---
title: "Watchlist intelligence briefing"
method: POST
path: "/v1/intelligence/watchlist"
---

# Watchlist intelligence briefing

`POST /v1/intelligence/watchlist`

## Request

- Base URL: `https://api.turos.app`
- URL: `https://api.turos.app/v1/intelligence/watchlist`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Return a watchlist briefing bundle with movers, catalysts, factor context, and regime overlays.

## Request body

- WatchlistIntelligenceRequest
  - `country` string, required
  - `lookback` string
  - `symbols` string[], required

## Response `200`

Successful response

- WatchlistIntelligenceBundle
  - `dataAsOf` string
  - `freshnessStatus` string
  - `methodologyVersion` string
  - `materializationVersion` string
  - `object` 'watchlist_intelligence_bundle', required
  - `id` string, required
  - `asOf` string, required
  - `symbols` string[], required
  - `movers` object[], required
    - `object` 'security_intelligence_bundle', required
    - `id` string, required
    - `asOf` string, required
    - `symbol` string, required
    - `snapshot` object, required
      - `object` 'market_snapshot', required: Resource type for a stored latest-market observation.
      - `id` string, required: Stable identifier for this stored snapshot.
      - `createdAt` string, required: Time this stored snapshot was last written.
      - `livemode` boolean, required: Whether the record belongs to a live account context.
      - `symbol` string, required: Requested security symbol.
      - `name` string, nullable: Security name when available.
      - `exchange` string, nullable: Exchange label supplied with the snapshot when available.
      - `currency` string, nullable: Currency for price fields when supplied.
      - `asOf` string, required: Timestamp represented by the market observation.
      - `price` number, required: Latest stored price for the security.
      - `change` number, nullable: Change from the supplied previous close, when available.
      - `changePercent` number, nullable: Percent change from the supplied previous close, when available.
      - `volume` integer, nullable: Reported trading volume when available.
      - `marketCap` number, nullable: Reported market capitalization when available.
      - `previousClose` number, nullable: Previous close used for change fields when available.
      - `requestId` string
      - `traceparent` string
      - `responseMode` 'compact' | 'standard' | 'verbose'
      - `dataAsOf` string
      - `freshnessStatus` string
      - `methodologyVersion` string
      - `materializationVersion` string
      - `provenance` object
        - `source` string, required
        - `sourceLabel` string
        - `sourceAgency` string
        - `canonicality` string
        - `fallbackPolicy` string
        - `accessionNumber` string, nullable, required
        - `filingUrl` string, uri, required
        - `acceptedAt` string, nullable
        - `retrievedAt` string, required
        - `parserVersion` string, required
      - `freshness` object
        - `status` 'fresh' | 'current' | 'archival' | 'stale' | 'degraded' | 'unknown', required
        - `asOf` string, required
        - `sourcePublishedAt` string, nullable
        - `lagMs` integer, nullable
        - `synthetic` boolean
      - `materialization` object
        - `parserVersion` string, required
        - `materializationVersion` string, required
      - `sourceRights` object
        - `source` string, required
        - `sourceLabel` string
        - `sourceAgency` string
        - `canonicality` string
        - `fallbackPolicy` string
        - `posture` 'public_safe' | 'contract_gated' | 'internal_only' | 'inventory_only' | 'review_required', required
        - `publicAvailability` 'public' | 'contract_gated' | 'internal_only' | 'inventory_only', required
        - `contractStatus` 'approved' | 'review_required' | 'restricted' | 'prohibited' | 'expired', required
        - `reviewOwner` string, nullable
        - `reviewedAt` string, nullable
        - `restrictions` string[], required
        - `notes` string, nullable
      - `methodology` object
        - `id` string, required
        - `version` string, required
        - `summary` string, required
        - `confidence` 'high' | 'medium' | 'low', required
        - `launchState` 'experimental' | 'beta' | 'ga', required
        - `inputs` string[], required
        - `validation` object
      - `revision` object
        - `sourcePublishedAt` string, nullable
        - `retrievedAt` string, required
        - `vintageId` string, nullable
        - `revisedFrom` string, nullable
      - `degradedState` object, nullable
        - `code` string, required
        - `message` string, required
        - `retryable` boolean, required
        - `missingCapabilities` string[], required
        - `fallbackUsed` string[], required
    - `reference` object
      - `object` 'market_reference', required: Resource type for security reference metadata.
      - `id` string, required: Stable identifier for this reference record.
      - `createdAt` string, required: Time this reference record was last written.
      - `livemode` boolean, required: Whether the record belongs to a live account context.
      - `symbol` string, required: Requested security symbol.
      - `name` string, nullable: Issuer or security name when available.
      - `market` string, nullable: Market classification when available.
      - `locale` string, nullable: Listing locale when available.
      - `exchange` string, nullable: Primary exchange identifier or label when available.
      - `securityType` string, nullable: Security type supplied by the reference source when available.
      - `active` boolean, nullable: Whether the source marks the security active; null means unavailable.
      - `currency` string, nullable: Listing currency when available.
      - `cik` string, nullable: SEC CIK when the security is mapped to an SEC registrant.
      - `compositeFigi` string, nullable: Composite FIGI when available.
      - `shareClassFigi` string, nullable: Share-class FIGI when available.
      - `marketCap` number, nullable: Reported market capitalization when available.
      - `listDate` string, nullable: Listing date when available.
      - `homepageUrl` string, uri, nullable
      - `description` string, nullable
      - `sicCode` string, nullable
      - `sicDescription` string, nullable
      - `totalEmployees` integer, nullable
      - `phoneNumber` string, nullable
      - `address` object, nullable
        - `line1` string, nullable
        - `line2` string, nullable
        - `city` string, nullable
        - `state` string, nullable
        - `postalCode` string, nullable
      - `branding` object, nullable
        - `logoUrl` string, uri, nullable
        - `iconUrl` string, uri, nullable
      - `asOf` string, required: Timestamp represented by this reference record.
      - `requestId` string
      - `traceparent` string
      - `responseMode` 'compact' | 'standard' | 'verbose'
      - `dataAsOf` string
      - `freshnessStatus` string
      - `methodologyVersion` string
      - `materializationVersion` string
      - `provenance` object
        - `source` string, required
        - `sourceLabel` string
        - `sourceAgency` string
        - `canonicality` string
        - `fallbackPolicy` string
        - `accessionNumber` string, nullable, required
        - `filingUrl` string, uri, required
        - `acceptedAt` string, nullable
        - `retrievedAt` string, required
        - `parserVersion` string, required
      - `freshness` object
        - `status` 'fresh' | 'current' | 'archival' | 'stale' | 'degraded' | 'unknown', required
        - `asOf` string, required
        - `sourcePublishedAt` string, nullable
        - `lagMs` integer, nullable
        - `synthetic` boolean
      - `materialization` object
        - `parserVersion` string, required
        - `materializationVersion` string, required
      - `sourceRights` object
        - `source` string, required
        - `sourceLabel` string
        - `sourceAgency` string
        - `canonicality` string
        - `fallbackPolicy` string
        - `posture` 'public_safe' | 'contract_gated' | 'internal_only' | 'inventory_only' | 'review_required', required
        - `publicAvailability` 'public' | 'contract_gated' | 'internal_only' | 'inventory_only', required
        - `contractStatus` 'approved' | 'review_required' | 'restricted' | 'prohibited' | 'expired', required
        - `reviewOwner` string, nullable
        - `reviewedAt` string, nullable
        - `restrictions` string[], required
        - `notes` string, nullable
      - `methodology` object
        - `id` string, required
        - `version` string, required
        - `summary` string, required
        - `confidence` 'high' | 'medium' | 'low', required
        - `launchState` 'experimental' | 'beta' | 'ga', required
        - `inputs` string[], required
        - `validation` object
      - `revision` object
        - `sourcePublishedAt` string, nullable
        - `retrievedAt` string, required
        - `vintageId` string, nullable
        - `revisedFrom` string, nullable
      - `degradedState` object, nullable
        - `code` string, required
        - `message` string, required
        - `retryable` boolean, required
        - `missingCapabilities` string[], required
        - `fallbackUsed` string[], required
    - `recentBars` object[], required
      - `object` 'market_bar', required: Resource type for one OHLCV price bar.
      - `id` string, required: Stable identifier for this bar.
      - `symbol` string, required: Security symbol for the bar.
      - `interval` '1m' | '5m' | '15m' | '1h' | '1d' | '1w' | '1mo', required: Time interval represented by the bar.
      - `open` number, required: Opening price for the interval.
      - `high` number, required: Highest price for the interval.
      - `low` number, required: Lowest price for the interval.
      - `close` number, required: Closing price for the interval.
      - `volume` integer, nullable: Reported volume for the interval when available.
      - `timestamp` string, required: Start timestamp for the bar interval.
      - `requestId` string
      - `traceparent` string
      - `responseMode` 'compact' | 'standard' | 'verbose'
      - `dataAsOf` string
      - `freshnessStatus` string
      - `methodologyVersion` string
      - `materializationVersion` string
      - `provenance` object
        - `source` string, required
        - `sourceLabel` string
        - `sourceAgency` string
        - `canonicality` string
        - `fallbackPolicy` string
        - `accessionNumber` string, nullable, required
        - `filingUrl` string, uri, required
        - `acceptedAt` string, nullable
        - `retrievedAt` string, required
        - `parserVersion` string, required
      - `freshness` object
        - `status` 'fresh' | 'current' | 'archival' | 'stale' | 'degraded' | 'unknown', required
        - `asOf` string, required
        - `sourcePublishedAt` string, nullable
        - `lagMs` integer, nullable
        - `synthetic` boolean
      - `materialization` object
        - `parserVersion` string, required
        - `materializationVersion` string, required
      - `sourceRights` object
        - `source` string, required
        - `sourceLabel` string
        - `sourceAgency` string
        - `canonicality` string
        - `fallbackPolicy` string
        - `posture` 'public_safe' | 'contract_gated' | 'internal_only' | 'inventory_only' | 'review_required', required
        - `publicAvailability` 'public' | 'contract_gated' | 'internal_only' | 'inventory_only', required
        - `contractStatus` 'approved' | 'review_required' | 'restricted' | 'prohibited' | 'expired', required
        - `reviewOwner` string, nullable
        - `reviewedAt` string, nullable
        - `restrictions` string[], required
        - `notes` string, nullable
      - `methodology` object
        - `id` string, required
        - `version` string, required
        - `summary` string, required
        - `confidence` 'high' | 'medium' | 'low', required
        - `launchState` 'experimental' | 'beta' | 'ga', required
        - `inputs` string[], required
        - `validation` object
      - `revision` object
        - `sourcePublishedAt` string, nullable
        - `retrievedAt` string, required
        - `vintageId` string, nullable
        - `revisedFrom` string, nullable
      - `degradedState` object, nullable
        - `code` string, required
        - `message` string, required
        - `retryable` boolean, required
        - `missingCapabilities` string[], required
        - `fallbackUsed` string[], required
    - `catalysts` object[], required
      - `object` 'news_story', required
      - `id` string, required
      - `createdAt` string, required
      - `livemode` boolean, required
      - `headline` string, required
      - `sourceName` string, required
      - `sourceUrl` string, uri, required
      - `publishedAt` string, required
      - `summaryMd` string, nullable
      - `symbols` string[], required
      - `mentions` object[], required
        - `symbol` string, nullable
        - `entityId` string, nullable
        - `companyName` string, nullable
        - `confidence` number
      - `sentiment` 'positive' | 'neutral' | 'negative', nullable
      - `requestId` string
      - `traceparent` string
      - `responseMode` 'compact' | 'standard' | 'verbose'
      - `dataAsOf` string
      - `freshnessStatus` string
      - `methodologyVersion` string
      - `materializationVersion` string
      - `provenance` object
        - `source` string, required
        - `sourceLabel` string
        - `sourceAgency` string
        - `canonicality` string
        - `fallbackPolicy` string
        - `accessionNumber` string, nullable, required
        - `filingUrl` string, uri, required
        - `acceptedAt` string, nullable
        - `retrievedAt` string, required
        - `parserVersion` string, required
      - `freshness` object
        - `status` 'fresh' | 'current' | 'archival' | 'stale' | 'degraded' | 'unknown', required
        - `asOf` string, required
        - `sourcePublishedAt` string, nullable
        - `lagMs` integer, nullable
        - `synthetic` boolean
      - `materialization` object
        - `parserVersion` string, required
        - `materializationVersion` string, required
      - `sourceRights` object
        - `source` string, required
        - `sourceLabel` string
        - `sourceAgency` string
        - `canonicality` string
        - `fallbackPolicy` string
        - `posture` 'public_safe' | 'contract_gated' | 'internal_only' | 'inventory_only' | 'review_required', required
        - `publicAvailability` 'public' | 'contract_gated' | 'internal_only' | 'inventory_only', required
        - `contractStatus` 'approved' | 'review_required' | 'restricted' | 'prohibited' | 'expired', required
        - `reviewOwner` string, nullable
        - `reviewedAt` string, nullable
        - `restrictions` string[], required
        - `notes` string, nullable
      - `methodology` object
        - `id` string, required
        - `version` string, required
        - `summary` string, required
        - `confidence` 'high' | 'medium' | 'low', required
        - `launchState` 'experimental' | 'beta' | 'ga', required
        - `inputs` string[], required
        - `validation` object
      - `revision` object
        - `sourcePublishedAt` string, nullable
        - `retrievedAt` string, required
        - `vintageId` string, nullable
        - `revisedFrom` string, nullable
      - `degradedState` object, nullable
        - `code` string, required
        - `message` string, required
        - `retryable` boolean, required
        - `missingCapabilities` string[], required
        - `fallbackUsed` string[], required
    - `freshFilings` object[], required
      - `id` string, required
      - `kind` 'filing_fact' | 'filing_excerpt' | 'derived_metric' | 'source_record', required
      - `status` 'supported' | 'degraded' | 'unavailable', required
      - `href` string, required
      - `page` integer, nullable
      - `region` object, nullable
        - `status` 'supported' | 'degraded' | 'unavailable', required
        - `kind` 'inline_xbrl_fact' | 'html_text_range', nullable
        - `startOffset` integer, nullable
        - `endOffset` integer, nullable
        - `snippet` string, nullable
        - `viewerFragment` string, nullable
    - `factorExposures` object[], required
      - `object` 'factor_exposure', required
      - `id` string, required
      - `subjectType` 'security' | 'portfolio' | 'watchlist', required
      - `subjectKey` string, required
      - `factorKey` string, required
      - `beta` number, required
      - `intercept` number, nullable
      - `rSquared` number, nullable
      - `adjustedRSquared` number, nullable
      - `tStat` number, nullable
      - `observationCount` integer, nullable
      - `nActiveFactors` integer, nullable
      - `percentile` number, nullable
      - `confidence` 'high' | 'medium' | 'low', nullable
      - `modelName` string, nullable
      - `asOf` string, required
      - `expansionHints` string[]
      - `requestId` string
      - `traceparent` string
      - `responseMode` 'compact' | 'standard' | 'verbose'
      - `dataAsOf` string
      - `freshnessStatus` string
      - `methodologyVersion` string
      - `materializationVersion` string
      - `provenance` object
        - `source` string, required
        - `sourceLabel` string
        - `sourceAgency` string
        - `canonicality` string
        - `fallbackPolicy` string
        - `accessionNumber` string, nullable, required
        - `filingUrl` string, uri, required
        - `acceptedAt` string, nullable
        - `retrievedAt` string, required
        - `parserVersion` string, required
      - `freshness` object
        - `status` 'fresh' | 'current' | 'archival' | 'stale' | 'degraded' | 'unknown', required
        - `asOf` string, required
        - `sourcePublishedAt` string, nullable
        - `lagMs` integer, nullable
        - `synthetic` boolean
      - `materialization` object
        - `parserVersion` string, required
        - `materializationVersion` string, required
      - `sourceRights` object
        - `source` string, required
        - `sourceLabel` string
        - `sourceAgency` string
        - `canonicality` string
        - `fallbackPolicy` string
        - `posture` 'public_safe' | 'contract_gated' | 'internal_only' | 'inventory_only' | 'review_required', required
        - `publicAvailability` 'public' | 'contract_gated' | 'internal_only' | 'inventory_only', required
        - `contractStatus` 'approved' | 'review_required' | 'restricted' | 'prohibited' | 'expired', required
        - `reviewOwner` string, nullable
        - `reviewedAt` string, nullable
        - `restrictions` string[], required
        - `notes` string, nullable
      - `methodology` object
        - `id` string, required
        - `version` string, required
        - `summary` string, required
        - `confidence` 'high' | 'medium' | 'low', required
        - `launchState` 'experimental' | 'beta' | 'ga', required
        - `inputs` string[], required
        - `validation` object
      - `revision` object
        - `sourcePublishedAt` string, nullable
        - `retrievedAt` string, required
        - `vintageId` string, nullable
        - `revisedFrom` string, nullable
      - `degradedState` object, nullable
        - `code` string, required
        - `message` string, required
        - `retryable` boolean, required
        - `missingCapabilities` string[], required
        - `fallbackUsed` string[], required
    - `summaryMd` string, required
    - `requestId` string
    - `traceparent` string
    - `responseMode` 'compact' | 'standard' | 'verbose'
    - `dataAsOf` string
    - `freshnessStatus` string
    - `methodologyVersion` string
    - `materializationVersion` string
    - `provenance` object
      - `source` string, required
      - `sourceLabel` string
      - `sourceAgency` string
      - `canonicality` string
      - `fallbackPolicy` string
      - `accessionNumber` string, nullable, required
      - `filingUrl` string, uri, required
      - `acceptedAt` string, nullable
      - `retrievedAt` string, required
      - `parserVersion` string, required
    - `freshness` object
      - `status` 'fresh' | 'current' | 'archival' | 'stale' | 'degraded' | 'unknown', required
      - `asOf` string, required
      - `sourcePublishedAt` string, nullable
      - `lagMs` integer, nullable
      - `synthetic` boolean
    - `materialization` object
      - `parserVersion` string, required
      - `materializationVersion` string, required
    - `sourceRights` object
      - `source` string, required
      - `sourceLabel` string
      - `sourceAgency` string
      - `canonicality` string
      - `fallbackPolicy` string
      - `posture` 'public_safe' | 'contract_gated' | 'internal_only' | 'inventory_only' | 'review_required', required
      - `publicAvailability` 'public' | 'contract_gated' | 'internal_only' | 'inventory_only', required
      - `contractStatus` 'approved' | 'review_required' | 'restricted' | 'prohibited' | 'expired', required
      - `reviewOwner` string, nullable
      - `reviewedAt` string, nullable
      - `restrictions` string[], required
      - `notes` string, nullable
    - `methodology` object
      - `id` string, required
      - `version` string, required
      - `summary` string, required
      - `confidence` 'high' | 'medium' | 'low', required
      - `launchState` 'experimental' | 'beta' | 'ga', required
      - `inputs` string[], required
      - `validation` object
    - `revision` object
      - `sourcePublishedAt` string, nullable
      - `retrievedAt` string, required
      - `vintageId` string, nullable
      - `revisedFrom` string, nullable
    - `degradedState` object, nullable
      - `code` string, required
      - `message` string, required
      - `retryable` boolean, required
      - `missingCapabilities` string[], required
      - `fallbackUsed` string[], required
  - `macroRegimes` object[], required
    - `key` string, required
    - `label` string, required
    - `country` string, required
    - `confidence` 'high' | 'medium' | 'low', required
    - `drivers` object[], required
      - `key` string, required
      - `label` string, required
      - `category` 'factor' | 'macro' | 'filing_risk' | 'news' | 'valuation' | 'ownership', required
      - `contributionPercent` number, required
      - `explanation` string, required
      - `trace` object, nullable
        - `id` string, required
        - `kind` 'filing_fact' | 'filing_excerpt' | 'derived_metric' | 'source_record', required
        - `status` 'supported' | 'degraded' | 'unavailable', required
        - `href` string, required
        - `page` integer, nullable
        - `region` object, nullable
          - `status` 'supported' | 'degraded' | 'unavailable', required
          - `kind` 'inline_xbrl_fact' | 'html_text_range', nullable
          - `startOffset` integer, nullable
          - `endOffset` integer, nullable
          - `snippet` string, nullable
          - `viewerFragment` string, nullable
    - `factorImpacts` object[], required
      - `factorKey` string, required
      - `score` number, required
      - `direction` 'tailwind' | 'headwind' | 'neutral', required
      - `rationale` string, required
  - `summaryMd` string, required
  - `requestId` string
  - `traceparent` string
  - `responseMode` 'compact' | 'standard' | 'verbose'
  - `provenance` object
    - `source` string, required
    - `sourceLabel` string
    - `sourceAgency` string
    - `canonicality` string
    - `fallbackPolicy` string
    - `accessionNumber` string, nullable, required
    - `filingUrl` string, uri, required
    - `acceptedAt` string, nullable
    - `retrievedAt` string, required
    - `parserVersion` string, required
  - `freshness` object
    - `status` 'fresh' | 'current' | 'archival' | 'stale' | 'degraded' | 'unknown', required
    - `asOf` string, required
    - `sourcePublishedAt` string, nullable
    - `lagMs` integer, nullable
    - `synthetic` boolean
  - `materialization` object
    - `parserVersion` string, required
    - `materializationVersion` string, required
  - `sourceRights` object
    - `source` string, required
    - `sourceLabel` string
    - `sourceAgency` string
    - `canonicality` string
    - `fallbackPolicy` string
    - `posture` 'public_safe' | 'contract_gated' | 'internal_only' | 'inventory_only' | 'review_required', required
    - `publicAvailability` 'public' | 'contract_gated' | 'internal_only' | 'inventory_only', required
    - `contractStatus` 'approved' | 'review_required' | 'restricted' | 'prohibited' | 'expired', required
    - `reviewOwner` string, nullable
    - `reviewedAt` string, nullable
    - `restrictions` string[], required
    - `notes` string, nullable
  - `methodology` object
    - `id` string, required
    - `version` string, required
    - `summary` string, required
    - `confidence` 'high' | 'medium' | 'low', required
    - `launchState` 'experimental' | 'beta' | 'ga', required
    - `inputs` string[], required
    - `validation` object
  - `revision` object
    - `sourcePublishedAt` string, nullable
    - `retrievedAt` string, required
    - `vintageId` string, nullable
    - `revisedFrom` string, nullable
  - `degradedState` object, nullable
    - `code` string, required
    - `message` string, required
    - `retryable` boolean, required
    - `missingCapabilities` string[], required
    - `fallbackUsed` string[], required

## Other responses

- `default`: Contract-aware error response

---

[API](https://skmtc.dev/turos/apis/turos-api.md) · [All operations](https://skmtc.dev/turos/apis/turos-api/llms.txt) · [OpenAPI document](https://skmtc.dev/turos/apis/turos-api/revisions/a68d3ec80a56?raw)