Skip to content

TOOL REFERENCE

Screen Indian stocks with a query like Screener.in

screen_by_query — Screen companies with a numerical query expression. This is a read-only research or operational tool. It does not place trades or issue investment recommendations.

What you can ask

Connect DalalOS to Claude or ChatGPT and ask in plain English; the assistant calls screen_by_query for you and answers from the figures it returns.

EXAMPLE PROMPTS

  • Screen companies where PE is below 25 and return on equity exceeds 15%.
  • Screen for companies where ROE above 20 AND debt to equity below 0.5.
  • Find stocks where PE is below 20 OR dividend yield is above 4.

Parameters and response fields

screen_by_query

Screen companies with a numerical query expression

USE WHEN

Evaluate user-defined numerical conditions, including OR and arithmetic, against the cached company metrics.

PARAMETERS

screen_by_query parameters
NameTypeRequiredDefaultDescription
querystringYes—Numerical screening expression.
dialectstringNoscreenerQuery dialect.
sort_bystringNomarket_capMetric used for ordering.
orderstringNodescasc or desc.
limitintegerNo25Maximum returned rows.
offsetintegerNo0Pagination offset.
snapshot_idinteger | nullNo—Reuse the returned metrics snapshot for consistent pagination.
definitionsobject[] | nullNo—Optional custom numerical definitions.
columnsstring[] | nullNo—Optional result metric columns.
scopeobject | nullNo—Optional structured universe restrictions.
only_latest_resultsbooleanNofalseRestrict to companies with the latest result period.

RESPONSE DATA

  • Matching company rows, pagination snapshot and numerical metric values.

NOTES

  • Uses cached metrics and preserves unavailable values; screening matches are data rather than recommendations.

See the same data on DalalOS

Public pages that need no sign-in and show data from the same source.

KEEP EXPLORING

Connect your AI to Indian stock market data

Sign in to DalalOS and connect your AI in one line of config. Free to start; paid plans when you need more.