Search filings
search_filingsFull-text search across ASX announcement filings, returning snippets of what filings say - commentary, explanations and wording - rather than structured figures. Suited to questions about specific disclosure language where no structured field covers it. Each call costs 1 credit. Queries of 2-5 keywords work best; a longer query that matches nothing is retried once with its key terms, and the response says so. Results carry doc_keys, which identify filings that filing_text reads in full. If a response has truncated=true the match pool was larger than the page: narrower parameters are symbol, match='phrase' for exact disclosure language, and the event, types and date bounds. Structured numbers for one company are in company_events.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "<query>"
},
"name": "search_filings"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | Optional latest date YYYY-MM-DD. | |
| tag | No | Optional company tag/sector filter, e.g. 'Copper'. | |
| from | No | Optional earliest date YYYY-MM-DD. | |
| tier | No | Optional: T1 (market-moving only), T2, or T3. | |
| event | No | Optional known announcement kind (suspension, takeover, guidance_revision, capital_raise, buyback, distress, trading_update, consolidation) — event matching bypasses text ranking entirely. | |
| limit | No | Max hits (default 10, max 25). | |
| match | No | Optional: 'phrase' for exact adjacent-word matching. | |
| query | Yes | Search terms, e.g. 'share purchase plan' or 'BHM'. | |
| types | No | Optional comma-separated ASX announcement types, e.g. 'Appendix 3Y,Appendix 4C'. | |
| symbol | No | Optional ticker filter, e.g. 'BHM'. | |
| priceSensitive | No | Optional: only price-sensitive filings, or only not. |