Screening

Screen the universe

Filter securities by mechanical criteria. Any query param other than sort_by/order/limit is treated as a filter (e.g. pe_max=20, roe_min=0.15, sector=IT); an unknown filter key returns a bad_request listing every accepted key.

get/screen

Request

  • Base URL: https://mcp.dalalos.in/v1
  • URL: https://mcp.dalalos.in/v1/screen
  • Auth: HTTP bearer

Query parameters

sort_bystring

Metric to sort by.

orderstring

asc or desc.

limitinteger

Max rows (1..100).

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.