Get the current price quote for a PSX-listed symbol.

Args: symbol: PSX ticker, e.g. "MEBL", "OGDC", "FFC", "ENGRO".

Returns last price, change, change %, volume, day high/low, open, prev close. Data is delayed by 5 minutes per PSX Data Portal.

List upcoming dividend payouts on PSX.

Args: symbol: Optional PSX ticker to filter. If omitted, returns all upcoming payouts in the table.

Each result includes book closure dates, AGM date, payout amount/type, and the computed buy deadline (T+2 settlement) — the last day you can buy and still be entitled to the dividend.

For a symbol with an upcoming dividend, return the last day you can buy and still be entitled to the dividend (T+2 settlement applied).

Returns 'no upcoming dividend' if the symbol isn't currently in the PSX payouts table.

Get historical dividend payouts for a symbol.

Args: symbol: PSX ticker. years: How many years of history to return (default 5).

Get recent corporate announcements from PSX.

Args: symbol: Optional ticker filter (e.g. only OGDC announcements). limit: Max rows to return (default 20, cap 100).

Each item includes date, symbol, title, and a PDF link to the original notice.

Fuzzy search PSX symbols and company names.

Useful when the user names a company casually ("habib bank" -> "HBL", "fauji fertilizer" -> "FFC").

Get current values for major PSX indices: KSE100, KSE30, ALLSHR, KMI30, KMIALLSHR, PSXDIV20, BKTI, OGTI, MII30.

Is PSX open right now? Returns OPEN / PRE_OPEN / CLOSED_TODAY / WEEKEND plus the next market open in PKT.

Screen the upcoming-payouts table by payout size.

Args: min_payout_pct: Minimum payout % to include (e.g. 50 = 50% of par). PSX payouts are quoted as % of face value (typically Rs 10). limit: Max results.

NOTE: This is a payout-size filter, not a true dividend-yield screen (yield = dividend / current price). For real yield you'd cross-reference each symbol's current price — call get_quote() per symbol if needed.