Query structured A-share announcement events by stock code(s). Returns events for: share_reduction (减持), delisting_risk (ST/退市), regulatory_letter (监管函/问询函), lockup_expiration (限售解禁), share_buyback (回购). Each event includes: event_id, event_type, stock_code, stock_name, ai_summary, confidence_tier, structured_payload, and announcement_date. Use when: you know the stock code(s) and want to check recent events for those stocks. Use this for portfolio monitoring, watchlist scanning, or single-stock deep dives. Do NOT use when: you want to search by event type across all stocks (use search_events_by_type), or when you need a specific shareholder's events (use search_events_by_shareholder). Supports cursor-based pagination — use the cursor field in the response to fetch the next page. Returns: {data: [...], cursor: <next_cursor_or_null>, has_more: bool}.

Query structured A-share announcement events by event type(s). Event types: share_reduction, delisting_risk, regulatory_letter, lockup_expiration, share_buyback. Use when: you want to find all events of a specific type across the market — e.g. all recent share reductions, all ST/delisting warnings, all regulatory letters. Do NOT use when: you know the stock code(s) (use search_events_by_stock), or when you need a complex multi-filter query (use search_events). Supports cursor-based pagination — use the cursor field in the response to fetch the next page. Returns: {data: [...], cursor: <next_cursor_or_null>, has_more: bool}.

Query events by shareholder name. Searches across all event types where the shareholder name appears in structured_payload. Most useful for: share_reduction (减持) events where shareholder_name is a top-level field in structured_payload. Use when: you want to track a specific shareholder's activity — e.g. '罗丽华' or '国家集成电路产业投资基金'. Do NOT use when: you want all events for a stock (use search_events_by_stock), or when you're unsure of the exact shareholder name (use search_events with keyword in ai_summary). Returns: {data: [...], cursor: <next_cursor_or_null>, has_more: bool}.

Get the full detail for a single event by its event_id. Returns ALL fields: event metadata, structured_payload (quantitative fields specific to the event type), quantitative_tags, confidence_reasons, source info, timeline array, related events, and ai_summary. Use when: you have an event_id and need the complete event record — including type-specific fields in structured_payload that are not shown in list/search results. Do NOT use when: you only need the timeline (use get_event_timeline), or when you want to browse/search (use search_events_by_stock/type). Returns a single event object with all fields, or null if not found.

Get the lifecycle timeline and full detail for a single event. Tracks the event through its lifecycle: plan → in_progress → completed/terminated. Returns: full event detail + timeline array (each entry has date, phase, description) + related event IDs. Use when: you want to see the phase transitions and lifecycle history of an event you already know the event_id for. Do NOT use when: you want to search or browse events (use search_events_by_stock/type), or when you only need the summary fields (search_events_by_stock already returns ai_summary and key fields). Returns a single event object with timeline, or null if event_id is invalid or not found.

Get events due within the next N days — early warning for expirations and deadlines. Covers: lockup share expiration dates (限售股解禁到期), share reduction plan deadlines (减持计划到期), delisting period end dates (退市整理期结束), buyback implementation deadlines (回购实施到期), and regulatory letter reply deadlines (监管函回复截止日). Each result includes: event_id, event_type, stock_code, stock_name, due_date (ISO 8601 date, YYYY-MM-DD), days_remaining (integer countdown), and ai_summary. Use when: you need a forward-looking calendar — what lockup expirations, regulatory deadlines, or buyback periods are ending soon. Do NOT use when: you need historical event data or events without a future due date (use search_events_by_stock/type for general event queries). Returns a JSON array of upcoming events, ordered by due_date ascending (soonest first). Max look-ahead: 30 days. Only events with status=active|updating are included.

Universal event search with all supported filters. This is the escape hatch for complex queries not covered by the specialized tools. Supports all filter combinations: stock_code, event_type, since (datetime), status, confidence_tier, shareholder_name. Use when: you need a multi-filter query that doesn't fit into the specialized tools — e.g. 'all verified share_reduction events for 002272 since 2026-05-01'. Do NOT use when: a specialized tool (search_events_by_stock, search_events_by_type, search_events_by_shareholder) would work — prefer specialized tools for better results. Supports cursor-based pagination. Returns: {data: [...], cursor: <next_cursor_or_null>, has_more: bool}.

Get a trust and verification report for a single event. Returns: confidence_tier + confidence_score (heuristic 0-1), multi-source cross-validation details (which sources agree/disagree), and extraction quality metrics from the review system (regex vs LLM conflict count, llm_validation status, whether human-reviewed). Use when: you need to assess how reliable or trustworthy an event's extraction is — e.g. before making a trading decision based on the event data. Do NOT use when: you only need the event data itself (use get_event_detail), or when browsing/searching (use search_events_by_* tools). Returns a trust report object: {event_id, confidence_tier, confidence_score, confidence_reasons, cross_validation: {sources_checked, sources_agree, sources_disagree, source_details}, extraction_quality: {total_fields_reviewed, regex_llm_conflicts, llm_validation, human_reviewed}}.

Search dividend events (分红/送转). Pre-filtered to dividend. Use for dividend announcements, ex-rights dates, payout ratios.

Search violation & penalty events (违规处罚/立案调查). Use for regulatory violations, investigations, penalties, fines.

Search asset restructuring events (重大资产重组). Use for M&A, asset injections, spin-offs, reverse mergers.

Search shareholder behavior events (减持/增持/回购/质押). Covers share_reduction, share_increase, share_buyback, pledge_risk. Use for insider signals.

Search risk events (ST/退市风险/质押风险/停复牌/限售解禁). Covers delisting_risk, pledge_risk, trading_halt_resume, lockup_expiration. Use for early warning signals.

Search regulatory events (监管函/问询函). Covers regulatory_letter, violation_penalty. Use for regulatory scrutiny signals from exchanges.

Search convertible bond events (可转债事件). Covers: call_redemption (强赎/提前赎回), put_resale (回售), conversion_price_down (下修转股价), maturity (到期兑付). Each event includes: cb_name (可转债名称), cb_event_type (子事件类型), and type-specific quantitative fields like redemption_price, event_price, old_conversion_price/new_conversion_price, event_date, etc. Use when: you want convertible bond corporate action signals — forced redemption deadlines (强赎), put-back rights (回售), conversion price adjustments (转股价修正), or maturity redemption. Convertible bond events are a differentiated product — this tool provides the dedicated entry point for this event category. Returns: {data: [...], cursor: <next_cursor_or_null>, has_more: bool}.

Search fund penetration events — cross-reference a fund's underlying stock holdings with AStockEvent structured events. Returns a weighted event feed sorted by impact_score = weight_pct × severity_weight. Covers all 13 A-share event types: share_reduction, delisting_risk, regulatory_letter, lockup_expiration, share_buyback, asset_restructuring, trading_halt_resume, pledge_risk, earnings_forecast, share_increase, dividend, violation_penalty, cb_event. Use when: you have a fund code and want to know what events happened to its underlying holdings — e.g. monitoring FOF portfolio risk, fund due diligence, or checking 'did my fund's heavy-weight stocks have any regulatory issues recently?'. Each event includes: stock_code, stock_name, weight_pct, event_type, event_summary, impact_score, severity_weight, confidence_tier. The response includes fund_info, holdings list, events sorted by impact_score DESC, a summary with total_events/affected_holdings_count/affected_weight_pct/top_risk, and a data_freshness disclaimer noting holdings are from the latest quarterly report. Free tier: Top 10 holdings only. Paid REST tier: full holdings + extended lookback.