{"tools":[{"name":"get_market_status","method":"GET","path":"/v1/market/status","permissions":["market:read"],"description":"Pakistan market open/closed calendar Asia/Karachi"},{"name":"get_market_snapshot","method":"GET","path":"/v1/market/snapshot","permissions":["market:read"],"description":"indices breadth freshness"},{"name":"get_quote","method":"GET","path":"/v1/quotes/{symbol}","permissions":["market:read"],"description":"delayed quote never live"},{"name":"get_price_history","method":"GET","path":"/v1/prices/{symbol}","permissions":["market:read"],"description":"daily ohlcv history"},{"name":"get_company","method":"GET","path":"/v1/companies/{symbol}","permissions":["company:read"],"description":"company profile ratios"},{"name":"get_company_financials","method":"GET","path":"/v1/financials/{symbol}","permissions":["company:read"],"description":"income statement periods"},{"name":"get_company_dividends","method":"GET","path":"/v1/dividends/{symbol}","permissions":["company:read"],"description":"dividend history trailing dps"},{"name":"get_company_announcements","method":"GET","path":"/v1/announcements/{symbol}","permissions":["company:read"],"description":"filings board meetings"},{"name":"get_sector","method":"GET","path":"/v1/sectors/{id}","permissions":["market:read"],"description":"sector metadata"},{"name":"get_sector_peers","method":"GET","path":"/v1/sectors/{id}/peers","permissions":["market:read"],"description":"companies in a sector"},{"name":"get_sector_valuation","method":"GET","path":"/v1/sectors/{id}/valuation","permissions":["market:read"],"description":"median pe pb yield excluding losses"},{"name":"screen_stocks","method":"GET","path":"/v1/screener","permissions":["market:read"],"description":"GET filter dividend yield drawdown pe over the full snapshot"},{"name":"compare_stocks","method":"GET","path":"/v1/compare","permissions":["company:read"],"description":"side by side symbols"},{"name":"get_stock_freshness","method":"GET","path":"/v1/stocks/{symbol}/freshness","permissions":["company:read"],"description":"dataset freshness"},{"name":"get_data_sources","method":"GET","path":"/v1/ai/sources/{symbol}","permissions":["company:read"],"description":"provenance citations"},{"name":"research_stock","method":"GET","path":"/v1/stocks/{symbol}/research","permissions":["company:read"],"description":"full dated source-aware research package"},{"name":"get_stock_analytics","method":"GET","path":"/v1/stocks/{symbol}/analytics","permissions":["company:read"],"description":"5d/20d drawdowns 52w 30d liquidity"},{"name":"get_stock_valuation","method":"GET","path":"/v1/stocks/{symbol}/valuation","permissions":["company:read"],"description":"pe yield market cap"},{"name":"get_stock_financials","method":"GET","path":"/v1/stocks/{symbol}/financials","permissions":["company:read"],"description":"income statement periods"},{"name":"get_stock_dividends","method":"GET","path":"/v1/stocks/{symbol}/dividends","permissions":["company:read"],"description":"dividend history"},{"name":"get_stock_announcements","method":"GET","path":"/v1/stocks/{symbol}/announcements","permissions":["company:read"],"description":"filings and board meetings"},{"name":"get_my_portfolio","method":"GET","path":"/v1/me/portfolio","permissions":["portfolio:read"],"description":"authorized user holdings"},{"name":"analyze_my_portfolio","method":"GET","path":"/v1/me/analyze","permissions":["portfolio:read"],"description":"allocation concentration pnl"}],"follow":{"after_quote":["analytics","research","financials","dividends","valuation","announcements"],"example":{"self":"/v1/quotes/OGDC","quote":"/v1/quotes/OGDC","stock":"/v1/stocks/OGDC","company":"/v1/companies/OGDC","analytics":"/v1/stocks/OGDC/analytics","financials":"/v1/stocks/OGDC/financials","dividends":"/v1/stocks/OGDC/dividends","valuation":"/v1/stocks/OGDC/valuation","announcements":"/v1/stocks/OGDC/announcements","research":"/v1/stocks/OGDC/research","rh":"/v1/stocks/OGDC/rh","prices":"/v1/prices/OGDC","market_status":"/v1/market/status","tools":"/v1/ai/tools","docs":"/docs"},"note":"every stock response includes data.links — follow those instead of guessing paths"}}