Tool reference

Facts extracted from an NSE or BSE filing

get_filing_extract — Grounded facts extracted from a filing. This tool can queue filing extraction or prefetch processing and use the caller's on-demand quota. It does not place market orders or modify brokerage data.

What you can ask

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

EXAMPLE PROMPTS

Extract the reported facts from this company's latest investor presentation filing.
Extract the reported figures from this earnings press release filing.
What facts does this order-win announcement state?

Parameters and response fields

get_filing_extract

Grounded facts extracted from a filing

USE WHEN

Read source-grounded facts from a selected filing after finding it in the company events feed.

PARAMETERS

get_filing_extract parameters
Name	Type	Required	Default	Description
`query`	`string`	Yes	—	Company name, symbol, code or ISIN.
`news_id`	`string`	Yes	—	Filing/news identifier returned by get_stock_events.

RESPONSE DATA

Extracted facts with source quotes, page references, filing metadata and guard status.
On a cache miss: status ("pending"/"failed"/"not_queued"), queued flag, and attachment_url so the raw filing is still reachable.

NOTES

Call get_stock_events first to find a news_id.
A cache miss usually enqueues on-demand extraction (status "pending", retry in ~1–2 min) rather than failing outright.
reason_code on a non-pending miss: "not_queued" (with sub-reasons "results_available_via_financials" or "no_document_to_extract") or "failed" (with error_reason), plus "on_demand_quota_exceeded" if the caller is rate-limited.
This capability can queue filing extraction or background prefetch and consume the caller's on-demand quota.

Also available via REST: /stocks/{q}/filings/{news_id}/extract

See the same data on DalalOS

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

Announcements by category

KEEP EXPLORING

Connect your AI to Indian stock market data

Get started free →