Stocks

Purpose-specific relevant peers

Cache-only, provenance-backed peer selection for a declared comparison purpose. May return fewer peers when business-model evidence is insufficient.

get/stocks/{q}/relevant-peers

Request

  • Base URL: https://mcp.dalalos.in/v1
  • URL: https://mcp.dalalos.in/v1/stocks/{q}/relevant-peers
  • Auth: HTTP bearer

Path parameters

qstring required

NSE symbol, ISIN, or BSE code.

Query parameters

purposestring

operating | financial | valuation.

event_contextstring

Optional declared event context label; selection purpose remains explicit.

limitinteger

Maximum peers (1..15).

Response

Success (or success-with-empty when nothing is cached).

cached_atstring nullable

ISO timestamp the served data was refreshed.

dataunknown
data_age_secondsnumber

Present only when cached_at is set.

errorstring nullable
reason_codestring nullable

Stable machine-readable category (no_data, not_found, bad_request, ...).

resolved_viastring

Present only when a query resolved via a rename/merger alias.

sourcestring nullable
staleboolean required
status'success' | 'error' required

Changes

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