{"tools":[{"name":"account_balance","title":"Account Balance","description":"Get account cash balance and asset summary. Returns balances[]{currency, total_cash, max_finance_amount, remaining_finance_amount, risk_level, margin_call}. Filter by currency (e.g. \"USD\", \"HKD\").","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"AccountBalanceParam","type":"object","properties":{"currency":{"description":"Filter by currency code (e.g. \"USD\", \"HKD\"). Omit to return all currencies.","type":"string"}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"ah_premium","title":"A/H Premium","description":"Get A/H share premium historical K-line data. Returns items[]{timestamp, open, high, low, close} representing the premium percentage over the given period.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"AhPremiumParam","type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"700.HK\"","type":"string"},"period":{"description":"K-line period: \"1m\", \"5m\", \"15m\", \"30m\", \"60m\", \"day\" (default), \"week\", \"month\", \"year\"","type":"string"},"count":{"description":"Number of K-lines to return (default: 100)","type":"integer","format":"uint32","minimum":0}},"required":["symbol"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"ah_premium_intraday","title":"A/H Premium (Intraday)","description":"Get A/H share premium intraday time-share data. Returns items[]{timestamp, premium_rate} showing the intraday A/H premium percentage minute by minute.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"SymbolParam","type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"700.HK\"","type":"string"}},"required":["symbol"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"alert_add","title":"Add Price Alert","description":"Add a price alert. condition: price_rise/price_fall (absolute price) or percent_rise/percent_fall (relative %). frequency: once/daily/every. Returns created alert object.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"AlertAddParam","type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"700.HK\"","type":"string"},"condition":{"description":"Alert condition: \"price_rise\", \"price_fall\", \"percent_rise\", \"percent_fall\"","type":"string"},"price":{"description":"Threshold price or percentage value","type":"string"},"frequency":{"description":"Alert frequency: \"once\" (trigger once then disable), \"daily\" (once per day), \"every\" (alert every time condition is met)","type":"string"}},"required":["symbol","condition","price"]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}},{"name":"alert_delete","title":"Delete Price Alert","description":"Delete a price alert by alert_id (numeric string from alert_list). Returns upstream API response on success; errors if alert_id is invalid.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"AlertIdParam","type":"object","properties":{"alert_id":{"description":"Alert indicator id","type":"string"}},"required":["alert_id"]},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":true}},{"name":"alert_disable","title":"Disable Price Alert","description":"Disable a price alert by alert_id. Returns {alert_id, enabled: false} on success. Use alert_list to find the numeric alert_id.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"AlertIdParam","type":"object","properties":{"alert_id":{"description":"Alert indicator id","type":"string"}},"required":["alert_id"]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"AlertToggleResponse","description":"Returned by `alert_enable` / `alert_disable`. The handler builds this exact\nobject on success.","type":"object","properties":{"alert_id":{"description":"The alert (indicator) ID that was toggled.","type":"string"},"enabled":{"description":"New enabled state: `true` for enable, `false` for disable.","type":"boolean"}},"required":["alert_id","enabled"]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"alert_enable","title":"Enable Price Alert","description":"Enable a price alert by alert_id. Returns {alert_id, enabled: true} on success. Use alert_list to find the numeric alert_id.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"AlertIdParam","type":"object","properties":{"alert_id":{"description":"Alert indicator id","type":"string"}},"required":["alert_id"]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"AlertToggleResponse","description":"Returned by `alert_enable` / `alert_disable`. The handler builds this exact\nobject on success.","type":"object","properties":{"alert_id":{"description":"The alert (indicator) ID that was toggled.","type":"string"},"enabled":{"description":"New enabled state: `true` for enable, `false` for disable.","type":"boolean"}},"required":["alert_id","enabled"]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"alert_list","title":"List Price Alerts","description":"Get all configured price alerts. Returns lists[]{counter_id, indicators[]{id, indicator_id, condition, price, frequency, enabled, triggered_at}}.","inputSchema":{"type":"object","properties":{}},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"AlertListResponse","description":"Returned by `alert_list`. The upstream price-alert payload, forwarded after\nthe standard transform (note: upstream `counter_id` is renamed to `symbol`\nand `*_at` timestamps become RFC3339). Subset of the wire payload — only the\ndocumented fields are declared; all are optional.","type":"object","properties":{"lists":{"description":"Per-symbol alert groups.","type":["array","null"],"items":{"$ref":"#/$defs/AlertSymbolGroup"}}},"$defs":{"AlertSymbolGroup":{"description":"A group of alert indicators configured for one security.","type":"object","properties":{"symbol":{"description":"Security symbol (upstream `counter_id`, normalized to `<CODE>.<MARKET>`).","type":["string","null"]},"indicators":{"description":"Configured alert indicators for this symbol.","type":["array","null"],"items":{"$ref":"#/$defs/AlertIndicator"}}}},"AlertIndicator":{"description":"A single configured price-alert indicator.","type":"object","properties":{"id":{"description":"Alert (indicator) ID. Use as `alert_id` in alert_delete/enable/disable.","type":["string","null"]},"indicator_id":{"description":"Indicator type ID.","type":["string","null"]},"condition":{"description":"Alert condition.","type":["string","null"]},"price":{"description":"Threshold price or percentage value.","type":["string","null"]},"frequency":{"description":"Alert frequency.","type":["string","null"]},"enabled":{"description":"Whether the alert is currently enabled.","type":["boolean","null"]},"triggered_at":{"description":"Time the alert last triggered (RFC3339), if any.","type":["string","null"]}}}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"anomaly","title":"Market Anomaly","description":"Get market anomaly alerts (unusual price/volume changes). market: HK/US/CN/SG. symbol: optional, filter to a specific stock. count: results per page (default 50, max 100). Returns changes[]{symbol, name, change_rate, volume, ...}, all_off.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"AnomalyParam","type":"object","properties":{"market":{"description":"Market code: HK, US, CN, SG","type":"string"},"symbol":{"description":"Filter to a specific symbol, e.g. \"700.HK\" or \"AAPL.US\"","type":"string"},"count":{"description":"Number of results to return (default: 50, max: 100)","type":"integer","format":"uint32","minimum":0}},"required":["market"]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"AnomalyResponse","description":"Returned by `anomaly`. Wraps a `changes` array of unusual price/volume\nalerts plus an `all_off` flag. Subset of the wire response — the\ndescription marks `changes[]` as having further undocumented fields.","type":"object","properties":{"changes":{"description":"Anomaly alert entries.","type":["array","null"],"items":{"$ref":"#/$defs/AnomalyChange"}},"all_off":{"description":"Whether anomaly alerting is globally off for the market.","type":["boolean","null"]}},"$defs":{"AnomalyChange":{"type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"700.HK\".","type":["string","null"]},"name":{"description":"Display name of the security.","type":["string","null"]},"change_rate":{"description":"Price change rate (decimal ratio).","type":["string","null"]},"volume":{"description":"Traded volume associated with the anomaly.","type":["string","null"]}}}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"authenticate","title":"Authenticate","description":"Authenticate when you have no Longbridge credentials yet (e.g. your client could not complete the browser OAuth flow). The user generates a one-time authorization code at https://open.longbridge.com/connect and pastes it to you; pass it as `auth_code`. On success the server returns an access token to use as the Bearer credential on subsequent requests, unlocking the full tool set. If you are not authenticated and the user has not provided a code, direct them to https://open.longbridge.com/connect to generate one.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"AuthenticateParam","description":"Parameters for the `authenticate` tool.","type":"object","properties":{"auth_code":{"description":"One-time OAuth authorization code generated by the user at\n<https://open.longbridge.com/connect>. Valid for 10 minutes and usable\nonly once.","type":"string"}},"required":["auth_code"]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}},{"name":"bank_cards","title":"Bank Cards","description":"List linked withdrawal bank cards for the current account. Returns cards[]{id, bank_name, account_number (masked), currency, status}.","inputSchema":{"type":"object","properties":{}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"broker_holding","title":"Broker Holding","description":"Get top broker holding data for a symbol (HK stocks only; sourced from HKEX CCASS participant disclosure). Returns items[]{broker_name, holding_quantity, holding_change, holding_ratio} for the given period (rct_1/rct_5/rct_20/rct_60).","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"BrokerHoldingParam","type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"700.HK\"","type":"string"},"period":{"description":"Period: \"rct_1\" (1 day, default), \"rct_5\" (5 days), \"rct_20\" (20 days), \"rct_60\" (60 days)","type":"string"}},"required":["symbol"]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"BrokerHoldingResponse","description":"Returned by `broker_holding`. Wraps an `items` array of top broker holdings\nfor an HK stock (HKEX CCASS participant disclosure). Subset of the wire\nresponse.","type":"object","properties":{"items":{"description":"Top broker holding entries for the requested period.","type":["array","null"],"items":{"$ref":"#/$defs/BrokerHoldingItem"}}},"$defs":{"BrokerHoldingItem":{"type":"object","properties":{"broker_name":{"description":"Broker (participant) name.","type":["string","null"]},"holding_quantity":{"description":"Shares held by this broker.","type":["string","null"]},"holding_change":{"description":"Change in shares held over the period.","type":["string","null"]},"holding_ratio":{"description":"Holding as a ratio of total issued shares.","type":["string","null"]}}}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"broker_holding_daily","title":"Broker Holding (Daily)","description":"Get daily holding history for a specific broker (by broker_id) in a symbol (HK stocks only; sourced from HKEX CCASS participant disclosure). Returns items[]{date, holding_quantity, holding_change, holding_ratio}.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"BrokerHoldingDailyParam","type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"700.HK\"","type":"string"},"broker_id":{"description":"Broker participant number","type":"string"}},"required":["symbol","broker_id"]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"BrokerHoldingDailyResponse","description":"Returned by `broker_holding_daily`. Wraps an `items` array of the daily\nholding history for one broker in an HK stock. Subset of the wire response.","type":"object","properties":{"items":{"description":"Daily holding history entries.","type":["array","null"],"items":{"$ref":"#/$defs/BrokerHoldingDailyItem"}}},"$defs":{"BrokerHoldingDailyItem":{"type":"object","properties":{"date":{"description":"Disclosure date (yyyy-mm-dd).","type":["string","null"]},"holding_quantity":{"description":"Shares held by this broker on that date.","type":["string","null"]},"holding_change":{"description":"Change in shares held versus the prior day.","type":["string","null"]},"holding_ratio":{"description":"Holding as a ratio of total issued shares.","type":["string","null"]}}}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"broker_holding_detail","title":"Broker Holding Detail","description":"Get full broker holding detail list for a symbol (HK stocks only; sourced from HKEX CCASS participant disclosure). Returns items[]{broker_id, broker_name, holding_quantity, holding_ratio, holding_change, date}.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"SymbolParam","type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"700.HK\"","type":"string"}},"required":["symbol"]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"BrokerHoldingDetailResponse","description":"Returned by `broker_holding_detail`. Wraps an `items` array of the full\nbroker holding list for an HK stock (HKEX CCASS participant disclosure).\nSubset of the wire response.","type":"object","properties":{"items":{"description":"Full broker holding detail entries.","type":["array","null"],"items":{"$ref":"#/$defs/BrokerHoldingDetailItem"}}},"$defs":{"BrokerHoldingDetailItem":{"type":"object","properties":{"broker_id":{"description":"Broker (participant) number.","type":["string","null"]},"broker_name":{"description":"Broker (participant) name.","type":["string","null"]},"holding_quantity":{"description":"Shares held by this broker.","type":["string","null"]},"holding_ratio":{"description":"Holding as a ratio of total issued shares.","type":["string","null"]},"holding_change":{"description":"Change in shares held.","type":["string","null"]},"date":{"description":"Disclosure date (yyyy-mm-dd).","type":["string","null"]}}}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"brokers","title":"Broker Queue","description":"Get broker queue (HK stocks only). Returns bid_brokers/ask_brokers arrays, each with position (1-based) and broker_ids. Map broker IDs to names via participants.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"SymbolParam","type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"700.HK\"","type":"string"}},"required":["symbol"]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"BrokersResponse","description":"Returned by `brokers`. Bid/ask broker queues for a security.","type":"object","properties":{"bid_brokers":{"description":"Bid brokers, best price first.","type":"array","items":{"$ref":"#/$defs/BrokerLevel"}},"ask_brokers":{"description":"Ask brokers, best price first.","type":"array","items":{"$ref":"#/$defs/BrokerLevel"}}},"required":["bid_brokers","ask_brokers"],"$defs":{"BrokerLevel":{"type":"object","properties":{"position":{"description":"Position number (1-based, depth ordering).","type":"integer","format":"int32"},"broker_ids":{"description":"Broker IDs queueing at this level. Map them to names via `participants`.","type":"array","items":{"type":"integer","format":"int32"}}},"required":["position","broker_ids"]}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"business_segments","title":"Business Segments","description":"Get current-period business segment revenue breakdown for a symbol (name, percent, total, currency)","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"BusinessSegmentsParam","type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"AAPL.US\"","type":"string"}},"required":["symbol"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"business_segments_history","title":"Business Segments History","description":"Get historical business segment revenue trends (by period and category). Returns historical[].{date, total, currency, business[{name,percent,value}], regionals[{name,percent,value}]}","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"BusinessSegmentsHistoryParam","type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"AAPL.US\"","type":"string"},"report":{"description":"Report period: \"qf\" (quarterly), \"saf\" (semi-annual), \"af\" (annual)","type":"string"},"cate":{"description":"Segment category filter","type":"string"}},"required":["symbol"]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"BusinessSegmentsHistoryResponse","description":"Returned by `business_segments_history`. Wraps a `historical` array of\nper-period segment snapshots.\n\nSubset of documented fields; upstream may return more.","type":"object","properties":{"historical":{"description":"Per-period segment snapshots.","type":["array","null"],"items":{"$ref":"#/$defs/BusinessSegmentsHistoryPeriod"}}},"$defs":{"BusinessSegmentsHistoryPeriod":{"description":"One period snapshot in `business_segments_history`'s `historical`.\n\nSubset of documented fields; upstream may return more.","type":"object","properties":{"date":{"description":"Period date.","type":["string","null"]},"total":{"description":"Total revenue for the period.","type":["string","null"]},"currency":{"description":"Settlement currency.","type":["string","null"]},"business":{"description":"Revenue by business line.","type":["array","null"],"items":{"$ref":"#/$defs/SegmentBreakdown"}},"regionals":{"description":"Revenue by region.","type":["array","null"],"items":{"$ref":"#/$defs/SegmentBreakdown"}}}},"SegmentBreakdown":{"description":"One segment breakdown entry in `business_segments_history`\n(`business[]` / `regionals[]`).\n\nSubset of documented fields; upstream may return more.","type":"object","properties":{"name":{"description":"Segment / region name.","type":["string","null"]},"percent":{"description":"Percentage of total.","type":["string","null"]},"value":{"description":"Absolute value.","type":["string","null"]}}}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"calc_indexes","title":"Calc Indexes","description":"Calculate financial indexes for symbols. Pass symbols, and optionally indexes (e.g. [\"PeTtmRatio\",\"PbRatio\",\"LastDone\",\"TurnoverRate\"]). When indexes is omitted or empty, defaults to [\"LastDone\",\"ChangeValue\",\"ChangeRate\",\"Volume\",\"PeTtmRatio\",\"PbRatio\",\"DividendRatioTtm\",\"TurnoverRate\",\"TotalMarketValue\"]. Returns per-symbol index values.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"CalcIndexesParam","type":"object","properties":{"symbols":{"description":"Security symbols, e.g. [\"700.HK\", \"AAPL.US\"]","type":"array","items":{"type":"string"}},"indexes":{"description":"Calc indexes (optional; defaults to LastDone, ChangeValue, ChangeRate, Volume, PeTtmRatio, PbRatio, DividendRatioTtm, TurnoverRate, TotalMarketValue): LastDone, ChangeValue, ChangeRate, Volume, Turnover, YtdChangeRate, TurnoverRate, TotalMarketValue, CapitalFlow, Amplitude, VolumeRatio, PeTtmRatio, PbRatio, DividendRatioTtm, FiveDayChangeRate, TenDayChangeRate, HalfYearChangeRate, FiveMinutesChangeRate, ExpiryDate, StrikePrice, UpperStrikePrice, LowerStrikePrice, OutstandingQty, OutstandingRatio, Premium, ItmOtm, ImpliedVolatility, WarrantDelta, CallPrice, ToCallPrice, EffectiveLeverage, LeverageRatio, ConversionRatio, BalancePoint, OpenInterest, Delta, Gamma, Theta, Vega, Rho","type":"array","items":{"type":"string"},"default":[]}},"required":["symbols"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"cancel_order","title":"Cancel Order","description":"Cancel an open order by order_id. Returns plain text \"order cancelled\" on success; errors if the order is already filled or cancelled.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"OrderIdParam","type":"object","properties":{"order_id":{"description":"Order ID (returned by submit_order or listed in today_orders / history_orders)","type":"string"}},"required":["order_id"]},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":true}},{"name":"candlesticks","title":"Candlesticks","description":"Get candlestick data (OHLCV). Only symbol is required; period defaults to day, count to 100 (max 1000), forward_adjust to false, trade_sessions to all. period: 1m/5m/15m/30m/60m/day/week/month/year. trade_sessions: intraday/all","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"CandlesticksParam","type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"700.HK\"","type":"string"},"period":{"description":"Period: 1m, 5m, 15m, 30m, 60m, day, week, month, year (default: day)","type":"string","default":"day"},"count":{"description":"Number of candlesticks (optional, max 1000; default 100)","type":"integer","format":"uint","minimum":0,"default":100},"forward_adjust":{"description":"Whether to forward-adjust for splits/dividends (default: false / no adjust)","type":"boolean","default":false},"trade_sessions":{"description":"Trade sessions: \"intraday\" (regular hours only) or \"all\" (include pre-market and post-market; default \"all\")","type":"string","default":"all"}},"required":["symbol"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"capital_distribution","title":"Capital Distribution","description":"Get capital distribution for a symbol. Returns {timestamp, capital_in{large, medium, small}, capital_out{large, medium, small}} (decimal strings in settlement currency).","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"SymbolParam","type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"700.HK\"","type":"string"}},"required":["symbol"]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"CapitalDistributionResponse","description":"Returned by `capital_distribution`.","type":"object","properties":{"timestamp":{"description":"Snapshot timestamp (RFC3339).","type":"string"},"capital_in":{"description":"Inflow capital broken down by order size.","$ref":"#/$defs/CapitalDistribution"},"capital_out":{"description":"Outflow capital broken down by order size.","$ref":"#/$defs/CapitalDistribution"}},"required":["timestamp","capital_in","capital_out"],"$defs":{"CapitalDistribution":{"type":"object","properties":{"large":{"description":"Capital from large orders.","type":"string"},"medium":{"description":"Capital from medium orders.","type":"string"},"small":{"description":"Capital from small orders.","type":"string"}},"required":["large","medium","small"]}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"capital_flow","title":"Capital Flow","description":"Get capital inflow/outflow time series. Returns items[]{timestamp, inflow, outflow, net_flow} for the symbol (same-day data).","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"SymbolParam","type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"700.HK\"","type":"string"}},"required":["symbol"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"cash_flow","title":"Cash Flow","description":"Get cash flow records (deposits, withdrawals, dividends). Returns items[]{transaction_type, amount, currency, balance, created_at, remark}. start_at/end_at in RFC3339.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"CashFlowParam","type":"object","properties":{"start_at":{"description":"Start time (RFC3339)","type":"string"},"end_at":{"description":"End time (RFC3339)","type":"string"}},"required":["start_at","end_at"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"company","title":"Company Profile","description":"Get company overview. Returns name, description, employees, CEO, founded_year, website, exchange, industry, market_cap, and business profile summary.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"SymbolParam","type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"700.HK\"","type":"string"}},"required":["symbol"]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"CompanyResponse","description":"Returned by `company`. Company overview / profile.\n\nSubset of documented fields; upstream may return more.","type":"object","properties":{"name":{"description":"Company name.","type":["string","null"]},"description":{"description":"Business profile / description.","type":["string","null"]},"employees":{"description":"Number of employees.","type":["integer","null"],"format":"int64"},"ceo":{"description":"Chief Executive Officer.","type":["string","null"]},"founded_year":{"description":"Year the company was founded.","type":["integer","null"],"format":"int64"},"website":{"description":"Company website.","type":["string","null"]},"exchange":{"description":"Listing exchange.","type":["string","null"]},"industry":{"description":"Industry classification.","type":["string","null"]},"market_cap":{"description":"Market capitalization.","type":["string","null"]}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"consensus","title":"Analyst Consensus","description":"Get financial consensus estimates. Returns items[]{period, revenue_estimate, eps_estimate, net_income_estimate, analyst_count, last_updated} for upcoming periods.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"SymbolParam","type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"700.HK\"","type":"string"}},"required":["symbol"]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"ConsensusResponse","description":"Returned by `consensus`. Wraps an `items` array of consensus estimates.\n\nSubset of documented fields; upstream may return more.","type":"object","properties":{"items":{"description":"Consensus estimate records for upcoming periods.","type":["array","null"],"items":{"$ref":"#/$defs/ConsensusItem"}}},"$defs":{"ConsensusItem":{"description":"One record in `consensus`'s `items`.\n\nSubset of documented fields; upstream may return more.","type":"object","properties":{"period":{"description":"Estimate period.","type":["string","null"]},"revenue_estimate":{"description":"Revenue estimate.","type":["string","null"]},"eps_estimate":{"description":"EPS estimate.","type":["string","null"]},"net_income_estimate":{"description":"Net income estimate.","type":["string","null"]},"analyst_count":{"description":"Number of contributing analysts.","type":["integer","null"],"format":"int64"},"last_updated":{"description":"Last update time.","type":["string","null"]}}}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"constituent","title":"Index Constituents / ETF Asset Allocation","description":"Get the constituents of an index or the asset allocation of an ETF. For an index (e.g. HSI.HK, .DJI.US) returns constituents[]{symbol, name, last_done, change_rate, market_cap, weight}. For an ETF (e.g. QQQ.US, 2800.HK) returns the asset allocation as info[] grouped by asset_type: 1=Holdings (top constituents with code, symbol, holding_detail), 2=Regional (country/region breakdown), 3=AssetClass (stock/bond/cash etc.), 4=Industry (sector breakdown). Each group has report_date and lists[]{name, position_ratio, name_locales}; Holdings groups additionally include code, symbol and holding_detail{industry_name, index_name, holding_type_name}.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"IndexSymbolParam","type":"object","properties":{"symbol":{"description":"Index symbol, e.g. \"HSI.HK\"","type":"string"}},"required":["symbol"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"corp_action","title":"Corporate Actions","description":"Get corporate actions (splits, buybacks, name changes). Returns items[]{action_type, effective_date, ratio, description} for the symbol.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"SymbolParam","type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"700.HK\"","type":"string"}},"required":["symbol"]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"CorpActionResponse","description":"Returned by `corp_action`. Wraps an `items` array of corporate actions.\n\nSubset of documented fields; upstream may return more.","type":"object","properties":{"items":{"description":"Corporate action events.","type":["array","null"],"items":{"$ref":"#/$defs/CorpActionItem"}}},"$defs":{"CorpActionItem":{"description":"One event in `corp_action`'s `items`.\n\nSubset of documented fields; upstream may return more.","type":"object","properties":{"action_type":{"description":"Action type (split, buyback, name change, ...).","type":["string","null"]},"effective_date":{"description":"Effective date.","type":["string","null"]},"ratio":{"description":"Ratio (e.g. for splits).","type":["string","null"]},"description":{"description":"Free-text description.","type":["string","null"]}}}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"create_watchlist_group","title":"Create Watchlist Group","description":"Create a new watchlist group. Returns the created group {id, name}. Optionally pass securities (e.g. [\"AAPL.US\", \"700.HK\"]) to pre-populate.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"CreateWatchlistGroupParam","type":"object","properties":{"name":{"description":"Group name","type":"string"},"securities":{"description":"Securities to add, e.g. [\"700.HK\", \"AAPL.US\"]","type":"array","items":{"type":"string"},"default":null}},"required":["name"]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"CreateWatchlistGroupResponse","description":"Returned by `create_watchlist_group`.","type":"object","properties":{"id":{"description":"The newly-created watchlist group ID. Pass this to\n`update_watchlist_group` / `delete_watchlist_group`.","type":"integer","format":"int64"}},"required":["id"]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}},{"name":"dca_check","title":"Check DCA Support","description":"Check whether given symbols support DCA recurring investment. Returns items[]{symbol, support_dca (bool), reason} for each queried symbol.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"DcaCheckParam","type":"object","properties":{"symbols":{"description":"Security symbols to check, e.g. [\"AAPL.US\", \"TSLA.US\"]","type":"array","items":{"type":"string"}}},"required":["symbols"]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"DcaCheckResponse","description":"Returned by `dca_check`. DCA-eligibility result per queried symbol,\nforwarded after the standard transform (upstream `counter_ids` query →\nper-symbol items). Subset of the wire payload — only documented fields are\ndeclared; all optional.","type":"object","properties":{"items":{"description":"Per-symbol support results.","type":["array","null"],"items":{"$ref":"#/$defs/DcaCheckItem"}}},"$defs":{"DcaCheckItem":{"description":"DCA-eligibility result for one symbol.","type":"object","properties":{"symbol":{"description":"Security symbol.","type":["string","null"]},"support_dca":{"description":"Whether the symbol supports DCA recurring investment.","type":["boolean","null"]},"reason":{"description":"Reason when unsupported.","type":["string","null"]}}}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"dca_create","title":"Create DCA Plan","description":"Create a DCA recurring investment plan. frequency: Daily/Weekly/Monthly. day_of_week (Weekly): Mon/Tue/Wed/Thu/Fri. day_of_month (Monthly): 1-28.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"DcaCreateParam","type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"AAPL.US\"","type":"string"},"amount":{"description":"Amount to invest per cycle, e.g. \"100\"","type":"string"},"frequency":{"description":"Investment frequency: Daily, Weekly, Monthly","type":"string"},"day_of_week":{"description":"Day of week for Weekly frequency: Mon, Tue, Wed, Thu, Fri","type":"string"},"day_of_month":{"description":"Day of month for Monthly frequency (1-28)","type":"integer","format":"uint32","minimum":0,"default":null},"allow_margin":{"description":"Allow margin financing (default false)","type":"boolean","default":null}},"required":["symbol","amount","frequency"]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}},{"name":"dca_history","title":"DCA Execution History","description":"Get execution history records for a DCA plan by plan_id. Returns executions[]{date, quantity, amount, price, status, order_id}.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"DcaHistoryParam","type":"object","properties":{"plan_id":{"description":"Plan ID","type":"string"},"page":{"description":"Page number (default 1)","type":"integer","format":"uint32","minimum":0,"default":null},"limit":{"description":"Records per page (default 20)","type":"integer","format":"uint32","minimum":0,"default":null}},"required":["plan_id"]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"DcaHistoryResponse","description":"Returned by `dca_history`. Execution records for one DCA plan, forwarded\nafter the standard transform. Subset of the wire payload — only documented\nfields are declared; all optional.","type":"object","properties":{"executions":{"description":"Execution records.","type":["array","null"],"items":{"$ref":"#/$defs/DcaExecution"}}},"$defs":{"DcaExecution":{"description":"A single DCA plan execution record.","type":"object","properties":{"date":{"description":"Execution date.","type":["string","null"]},"quantity":{"description":"Quantity acquired (decimal string).","type":["string","null"]},"amount":{"description":"Amount invested (decimal string).","type":["string","null"]},"price":{"description":"Execution price (decimal string).","type":["string","null"]},"status":{"description":"Execution status.","type":["string","null"]},"order_id":{"description":"Resulting order ID, if any.","type":["string","null"]}}}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"dca_list","title":"List DCA Plans","description":"List DCA recurring investment plans. Returns plans[]{plan_id, symbol, amount, currency, frequency, status, next_execution_date}. Filter by status (Active/Suspended/Finished) or symbol.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"DcaListParam","type":"object","properties":{"status":{"description":"Filter by status: Active, Suspended, Finished. Omit to return all.","type":"string"},"symbol":{"description":"Filter by symbol, e.g. \"AAPL.US\". Omit to return all plans.","type":"string"},"page":{"description":"Page number (default 1)","type":"integer","format":"uint32","minimum":0,"default":null},"limit":{"description":"Records per page (default 20)","type":"integer","format":"uint32","minimum":0,"default":null}}},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"DcaListResponse","description":"Returned by `dca_list`. Upstream DCA plan-query payload forwarded after the\nstandard transform; the `next_trd_date` unix field is converted to RFC3339.\nSubset of the wire payload — only documented fields are declared; all\noptional.","type":"object","properties":{"plans":{"description":"Recurring-investment (DCA) plans.","type":["array","null"],"items":{"$ref":"#/$defs/DcaPlan"}}},"$defs":{"DcaPlan":{"description":"A single DCA recurring-investment plan.","type":"object","properties":{"plan_id":{"description":"Plan ID. Use with dca_update / dca_pause / dca_resume / dca_stop.","type":["string","null"]},"symbol":{"description":"Security symbol (e.g. \"AAPL.US\").","type":["string","null"]},"amount":{"description":"Amount invested per cycle (decimal string).","type":["string","null"]},"currency":{"description":"Settlement currency.","type":["string","null"]},"frequency":{"description":"Investment frequency (Daily / Weekly / Monthly).","type":["string","null"]},"status":{"description":"Plan status (Active / Suspended / Finished).","type":["string","null"]},"next_execution_date":{"description":"Next scheduled execution date (RFC3339; upstream `next_trd_date`).","type":["string","null"]}}}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"dca_pause","title":"Pause DCA Plan","description":"Pause (suspend) a DCA plan by plan_id. The plan stops executing until resumed. Returns upstream API response. Use dca_resume to restart.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"DcaPlanIdParam","type":"object","properties":{"plan_id":{"description":"Plan ID","type":"string"}},"required":["plan_id"]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"dca_resume","title":"Resume DCA Plan","description":"Resume a suspended DCA plan by plan_id. Resumes automated execution on the configured schedule. Returns upstream API response.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"DcaPlanIdParam","type":"object","properties":{"plan_id":{"description":"Plan ID","type":"string"}},"required":["plan_id"]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"dca_stats","title":"DCA Statistics","description":"Get DCA investment statistics. Returns {total_invested, total_value, total_return, return_rate, plan_count, items[]{symbol, invested, value, return_rate}}.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"DcaStatsParam","type":"object","properties":{"symbol":{"description":"Filter by symbol, e.g. \"AAPL.US\". Omit to return stats for all plans.","type":"string"}}},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"DcaStatsResponse","description":"Returned by `dca_stats`. Aggregate DCA statistics forwarded after the\nstandard transform. Subset of the wire payload — only documented fields are\ndeclared; all optional.","type":"object","properties":{"total_invested":{"description":"Total amount invested across plans (decimal string).","type":["string","null"]},"total_value":{"description":"Current total market value (decimal string).","type":["string","null"]},"total_return":{"description":"Total return (decimal string).","type":["string","null"]},"return_rate":{"description":"Overall return rate (decimal string).","type":["string","null"]},"plan_count":{"description":"Number of plans included.","type":["integer","null"],"format":"int64"},"items":{"description":"Per-symbol breakdown.","type":["array","null"],"items":{"$ref":"#/$defs/DcaStatsItem"}}},"$defs":{"DcaStatsItem":{"description":"Per-symbol DCA statistics line.","type":"object","properties":{"symbol":{"description":"Security symbol.","type":["string","null"]},"invested":{"description":"Amount invested in this symbol (decimal string).","type":["string","null"]},"value":{"description":"Current value of this symbol's position (decimal string).","type":["string","null"]},"return_rate":{"description":"Return rate for this symbol (decimal string).","type":["string","null"]}}}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"dca_stop","title":"Stop DCA Plan","description":"Permanently stop a DCA plan by plan_id. This cannot be undone. To temporarily pause, use dca_pause instead. Returns upstream API response.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"DcaPlanIdParam","type":"object","properties":{"plan_id":{"description":"Plan ID","type":"string"}},"required":["plan_id"]},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":true}},{"name":"dca_update","title":"Update DCA Plan","description":"Update an existing DCA plan by plan_id. Can change amount, frequency (Daily/Weekly/Monthly), day_of_week (Mon-Fri), or day_of_month (1-28). Returns updated plan.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"DcaUpdateParam","type":"object","properties":{"plan_id":{"description":"Plan ID to update","type":"string"},"amount":{"description":"New investment amount per cycle","type":"string"},"frequency":{"description":"New investment frequency: Daily, Weekly, Monthly","type":"string"},"day_of_week":{"description":"Day of week for Weekly frequency: Mon, Tue, Wed, Thu, Fri","type":"string"},"day_of_month":{"description":"Day of month for Monthly frequency (1-28)","type":"integer","format":"uint32","minimum":0,"default":null},"allow_margin":{"description":"Allow margin financing","type":"boolean","default":null}},"required":["plan_id"]},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":true}},{"name":"delete_watchlist_group","title":"Delete Watchlist Group","description":"Delete a watchlist group by id (numeric). Set purge=true to also remove its securities from all other groups. Returns upstream API response.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"DeleteWatchlistGroupParam","type":"object","properties":{"id":{"description":"Watchlist group id","type":"integer","format":"int64"},"purge":{"description":"Whether to also remove the securities from other groups","type":"boolean"}},"required":["id","purge"]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"DeleteWatchlistGroupResponse","description":"Returned by `delete_watchlist_group`.","type":"object","properties":{"id":{"description":"The deleted watchlist group ID (echoed from the request).","type":"integer","format":"int64"},"deleted":{"description":"Always `true` on success.","type":"boolean"}},"required":["id","deleted"]},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":true}},{"name":"deposits","title":"Deposits","description":"List deposit history for the current account. Returns items[]{id, amount, currency, status, created_at, updated_at}. states: comma-separated (Pending/Finished/Failed). currencies: comma-separated codes.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"DepositParam","type":"object","properties":{"page":{"description":"Page number (default: 1)","type":"integer","format":"uint32","minimum":0},"size":{"description":"Page size (default: 20)","type":"integer","format":"uint32","minimum":0},"states":{"description":"Filter by deposit states (comma-separated)","type":"string"},"currencies":{"description":"Filter by currencies (comma-separated, e.g. \"USD,HKD\")","type":"string"}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"depth","title":"Order Book Depth","description":"Get order book depth for a symbol. Returns {bids[]{position, price, volume, order_num}, asks[]{position, price, volume, order_num}}. Up to 10 price levels.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"SymbolParam","type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"700.HK\"","type":"string"}},"required":["symbol"]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"DepthResponse","description":"Returned by `depth`. Snapshot of the bid/ask order book.","type":"object","properties":{"bids":{"description":"Bid levels, best price first.","type":"array","items":{"$ref":"#/$defs/DepthLevel"}},"asks":{"description":"Ask levels, best price first.","type":"array","items":{"$ref":"#/$defs/DepthLevel"}}},"required":["bids","asks"],"$defs":{"DepthLevel":{"type":"object","properties":{"position":{"description":"Position number (1-based, depth ordering).","type":"integer","format":"int32"},"price":{"description":"Price at this level. May be null when the level is empty.","type":["string","null"]},"volume":{"description":"Total quantity at this price level.","type":"integer","format":"int64"},"order_num":{"description":"Number of orders sitting at this price level.","type":"integer","format":"int64"}},"required":["position","volume","order_num"]}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"dividend","title":"Dividend","description":"Get dividend history. Returns items[]{ex_date, pay_date, record_date, dividend_type, amount, currency, status} for the symbol.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"SymbolParam","type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"700.HK\"","type":"string"}},"required":["symbol"]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"DividendResponse","description":"Returned by `dividend`. Wraps an `items` array of dividend events.\n\nSubset of documented fields; upstream may return more.","type":"object","properties":{"items":{"description":"Dividend events for the symbol.","type":["array","null"],"items":{"$ref":"#/$defs/DividendItem"}}},"$defs":{"DividendItem":{"description":"One dividend event in `dividend`'s `items`.\n\nSubset of documented fields; upstream may return more.","type":"object","properties":{"ex_date":{"description":"Ex-dividend date.","type":["string","null"]},"pay_date":{"description":"Payment date.","type":["string","null"]},"record_date":{"description":"Record date.","type":["string","null"]},"dividend_type":{"description":"Dividend type.","type":["string","null"]},"amount":{"description":"Dividend amount.","type":["string","null"]},"currency":{"description":"Settlement currency.","type":["string","null"]},"status":{"description":"Dividend status.","type":["string","null"]}}}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"dividend_detail","title":"Dividend Detail","description":"Get detailed dividend distribution scheme. Returns details[]{period, cash_dividend, stock_dividend, record_date, ex_date, pay_date, currency}.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"SymbolParam","type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"700.HK\"","type":"string"}},"required":["symbol"]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"DividendDetailResponse","description":"Returned by `dividend_detail`. Wraps a `details` array of distribution\nschemes.\n\nSubset of documented fields; upstream may return more.","type":"object","properties":{"details":{"description":"Per-period distribution schemes.","type":["array","null"],"items":{"$ref":"#/$defs/DividendDetailItem"}}},"$defs":{"DividendDetailItem":{"description":"One distribution scheme in `dividend_detail`'s `details`.\n\nSubset of documented fields; upstream may return more.","type":"object","properties":{"period":{"description":"Reporting period.","type":["string","null"]},"cash_dividend":{"description":"Cash dividend per share.","type":["string","null"]},"stock_dividend":{"description":"Stock dividend ratio / amount.","type":["string","null"]},"record_date":{"description":"Record date.","type":["string","null"]},"ex_date":{"description":"Ex-dividend date.","type":["string","null"]},"pay_date":{"description":"Payment date.","type":["string","null"]},"currency":{"description":"Settlement currency.","type":["string","null"]}}}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"estimate_max_purchase_quantity","title":"Estimate Max Purchase Quantity","description":"Estimate maximum buy/sell quantity for a symbol. Returns {cash_max_qty, margin_max_qty} (decimal strings). Only symbol is required; side (case-insensitive Buy/Sell) defaults to Buy, order_type (case-insensitive) defaults to LO, and price is optional.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"EstimateMaxQtyParam","type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"700.HK\"","type":"string"},"side":{"description":"Buy or Sell (case-insensitive; default: Buy)","type":"string","default":"Buy"},"order_type":{"description":"Order type, case-insensitive (default: LO): LO (Limit Order) / ELO (Enhanced Limit Order) / MO (Market Order) / AO (At-auction) / ALO (At-auction Limit Order)","type":"string","default":"LO"},"price":{"description":"Limit price for limit-style orders. Omit for market orders.","type":"string"}},"required":["symbol"]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"EstimateMaxQtyResponse","description":"Returned by `estimate_max_purchase_quantity`.\n\nBoth quantities are `Decimal` upstream and become strings after the\n`to_tool_json` serializer pipeline (snake_case + decimal stringification).","type":"object","properties":{"cash_max_qty":{"description":"Maximum buy/sell quantity using cash buying power.","type":"string"},"margin_max_qty":{"description":"Maximum buy/sell quantity using margin buying power.","type":"string"}},"required":["cash_max_qty","margin_max_qty"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"exchange_rate","title":"Exchange Rate","description":"Get exchange rates for all supported currencies. Returns list[]{from_currency, to_currency, rate, timestamp} covering USD, HKD, CNY, SGD and others.","inputSchema":{"type":"object","properties":{}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"executive","title":"Executive","description":"Get company executive and board member information. Returns members[]{name, title, appointed_date, age, biography, compensation}.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"SymbolParam","type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"700.HK\"","type":"string"}},"required":["symbol"]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"ExecutiveResponse","description":"Returned by `executive`. Wraps a `members` array of executives / board\nmembers.\n\nSubset of documented fields; upstream may return more.","type":"object","properties":{"members":{"description":"Executive and board members.","type":["array","null"],"items":{"$ref":"#/$defs/ExecutiveMember"}}},"$defs":{"ExecutiveMember":{"description":"One person in `executive`'s `members`.\n\nSubset of documented fields; upstream may return more.","type":"object","properties":{"name":{"description":"Full name.","type":["string","null"]},"title":{"description":"Title / role.","type":["string","null"]},"appointed_date":{"description":"Date appointed.","type":["string","null"]},"age":{"description":"Age.","type":["integer","null"],"format":"int64"},"biography":{"description":"Biography.","type":["string","null"]},"compensation":{"description":"Compensation.","type":["string","null"]}}}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"filings","title":"Filings","description":"Get regulatory filings (8-K, 10-Q, 10-K, etc.). Returns items[]{id, title, type, language, filing_date, url} for the symbol.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"SymbolParam","type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"700.HK\"","type":"string"}},"required":["symbol"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"finance_calendar","title":"Financial Calendar","description":"Get finance calendar events by category and date range. category: report (earnings + financials) / dividend / split (splits & reverse splits) / ipo / macrodata (CPI, NFP, rate decisions) / closed (market holidays). market: HK/US/CN/SG/JP/UK/DE/AU (optional). Keep the date range to 2 weeks or less; for longer periods split into multiple calls to avoid truncation.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"FinanceCalendarParam","type":"object","properties":{"category":{"description":"Event category. One of:\n- \"report\": earnings reports (includes financial statements)\n- \"dividend\": dividend announcements\n- \"split\": stock splits and reverse splits (share consolidations)\n- \"ipo\": upcoming IPO listings\n- \"macrodata\": macro economic data releases (CPI, NFP, rate decisions, etc.)\n- \"closed\": market closure days","type":"string"},"start":{"description":"Start date in YYYY-MM-DD format (inclusive)","type":"string"},"end":{"description":"End date in YYYY-MM-DD format (inclusive)","type":"string"},"market":{"description":"Optional market filter. One of: HK, US, CN, SG, JP, UK, DE, AU.\nOmit to include all markets.","type":"string"}},"required":["category","start","end"]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"FinanceCalendarResponse","description":"Returned by `finance_calendar`. Wraps a `list` array of date buckets, each\nholding an `infos` array of events. Subset of the wire response — the\nevent field set varies by `category` (report / dividend / split / ipo /\nmacrodata / closed) and is only partially documented, so only the keys the\nmerge/dedup pipeline relies on are modeled here.","type":"object","properties":{"list":{"description":"Date buckets, sorted ascending by date.","type":["array","null"],"items":{"$ref":"#/$defs/FinanceCalendarBucket"}}},"$defs":{"FinanceCalendarBucket":{"type":"object","properties":{"date":{"description":"Bucket date (yyyy-mm-dd).","type":["string","null"]},"infos":{"description":"Events occurring on this date.","type":["array","null"],"items":{"$ref":"#/$defs/FinanceCalendarEvent"}}}},"FinanceCalendarEvent":{"type":"object","properties":{"id":{"description":"Event ID (may be empty for events without one, e.g. market closures).","type":["string","null"]},"symbol":{"description":"Security symbol when the event is stock-specific, e.g. \"AAPL.US\".","type":["string","null"]},"datetime":{"description":"Event time (RFC3339).","type":["string","null"]},"market":{"description":"Market code, e.g. \"US\" / \"HK\".","type":["string","null"]}}}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"financial_report","title":"Financial Report","description":"Get financial reports (income statement, balance sheet, cash flow). kind: IS/BS/CF/ALL. report_type: af (annual), saf (semi-annual), q1/q2/q3, qf (quarterly full).","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"FinancialReportParam","type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"AAPL.US\"","type":"string"},"kind":{"description":"Statement kind: \"IS\" (income statement), \"BS\" (balance sheet), \"CF\" (cash flow), \"ALL\" (default)","type":"string"},"report_type":{"description":"Report period: \"af\" (annual), \"saf\" (semi-annual), \"q1\"/\"q2\"/\"q3\" (quarterly), \"qf\" (quarterly full)","type":"string"}},"required":["symbol"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"financial_report_latest","title":"Latest Financial Report","description":"Get the latest financial report summary for a security. Returns {period, revenue, net_income, eps, roe, gross_margin, report_date} and key financial highlights.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"SymbolParam","type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"700.HK\"","type":"string"}},"required":["symbol"]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"FinancialReportLatestResponse","description":"Returned by `financial_report_latest`. Latest financial report summary.\n\nSubset of documented fields; upstream may return more.","type":"object","properties":{"period":{"description":"Reporting period.","type":["string","null"]},"revenue":{"description":"Revenue.","type":["string","null"]},"net_income":{"description":"Net income.","type":["string","null"]},"eps":{"description":"Earnings per share.","type":["string","null"]},"roe":{"description":"Return on equity.","type":["string","null"]},"gross_margin":{"description":"Gross margin.","type":["string","null"]},"report_date":{"description":"Report date.","type":["string","null"]}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"financial_report_snapshot","title":"Financial Report Snapshot","description":"Get financial report snapshot: report_desc (text summary), fo_revenue/fo_ebit/fo_eps (actual vs forecast with yoy/cmp), fr_* financial ratios (ROE, margins, assets, cash flow). report: qf/saf/af.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"FinancialReportSnapshotParam","type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"AAPL.US\"","type":"string"},"report":{"description":"Report type: \"qf\" (quarterly), \"saf\" (semi-annual), \"af\" (annual)","type":"string"},"fiscal_year":{"description":"Fiscal year, e.g. 2024","type":"integer","format":"uint32","minimum":0},"fiscal_period":{"description":"Fiscal period, e.g. \"1\" \"2\" \"3\" \"4\"","type":"string"}},"required":["symbol"]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"FinancialReportSnapshotResponse","description":"Returned by `financial_report_snapshot`. Actual-vs-forecast comparison\nplus financial ratios.\n\nSubset of documented fields; upstream may return more.","type":"object","properties":{"report_desc":{"description":"Text summary of the report.","type":["string","null"]},"fo_revenue":{"description":"Revenue: actual vs forecast.","anyOf":[{"$ref":"#/$defs/ForecastActual"},{"type":"null"}]},"fo_ebit":{"description":"EBIT: actual vs forecast.","anyOf":[{"$ref":"#/$defs/ForecastActual"},{"type":"null"}]},"fo_eps":{"description":"EPS: actual vs forecast.","anyOf":[{"$ref":"#/$defs/ForecastActual"},{"type":"null"}]}},"$defs":{"ForecastActual":{"description":"An actual-vs-forecast comparison block in `financial_report_snapshot`\n(`fo_revenue` / `fo_ebit` / `fo_eps`).\n\nSubset of documented fields; upstream may return more.","type":"object","properties":{"yoy":{"description":"Year-over-year change.","type":["string","null"]},"cmp":{"description":"Actual vs forecast comparison.","type":["string","null"]}}}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"financial_statement","title":"Financial Statements","description":"Get financial statements (income statement, balance sheet, or cash flow) for a security. kind: IS/BS/CF/ALL. report: af (annual), saf (semi-annual), qf (quarterly full), q1/q2/q3.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"FinancialStatementParam","type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"AAPL.US\"","type":"string"},"kind":{"description":"Statement kind: \"IS\" (income statement), \"BS\" (balance sheet), \"CF\" (cash flow), \"ALL\" (default)","type":"string"},"report":{"description":"Report period: \"af\" (annual), \"saf\" (semi-annual), \"qf\" (quarterly full), \"q1\"/\"q2\"/\"q3\"","type":"string"}},"required":["symbol"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"forecast_eps","title":"Forecast EPS","description":"Get EPS forecast and analyst estimate history. Returns items[]{forecast_start_date, forecast_end_date, eps_estimate, eps_actual, surprise_pct, analyst_count}.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"SymbolParam","type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"700.HK\"","type":"string"}},"required":["symbol"]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"ForecastEpsResponse","description":"Returned by `forecast_eps`. Wraps an `items` array of EPS estimates.\n\nSubset of documented fields; upstream may return more.","type":"object","properties":{"items":{"description":"EPS forecast / actual records.","type":["array","null"],"items":{"$ref":"#/$defs/ForecastEpsItem"}}},"$defs":{"ForecastEpsItem":{"description":"One record in `forecast_eps`'s `items`.\n\nSubset of documented fields; upstream may return more.","type":"object","properties":{"forecast_start_date":{"description":"Forecast period start (RFC3339; rewritten from a unix-epoch field).","type":["string","null"]},"forecast_end_date":{"description":"Forecast period end (RFC3339; rewritten from a unix-epoch field).","type":["string","null"]},"eps_estimate":{"description":"Consensus EPS estimate.","type":["string","null"]},"eps_actual":{"description":"Actual reported EPS.","type":["string","null"]},"surprise_pct":{"description":"Surprise percentage (actual vs estimate).","type":["string","null"]},"analyst_count":{"description":"Number of contributing analysts.","type":["integer","null"],"format":"int64"}}}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"fund_holder","title":"Fund Holders","description":"Get funds and ETFs that hold a given symbol. Returns fund_holders[]{fund_name, fund_symbol, shares, ratio, change, reported_at}.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"SymbolParam","type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"700.HK\"","type":"string"}},"required":["symbol"]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"FundHolderResponse","description":"Returned by `fund_holder`. Wraps a `fund_holders` array.\n\nSubset of documented fields; upstream may return more.","type":"object","properties":{"fund_holders":{"description":"Funds / ETFs that hold the symbol.","type":["array","null"],"items":{"$ref":"#/$defs/FundHolderItem"}}},"$defs":{"FundHolderItem":{"description":"One holder in `fund_holder`'s `fund_holders`.\n\nSubset of documented fields; upstream may return more.","type":"object","properties":{"fund_name":{"description":"Fund name.","type":["string","null"]},"fund_symbol":{"description":"Fund symbol.","type":["string","null"]},"shares":{"description":"Shares held.","type":["string","null"]},"ratio":{"description":"Ownership ratio.","type":["string","null"]},"change":{"description":"Change in shares.","type":["string","null"]},"reported_at":{"description":"Report date.","type":["string","null"]}}}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"fund_positions","title":"Fund Positions","description":"Get current fund positions. Returns list[].fund_info[]{symbol, symbol_name, currency, holding_units, current_net_asset_value, cost_net_asset_value, net_asset_value_day}.","inputSchema":{"type":"object","properties":{}},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"FundPositionsResponse","description":"Returned by `fund_positions`. Same channel-list shape as\n`StockPositionsResponse`, but with fund-specific position fields.","type":"object","properties":{"list":{"type":"array","items":{"$ref":"#/$defs/FundPositionChannel"}}},"required":["list"],"$defs":{"FundPositionChannel":{"type":"object","properties":{"account_channel":{"description":"Broker channel identifier. Always emitted as `null` for privacy.","type":["string","null"]},"fund_info":{"description":"Fund positions held in this channel.","type":"array","items":{"$ref":"#/$defs/FundPosition"}}},"required":["fund_info"]},"FundPosition":{"type":"object","properties":{"symbol":{"description":"Fund ISIN code.","type":"string"},"symbol_name":{"description":"Display name of the fund.","type":"string"},"currency":{"description":"Settlement currency.","type":"string"},"holding_units":{"description":"Number of fund units held.","type":"string"},"current_net_asset_value":{"description":"Net asset value at last settlement.","type":"string"},"net_asset_value_day":{"description":"Settlement timestamp (RFC3339).","type":"string"},"cost_net_asset_value":{"description":"Cost net asset value.","type":"string"}},"required":["symbol","symbol_name","currency","holding_units","current_net_asset_value","net_asset_value_day","cost_net_asset_value"]}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"history_candlesticks_by_date","title":"Historical Candlesticks by Date","description":"Get historical candlestick data by date range. period: 1m/5m/15m/30m/60m/day/week/month/year","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"HistoryCandlesticksByDateParam","type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"700.HK\"","type":"string"},"period":{"description":"Period: 1m, 5m, 15m, 30m, 60m, day, week, month, year","type":"string"},"forward_adjust":{"description":"Whether to forward-adjust for splits/dividends","type":"boolean"},"start":{"description":"Start date (yyyy-mm-dd), optional","type":"string"},"end":{"description":"End date (yyyy-mm-dd), optional","type":"string"},"trade_sessions":{"description":"Trade sessions: \"intraday\" (regular hours only) or \"all\" (include pre-market and post-market)","type":"string"}},"required":["symbol","period","forward_adjust","trade_sessions"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"history_candlesticks_by_offset","title":"Historical Candlesticks by Offset","description":"Get historical candlestick data by offset from a reference time. period: 1m/5m/15m/30m/60m/day/week/month/year","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"HistoryCandlesticksByOffsetParam","type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"700.HK\"","type":"string"},"period":{"description":"Period: 1m, 5m, 15m, 30m, 60m, day, week, month, year","type":"string"},"forward_adjust":{"description":"Whether to forward-adjust for splits/dividends","type":"boolean"},"forward":{"description":"Whether to query forward in time (true) or backward (false)","type":"boolean"},"time":{"description":"Reference datetime (yyyy-mm-ddTHH:MM:SS), omit to start from latest","type":"string"},"count":{"description":"Number of candlesticks (max 1000)","type":"integer","format":"uint","minimum":0},"trade_sessions":{"description":"Trade sessions: \"intraday\" (regular hours only) or \"all\" (include pre-market and post-market)","type":"string"}},"required":["symbol","period","forward_adjust","forward","count","trade_sessions"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"history_executions","title":"Historical Executions","description":"Get historical trade executions between dates. Returns executions[]{order_id, symbol, side, quantity, price, trade_done_at}. start_at/end_at in RFC3339.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"HistoryOrdersParam","type":"object","properties":{"symbol":{"description":"Filter by symbol (optional)","type":"string"},"start_at":{"description":"Start time (RFC3339)","type":"string"},"end_at":{"description":"End time (RFC3339)","type":"string"}},"required":["start_at","end_at"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"history_market_temperature","title":"Historical Market Temperature","description":"Get historical market temperature time series. Returns {type, list[]{temperature, description, valuation, sentiment, timestamp}} for the given market and date range.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"MarketDateRangeParam","type":"object","properties":{"market":{"description":"Market code: HK, US, CN, SG","type":"string"},"start":{"description":"Start date (yyyy-mm-dd)","type":"string"},"end":{"description":"End date (yyyy-mm-dd)","type":"string"}},"required":["market","start","end"]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"HistoryMarketTemperatureResponse","description":"Returned by `history_market_temperature`.","type":"object","properties":{"type":{"description":"Granularity, e.g. \"day\".","type":"string"},"list":{"description":"Per-period samples in chronological order.","type":"array","items":{"$ref":"#/$defs/MarketTemperatureResponse"}}},"required":["type","list"],"$defs":{"MarketTemperatureResponse":{"description":"Returned by `market_temperature`.","type":"object","properties":{"temperature":{"description":"Temperature value (0-100).","type":"integer","format":"int32"},"description":{"description":"Human-readable temperature description (locale-aware).","type":"string"},"valuation":{"description":"Market valuation indicator (0-100).","type":"integer","format":"int32"},"sentiment":{"description":"Market sentiment indicator (0-100).","type":"integer","format":"int32"},"timestamp":{"description":"Snapshot timestamp (RFC3339).","type":"string"}},"required":["temperature","description","valuation","sentiment","timestamp"]}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"history_orders","title":"Historical Orders","description":"Get historical orders between dates (excludes today). Returns orders[]{order_id, symbol, side, status, quantity, price, submitted_at}. start_at/end_at in RFC3339.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"HistoryOrdersParam","type":"object","properties":{"symbol":{"description":"Filter by symbol (optional)","type":"string"},"start_at":{"description":"Start time (RFC3339)","type":"string"},"end_at":{"description":"End time (RFC3339)","type":"string"}},"required":["start_at","end_at"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"industry_peers","title":"Industry Peers","description":"Hierarchical sub-sector tree for an industry group. Accepts BK counter_id from industry_rank (e.g. BK/US/IN00258). Returns chain{name,counter_id,stock_num,chg,ytd_chg,next[{...}]} and top{name,market}. Each node shows stock count, daily change, and YTD change.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"IndustryPeersParam","type":"object","properties":{"symbol":{"description":"BK counter_id from `industry_rank`, e.g. \"BK/US/IN00258\".","type":"string"}},"required":["symbol"]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"IndustryPeersResponse","description":"Returned by `industry_peers`. A hierarchical sub-sector tree (`chain`) plus\nthe originating industry group (`top`).\n\nSubset of documented fields; upstream may return more.","type":"object","properties":{"chain":{"description":"Root node of the sub-sector tree.","anyOf":[{"$ref":"#/$defs/IndustryPeersNode"},{"type":"null"}]},"top":{"description":"The originating industry group.","anyOf":[{"$ref":"#/$defs/IndustryPeersTop"},{"type":"null"}]}},"$defs":{"IndustryPeersNode":{"description":"One node in `industry_peers`' `chain` tree. Self-referential via `next`.\n\nSubset of documented fields; upstream may return more.","type":"object","properties":{"name":{"description":"Node name.","type":["string","null"]},"counter_id":{"description":"Node identifier (transformed from `counter_id`).","type":["string","null"]},"stock_num":{"description":"Number of stocks in this sub-sector.","type":["integer","null"],"format":"int64"},"chg":{"description":"Daily change.","type":["string","null"]},"ytd_chg":{"description":"Year-to-date change.","type":["string","null"]},"next":{"description":"Child sub-sector nodes.","type":["array","null"],"items":{"$ref":"#/$defs/IndustryPeersNode"}}}},"IndustryPeersTop":{"description":"`top` block of `industry_peers`.\n\nSubset of documented fields; upstream may return more.","type":"object","properties":{"name":{"description":"Industry group name.","type":["string","null"]},"market":{"description":"Market code.","type":["string","null"]}}}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"industry_rank","title":"Industry Rank","description":"Industry ranking list by market (US/HK/CN/SG) and indicator (0=领涨/1=今日走势/2=人气/3=市值/4=营收/5=营收增长率/6=净利润/7=净利润增长率). sort_type: 0=单级 1=多层. Returns items[]{counter_id(BK/US/IN00258), name, chg, lists[]}. Pass counter_id directly to industry_peers.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"IndustryRankParam","type":"object","properties":{"market":{"description":"Market: \"US\" | \"HK\" | \"SG\" | \"CN\"","type":"string"},"indicator":{"description":"Ranking indicator (default: \"0\"):\n  \"0\" = 领涨行业, \"1\" = 今日走势, \"2\" = 行业人气, \"3\" = 市值,\n  \"4\" = 营收, \"5\" = 营收增长率, \"6\" = 净利润, \"7\" = 净利润增长率","type":"string"},"limit":{"description":"Number of results to return (default: returns all)","type":"string"},"sort_type":{"description":"Sort type: \"0\" = 单级 (default) | \"1\" = 多层","type":"string"}},"required":["market"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"industry_valuation","title":"Industry Valuation","description":"Get industry valuation comparison for peers. Returns list[]{symbol, name, pe, pb, ps, dividend_yield, history[]{date, pe, pb}} for peers in the same industry.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"SymbolParam","type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"700.HK\"","type":"string"}},"required":["symbol"]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"IndustryValuationResponse","description":"Returned by `industry_valuation`. Wraps a `list` of industry peers.\n\nSubset of documented fields; upstream may return more.","type":"object","properties":{"list":{"description":"Peers in the same industry.","type":["array","null"],"items":{"$ref":"#/$defs/IndustryValuationItem"}}},"$defs":{"IndustryValuationItem":{"description":"One peer in `industry_valuation`'s `list`.\n\nSubset of documented fields; upstream may return more.","type":"object","properties":{"symbol":{"description":"Security symbol (transformed from `counter_id`).","type":["string","null"]},"name":{"description":"Display name.","type":["string","null"]},"pe":{"description":"Price-to-earnings.","type":["string","null"]},"pb":{"description":"Price-to-book.","type":["string","null"]},"ps":{"description":"Price-to-sales.","type":["string","null"]},"dividend_yield":{"description":"Dividend yield.","type":["string","null"]},"history":{"description":"Per-date history of PE/PB.","type":["array","null"],"items":{"$ref":"#/$defs/IndustryValuationHistoryPoint"}}}},"IndustryValuationHistoryPoint":{"description":"One history point in `industry_valuation`'s nested `history`.\n\nSubset of documented fields; upstream may return more.","type":"object","properties":{"date":{"description":"Sample date (RFC3339; rewritten from a unix-epoch field).","type":["string","null"]},"pe":{"description":"Price-to-earnings at this date.","type":["string","null"]},"pb":{"description":"Price-to-book at this date.","type":["string","null"]}}}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"industry_valuation_dist","title":"Industry Valuation Distribution","description":"Get industry PE/PB/PS valuation distribution. Returns distributions{pe/pb/ps}{min, p25, median, p75, max, current_percentile} to see where the stock sits in its sector.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"SymbolParam","type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"700.HK\"","type":"string"}},"required":["symbol"]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"IndustryValuationDistResponse","description":"Returned by `industry_valuation_dist`. Per-indicator distribution stats\ngrouped under `distributions`.\n\nSubset of documented fields; upstream may return more.","type":"object","properties":{"distributions":{"description":"Per-indicator distribution blocks.","anyOf":[{"$ref":"#/$defs/IndustryValuationDistributions"},{"type":"null"}]}},"$defs":{"IndustryValuationDistributions":{"description":"`distributions` block of `industry_valuation_dist`.\n\nSubset of documented fields; upstream may return more.","type":"object","properties":{"pe":{"description":"Price-to-earnings distribution.","anyOf":[{"$ref":"#/$defs/IndustryValuationDistribution"},{"type":"null"}]},"pb":{"description":"Price-to-book distribution.","anyOf":[{"$ref":"#/$defs/IndustryValuationDistribution"},{"type":"null"}]},"ps":{"description":"Price-to-sales distribution.","anyOf":[{"$ref":"#/$defs/IndustryValuationDistribution"},{"type":"null"}]}}},"IndustryValuationDistribution":{"description":"One indicator's distribution stats in `industry_valuation_dist`.\n\nSubset of documented fields; upstream may return more.","type":"object","properties":{"min":{"description":"Minimum value.","type":["string","null"]},"p25":{"description":"25th percentile.","type":["string","null"]},"median":{"description":"Median.","type":["string","null"]},"p75":{"description":"75th percentile.","type":["string","null"]},"max":{"description":"Maximum value.","type":["string","null"]},"current_percentile":{"description":"Where the stock currently sits in this distribution.","type":["string","null"]}}}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"institution_rating","title":"Institution Rating","description":"Get institution rating summary. Returns analyst{buy, outperform, hold, underperform, sell counts, target_price, consensus_rating} and instratings list.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"SymbolParam","type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"700.HK\"","type":"string"}},"required":["symbol"]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"InstitutionRatingResponse","description":"Returned by `institution_rating`.\n\nThe tool combines two upstream calls into\n`{\"analyst\": {...}, \"instratings\": [...]}`. Only the `analyst` fields are\ndocumented; the `instratings` payload shape is unspecified and left as raw\nJSON. Subset of documented fields; upstream may return more.","type":"object","properties":{"analyst":{"description":"Analyst rating consensus summary.","anyOf":[{"$ref":"#/$defs/InstitutionRatingAnalyst"},{"type":"null"}]},"instratings":{"description":"Per-institution rating list. Shape is unspecified by the tool\ndescription; passed through as raw JSON."}},"$defs":{"InstitutionRatingAnalyst":{"description":"Analyst consensus block of `institution_rating`.\n\nSubset of documented fields; upstream may return more.","type":"object","properties":{"buy":{"description":"Number of analysts rating \"buy\".","type":["integer","null"],"format":"int64"},"outperform":{"description":"Number of analysts rating \"outperform\".","type":["integer","null"],"format":"int64"},"hold":{"description":"Number of analysts rating \"hold\".","type":["integer","null"],"format":"int64"},"underperform":{"description":"Number of analysts rating \"underperform\".","type":["integer","null"],"format":"int64"},"sell":{"description":"Number of analysts rating \"sell\".","type":["integer","null"],"format":"int64"},"target_price":{"description":"Consensus target price.","type":["string","null"]},"consensus_rating":{"description":"Consensus rating label.","type":["string","null"]}}}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"institution_rating_detail","title":"Institution Rating Detail","description":"Get detailed historical institution ratings and target price history. Returns target.list[]{analyst, firm, rating, target_price, timestamp} per institution.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"SymbolParam","type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"700.HK\"","type":"string"}},"required":["symbol"]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"InstitutionRatingDetailResponse","description":"Returned by `institution_rating_detail`.\n\nDetailed historical institution ratings and target price history, grouped\nunder `target.list[]`. Subset of documented fields; upstream may return\nmore.","type":"object","properties":{"target":{"description":"Target-price / rating history container.","anyOf":[{"$ref":"#/$defs/InstitutionRatingDetailTarget"},{"type":"null"}]}},"$defs":{"InstitutionRatingDetailTarget":{"description":"`target` block of `institution_rating_detail`.","type":"object","properties":{"list":{"description":"Per-institution rating records.","type":["array","null"],"items":{"$ref":"#/$defs/InstitutionRatingDetailItem"}}}},"InstitutionRatingDetailItem":{"description":"One per-institution record in `institution_rating_detail`'s `target.list`.\n\nSubset of documented fields; upstream may return more.","type":"object","properties":{"analyst":{"description":"Analyst name.","type":["string","null"]},"firm":{"description":"Issuing firm / institution name.","type":["string","null"]},"rating":{"description":"Rating label.","type":["string","null"]},"target_price":{"description":"Target price.","type":["string","null"]},"timestamp":{"description":"Rating timestamp (RFC3339; rewritten from a unix-epoch field).","type":["string","null"]}}}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"institution_rating_history","title":"Institution Rating History","description":"Get institution rating history. Returns target_history[]{firm, analyst, old_target, new_target, date} and evaluate_history[]{firm, old_rating, new_rating, date}.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"SymbolParam","type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"700.HK\"","type":"string"}},"required":["symbol"]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"InstitutionRatingHistoryResponse","description":"Returned by `institution_rating_history`. Two history arrays: target-price\nrevisions and rating-evaluation changes.\n\nSubset of documented fields; upstream may return more.","type":"object","properties":{"target_history":{"description":"Target-price revisions.","type":["array","null"],"items":{"$ref":"#/$defs/TargetHistoryItem"}},"evaluate_history":{"description":"Rating-evaluation changes.","type":["array","null"],"items":{"$ref":"#/$defs/EvaluateHistoryItem"}}},"$defs":{"TargetHistoryItem":{"description":"One target-price revision in `institution_rating_history`.\n\nSubset of documented fields; upstream may return more.","type":"object","properties":{"firm":{"description":"Issuing firm.","type":["string","null"]},"analyst":{"description":"Analyst name.","type":["string","null"]},"old_target":{"description":"Prior target price.","type":["string","null"]},"new_target":{"description":"New target price.","type":["string","null"]},"date":{"description":"Revision date.","type":["string","null"]}}},"EvaluateHistoryItem":{"description":"One rating-evaluation change in `institution_rating_history`.\n\nSubset of documented fields; upstream may return more.","type":"object","properties":{"firm":{"description":"Issuing firm.","type":["string","null"]},"old_rating":{"description":"Prior rating.","type":["string","null"]},"new_rating":{"description":"New rating.","type":["string","null"]},"date":{"description":"Change date.","type":["string","null"]}}}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"institution_rating_industry_rank","title":"Institution Rating Industry Rank","description":"Get peers ranked by institution analyst ratings in the same industry. Returns list[]{symbol, name, buy_count, sell_count, consensus_rating, target_price}. Paginated.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"InstitutionRatingIndustryRankParam","type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"AAPL.US\"","type":"string"},"page":{"description":"Page number (default: 1)","type":"integer","format":"uint32","minimum":0},"size":{"description":"Page size (default: 20)","type":"integer","format":"uint32","minimum":0}},"required":["symbol"]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"InstitutionRatingIndustryRankResponse","description":"Returned by `institution_rating_industry_rank`. Peers ranked by analyst\nratings.\n\nThe tool description says `list[]`, while the implementation transforms a\ntop-level `items[]` array (rewriting `counter_id` → `symbol`). Both names\nare modelled so the schema matches whichever the upstream emits. Subset of\ndocumented fields; upstream may return more.","type":"object","properties":{"list":{"description":"Ranked peers (description's documented key).","type":["array","null"],"items":{"$ref":"#/$defs/InstitutionRatingIndustryRankItem"}},"items":{"description":"Ranked peers (key the implementation transforms in place).","type":["array","null"],"items":{"$ref":"#/$defs/InstitutionRatingIndustryRankItem"}}},"$defs":{"InstitutionRatingIndustryRankItem":{"description":"One peer in `institution_rating_industry_rank`.\n\nSubset of documented fields; upstream may return more.","type":"object","properties":{"symbol":{"description":"Security symbol (transformed from `counter_id`).","type":["string","null"]},"name":{"description":"Display name.","type":["string","null"]},"buy_count":{"description":"Buy rating count.","type":["integer","null"],"format":"int64"},"sell_count":{"description":"Sell rating count.","type":["integer","null"],"format":"int64"},"consensus_rating":{"description":"Consensus rating label.","type":["string","null"]},"target_price":{"description":"Target price.","type":["string","null"]}}}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"institutional_views","title":"Institutional Views","description":"Get monthly institutional rating distribution timeline. Returns months[]{date, buy, outperform, hold, underperform, sell, total} for trend analysis.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"SymbolParam","type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"700.HK\"","type":"string"}},"required":["symbol"]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"InstitutionalViewsResponse","description":"Returned by `institutional_views`. Wraps a `months` array of monthly\nrating-distribution snapshots.\n\nSubset of documented fields; upstream may return more.","type":"object","properties":{"months":{"description":"Monthly rating-distribution snapshots.","type":["array","null"],"items":{"$ref":"#/$defs/InstitutionalViewsMonth"}}},"$defs":{"InstitutionalViewsMonth":{"description":"One month in `institutional_views`'s `months`.\n\nSubset of documented fields; upstream may return more.","type":"object","properties":{"date":{"description":"Month date (RFC3339; rewritten from a unix-epoch field).","type":["string","null"]},"buy":{"description":"Buy count.","type":["integer","null"],"format":"int64"},"outperform":{"description":"Outperform count.","type":["integer","null"],"format":"int64"},"hold":{"description":"Hold count.","type":["integer","null"],"format":"int64"},"underperform":{"description":"Underperform count.","type":["integer","null"],"format":"int64"},"sell":{"description":"Sell count.","type":["integer","null"],"format":"int64"},"total":{"description":"Total ratings.","type":["integer","null"],"format":"int64"}}}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"intraday","title":"Intraday Line","description":"Get intraday minute-by-minute price/volume data. trade_sessions: \"intraday\" (default, regular hours) or \"all\" (include pre-market and post-market)","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"IntradayParam","type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"700.HK\"","type":"string"},"trade_sessions":{"description":"Trade sessions to include: \"intraday\" (default, regular hours only) or \"all\" (include pre-market and post-market).","type":"string"}},"required":["symbol"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"invest_relation","title":"Investor Relations","description":"Get investor relations events and announcements. Returns items[]{title, event_type, event_date, url, description} for the symbol.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"SymbolParam","type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"700.HK\"","type":"string"}},"required":["symbol"]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"InvestRelationResponse","description":"Returned by `invest_relation`. Wraps an `items` array of IR events.\n\nSubset of documented fields; upstream may return more.","type":"object","properties":{"items":{"description":"Investor-relations events and announcements.","type":["array","null"],"items":{"$ref":"#/$defs/InvestRelationItem"}}},"$defs":{"InvestRelationItem":{"description":"One event in `invest_relation`'s `items`.\n\nSubset of documented fields; upstream may return more.","type":"object","properties":{"title":{"description":"Event title.","type":["string","null"]},"event_type":{"description":"Event type.","type":["string","null"]},"event_date":{"description":"Event date.","type":["string","null"]},"url":{"description":"Related URL.","type":["string","null"]},"description":{"description":"Free-text description.","type":["string","null"]}}}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"ipo_calendar","title":"IPO Calendar","description":"Show the IPO calendar. Returns items[]{symbol, name, market, sub_start_date, sub_end_date, listing_date, status} for upcoming and recent IPOs.","inputSchema":{"type":"object","properties":{}},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"IpoCalendarResponse","description":"Returned by `ipo_calendar`. Passthrough of the upstream calendar payload;\nthe documented portion is `items[]`. The upstream `timestamp` is converted\nto RFC3339 by the unix-path transform.","type":"object","properties":{"items":{"description":"Calendar entries for upcoming and recent IPOs.","type":["array","null"],"items":{"$ref":"#/$defs/IpoItem"}}},"$defs":{"IpoItem":{"description":"A single IPO entry as it appears in the subscription / calendar / listed\nfeeds. Subset of the upstream item; field availability varies by feed and\nmarket. Numeric/price fields are stringified by the transform pipeline.","type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"6871.HK\" or \"ARM.US\".","type":["string","null"]},"name":{"description":"Display name of the security.","type":["string","null"]},"market":{"description":"Market code, e.g. \"HK\" / \"US\".","type":["string","null"]},"sub_start_date":{"description":"Subscription window start date (yyyy-mm-dd).","type":["string","null"]},"sub_end_date":{"description":"Subscription window end date (yyyy-mm-dd).","type":["string","null"]},"listing_date":{"description":"Listing date (yyyy-mm-dd).","type":["string","null"]},"issue_price":{"description":"Issue price (stringified decimal).","type":["string","null"]},"min_lot_size":{"description":"Minimum lot size for subscription.","type":["string","null"]},"status":{"description":"IPO status (calendar feed), e.g. upcoming / listed.","type":["string","null"]}}}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"ipo_detail","title":"IPO Detail","description":"Show IPO detail for a symbol. Returns profile (business overview), timeline[]{event, date}, subscription eligibility, pricing_range, lot_size, allotment_rules.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"IpoDetailParam","type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"6871.HK\" or \"ARM.US\"","type":"string"},"market":{"description":"Market: \"HK\" or \"US\" (default: inferred from symbol suffix)","type":"string"}},"required":["symbol"]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"IpoDetailResponse","description":"Returned by `ipo_detail`. The tool combines three upstream payloads\n(`profile`, `timeline`, `eligibility`) under one wrapper object. Each part\nis a passthrough; only the documented portions are typed here.","type":"object","properties":{"profile":{"description":"Business overview / profile payload (passthrough, shape upstream-defined)."},"timeline":{"description":"Timeline events. The upstream payload may wrap this differently; the\ndocumented portion is a list of `{event, date}` entries."},"eligibility":{"description":"Subscription eligibility payload (passthrough, shape upstream-defined)."}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"ipo_listed","title":"IPO Listed","description":"List recently listed IPO stocks (HK+US). Returns items[]{symbol, name, listing_date, issue_price, first_day_close, first_day_return, volume, market}.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"IpoListedParam","type":"object","properties":{"page":{"description":"Page number (default: 1)","type":"integer","format":"uint32","minimum":0},"size":{"description":"Page size (default: 20)","type":"integer","format":"uint32","minimum":0}}},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"IpoListedResponse","description":"Returned by `ipo_listed`. HK and US listed feeds combined under a\n`{hk, us}` wrapper object built by the tool.","type":"object","properties":{"hk":{"description":"Hong Kong recently-listed feed.","$ref":"#/$defs/IpoListedMarketFeed"},"us":{"description":"US recently-listed feed.","$ref":"#/$defs/IpoListedMarketFeed"}},"required":["hk","us"],"$defs":{"IpoListedMarketFeed":{"description":"One side (HK or US) of the listed feed. The documented portion is `items[]`.","type":"object","properties":{"items":{"description":"Recently-listed IPO entries (documented subset of upstream fields).","type":["array","null"],"items":{"$ref":"#/$defs/IpoListedItem"}}}},"IpoListedItem":{"description":"A single recently-listed IPO entry. Subset of upstream fields; numeric and\nprice fields are stringified by the transform pipeline.","type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"6871.HK\".","type":["string","null"]},"name":{"description":"Display name of the security.","type":["string","null"]},"listing_date":{"description":"Listing date (yyyy-mm-dd).","type":["string","null"]},"issue_price":{"description":"Issue price (stringified decimal).","type":["string","null"]},"first_day_close":{"description":"First-day close price (stringified decimal).","type":["string","null"]},"first_day_return":{"description":"First-day return (stringified decimal / percentage).","type":["string","null"]},"volume":{"description":"First-day trading volume.","type":["string","null"]},"market":{"description":"Market code, e.g. \"HK\" / \"US\".","type":["string","null"]}}}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"ipo_order_detail","title":"IPO Order Detail","description":"Show detailed information for a specific IPO order by order_id. Returns {order_id, symbol, market, quantity, allotted_quantity, total_amount, status, submitted_at}.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"IpoOrderDetailParam","type":"object","properties":{"order_id":{"description":"IPO order ID","type":"string"}},"required":["order_id"]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"IpoOrderDetailResponse","description":"Returned by `ipo_order_detail`. Passthrough of a single IPO order; the\ndocumented subset is typed here. Amount fields are stringified decimals and\n`submitted_at` is RFC3339.","type":"object","properties":{"order_id":{"description":"IPO order ID.","type":["string","null"]},"symbol":{"description":"Security symbol, e.g. \"6871.HK\".","type":["string","null"]},"market":{"description":"Market code, e.g. \"HK\" / \"US\".","type":["string","null"]},"quantity":{"description":"Subscription quantity.","type":["string","null"]},"allotted_quantity":{"description":"Allotted quantity after the IPO drawing.","type":["string","null"]},"total_amount":{"description":"Total subscription amount (stringified decimal).","type":["string","null"]},"status":{"description":"Order status.","type":["string","null"]},"submitted_at":{"description":"Order submission time (RFC3339).","type":["string","null"]}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"ipo_orders","title":"IPO Orders","description":"List IPO orders (active+history). Returns orders[]{order_id, symbol, market, quantity, total_amount, status, submitted_at}. Filter by symbol, market, or status.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"IpoOrdersParam","type":"object","properties":{"symbol":{"description":"Filter by symbol, e.g. \"6871.HK\"","type":"string"},"market":{"description":"Filter by market: \"HK\" or \"US\"","type":"string"},"status":{"description":"Filter by order status","type":"string"},"page":{"description":"Page number (default: 1)","type":"integer","format":"uint32","minimum":0},"size":{"description":"Page size (default: 20)","type":"integer","format":"uint32","minimum":0}}},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"IpoOrdersResponse","description":"Returned by `ipo_orders`. Active orders and order history combined under an\n`{orders, history}` wrapper object built by the tool.","type":"object","properties":{"orders":{"description":"Active IPO orders feed.","$ref":"#/$defs/IpoOrdersFeed"},"history":{"description":"Historical IPO orders feed.","$ref":"#/$defs/IpoOrdersFeed"}},"required":["orders","history"],"$defs":{"IpoOrdersFeed":{"description":"One side of the IPO orders feed (active or historical). The documented\nportion is `orders[]`.","type":"object","properties":{"orders":{"description":"IPO order entries (documented subset of upstream fields).","type":["array","null"],"items":{"$ref":"#/$defs/IpoOrderItem"}}}},"IpoOrderItem":{"description":"A single IPO order entry. Subset of upstream fields; amount fields are\nstringified by the transform pipeline and `submitted_at` is RFC3339.","type":"object","properties":{"order_id":{"description":"IPO order ID.","type":["string","null"]},"symbol":{"description":"Security symbol, e.g. \"6871.HK\".","type":["string","null"]},"market":{"description":"Market code, e.g. \"HK\" / \"US\".","type":["string","null"]},"quantity":{"description":"Subscription quantity.","type":["string","null"]},"total_amount":{"description":"Total subscription amount (stringified decimal).","type":["string","null"]},"status":{"description":"Order status.","type":["string","null"]},"submitted_at":{"description":"Order submission time (RFC3339).","type":["string","null"]}}}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"ipo_profit_loss","title":"IPO Profit / Loss","description":"Show IPO profit/loss summary and per-stock breakdown. Returns {total_cost, total_value, total_return, items[]{symbol, cost, current_value, return_rate}}. period: all/ytd/1y/3y.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"IpoProfitLossParam","type":"object","properties":{"period":{"description":"Period filter: \"all\", \"ytd\", \"1y\", \"3y\" (default: \"all\")","type":"string"},"page":{"description":"Page number (default: 1)","type":"integer","format":"uint32","minimum":0},"size":{"description":"Page size (default: 20)","type":"integer","format":"uint32","minimum":0}}},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"IpoProfitLossResponse","description":"Returned by `ipo_profit_loss`. Summary and per-stock breakdown combined\nunder a `{summary, items}` wrapper object built by the tool.","type":"object","properties":{"summary":{"description":"Aggregate cost/value/return totals.","$ref":"#/$defs/IpoProfitLossSummary"},"items":{"description":"Per-stock breakdown items.","$ref":"#/$defs/IpoProfitLossItems"}},"required":["summary","items"],"$defs":{"IpoProfitLossSummary":{"description":"The summary side of the IPO profit/loss feed. Documented totals are\nstringified decimals.","type":"object","properties":{"total_cost":{"description":"Total cost across all IPO holdings (stringified decimal).","type":["string","null"]},"total_value":{"description":"Total current value across all IPO holdings (stringified decimal).","type":["string","null"]},"total_return":{"description":"Total return across all IPO holdings (stringified decimal).","type":["string","null"]}}},"IpoProfitLossItems":{"description":"The items side of the IPO profit/loss feed. The documented portion is\n`items[]`.","type":"object","properties":{"items":{"description":"Per-stock profit/loss breakdown entries.","type":["array","null"],"items":{"$ref":"#/$defs/IpoProfitLossItem"}}}},"IpoProfitLossItem":{"description":"A single per-stock IPO profit/loss breakdown item. Subset of upstream\nfields; monetary and rate fields are stringified by the transform pipeline.","type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"6871.HK\".","type":["string","null"]},"cost":{"description":"Cost basis for this stock (stringified decimal).","type":["string","null"]},"current_value":{"description":"Current market value for this stock (stringified decimal).","type":["string","null"]},"return_rate":{"description":"Return rate for this stock (stringified decimal / percentage).","type":["string","null"]}}}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"ipo_subscriptions","title":"IPO Subscriptions","description":"List IPO stocks in subscription/pre-filing stage (HK+US). Returns items[]{symbol, name, market, sub_start_date, sub_end_date, listing_date, issue_price, min_lot_size}.","inputSchema":{"type":"object","properties":{}},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"IpoSubscriptionsResponse","description":"Returned by `ipo_subscriptions`. HK and US subscription feeds combined under\na `{hk, us}` wrapper object built by the tool.","type":"object","properties":{"hk":{"description":"Hong Kong subscription / pre-filing feed.","$ref":"#/$defs/IpoMarketFeed"},"us":{"description":"US subscription / pre-filing feed.","$ref":"#/$defs/IpoMarketFeed"}},"required":["hk","us"],"$defs":{"IpoMarketFeed":{"description":"One side (HK or US) of an IPO feed that splits results by market. Each side\nis the raw upstream payload; the documented portion is `items[]`.","type":"object","properties":{"items":{"description":"IPO entries for this market (documented subset of upstream fields).","type":["array","null"],"items":{"$ref":"#/$defs/IpoItem"}}}},"IpoItem":{"description":"A single IPO entry as it appears in the subscription / calendar / listed\nfeeds. Subset of the upstream item; field availability varies by feed and\nmarket. Numeric/price fields are stringified by the transform pipeline.","type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"6871.HK\" or \"ARM.US\".","type":["string","null"]},"name":{"description":"Display name of the security.","type":["string","null"]},"market":{"description":"Market code, e.g. \"HK\" / \"US\".","type":["string","null"]},"sub_start_date":{"description":"Subscription window start date (yyyy-mm-dd).","type":["string","null"]},"sub_end_date":{"description":"Subscription window end date (yyyy-mm-dd).","type":["string","null"]},"listing_date":{"description":"Listing date (yyyy-mm-dd).","type":["string","null"]},"issue_price":{"description":"Issue price (stringified decimal).","type":["string","null"]},"min_lot_size":{"description":"Minimum lot size for subscription.","type":["string","null"]},"status":{"description":"IPO status (calendar feed), e.g. upcoming / listed.","type":["string","null"]}}}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"margin_ratio","title":"Margin Ratio","description":"Get margin ratio for a symbol. Returns {im_factor (initial margin), mm_factor (maintenance margin), fm_factor (forced liquidation)} as decimal strings.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"SymbolParam","type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"700.HK\"","type":"string"}},"required":["symbol"]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"MarginRatioResponse","description":"Returned by `margin_ratio`.\n\nDecimals are stringified by `to_tool_json`.","type":"object","properties":{"im_factor":{"description":"Initial-margin ratio (`im_factor`).","type":"string"},"mm_factor":{"description":"Maintenance-margin ratio (`mm_factor`).","type":"string"},"fm_factor":{"description":"Forced close-out margin ratio (`fm_factor`).","type":"string"}},"required":["im_factor","mm_factor","fm_factor"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"market_status","title":"Market Status","description":"Get current market trading status for all markets. Returns market_time[]{market, trade_status (Trading/Closed/Mid-Day Break/Pre-Market/Post-Market/Overnight), timestamp}.","inputSchema":{"type":"object","properties":{}},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"MarketStatusResponse","description":"Returned by `market_status`. Wraps a `market_time` array, one entry per\nmarket. Subset of the wire response — `trade_status` is mapped from the\nupstream numeric code to a human label, and `timestamp` is converted to\nRFC3339.","type":"object","properties":{"market_time":{"description":"Per-market trading status entries.","type":["array","null"],"items":{"$ref":"#/$defs/MarketStatusEntry"}}},"$defs":{"MarketStatusEntry":{"type":"object","properties":{"market":{"description":"Market code, e.g. \"US\" / \"HK\" / \"CN\" / \"SG\".","type":["string","null"]},"trade_status":{"description":"Trading status label, e.g. Trading / Closed / Mid-Day Break /\nPre-Market / Post-Market / Overnight / Unknown.","type":["string","null"]},"timestamp":{"description":"Status snapshot timestamp (RFC3339).","type":["string","null"]},"delay_trade_status":{"description":"Delayed-quote trading status label (same value set as `trade_status`).","type":["string","null"]},"delay_timestamp":{"description":"Delayed-quote status timestamp (RFC3339).","type":["string","null"]}}}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"market_temperature","title":"Market Temperature","description":"Get current market sentiment temperature. Returns {temperature (0-100), description, valuation (0-100), sentiment (0-100), timestamp}. market: HK/US/CN/SG.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"MarketParam","type":"object","properties":{"market":{"description":"Market code: HK, US, CN, SG","type":"string"}},"required":["market"]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"MarketTemperatureResponse","description":"Returned by `market_temperature`.","type":"object","properties":{"temperature":{"description":"Temperature value (0-100).","type":"integer","format":"int32"},"description":{"description":"Human-readable temperature description (locale-aware).","type":"string"},"valuation":{"description":"Market valuation indicator (0-100).","type":"integer","format":"int32"},"sentiment":{"description":"Market sentiment indicator (0-100).","type":"integer","format":"int32"},"timestamp":{"description":"Snapshot timestamp (RFC3339).","type":"string"}},"required":["temperature","description","valuation","sentiment","timestamp"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"news","title":"News","description":"Get latest news articles for a symbol. Returns items[]{id, title, source, publish_time, summary, url, related_symbols[]}.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"SymbolParam","type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"700.HK\"","type":"string"}},"required":["symbol"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"news_search","title":"News Search","description":"Search news articles by keyword. Returns news_list[]{id, title, description, source_name, publish_at (RFC3339), score}. Paginate with score+publish_at_timestamp+id cursors.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"NewsSearchParam","type":"object","properties":{"keyword":{"description":"Search keyword","type":"string"},"limit":{"description":"Max results to return (default: 20)","type":"integer","format":"uint32","minimum":0}},"required":["keyword"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"now","title":"Current Time","description":"Get current UTC time as an RFC3339 string (e.g. \"2025-01-15T08:30:00Z\"). Use to determine current date/time before making date-based queries.","inputSchema":{"type":"object","properties":{}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"operating","title":"Operating Performance","description":"Get company operating metrics (HK stocks only). Returns items[]{period, metric_name, value, unit} such as passenger traffic, cargo volumes, or store counts.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"SymbolParam","type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"700.HK\"","type":"string"}},"required":["symbol"]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"OperatingResponse","description":"Returned by `operating`. Wraps an `items` array of operating metrics\n(HK stocks only).\n\nSubset of documented fields; upstream may return more.","type":"object","properties":{"items":{"description":"Operating metric records.","type":["array","null"],"items":{"$ref":"#/$defs/OperatingItem"}}},"$defs":{"OperatingItem":{"description":"One record in `operating`'s `items`.\n\nSubset of documented fields; upstream may return more.","type":"object","properties":{"period":{"description":"Reporting period.","type":["string","null"]},"metric_name":{"description":"Metric name (e.g. passenger traffic, cargo volume).","type":["string","null"]},"value":{"description":"Metric value.","type":["string","null"]},"unit":{"description":"Unit of measure.","type":["string","null"]}}}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"option_chain_expiry_date_list","title":"Option Expiry Dates","description":"Get option chain expiry dates for a symbol (e.g. AAPL.US). Returns expiry_dates[] as \"yyyy-mm-dd\" strings. Use with option_chain_info_by_date to get strikes and Greeks.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"SymbolParam","type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"700.HK\"","type":"string"}},"required":["symbol"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"option_chain_info_by_date","title":"Option Chain by Date","description":"Get option chain for an expiry date. Returns strikePrices[]{strike_price, call{symbol, last_done, iv, delta, gamma}, put{symbol, last_done, iv, delta, gamma}}.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"SymbolDateParam","type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"700.HK\"","type":"string"},"date":{"description":"Date (yyyy-mm-dd)","type":"string"}},"required":["symbol","date"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"option_quote","title":"Option Quote","description":"Get option quotes (max 500 symbols). Returns last_done, prev_close, open, high, low, volume, turnover, implied_volatility, delta, gamma, theta, vega, rho, open_interest per symbol.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"SymbolsParam","type":"object","properties":{"symbols":{"description":"Security symbols, e.g. [\"700.HK\", \"AAPL.US\"]","type":"array","items":{"type":"string"}}},"required":["symbols"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"option_volume","title":"Option Volume","description":"Get real-time option call/put volume stats for a US stock. Returns {call_volume, put_volume, put_call_ratio, call_oi, put_oi} and top active contracts.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"OptionVolumeParam","type":"object","properties":{"symbol":{"description":"Underlying symbol (US market only), e.g. \"AAPL.US\"","type":"string"}},"required":["symbol"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"option_volume_daily","title":"Option Volume (Daily)","description":"Get daily historical option stats for a US stock. Returns items[]{date, call_volume, put_volume, put_call_vol_ratio, call_oi, put_oi, put_call_oi_ratio}.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"OptionVolumeDailyParam","type":"object","properties":{"symbol":{"description":"Underlying symbol (US market only), e.g. \"AAPL.US\"","type":"string"},"count":{"description":"Number of trading days to return (default 20)","type":"integer","format":"uint","minimum":0,"default":null}},"required":["symbol"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"order_detail","title":"Order Detail","description":"Get detailed information about a specific order. Returns {order_id, symbol, status, side, order_type, quantity, price, executed_quantity, executed_price, submitted_at, time_in_force, msg}.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"OrderIdParam","type":"object","properties":{"order_id":{"description":"Order ID (returned by submit_order or listed in today_orders / history_orders)","type":"string"}},"required":["order_id"]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"OrderDetailResponse","description":"Returned by `order_detail`. Single order with full lifecycle metadata.","type":"object","properties":{"order_id":{"description":"Order ID.","type":"string"},"status":{"description":"Status enum (e.g. `Filled`, `WaitToNew`, `Canceled`).","type":"string"},"symbol":{"description":"Security symbol, e.g. \"700.HK\".","type":"string"},"stock_name":{"description":"Display name of the security.","type":"string"},"quantity":{"description":"Submitted quantity.","type":"string"},"executed_quantity":{"description":"Quantity already executed.","type":"string"},"price":{"description":"Submitted limit price (null for market orders).","type":["string","null"]},"executed_price":{"description":"Volume-weighted average executed price (null when unfilled).","type":["string","null"]},"submitted_at":{"description":"Order submission time (RFC3339).","type":"string"},"side":{"description":"Buy or Sell.","type":"string"},"order_type":{"description":"Order type enum, e.g. `LO`, `MO`, `LIT`.","type":"string"},"last_done":{"description":"Latest price snapshot at order time (null if missing).","type":["string","null"]},"trigger_price":{"description":"Trigger price for LIT/MIT/trailing orders.","type":["string","null"]},"msg":{"description":"Reject message or remark.","type":"string"},"tag":{"description":"Order tag (e.g. `Normal`, `LongTerm`).","type":"string"},"time_in_force":{"description":"Time-in-force: `Day` / `GTC` / `GTD`.","type":"string"},"expire_date":{"description":"GTD expiry date (yyyy-mm-dd).","type":["string","null"]},"updated_at":{"description":"Last update time (RFC3339).","type":["string","null"]},"trigger_at":{"description":"Conditional-order trigger time (RFC3339).","type":["string","null"]},"trailing_amount":{"description":"Trailing-stop trail amount (TSLPAMT).","type":["string","null"]},"trailing_percent":{"description":"Trailing-stop trail percent (TSLPPCT, decimal).","type":["string","null"]},"limit_offset":{"description":"Trailing-stop limit offset (TSLPAMT/TSLPPCT).","type":["string","null"]},"trigger_status":{"description":"Trigger status, e.g. `Deactive` / `Active` / `Released`.","type":["string","null"]},"currency":{"description":"Settlement currency.","type":"string"},"outside_rth":{"description":"Outside-RTH setting: `RTH_ONLY` / `ANY_TIME` / `OVERNIGHT`.","type":["string","null"]}},"required":["order_id","status","symbol","stock_name","quantity","executed_quantity","submitted_at","side","order_type","msg","tag","time_in_force","currency"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"participants","title":"Market Participants","description":"Get HK market participant broker information. Returns participants[]{broker_ids[], name_en, name_cn, name_hk}. Use broker_ids to interpret broker queue data.","inputSchema":{"type":"object","properties":{}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"profit_analysis","title":"Profit Analysis","description":"Get portfolio profit and loss analysis summary. start/end: optional date range in yyyy-mm-dd format. Both must be provided together — passing only one returns empty results.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"ProfitAnalysisParam","type":"object","properties":{"start":{"description":"Start date (yyyy-mm-dd). Must be paired with `end`; passing only one returns empty results.","type":"string"},"end":{"description":"End date (yyyy-mm-dd). Must be paired with `start`; passing only one returns empty results.","type":"string"}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"profit_analysis_detail","title":"Profit Analysis Detail","description":"Get detailed profit and loss analysis for a specific symbol. start/end: optional date range in yyyy-mm-dd format. Both must be provided together — passing only one returns empty results.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"ProfitAnalysisDetailParam","type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"700.HK\"","type":"string"},"start":{"description":"Start date (yyyy-mm-dd). Must be paired with `end`; passing only one returns empty results.","type":"string"},"end":{"description":"End date (yyyy-mm-dd). Must be paired with `start`; passing only one returns empty results.","type":"string"}},"required":["symbol"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"quant_run","title":"Quant — Run Indicator Script","description":"Run a quant indicator script against historical K-line data on the server. Executes the script server-side and returns the computed indicator/plot values as JSON. Periods: 1m, 5m, 15m, 30m, 1h, day, week, month, year (default: day). The optional input parameter accepts a JSON array matching the order of input.*() calls in the script, e.g. \"[14,2.0]\".","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"RunScriptParam","description":"Parameters for running an indicator script against historical K-line data:\ntarget symbol, date range, K-line period, the script source itself, and\noptional script inputs.","type":"object","properties":{"symbol":{"description":"Symbol in <CODE>.<MARKET> format, e.g. TSLA.US, 700.HK","type":"string"},"period":{"description":"K-line period: 1m, 5m, 15m, 30m, 1h, day, week, month, year (default: day)","type":"string","default":"day"},"start":{"description":"Start date (YYYY-MM-DD) for the K-line range","type":"string"},"end":{"description":"End date (YYYY-MM-DD) for the K-line range","type":"string"},"script":{"description":"Indicator script source.","type":"string"},"input":{"description":"Script input values as a JSON array, e.g. \"[14,2.0]\". Must match the order of input.*() calls in the script.","type":"string"}},"required":["symbol","start","end"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"quote","title":"Quote","description":"Get latest price quotes. Returns per symbol: last_done, prev_close, open, high, low, volume, turnover, change_rate, change_value, trade_status, timestamp.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"SymbolsParam","type":"object","properties":{"symbols":{"description":"Security symbols, e.g. [\"700.HK\", \"AAPL.US\"]","type":"array","items":{"type":"string"}}},"required":["symbols"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"rank_categories","title":"Rank Categories","description":"Get rank tab category configurations for the popularity leaderboard. Returns first_tags[]{key, name, second_tags[]{key, name, market}}. Pass a second_tags key (e.g. `hot_all-us`) to rank_list.","inputSchema":{"type":"object","properties":{}},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"RankCategoriesResponse","description":"Returned by `rank_categories`. Wraps a `first_tags` array of rank tab\ncategory configurations for the popularity leaderboard. Subset of the wire\nresponse.","type":"object","properties":{"first_tags":{"description":"Top-level rank category tags.","type":["array","null"],"items":{"$ref":"#/$defs/RankFirstTag"}}},"$defs":{"RankFirstTag":{"type":"object","properties":{"key":{"description":"Category key.","type":["string","null"]},"name":{"description":"Display name.","type":["string","null"]},"second_tags":{"description":"Sub-categories. Pass a `second_tags[].key` to `rank_list`.","type":["array","null"],"items":{"$ref":"#/$defs/RankSecondTag"}}}},"RankSecondTag":{"type":"object","properties":{"key":{"description":"Tab key to pass to `rank_list` (e.g. \"hot_all-us\").","type":["string","null"]},"name":{"description":"Display name.","type":["string","null"]},"market":{"description":"Market this tab covers, e.g. \"US\" / \"HK\".","type":["string","null"]}}}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"rank_list","title":"Rank List","description":"Get ranked stock list by leaderboard tab key. key: from rank_categories second_tags[].key (e.g. \"hot_all-us\", \"hot_up-hk\", \"trade_heat-us\"). market: inferred from key suffix (-us/-hk) or pass explicitly. size: results (default 20). Returns lists[]{symbol, name, last_done, chg(decimal), inflow, market_cap, pre_post_price, pre_post_chg, amplitude, turnover_rate, volume_rate, five_day_chg, ten_day_chg, twenty_day_chg, this_year_chg, industry, intro}, updated_at.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"RankListParam","type":"object","properties":{"key":{"description":"Tab key from rank_categories second_tags[].key, e.g. \"hot_all-us\" (US total heat),\n\"hot_up-hk\" (HK rising heat), \"trade_heat-us\" (US hot trades).\nThe \"ib_\" prefix is stripped from rank_categories keys and added back automatically.","type":"string"},"market":{"description":"Market override: \"US\" | \"HK\" | \"CN\" | \"SG\".\nDefaults to the market suffix in the key (e.g. \"ib_hot_all-hk\" → HK), then \"US\".","type":"string"},"size":{"description":"Number of results to return (default: 20)","type":"integer","format":"uint32","minimum":0},"need_article":{"description":"Whether to include related news articles (default: false)","type":"boolean"}},"required":["key"]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"RankListResponse","description":"Returned by `rank_list`. Wraps a `lists` array of ranked stocks for a\nleaderboard tab, plus a refresh time. Subset of the wire response.","type":"object","properties":{"lists":{"description":"Ranked stock entries.","type":["array","null"],"items":{"$ref":"#/$defs/RankListItem"}},"updated_at":{"description":"Last refresh time (RFC3339).","type":["string","null"]}},"$defs":{"RankListItem":{"type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"700.HK\".","type":["string","null"]},"name":{"description":"Display name of the security.","type":["string","null"]},"last_done":{"description":"Latest traded price.","type":["string","null"]},"chg":{"description":"Price change (decimal ratio).","type":["string","null"]},"inflow":{"description":"Net capital inflow.","type":["string","null"]},"market_cap":{"description":"Total market capitalization.","type":["string","null"]},"pre_post_price":{"description":"Pre-/post-market price.","type":["string","null"]},"pre_post_chg":{"description":"Pre-/post-market price change (decimal ratio).","type":["string","null"]},"amplitude":{"description":"Intraday amplitude.","type":["string","null"]},"turnover_rate":{"description":"Turnover rate.","type":["string","null"]},"volume_rate":{"description":"Volume ratio versus average.","type":["string","null"]},"five_day_chg":{"description":"5-day price change (decimal ratio).","type":["string","null"]},"ten_day_chg":{"description":"10-day price change (decimal ratio).","type":["string","null"]},"twenty_day_chg":{"description":"20-day price change (decimal ratio).","type":["string","null"]},"this_year_chg":{"description":"Year-to-date price change (decimal ratio).","type":["string","null"]},"industry":{"description":"Industry/sector name.","type":["string","null"]},"intro":{"description":"Short company introduction.","type":["string","null"]}}}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"replace_order","title":"Replace Order","description":"Modify an open order's quantity, price, trigger_price, or trailing params. Returns \"order replaced\" on success. Only open/pending orders can be modified.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"ReplaceOrderParam","type":"object","properties":{"order_id":{"description":"Order ID to replace (returned by submit_order or listed in today_orders / history_orders)","type":"string"},"quantity":{"description":"New order quantity (number of shares)","type":"string"},"price":{"description":"New limit price (for limit-style orders)","type":"string"},"trigger_price":{"description":"New trigger (activation) price (for LIT / MIT / trailing-stop orders)","type":"string"},"limit_offset":{"description":"New limit offset from the trailing stop price (for TSLPAMT / TSLPPCT)","type":"string"},"trailing_amount":{"description":"New trailing amount as absolute price distance (for TSLPAMT)","type":"string"},"trailing_percent":{"description":"New trailing percent as decimal e.g. 0.05 = 5% (for TSLPPCT)","type":"string"}},"required":["order_id","quantity"]},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":true}},{"name":"screener_indicators","title":"Screener Indicators","description":"Get all available screener indicator keys with units and default value ranges. Technical indicators include a tech_values field showing available options (e.g. macd_day: {category:[goldenfork,deadcross], period:[day,week]}). Optional symbol (e.g. AAPL.US) narrows to stock-specific indicators. Returns groups[]{group_name, indicators[]{id, key, name, unit, default_range{min,max}, tech_values?{key:[{value,label},...]}}}.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"ScreenerIndicatorsParam","type":"object","properties":{"symbol":{"description":"Optional security symbol to filter indicators for a specific stock, e.g. \"AAPL.US\"","type":"string"}}},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"ScreenerIndicatorsResponse","description":"Returned by `screener_indicators`. Documented portion is `groups[]`.","type":"object","properties":{"groups":{"description":"Indicator metadata grouped by category.","type":["array","null"],"items":{"$ref":"#/$defs/ScreenerIndicatorGroup"}}},"$defs":{"ScreenerIndicatorGroup":{"description":"A named group of screener indicators.","type":"object","properties":{"group_name":{"description":"Group display name.","type":["string","null"]},"indicators":{"description":"Indicators in this group.","type":["array","null"],"items":{"$ref":"#/$defs/ScreenerIndicator"}}}},"ScreenerIndicator":{"description":"A single screener indicator's metadata. The `filter_` prefix is stripped\nfrom `key` by the tool. `tech_values`, when present, is a synthesized schema\n(`{tech_key: [{value, label}, ...]}`) describing the options a technical\nindicator accepts.","type":"object","properties":{"id":{"description":"Indicator ID.","type":["string","null"]},"key":{"description":"Indicator key (without the `filter_` prefix).","type":["string","null"]},"name":{"description":"Indicator display name.","type":["string","null"]},"unit":{"description":"Value unit, where applicable.","type":["string","null"]},"default_range":{"description":"Default value range for the indicator.","anyOf":[{"$ref":"#/$defs/ScreenerIndicatorRange"},{"type":"null"}]},"tech_values":{"description":"For technical indicators: synthesized schema of accepted option values,\nkeyed by technical sub-key, each mapping to a list of `{value, label}`."}}},"ScreenerIndicatorRange":{"description":"Default value range for a screener indicator.","type":"object","properties":{"min":{"description":"Default lower bound (string).","type":["string","null"]},"max":{"description":"Default upper bound (string).","type":["string","null"]}}}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"screener_recommend_strategies","title":"Screener Recommend Strategies","description":"List platform-preset screener strategies. market: US|HK|CN|SG (default: US). Returns strategys[]{id, name, description, market, three_months_chg, risk}. Pass id to screener_search strategy_id to run, or screener_strategy to inspect filter conditions.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"ScreenerRecommendStrategiesParam","type":"object","properties":{"market":{"description":"Market filter: \"US\" | \"HK\" | \"CN\" | \"SG\" (default: \"US\")","type":"string"}}},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"ScreenerStrategiesResponse","description":"Returned by `screener_recommend_strategies` and `screener_user_strategies`.\nThe documented portion is `strategys[]`.","type":"object","properties":{"strategys":{"description":"Screener strategies (note the upstream `strategys` spelling).","type":["array","null"],"items":{"$ref":"#/$defs/ScreenerStrategyItem"}}},"$defs":{"ScreenerStrategyItem":{"description":"A single screener strategy entry. Subset of upstream fields; the change\nfigure is stringified by the transform pipeline.","type":"object","properties":{"id":{"description":"Strategy ID. Pass to `screener_search` `strategy_id` to run, or to\n`screener_strategy` to inspect the filter conditions.","type":["string","null"]},"name":{"description":"Strategy display name.","type":["string","null"]},"description":{"description":"Strategy description.","type":["string","null"]},"market":{"description":"Market the strategy targets, e.g. \"US\" / \"HK\" / \"CN\" / \"SG\".","type":["string","null"]},"three_months_chg":{"description":"Trailing three-month change (stringified decimal / percentage).","type":["string","null"]},"risk":{"description":"Risk classification label.","type":["string","null"]}}}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"screener_search","title":"Screener Search","description":"Screen stocks. market: US|HK|CN|SG (Mode B required; Mode A uses strategy's market). Mode A: strategy_id from screener_recommend_strategies — auto-runs saved strategy. Mode B: conditions=[{\"key\":\"KEY\",\"min\":\"10\",\"max\":\"50\",\"tech_values\":{}},...]. extra_returns=[\"key\",...] adds display-only columns. sort_by_key: key name to sort by; sort_order: asc|desc (default desc). page: 0-based (default 0). Returns {total, items[]{symbol, name, indicators[]{key, name, value, unit}}}. Fundamental keys: pettm pbmrq roe roa netmargin salesgrowthyoy netincomegrowthyoy marketcap(亿) circulating_marketcap(亿) prevclose prevchg(%) divyld la epsttm netincome(亿) sales(亿) turnover_rate balance(万). Technical keys (call screener_indicators for tech_values schema): macd_day/week rsi_day/week kdj_day/week boll_day/week.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"ScreenerSearchParam","type":"object","properties":{"market":{"description":"Market: \"US\" | \"HK\" | \"CN\" | \"SG\".\nMode A: overridden by the market embedded in the strategy; pass any value or omit.\nMode B: required — determines which market to screen.","type":"string"},"strategy_id":{"description":"Mode A — Strategy ID from screener_recommend_strategies screeners[].id.\nThe tool auto-fetches the strategy and builds filters. Omit for Mode B.","type":"string"},"conditions":{"description":"Mode B — Filter conditions as objects, passed directly to the API.\nEach item: {\"key\": \"KEY\", \"min\": \"10\", \"max\": \"50\", \"tech_values\": {}}\nThe \"filter_\" prefix is added automatically to the key if missing.\n\nFundamental keys (pass with or without filter_ prefix):\n  pettm  pbmrq  roe  roa  netmargin\n  salesgrowthyoy  netincomegrowthyoy  marketcap(亿)\n  circulating_marketcap(亿)  prevclose  prevchg(%)\n  divyld  la  epsttm  netincome(亿)  sales(亿)  turnover_rate  balance(万)\n\nTechnical indicator keys (tech_values required; call screener_indicators for schema):\n  macd_day/week  → {\"category\":\"goldenfork\"|\"deadcross\",\"period\":\"day\"|\"week\"}\n  rsi_day/week   → {\"value_type\":\"overbought\"|\"oversold\"}\n  kdj_day/week   → {\"category\":\"goldenfork\"|\"deadcross\"}\n  boll_day/week  → {\"category\":\"breakthrough_up\"|\"breakthrough_down\"}","type":"array","items":true},"extra_returns":{"description":"Extra indicator keys to include in each result row (display-only, not used as filters).\nSame key naming as conditions (filter_ prefix added automatically).\nExample: [\"marketcap\", \"prevclose\", \"epsttm\"]","type":"array","items":{"type":"string"}},"sort_by_key":{"description":"Indicator key to sort results by (e.g. \"marketcap\", \"roe\").\nDefaults to the first condition key. Must be one of the condition or extra_returns keys.","type":"string"},"sort_order":{"description":"Sort order: \"asc\" | \"desc\" (default: \"desc\")","type":"string"},"page":{"description":"Page number, 0-based (default: 0)","type":"integer","format":"uint32","minimum":0},"size":{"description":"Page size (default: 20, max: 100)","type":"integer","format":"uint32","minimum":0}}},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"ScreenerSearchResponse","description":"Returned by `screener_search`. Documented portion is `total` plus the\n`items[]` result rows.","type":"object","properties":{"total":{"description":"Total number of matching securities.","type":["integer","null"],"format":"int64"},"items":{"description":"Result rows for the current page.","type":["array","null"],"items":{"$ref":"#/$defs/ScreenerResultItem"}}},"$defs":{"ScreenerResultItem":{"description":"A single screener search result row. Subset of upstream fields.","type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"AAPL.US\".","type":["string","null"]},"name":{"description":"Display name of the security.","type":["string","null"]},"indicators":{"description":"Per-indicator values for this row (condition + extra-return columns).","type":["array","null"],"items":{"$ref":"#/$defs/ScreenerResultIndicator"}}}},"ScreenerResultIndicator":{"description":"A single indicator value attached to a screener search result row. The\n`filter_` prefix is stripped from `key` by the tool.","type":"object","properties":{"key":{"description":"Indicator key (without the `filter_` prefix).","type":["string","null"]},"name":{"description":"Indicator display name.","type":["string","null"]},"value":{"description":"Indicator value (stringified by the transform pipeline).","type":["string","null"]},"unit":{"description":"Value unit, where applicable.","type":["string","null"]}}}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"screener_strategy","title":"Screener Strategy","description":"Inspect a screener strategy's filter conditions before running it. Returns market, filter{filters[]{key, min, max, tech_values}}. Use screener_search strategy_id to execute the strategy.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"ScreenerStrategyParam","type":"object","properties":{"id":{"description":"Strategy ID from screener_recommend_strategies or screener_user_strategies screeners[].id","type":"string"}},"required":["id"]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"ScreenerStrategyResponse","description":"Returned by `screener_strategy`. Documented portion is `market` plus the\n`filter.filters[]` condition list.","type":"object","properties":{"market":{"description":"Market the strategy targets, e.g. \"US\" / \"HK\" / \"CN\" / \"SG\".","type":["string","null"]},"filter":{"description":"Filter group containing the strategy's conditions.","anyOf":[{"$ref":"#/$defs/ScreenerStrategyFilterGroup"},{"type":"null"}]}},"$defs":{"ScreenerStrategyFilterGroup":{"description":"The `filter` wrapper of a screener strategy, holding the condition list.","type":"object","properties":{"filters":{"description":"Filter conditions making up the strategy.","type":["array","null"],"items":{"$ref":"#/$defs/ScreenerStrategyFilter"}}}},"ScreenerStrategyFilter":{"description":"A single filter condition within a screener strategy. The `filter_` prefix\nis stripped from `key` by the tool so it matches `screener_indicators` and\n`screener_search` condition input.","type":"object","properties":{"key":{"description":"Indicator key (without the `filter_` prefix).","type":["string","null"]},"min":{"description":"Lower bound for the condition (string, may be empty).","type":["string","null"]},"max":{"description":"Upper bound for the condition (string, may be empty).","type":["string","null"]},"tech_values":{"description":"Technical-indicator value selection for technical keys. Passthrough\nobject whose shape depends on the indicator (see `screener_indicators`)."}}}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"screener_user_strategies","title":"Screener User Strategies","description":"List the current user's saved screener strategies. market: US|HK|CN|SG (default: US). Returns strategys[]{id, name, description, market, three_months_chg, risk}. Pass id to screener_search strategy_id to run, or screener_strategy to inspect conditions.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"ScreenerUserStrategiesParam","type":"object","properties":{"market":{"description":"Market filter: \"US\" | \"HK\" | \"CN\" | \"SG\" (default: \"US\")","type":"string"}}},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"ScreenerStrategiesResponse","description":"Returned by `screener_recommend_strategies` and `screener_user_strategies`.\nThe documented portion is `strategys[]`.","type":"object","properties":{"strategys":{"description":"Screener strategies (note the upstream `strategys` spelling).","type":["array","null"],"items":{"$ref":"#/$defs/ScreenerStrategyItem"}}},"$defs":{"ScreenerStrategyItem":{"description":"A single screener strategy entry. Subset of upstream fields; the change\nfigure is stringified by the transform pipeline.","type":"object","properties":{"id":{"description":"Strategy ID. Pass to `screener_search` `strategy_id` to run, or to\n`screener_strategy` to inspect the filter conditions.","type":["string","null"]},"name":{"description":"Strategy display name.","type":["string","null"]},"description":{"description":"Strategy description.","type":["string","null"]},"market":{"description":"Market the strategy targets, e.g. \"US\" / \"HK\" / \"CN\" / \"SG\".","type":["string","null"]},"three_months_chg":{"description":"Trailing three-month change (stringified decimal / percentage).","type":["string","null"]},"risk":{"description":"Risk classification label.","type":["string","null"]}}}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"security_list","title":"Security List","description":"Get security list for a market. Supports market: US, HK, CN, SG. category: \"Overnight\" (default). page: 1-based page number (default 1). count: records per page (default 50). Returns {total, page, count, items[]{symbol, name_en, name_cn}}.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"SecurityListParam","type":"object","properties":{"market":{"description":"Market code: US, HK, CN, SG","type":"string"},"category":{"description":"Category filter. Currently only \"Overnight\" is supported; omitting defaults to Overnight.","type":"string"},"page":{"description":"Page number, 1-based (default: 1)","type":"integer","format":"uint","minimum":0,"default":null},"count":{"description":"Records per page (default: 50)","type":"integer","format":"uint","minimum":0,"default":null}},"required":["market"]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"SecurityListResponse","description":"Returned by `security_list`. Top-level pagination envelope built in\n`quote::security_list` around the upstream `Vec<Security>`.","type":"object","properties":{"total":{"description":"Total number of securities available for this market/category (before\npagination).","type":"integer","format":"uint","minimum":0},"page":{"description":"1-based page number echoed back from the request.","type":"integer","format":"uint","minimum":0},"count":{"description":"Records-per-page echoed back from the request.","type":"integer","format":"uint","minimum":0},"items":{"description":"The securities on this page.","type":"array","items":{"$ref":"#/$defs/SecurityListItem"}}},"required":["total","page","count","items"],"$defs":{"SecurityListItem":{"type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"AAPL.US\".","type":"string"},"name_cn":{"description":"Security name (zh-CN).","type":"string"},"name_en":{"description":"Security name (en).","type":"string"},"name_hk":{"description":"Security name (zh-HK).","type":"string"}},"required":["symbol","name_cn","name_en","name_hk"]}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"shareholder","title":"Shareholders","description":"Get institutional shareholders for a symbol. Returns shareholders[]{institution, shares, ratio, change, change_type, reported_at}.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"SymbolParam","type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"700.HK\"","type":"string"}},"required":["symbol"]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"ShareholderResponse","description":"Returned by `shareholder`. Wraps a `shareholders` array.\n\nSubset of documented fields; upstream may return more.","type":"object","properties":{"shareholders":{"description":"Institutional shareholders.","type":["array","null"],"items":{"$ref":"#/$defs/ShareholderItem"}}},"$defs":{"ShareholderItem":{"description":"One holder in `shareholder`'s `shareholders`.\n\nSubset of documented fields; upstream may return more.","type":"object","properties":{"institution":{"description":"Institution name.","type":["string","null"]},"shares":{"description":"Shares held.","type":["string","null"]},"ratio":{"description":"Ownership ratio.","type":["string","null"]},"change":{"description":"Change in shares.","type":["string","null"]},"change_type":{"description":"Direction / kind of change.","type":["string","null"]},"reported_at":{"description":"Report date.","type":["string","null"]}}}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"shareholder_detail","title":"Shareholder Detail","description":"Get a single shareholder's holding and trade history. Requires object_id from shareholder_top. Returns name, owner_source (Company/Institution/Person/Insider), tradings[]{period, accum_buy, accum_sell, net_buy, trading_details[]{trading_date, trading_type, trading_shares, trading_price, security_type, filing_date}}, holding_summary, holding_periods, trading_periods. Note: trading_details[] is empty for institutional (13F) holders — it is only populated for insider/individual filers (Form 4).","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"ShareholderDetailParam","type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"AAPL.US\"","type":"string"},"object_id":{"description":"Shareholder object_id from shareholder_top tool","type":"integer","format":"int64"}},"required":["symbol","object_id"]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"ShareholderDetailResponse","description":"Returned by `shareholder_detail`. A single holder's holding and trade\nhistory.\n\nSubset of documented fields; upstream may return more.","type":"object","properties":{"name":{"description":"Holder name.","type":["string","null"]},"owner_source":{"description":"Holder source: Company / Institution / Person / Insider.","type":["string","null"]},"tradings":{"description":"Per-period trading records.","type":["array","null"],"items":{"$ref":"#/$defs/ShareholderTrading"}},"holding_summary":{"description":"Holding summary. Shape unspecified by the description; raw JSON."},"holding_periods":{"description":"Holding periods. Shape unspecified by the description; raw JSON."},"trading_periods":{"description":"Trading periods. Shape unspecified by the description; raw JSON."}},"$defs":{"ShareholderTrading":{"description":"One per-period trading record in `shareholder_detail`'s `tradings`.\n\nSubset of documented fields; upstream may return more.","type":"object","properties":{"period":{"description":"Reporting period.","type":["string","null"]},"accum_buy":{"description":"Accumulated buys.","type":["string","null"]},"accum_sell":{"description":"Accumulated sells.","type":["string","null"]},"net_buy":{"description":"Net buys.","type":["string","null"]},"trading_details":{"description":"Individual trades. Empty for institutional (13F) holders; populated\nonly for insider / individual filers (Form 4).","type":["array","null"],"items":{"$ref":"#/$defs/ShareholderTradingDetail"}}}},"ShareholderTradingDetail":{"description":"One trade in `shareholder_detail`'s `trading_details`.\n\nSubset of documented fields; upstream may return more.","type":"object","properties":{"trading_date":{"description":"Trade date.","type":["string","null"]},"trading_type":{"description":"Trade type (buy / sell).","type":["string","null"]},"trading_shares":{"description":"Number of shares traded.","type":["string","null"]},"trading_price":{"description":"Trade price.","type":["string","null"]},"security_type":{"description":"Security type.","type":["string","null"]},"filing_date":{"description":"Filing date.","type":["string","null"]}}}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"shareholder_top","title":"Top 20 Shareholders","description":"Get Top 20 major shareholders (institutions, individuals, insiders) across reporting periods. Returns info[]{period, share_holders[]{object_id, name, title, shares_held, percent_shares_held, shares_changed, filing_date}}. Use object_id with shareholder_detail to drill into a holder's full trade history.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"ShareholderTopParam","type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"AAPL.US\"","type":"string"}},"required":["symbol"]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"ShareholderTopResponse","description":"Returned by `shareholder_top`. Wraps an `info` array of per-period\nsnapshots, each with a `share_holders` list.\n\nSubset of documented fields; upstream may return more.","type":"object","properties":{"info":{"description":"Per-period holder snapshots.","type":["array","null"],"items":{"$ref":"#/$defs/ShareholderTopPeriod"}}},"$defs":{"ShareholderTopPeriod":{"description":"One period snapshot in `shareholder_top`'s `info`.\n\nSubset of documented fields; upstream may return more.","type":"object","properties":{"period":{"description":"Reporting period.","type":["string","null"]},"share_holders":{"description":"Holders for this period.","type":["array","null"],"items":{"$ref":"#/$defs/ShareholderTopHolder"}}}},"ShareholderTopHolder":{"description":"One holder in `shareholder_top`'s `share_holders`.\n\nSubset of documented fields; upstream may return more.","type":"object","properties":{"object_id":{"description":"Holder object id. Pass to `shareholder_detail`.","type":["integer","null"],"format":"int64"},"name":{"description":"Holder name.","type":["string","null"]},"title":{"description":"Holder title / role.","type":["string","null"]},"shares_held":{"description":"Shares held.","type":["string","null"]},"percent_shares_held":{"description":"Percentage of shares held.","type":["string","null"]},"shares_changed":{"description":"Change in shares held.","type":["string","null"]},"filing_date":{"description":"Filing date.","type":["string","null"]}}}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"sharelist_add","title":"Add to Sharelist","description":"Add securities to a community sharelist by id. Provide symbols (e.g. [\"AAPL.US\", \"700.HK\"]) to add. Returns upstream API response.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"SharelistItemsParam","type":"object","properties":{"id":{"description":"Sharelist ID","type":"string"},"symbols":{"description":"Security symbols, e.g. [\"AAPL.US\", \"700.HK\"]","type":"array","items":{"type":"string"}}},"required":["id","symbols"]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}},{"name":"sharelist_create","title":"Create Sharelist","description":"Create a new community sharelist with a name and optional description. Returns the created sharelist object including its id, name, and description.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"SharelistCreateParam","type":"object","properties":{"name":{"description":"List name (also used as description if `description` is omitted).","type":"string"},"description":{"description":"List description. Defaults to `name` when omitted.","type":"string"}},"required":["name"]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"SharelistCreateResponse","description":"Returned by `sharelist_create`. The created sharelist object; documented\nfields are `id`, `name`, and `description`.","type":"object","properties":{"id":{"description":"Newly-created sharelist ID.","type":["string","null"]},"name":{"description":"List name.","type":["string","null"]},"description":{"description":"List description.","type":["string","null"]}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}},{"name":"sharelist_delete","title":"Delete Sharelist","description":"Delete a community sharelist by id (own lists only; subscribed lists cannot be deleted). Returns upstream API response on success.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"SharelistIdParam","type":"object","properties":{"id":{"description":"Sharelist ID","type":"string"}},"required":["id"]},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":true}},{"name":"sharelist_detail","title":"Sharelist Detail","description":"Get community sharelist detail by id. Returns {id, name, description, constituents[]{symbol, name, last_done, change_rate}, quote data, subscription status}.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"SharelistIdParam","type":"object","properties":{"id":{"description":"Sharelist ID","type":"string"}},"required":["id"]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"SharelistDetailResponse","description":"Returned by `sharelist_detail`. Subset of the upstream detail payload: list\nmetadata plus the constituent rows. Additional quote and subscription\nfields may be present but are not enumerated here.","type":"object","properties":{"id":{"description":"Sharelist ID.","type":["string","null"]},"name":{"description":"List name.","type":["string","null"]},"description":{"description":"List description.","type":["string","null"]},"constituents":{"description":"Constituent securities with quote snapshots.","type":["array","null"],"items":{"$ref":"#/$defs/SharelistConstituent"}}},"$defs":{"SharelistConstituent":{"description":"A single constituent of a sharelist detail. Subset of upstream fields;\nquote fields are stringified by the transform pipeline.","type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"AAPL.US\".","type":["string","null"]},"name":{"description":"Display name of the security.","type":["string","null"]},"last_done":{"description":"Latest traded price (stringified decimal).","type":["string","null"]},"change_rate":{"description":"Change rate (stringified decimal / percentage).","type":["string","null"]}}}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"sharelist_list","title":"List Sharelists","description":"List user's own and subscribed community sharelists. Returns lists[]{id, name, description, symbol_count, is_owner, follower_count}.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"SharelistCountParam","type":"object","properties":{"count":{"description":"Number of lists to return (default 20)","type":"integer","format":"uint32","minimum":0,"default":null}}},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"SharelistListResponse","description":"Returned by `sharelist_list` and `sharelist_popular`. Documented portion is\n`lists[]`.","type":"object","properties":{"lists":{"description":"Sharelist summaries.","type":["array","null"],"items":{"$ref":"#/$defs/SharelistSummary"}}},"$defs":{"SharelistSummary":{"description":"A single sharelist summary entry. Subset of upstream fields.","type":"object","properties":{"id":{"description":"Sharelist ID.","type":["string","null"]},"name":{"description":"List name.","type":["string","null"]},"description":{"description":"List description.","type":["string","null"]},"symbol_count":{"description":"Number of securities in the list.","type":["integer","null"],"format":"int64"},"is_owner":{"description":"Whether the current user owns this list (`sharelist_list` only).","type":["boolean","null"]},"follower_count":{"description":"Number of followers / subscribers of this list.","type":["integer","null"],"format":"int64"},"creator":{"description":"Creator info (`sharelist_popular` only); passthrough, shape\nupstream-defined."}}}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"sharelist_popular","title":"Popular Sharelists","description":"Get popular/trending community sharelists. Returns lists[]{id, name, description, symbol_count, follower_count, creator} sorted by popularity.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"SharelistCountParam","type":"object","properties":{"count":{"description":"Number of lists to return (default 20)","type":"integer","format":"uint32","minimum":0,"default":null}}},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"SharelistListResponse","description":"Returned by `sharelist_list` and `sharelist_popular`. Documented portion is\n`lists[]`.","type":"object","properties":{"lists":{"description":"Sharelist summaries.","type":["array","null"],"items":{"$ref":"#/$defs/SharelistSummary"}}},"$defs":{"SharelistSummary":{"description":"A single sharelist summary entry. Subset of upstream fields.","type":"object","properties":{"id":{"description":"Sharelist ID.","type":["string","null"]},"name":{"description":"List name.","type":["string","null"]},"description":{"description":"List description.","type":["string","null"]},"symbol_count":{"description":"Number of securities in the list.","type":["integer","null"],"format":"int64"},"is_owner":{"description":"Whether the current user owns this list (`sharelist_list` only).","type":["boolean","null"]},"follower_count":{"description":"Number of followers / subscribers of this list.","type":["integer","null"],"format":"int64"},"creator":{"description":"Creator info (`sharelist_popular` only); passthrough, shape\nupstream-defined."}}}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"sharelist_remove","title":"Remove from Sharelist","description":"Remove securities from a community sharelist by id. Provide symbols to remove. Returns upstream API response on success.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"SharelistItemsParam","type":"object","properties":{"id":{"description":"Sharelist ID","type":"string"},"symbols":{"description":"Security symbols, e.g. [\"AAPL.US\", \"700.HK\"]","type":"array","items":{"type":"string"}}},"required":["id","symbols"]},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":true}},{"name":"sharelist_sort","title":"Sort Sharelist","description":"Reorder securities in a community sharelist by id. Provide symbols in the desired new order. Returns upstream API response on success.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"SharelistItemsParam","type":"object","properties":{"id":{"description":"Sharelist ID","type":"string"},"symbols":{"description":"Security symbols, e.g. [\"AAPL.US\", \"700.HK\"]","type":"array","items":{"type":"string"}}},"required":["id","symbols"]},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":true}},{"name":"short_margin","title":"Short Margin","description":"Get short margin deposit details for the current account. Returns short positions with margin_amount, margin_rate, interest_rate, symbol, quantity per position.","inputSchema":{"type":"object","properties":{}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"short_positions","title":"Short Positions","description":"Get short interest history (open short positions) for HK or US stocks. Market inferred from symbol suffix. count: 1–100 (default 20). Unified data[]{timestamp(RFC3339), short_shares(open short position in shares), rate(decimal ratio e.g. 0.009=0.9%), close}. US-only: avg_daily_vol, days_to_cover. HK-only: balance(outstanding short position in HKD). US source: FINRA bi-weekly. HK source: HKEX daily.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"ShortPositionsParam","type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"AAPL.US\" (US) or \"700.HK\" (HK). Market is inferred from suffix.","type":"string"},"count":{"description":"Number of records to return (1-100, default 20)","type":"integer","format":"uint","minimum":0,"default":null}},"required":["symbol"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"short_trades","title":"Short Trades","description":"Get daily short-sale volume history for HK or US stocks. Market inferred from symbol suffix. last_timestamp: unix seconds (omit for latest). page_size: 1–100 (default 20). Unified data[]{timestamp(RFC3339), short_vol(daily short volume in shares), rate(decimal ratio e.g. 0.36=36%), close}. US-only: nasdaq_vol(NASDAQ short), nyse_vol(NYSE short). HK-only: balance(HKD), market_vol(total market volume that day). US source: FINRA/NASDAQ daily. HK source: HKEX daily.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"ShortTradesParam","type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"AAPL.US\" (US) or \"700.HK\" (HK). Market is inferred from suffix.","type":"string"},"last_timestamp":{"description":"Query cutoff timestamp in seconds (pass current timestamp for latest data)","type":"string"},"page_size":{"description":"Page size: 1–100 (default: 20)","type":"string"}},"required":["symbol","last_timestamp"]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"ShortTradesResponse","description":"Returned by `short_trades`. Wraps a unified `data` array of daily short-sale\nvolume history for HK or US stocks. Market-specific fields are populated\nonly for their respective market (US: `nasdaq_vol`/`nyse_vol`; HK:\n`balance`/`market_vol`). Subset of the wire response.","type":"object","properties":{"data":{"description":"Daily short-sale volume entries.","type":["array","null"],"items":{"$ref":"#/$defs/ShortTradesItem"}}},"$defs":{"ShortTradesItem":{"type":"object","properties":{"timestamp":{"description":"Trade date (RFC3339).","type":["string","null"]},"short_vol":{"description":"Daily short-sale volume in shares.","type":["string","null"]},"rate":{"description":"Short volume as a ratio of total volume (decimal, e.g. 0.36 = 36%).","type":["string","null"]},"close":{"description":"Close price for the day.","type":["string","null"]},"nasdaq_vol":{"description":"US only — NASDAQ short volume.","type":["string","null"]},"nyse_vol":{"description":"US only — NYSE short volume.","type":["string","null"]},"balance":{"description":"HK only — outstanding short balance (HKD).","type":["string","null"]},"market_vol":{"description":"HK only — total market trading volume for the day.","type":["string","null"]}}}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"statement_export","title":"Export Statement","description":"Get a pre-signed download URL for a statement data file (obtained from statement_list). Returns {url}; fetch that URL to get the statement JSON.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"StatementExportParam","type":"object","properties":{"file_key":{"description":"File key from statement_list, e.g. \"/statement_data/data/.../20975338.json\"","type":"string"}},"required":["file_key"]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"StatementUrlResponse","description":"Returned by `statement_export`.","type":"object","properties":{"url":{"description":"Pre-signed HTTPS URL for downloading the statement JSON. Short-lived\n— fetch it promptly.","type":"string"}},"required":["url"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"statement_list","title":"Statement List","description":"List available account statements (daily/monthly). Returns list[]{id, type (daily/monthly), date, status}. Use the id with statement_export to download.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"StatementListParam","type":"object","properties":{"statement_type":{"description":"Statement type: \"daily\" (default) or \"monthly\".","type":"string"},"start_date":{"description":"Start date (yyyy-mm-dd). Defaults to 30 days ago for \"daily\" or 12 months ago for \"monthly\".","type":"string"},"limit":{"description":"Number of records to return. Defaults to 30 for \"daily\" or 12 for \"monthly\".","type":"integer","format":"int32","default":null}}},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"StatementListResponse","description":"Returned by `statement_list`.\n\nWraps a `list` array of statement entries. The SDK's `StatementItem`\n(`{ dt: i32, file_key: String }`) is emitted unchanged by the transform\npipeline: `dt` is a plain integer date (`yyyymmdd`, e.g. `20240115`) that is\nnot a `*_at` field and so is left as a number, and `file_key` does not match\nthe counter_id pattern.","type":"object","properties":{"list":{"description":"Available statements in the requested range.","type":"array","items":{"$ref":"#/$defs/StatementItem"}}},"required":["list"],"$defs":{"StatementItem":{"type":"object","properties":{"dt":{"description":"Statement date as a `yyyymmdd` integer (e.g. `20240115`).","type":"integer","format":"int32"},"file_key":{"description":"Opaque file key identifying this statement. Pass to `statement_export`\nto obtain a pre-signed download URL.","type":"string"}},"required":["dt","file_key"]}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"static_info","title":"Security Static Info","description":"Get static info for securities. Returns per symbol: symbol, name_cn, name_en, exchange (e.g. NASDAQ), type (e.g. US_Stock), lot_size, listed_date, delisted (bool).","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"SymbolsParam","type":"object","properties":{"symbols":{"description":"Security symbols, e.g. [\"700.HK\", \"AAPL.US\"]","type":"array","items":{"type":"string"}}},"required":["symbols"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"stock_positions","title":"Stock Positions","description":"Get current stock positions across all channels. Returns list[].stock_info[]{symbol, symbol_name, quantity, available_quantity, currency, cost_price, market}.","inputSchema":{"type":"object","properties":{}},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"StockPositionsResponse","description":"Returned by `stock_positions`. Top-level wraps a `list` array\n(one entry per linked broker channel), each carrying its own positions.","type":"object","properties":{"list":{"description":"Position channels — one entry per broker channel.","type":"array","items":{"$ref":"#/$defs/StockPositionChannel"}}},"required":["list"],"$defs":{"StockPositionChannel":{"type":"object","properties":{"account_channel":{"description":"Broker channel identifier. Always emitted as `null` for privacy.","type":["string","null"]},"stock_info":{"description":"Stock positions held in this channel.","type":"array","items":{"$ref":"#/$defs/StockPosition"}}},"required":["stock_info"]},"StockPosition":{"type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"700.HK\".","type":"string"},"symbol_name":{"description":"Display name of the security.","type":"string"},"quantity":{"description":"Total holding quantity.","type":"string"},"available_quantity":{"description":"Quantity available to sell (excludes locked / pending).","type":"string"},"currency":{"description":"Settlement currency, e.g. \"USD\" / \"HKD\".","type":"string"},"cost_price":{"description":"Cost price (per the client's choice of average or diluted cost).","type":"string"},"market":{"description":"Market code, e.g. \"US\" / \"HK\".","type":"string"},"init_quantity":{"description":"Holding quantity at market open (pre-market baseline).","type":["string","null"]}},"required":["symbol","symbol_name","quantity","available_quantity","currency","cost_price","market"]}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"submit_order","title":"Submit Order","description":"Submit a buy/sell order. order_type: LO (Limit) / ELO (Enhanced Limit, HK) / MO (Market) / AO (At-auction, HK) / ALO (At-auction Limit, HK) / ODD (Odd Lots, HK) / LIT (Limit If Touched) / MIT (Market If Touched) / TSLPAMT (Trailing Limit by Amount) / TSLPPCT (Trailing Limit by Percent) / SLO (Special Limit, HK). side: Buy/Sell. time_in_force: Day/GTC/GTD","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"SubmitOrderParam","type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"700.HK\"","type":"string"},"order_type":{"description":"Order type (HK supports all; US supports LO/MO/LIT/MIT/TSLPAMT/TSLPPCT only):\n- LO (Limit Order): requires submitted_price\n- ELO (Enhanced Limit Order, HK only): requires submitted_price\n- MO (Market Order): no price required\n- AO (At-auction Order, HK only): executed at auction price, no price required\n- ALO (At-auction Limit Order, HK only): requires submitted_price\n- ODD (Odd Lots Order, HK only): requires submitted_price, for non-standard lot sizes\n- LIT (Limit If Touched): requires submitted_price and trigger_price; activates when market price touches trigger_price\n- MIT (Market If Touched): requires trigger_price only; executes at market when trigger_price is touched\n- TSLPAMT (Trailing Limit If Touched by Amount): requires trailing_amount and limit_offset; trailing stop by fixed amount\n- TSLPPCT (Trailing Limit If Touched by Percent): requires trailing_percent (0-1) and limit_offset; trailing stop by percentage\n- SLO (Special Limit Order, HK only): requires submitted_price; cannot be replaced after submission","type":"string"},"side":{"description":"Buy or Sell","type":"string"},"submitted_quantity":{"description":"Order quantity (number of shares)","type":"string"},"time_in_force":{"description":"Order validity: \"Day\" (Day Order, expires end of session), \"GTC\" (Good Til Canceled), \"GTD\" (Good Til Date, requires expire_date)","type":"string"},"submitted_price":{"description":"Limit price. Required for: LO, ELO, ALO, ODD, LIT, SLO","type":"string"},"trigger_price":{"description":"Trigger (activation) price. Required for: LIT, MIT, TSLPAMT, TSLPPCT","type":"string"},"limit_offset":{"description":"Limit offset from the trailing stop price. Required for: TSLPAMT, TSLPPCT","type":"string"},"trailing_amount":{"description":"Trailing amount (absolute price distance). Required for TSLPAMT","type":"string"},"trailing_percent":{"description":"Trailing percent as decimal (e.g. 0.05 = 5%). Required for TSLPPCT","type":"string"},"expire_date":{"description":"Expiry date (yyyy-mm-dd). Required when time_in_force is GTD","type":"string"},"outside_rth":{"description":"Outside regular trading hours: \"RTH_ONLY\" (regular trading hours only), \"ANY_TIME\" (any time including pre/post market), \"OVERNIGHT\" (overnight session, US only)","type":"string"},"remark":{"description":"Order remark (max 255 characters)","type":"string"}},"required":["symbol","order_type","side","submitted_quantity","time_in_force"]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"OrderIdResponse","description":"Returned by `submit_order`.","type":"object","properties":{"order_id":{"description":"The newly-created order ID. Pass this to `cancel_order` /\n`replace_order` / `order_detail`.","type":"string"}},"required":["order_id"]},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":true}},{"name":"today_executions","title":"Today's Executions","description":"Get today's trade executions (fills). Returns executions[]{order_id, symbol, side, quantity, price, trade_done_at}. Pass symbol or order_id to filter.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"TodayExecutionsParam","type":"object","properties":{"symbol":{"description":"Filter by symbol, e.g. \"700.HK\".","type":"string"},"order_id":{"description":"Filter by a specific order_id.","type":"string"}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"today_orders","title":"Today's Orders","description":"Get orders placed today. Returns orders[]{order_id, symbol, side, order_type, status, quantity, price, submitted_at, executed_quantity, executed_price}. Pass symbol to filter.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"TodayOrdersParam","type":"object","properties":{"symbol":{"description":"Filter by symbol, e.g. \"700.HK\". Omit to return all today's orders.","type":"string"}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"top_movers","title":"Top Movers","description":"Get stocks whose price fluctuation exceeds the 20-trading-day standard deviation, with correlated news reasons. markets: comma-separated HK/US/CN/SG (omit=all). sort: 0=time 1=change-magnitude 2=popularity/heat (default). limit: results per page (default 20). next_params: pass next_params from previous response to paginate. Returns events[]{timestamp(RFC3339), alert_reason, alert_type, stock{symbol, name, change(decimal ratio e.g. 0.0445=+4.45%), last_done, labels[], intro}}, updated_at, next_params.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"StockEventsParam","type":"object","properties":{"markets":{"description":"Market filter: comma-separated list of markets to include.\nSupported values: \"HK\", \"US\", \"CN\", \"SG\". Omit to return all markets.\nExample: \"HK,US\"","type":"string"},"sort":{"description":"Sort order (default: \"2\"):\n  \"0\" = by time (most recent first)\n  \"1\" = by price change magnitude (largest move first)\n  \"2\" = by popularity (most-viewed first)","type":"string"},"date":{"description":"Date to query in \"YYYY-MM-DD\" format. Omit for today's movers.","type":"string"},"limit":{"description":"Number of events to return per page (default: 20, max: 100)","type":"integer","format":"uint32","minimum":0},"next_params":{"description":"Pagination cursor from previous response next_params field.\nPass the entire next_params object returned by the previous call to get the next page.\nOmit for the first page.","type":"object","properties":{},"additionalProperties":true,"default":null}}},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"TopMoversResponse","description":"Returned by `top_movers`. Wraps an `events` array of stocks whose price\nfluctuation exceeded the 20-trading-day standard deviation, with correlated\nnews reasons, plus pagination metadata. Subset of the wire response.","type":"object","properties":{"events":{"description":"Mover events.","type":["array","null"],"items":{"$ref":"#/$defs/TopMoverEvent"}},"updated_at":{"description":"Last refresh time (RFC3339).","type":["string","null"]},"next_params":{"description":"Pagination cursor. Pass back verbatim as `next_params` to fetch the\nnext page. Opaque object — exact fields are an implementation detail."}},"$defs":{"TopMoverEvent":{"type":"object","properties":{"timestamp":{"description":"Event time (RFC3339).","type":["string","null"]},"alert_reason":{"description":"Human-readable reason for the alert.","type":["string","null"]},"alert_type":{"description":"Alert type/category.","type":["string","null"]},"stock":{"description":"The stock that moved.","anyOf":[{"$ref":"#/$defs/TopMoverStock"},{"type":"null"}]}}},"TopMoverStock":{"type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"700.HK\".","type":["string","null"]},"name":{"description":"Display name of the security.","type":["string","null"]},"change":{"description":"Price change (decimal ratio, e.g. 0.0445 = +4.45%).","type":["string","null"]},"last_done":{"description":"Latest traded price.","type":["string","null"]},"labels":{"description":"Tag labels associated with the stock.","type":["array","null"],"items":{"type":"string"}},"intro":{"description":"Short company introduction.","type":["string","null"]}}}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"topic","title":"Topic List","description":"Get discussion topics for a symbol. Returns items[]{id, title, author, created_at, like_count, comment_count, content_summary}.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"SymbolParam","type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"700.HK\"","type":"string"}},"required":["symbol"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"topic_create","title":"Create Topic","description":"Create a new discussion topic. topic_type=\"post\" (default) is plain text; \"article\" requires a non-empty title and accepts Markdown body.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"TopicCreateParam","type":"object","properties":{"title":{"description":"Topic title. Required when topic_type is \"article\", optional for \"post\".","type":"string"},"body":{"description":"Topic body. \"post\" type is plain text only; \"article\" type accepts Markdown.","type":"string"},"symbols":{"description":"Related security symbols, e.g. [\"700.HK\", \"TSLA.US\"] (max 10).","type":"array","items":{"type":"string"},"default":null},"topic_type":{"description":"Topic type: \"post\" (default, plain text) or \"article\" (Markdown, title required).","type":"string"}},"required":["title","body"]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"TopicCreateResponse","description":"Returned by `topic_create`. The handler wraps the new topic ID in a single\n`{ \"id\": ... }` object.","type":"object","properties":{"id":{"description":"ID of the newly-created topic. Pass to `topic_detail` / `topic_replies`.","type":"string"}},"required":["id"]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}},{"name":"topic_create_reply","title":"Create Topic Reply","description":"Create a reply to a discussion topic. Pass reply_to_id to nest under another reply; omit for a top-level reply.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"TopicCreateReplyParam","type":"object","properties":{"topic_id":{"description":"Topic ID to reply to.","type":"string"},"body":{"description":"Reply body (plain text only).","type":"string"},"reply_to_id":{"description":"Optional parent reply ID for nested replies. Get IDs from `topic_replies`. Omit for a top-level reply.","type":"string"}},"required":["topic_id","body"]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"TopicCreateReplyResponse","description":"Returned by `topic_create_reply`. The created reply.\n\nSDK-typed (`longbridge::content::TopicReply`) and serialized via `tool_json`.\n`created_at` is emitted as an RFC3339 string.","type":"object","properties":{"id":{"description":"Reply ID.","type":"string"},"topic_id":{"description":"Topic ID this reply belongs to.","type":"string"},"body":{"description":"Reply body (plain text).","type":"string"},"reply_to_id":{"description":"Parent reply ID (`\"0\"` means top-level).","type":"string"},"author":{"description":"Reply author.","$ref":"#/$defs/TopicAuthor"},"images":{"description":"Attached images.","type":"array","items":{"$ref":"#/$defs/TopicImage"}},"likes_count":{"description":"Likes count.","type":"integer","format":"int32"},"comments_count":{"description":"Nested replies count.","type":"integer","format":"int32"},"created_at":{"description":"Created time (RFC3339).","type":"string"}},"required":["id","topic_id","body","reply_to_id","author","images","likes_count","comments_count","created_at"],"$defs":{"TopicAuthor":{"description":"Author of a topic or reply.","type":"object","properties":{"member_id":{"description":"Member ID.","type":"string"},"name":{"description":"Display name.","type":"string"},"avatar":{"description":"Avatar URL.","type":"string"}},"required":["member_id","name","avatar"]},"TopicImage":{"description":"An image attached to a topic or reply.","type":"object","properties":{"url":{"description":"Original image URL.","type":"string"},"sm":{"description":"Small thumbnail URL.","type":"string"},"lg":{"description":"Large image URL.","type":"string"}},"required":["url","sm","lg"]}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}},{"name":"topic_detail","title":"Topic Detail","description":"Get discussion topic detail by topic_id. Returns {id, title, content, author, created_at, like_count, comment_count, symbols[]}.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"TopicIdParam","type":"object","properties":{"topic_id":{"description":"Topic ID","type":"string"}},"required":["topic_id"]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"TopicDetailResponse","description":"Returned by `topic_detail`. Full details of a single community topic.\n\nSDK-typed (`longbridge::content::OwnedTopic`) and serialized via `tool_json`.\n`created_at` / `updated_at` are emitted as RFC3339 strings.","type":"object","properties":{"id":{"description":"Topic ID.","type":"string"},"title":{"description":"Title.","type":"string"},"description":{"description":"Plain-text excerpt / description.","type":"string"},"body":{"description":"Markdown body.","type":"string"},"author":{"description":"Topic author.","$ref":"#/$defs/TopicAuthor"},"tickers":{"description":"Related stock tickers, format `<CODE>.<MARKET>` (e.g. \"TSLA.US\").","type":"array","items":{"type":"string"}},"hashtags":{"description":"Hashtag names.","type":"array","items":{"type":"string"}},"images":{"description":"Attached images.","type":"array","items":{"$ref":"#/$defs/TopicImage"}},"likes_count":{"description":"Likes count.","type":"integer","format":"int32"},"comments_count":{"description":"Comments count.","type":"integer","format":"int32"},"views_count":{"description":"Views count.","type":"integer","format":"int32"},"shares_count":{"description":"Shares count.","type":"integer","format":"int32"},"topic_type":{"description":"Content type: \"article\" or \"post\".","type":"string"},"detail_url":{"description":"URL to the full topic page.","type":"string"},"created_at":{"description":"Created time (RFC3339).","type":"string"},"updated_at":{"description":"Last updated time (RFC3339).","type":"string"}},"required":["id","title","description","body","author","tickers","hashtags","images","likes_count","comments_count","views_count","shares_count","topic_type","detail_url","created_at","updated_at"],"$defs":{"TopicAuthor":{"description":"Author of a topic or reply.","type":"object","properties":{"member_id":{"description":"Member ID.","type":"string"},"name":{"description":"Display name.","type":"string"},"avatar":{"description":"Avatar URL.","type":"string"}},"required":["member_id","name","avatar"]},"TopicImage":{"description":"An image attached to a topic or reply.","type":"object","properties":{"url":{"description":"Original image URL.","type":"string"},"sm":{"description":"Small thumbnail URL.","type":"string"},"lg":{"description":"Large image URL.","type":"string"}},"required":["url","sm","lg"]}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"topic_replies","title":"Topic Replies","description":"Get replies to a discussion topic, paginated (page default 1, size default 20, range 1-50)","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"TopicRepliesParam","type":"object","properties":{"topic_id":{"description":"Topic ID.","type":"string"},"page":{"description":"Page number, 1-based (default: 1).","type":"integer","format":"int32","default":null},"size":{"description":"Records per page, 1-50 (default: 20).","type":"integer","format":"int32","default":null}},"required":["topic_id"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"topic_search","title":"Topic Search","description":"Search community topics/posts by keyword. Returns id, author, time, and excerpt.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"TopicSearchParam","type":"object","properties":{"keyword":{"description":"Search keyword","type":"string"},"limit":{"description":"Max results to return (default: 20)","type":"integer","format":"uint32","minimum":0}},"required":["keyword"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"trade_stats","title":"Trade Statistics","description":"Get trade statistics (buy/sell/neutral volume distribution). Returns items[]{price_range, buy_volume, sell_volume, neutral_volume} for price-volume profile.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"SymbolParam","type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"700.HK\"","type":"string"}},"required":["symbol"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"trades","title":"Recent Trades","description":"Get recent trades (max 1000). Returns trades[]{price, volume, timestamp, trade_type, direction} for the symbol.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"SymbolCountParam","type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"700.HK\"","type":"string"},"count":{"description":"Maximum number of results (max 1000)","type":"integer","format":"uint","minimum":0}},"required":["symbol","count"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"trading_days","title":"Trading Days","description":"Get trading days for a market between dates. Returns trading_days[] and half_trading_days[] as \"yyyy-mm-dd\" strings. market: HK/US/CN/SG.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"MarketDateRangeParam","type":"object","properties":{"market":{"description":"Market code: HK, US, CN, SG","type":"string"},"start":{"description":"Start date (yyyy-mm-dd)","type":"string"},"end":{"description":"End date (yyyy-mm-dd)","type":"string"}},"required":["market","start","end"]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"TradingDaysResponse","description":"Returned by `trading_days`.","type":"object","properties":{"trading_days":{"description":"Full trading days in the requested range (yyyy-mm-dd).","type":"array","items":{"type":"string"}},"half_trading_days":{"description":"Half-day trading sessions in the requested range (yyyy-mm-dd).","type":"array","items":{"type":"string"}}},"required":["trading_days","half_trading_days"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"trading_session","title":"Trading Sessions","description":"Get trading session schedule for all markets. Returns market_sessions[]{market, trade_sessions[]{beg_time, end_time, trade_session_type}}.","inputSchema":{"type":"object","properties":{}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"update_watchlist_group","title":"Update Watchlist Group","description":"Update a watchlist group by id. Can rename (name param) or modify securities (securities + mode: add/remove/replace). Returns upstream API response.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"UpdateWatchlistGroupParam","type":"object","properties":{"id":{"description":"Watchlist group id","type":"integer","format":"int64"},"name":{"description":"New group name (optional)","type":"string"},"securities":{"description":"Securities list (optional)","type":"array","items":{"type":"string"},"default":null},"mode":{"description":"Update mode for securities: \"add\", \"remove\", or \"replace\" (default: \"replace\")","type":"string"}},"required":["id"]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"UpdateWatchlistGroupResponse","description":"Returned by `update_watchlist_group`.","type":"object","properties":{"id":{"description":"The updated watchlist group ID (echoed from the request).","type":"integer","format":"int64"},"updated":{"description":"Always `true` on success.","type":"boolean"}},"required":["id","updated"]},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":true}},{"name":"valuation","title":"Valuation","description":"Get valuation overview with peer comparison. Returns metrics.pe/pb/ps/dividend_yield{current, industry_avg, 5yr_avg, percentile} and peer comparison list.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"SymbolParam","type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"700.HK\"","type":"string"}},"required":["symbol"]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"ValuationResponse","description":"Returned by `valuation`. The valuation overview groups per-metric blocks\nunder `metrics`.\n\nSubset of documented fields; upstream may return more.","type":"object","properties":{"metrics":{"description":"Valuation metric blocks keyed by indicator.","anyOf":[{"$ref":"#/$defs/ValuationMetrics"},{"type":"null"}]}},"$defs":{"ValuationMetrics":{"description":"`metrics` block of `valuation`. Each indicator carries the same shape.\n\nSubset of documented fields; upstream may return more.","type":"object","properties":{"pe":{"description":"Price-to-earnings block.","anyOf":[{"$ref":"#/$defs/ValuationMetric"},{"type":"null"}]},"pb":{"description":"Price-to-book block.","anyOf":[{"$ref":"#/$defs/ValuationMetric"},{"type":"null"}]},"ps":{"description":"Price-to-sales block.","anyOf":[{"$ref":"#/$defs/ValuationMetric"},{"type":"null"}]},"dividend_yield":{"description":"Dividend-yield block.","anyOf":[{"$ref":"#/$defs/ValuationMetric"},{"type":"null"}]}}},"ValuationMetric":{"description":"A single valuation indicator block in `valuation`.\n\nSubset of documented fields; upstream may return more.","type":"object","properties":{"current":{"description":"Current value.","type":["string","null"]},"industry_avg":{"description":"Industry average.","type":["string","null"]},"5yr_avg":{"description":"5-year average. (camelCase `5yr_avg` per description.)","type":["string","null"]},"percentile":{"description":"Historical percentile.","type":["string","null"]}}}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"valuation_comparison","title":"Stock Comparison","description":"Stock valuation comparison. Mode A (single): pass only symbol — server returns stock + auto-selected industry peers. Mode B (multi): pass symbol as primary + comparison_symbols (comma-separated, e.g. 'MSFT.US,GOOGL.US') for explicit peer comparison. currency: USD/HKD/CNY. Returns list[]{symbol, name, market_value, price_close, pe, pb, ps, history[]{date, pe, pb, ps}}.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"ValuationComparisonParam","type":"object","properties":{"symbol":{"description":"Security symbol to compare, e.g. \"AAPL.US\"","type":"string"},"currency":{"description":"Currency: \"USD\" | \"HKD\" | \"CNY\"","type":"string"},"comparison_symbols":{"description":"Comparison symbols, comma-separated, max 4, e.g. \"MSFT.US,GOOGL.US\".\nNote: pending backend support — currently server auto-selects industry peers.","type":"string"}},"required":["symbol","currency"]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"ValuationComparisonResponse","description":"Returned by `valuation_comparison`. Wraps a `list` of compared stocks.\n\nSubset of documented fields; upstream may return more.","type":"object","properties":{"list":{"description":"Compared stocks (primary + peers).","type":["array","null"],"items":{"$ref":"#/$defs/ValuationComparisonItem"}}},"$defs":{"ValuationComparisonItem":{"description":"One stock in `valuation_comparison`'s `list`.\n\nSubset of documented fields; upstream may return more.","type":"object","properties":{"symbol":{"description":"Security symbol (transformed from `counter_id`).","type":["string","null"]},"name":{"description":"Display name.","type":["string","null"]},"market_value":{"description":"Market value.","type":["string","null"]},"price_close":{"description":"Latest close price.","type":["string","null"]},"pe":{"description":"Price-to-earnings.","type":["string","null"]},"pb":{"description":"Price-to-book.","type":["string","null"]},"ps":{"description":"Price-to-sales.","type":["string","null"]},"history":{"description":"Per-date valuation history.","type":["array","null"],"items":{"$ref":"#/$defs/ValuationComparisonHistoryPoint"}}}},"ValuationComparisonHistoryPoint":{"description":"One history point in `valuation_comparison`'s nested `history`.\n\nSubset of documented fields; upstream may return more.","type":"object","properties":{"date":{"description":"Sample date (RFC3339; rewritten from a unix-epoch field).","type":["string","null"]},"pe":{"description":"Price-to-earnings at this date.","type":["string","null"]},"pb":{"description":"Price-to-book at this date.","type":["string","null"]},"ps":{"description":"Price-to-sales at this date.","type":["string","null"]}}}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"valuation_history","title":"Valuation History","description":"Get detailed valuation history time series. Returns history.metrics{pe/pb/ps/dividend_yield}[]{timestamp, value} for long-term percentile analysis.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"SymbolParam","type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"700.HK\"","type":"string"}},"required":["symbol"]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"ValuationHistoryResponse","description":"Returned by `valuation_history`. Time-series valuation metrics grouped\nunder `history.metrics`.\n\nSubset of documented fields; upstream may return more.","type":"object","properties":{"history":{"description":"History container.","anyOf":[{"$ref":"#/$defs/ValuationHistoryBlock"},{"type":"null"}]}},"$defs":{"ValuationHistoryBlock":{"description":"`history` block of `valuation_history`.","type":"object","properties":{"metrics":{"description":"Per-indicator time series.","anyOf":[{"$ref":"#/$defs/ValuationHistoryMetrics"},{"type":"null"}]}}},"ValuationHistoryMetrics":{"description":"`history.metrics` block of `valuation_history`. Each indicator is an array\nof time-series samples.\n\nSubset of documented fields; upstream may return more.","type":"object","properties":{"pe":{"description":"Price-to-earnings series.","type":["array","null"],"items":{"$ref":"#/$defs/ValuationHistoryPoint"}},"pb":{"description":"Price-to-book series.","type":["array","null"],"items":{"$ref":"#/$defs/ValuationHistoryPoint"}},"ps":{"description":"Price-to-sales series.","type":["array","null"],"items":{"$ref":"#/$defs/ValuationHistoryPoint"}},"dividend_yield":{"description":"Dividend-yield series.","type":["array","null"],"items":{"$ref":"#/$defs/ValuationHistoryPoint"}}}},"ValuationHistoryPoint":{"description":"One sample in a `valuation_history` metric time series.\n\nSubset of documented fields; upstream may return more.","type":"object","properties":{"timestamp":{"description":"Sample timestamp (RFC3339; rewritten from a unix-epoch field).","type":["string","null"]},"value":{"description":"Metric value at this timestamp.","type":["string","null"]}}}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"valuation_rank","title":"Valuation Rank","description":"Get daily valuation rank (PE/PB/PS/dividend yield industry percentile) for a security over a date range. start/end in yyyymmdd format.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"ValuationRankParam","type":"object","properties":{"symbol":{"description":"Security symbol, e.g. \"AAPL.US\"","type":"string"},"start":{"description":"Start date in yyyymmdd format (default: 30 days ago)","type":"string"},"end":{"description":"End date in yyyymmdd format (default: today)","type":"string"}},"required":["symbol"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"warrant_issuers","title":"Warrant Issuers","description":"Get HK warrant issuer information. Returns issuers[]{id, name_en, name_cn}. Use id in warrant_list issuer filter.","inputSchema":{"type":"object","properties":{}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"warrant_list","title":"Warrant List","description":"Get filtered warrant list for an underlying symbol. Returns warrants[]{symbol, name, last_done, change_rate, implied_volatility, expiry_date, strike_price, leverage_ratio, outstanding_ratio}.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"WarrantListParam","type":"object","properties":{"symbol":{"description":"Underlying symbol, e.g. \"700.HK\"","type":"string"},"sort_by":{"description":"Sort field: LastDone, ChangeRate, ChangeValue, Volume, Turnover, ExpiryDate, StrikePrice, UpperStrikePrice, LowerStrikePrice, OutstandingQuantity, OutstandingRatio, Premium, ItmOtm, ImpliedVolatility, Delta","type":"string"},"sort_order":{"description":"Sort order: Ascending or Descending","type":"string"},"warrant_type":{"description":"Filter by warrant type (optional): \"Call\", \"Put\", \"Bull\", \"Bear\", \"Inline\"","type":"array","items":{"type":"string"},"default":null},"issuer":{"description":"Filter by issuer ID (optional), use issuer_id from warrant_issuers tool","type":"array","items":{"type":"integer","format":"int32"},"default":null},"expiry_date":{"description":"Filter by expiry date range (optional): \"LT_3\" (<3 months), \"Between_3_6\" (3-6 months), \"Between_6_12\" (6-12 months), \"GT_12\" (>12 months)","type":"array","items":{"type":"string"},"default":null},"price_type":{"description":"Filter by in/out of bounds (optional): \"In\" (in bounds), \"Out\" (out of bounds). Only for Inline warrants.","type":"array","items":{"type":"string"},"default":null},"status":{"description":"Filter by status (optional): \"Suspend\" (suspended), \"PrepareList\" (pending listing), \"Normal\" (normal trading)","type":"array","items":{"type":"string"},"default":null}},"required":["symbol","sort_by","sort_order"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"warrant_quote","title":"Warrant Quote","description":"Get warrant quotes. Returns last_done, prev_close, open, high, low, volume, turnover, implied_volatility, delta, leverage_ratio, effective_leverage per symbol.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"SymbolsParam","type":"object","properties":{"symbols":{"description":"Security symbols, e.g. [\"700.HK\", \"AAPL.US\"]","type":"array","items":{"type":"string"}}},"required":["symbols"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"watchlist","title":"Watchlist","description":"Get all watchlist groups and their securities. Returns groups[]{id, name, securities[]{symbol, market, name, watched_price, watched_at}}.","inputSchema":{"type":"object","properties":{}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"withdrawals","title":"Withdrawals","description":"List withdrawal history for the current account. Returns items[]{id, amount, currency, status, created_at, bank_name, account_number (masked)}.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"WithdrawalParam","type":"object","properties":{"page":{"description":"Page number (default: 1)","type":"integer","format":"uint32","minimum":0},"size":{"description":"Page size (default: 20)","type":"integer","format":"uint32","minimum":0}}},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}}],"scopes":[{"id":"0","name":"General","key":"","description":"General-purpose tools covering market data, quotes, fundamentals, alerts, DCA, sharelists, IPO, and content.","tools":["ah_premium","ah_premium_intraday","alert_add","alert_delete","alert_disable","alert_enable","alert_list","anomaly","broker_holding","broker_holding_daily","broker_holding_detail","brokers","business_segments","business_segments_history","calc_indexes","candlesticks","capital_distribution","capital_flow","company","consensus","constituent","corp_action","dca_check","depth","dividend","dividend_detail","exchange_rate","executive","filings","finance_calendar","financial_report","financial_report_latest","financial_report_snapshot","financial_statement","forecast_eps","fund_holder","history_candlesticks_by_date","history_candlesticks_by_offset","history_market_temperature","industry_peers","industry_rank","industry_valuation","industry_valuation_dist","institution_rating","institution_rating_detail","institution_rating_history","institution_rating_industry_rank","institutional_views","intraday","invest_relation","ipo_calendar","ipo_detail","ipo_listed","ipo_subscriptions","market_status","market_temperature","news","news_search","now","operating","option_chain_expiry_date_list","option_chain_info_by_date","option_quote","option_volume","option_volume_daily","participants","quant_run","quote","rank_categories","rank_list","screener_indicators","screener_recommend_strategies","screener_search","screener_strategy","screener_user_strategies","shareholder","shareholder_detail","shareholder_top","sharelist_add","sharelist_create","sharelist_delete","sharelist_detail","sharelist_list","sharelist_popular","sharelist_remove","sharelist_sort","short_positions","short_trades","static_info","top_movers","topic","topic_create","topic_create_reply","topic_detail","topic_replies","topic_search","trade_stats","trades","trading_days","trading_session","valuation","valuation_comparison","valuation_history","valuation_rank","warrant_issuers","warrant_list","warrant_quote"]},{"id":"4","name":"Watchlist","key":"watchlist","description":"Manage the user's watchlist groups (read/create/update/delete) and look up the securities each group contains.","tools":["create_watchlist_group","delete_watchlist_group","security_list","update_watchlist_group","watchlist"]},{"id":"6","name":"Account & Positions","key":"account.read","description":"Query account assets and cash flow — fund/stock holdings, account cash and equity, margin ratio, profit analysis and statements — for portfolio overviews, position display and account reconciliation.","tools":["account_balance","bank_cards","cash_flow","deposits","fund_positions","ipo_order_detail","ipo_orders","ipo_profit_loss","margin_ratio","profit_analysis","profit_analysis_detail","short_margin","statement_export","statement_list","stock_positions","withdrawals"]},{"id":"10","name":"Trade Order Lookup","key":"trade.read","description":"Cover the post-submit order lifecycle and execution data: order detail, today/history orders, today/history executions, DCA plan reads, plus pre-trade max purchase quantity estimation.","tools":["dca_history","dca_list","dca_stats","estimate_max_purchase_quantity","history_executions","history_orders","order_detail","today_executions","today_orders"]},{"id":"11","name":"Trade Execution","key":"trade.write","description":"Place, replace and cancel orders, plus DCA plan create/update/pause/resume/stop.","tools":["cancel_order","dca_create","dca_pause","dca_resume","dca_stop","dca_update","replace_order","submit_order"]}],"locales":{"zh-CN":{"$schema":"../tools.schema.json","server_instructions":"长桥 MCP 服务 —— 提供市场数据、交易与金融分析工具。","tools":{"create_watchlist_group":{"title":"新建自选分组","description":"新建自选分组，返回 {id, name}。可选传入 securities（如 [\"AAPL.US\"]）预填入证券","properties":{"name":"分组名称","securities":"要加入的证券代码，例如 `[\"700.HK\", \"AAPL.US\"]`"}},"delete_watchlist_group":{"title":"删除自选分组","description":"按分组 id 删除自选分组。purge=true 时同时从其他分组中移除该分组包含的证券","properties":{"id":"自选分组 id","purge":"是否同时从其他分组中清除这些证券"}},"security_list":{"title":"证券列表","description":"获取指定市场的证券列表。支持市场：US、HK、CN、SG。category 当前仅支持 \"Overnight\"（默认）。page：页码（从1开始，默认1）。count：每页条数（默认50）。返回 {total, page, count, items[]{symbol, name_en, name_cn}}。","properties":{"market":"市场代码：US、HK、CN、SG","category":"类别筛选，当前仅支持 \"Overnight\"（默认）","page":"页码，从1开始，默认1","count":"每页返回条数，默认50"}},"update_watchlist_group":{"title":"更新自选分组","description":"更新自选分组：重命名（name）或修改成员证券（securities + mode: add/remove/replace）","properties":{"id":"自选分组 id","name":"新的分组名称（可选）","securities":"证券代码列表（可选）","mode":"证券更新模式：`add`（新增）、`remove`（移除）或 `replace`（替换，默认）"}},"watchlist":{"title":"自选列表","description":"获取所有自选分组及其包含的证券，返回 groups[]{id, name, securities[]{symbol, name, watched_price, watched_at}}"},"account_balance":{"title":"账户余额","description":"查询账户现金余额与资产概览，返回 balances[]{currency, total_cash, max_finance_amount, remaining_finance_amount, risk_level, margin_call}","properties":{"currency":"按币种代码筛选（如 `\"USD\"`、`\"HKD\"`），省略则返回所有币种"}},"cash_flow":{"title":"资金流水","description":"查询资金流水记录（出入金、派息等），返回 items[]{transaction_type, amount, currency, balance, created_at, remark}","properties":{"start_at":"起始时间（RFC3339 格式）","end_at":"结束时间（RFC3339 格式）"}},"fund_positions":{"title":"基金持仓","description":"查询当前基金持仓，返回 list[].fund_info[]{symbol, symbol_name, currency, holding_units, current_net_asset_value, cost_net_asset_value, net_asset_value_day}"},"margin_ratio":{"title":"保证金比率","description":"查询标的保证金比率，返回 {im_factor（初始保证金）, mm_factor（维持保证金）, fm_factor（强平保证金）}","properties":{"symbol":"证券代码，例如 `\"700.HK\"`"}},"profit_analysis":{"title":"盈亏分析","description":"获取组合盈亏分析汇总。start/end（yyyy-mm-dd）须成对传入，只传其中之一会返回空结果","properties":{"start":"起始日期（`yyyy-mm-dd`）。必须与 `end` 成对传入，只传其一会返回空结果","end":"结束日期（`yyyy-mm-dd`）。必须与 `start` 成对传入，只传其一会返回空结果"}},"profit_analysis_detail":{"title":"盈亏分析明细","description":"获取指定标的详细盈亏分析。start/end（yyyy-mm-dd）须成对传入，只传其中之一会返回空结果","properties":{"symbol":"证券代码，例如 `\"700.HK\"`","start":"起始日期（`yyyy-mm-dd`）。必须与 `end` 成对传入，只传其一会返回空结果","end":"结束日期（`yyyy-mm-dd`）。必须与 `start` 成对传入，只传其一会返回空结果"}},"statement_export":{"title":"对账单导出","description":"获取对账单文件的预签名下载 URL（file_key 来自 statement_list），返回 {url}，访问该 URL 即可获取对账单 JSON","properties":{"file_key":"来自 `statement_list` 的文件 key，例如 `\"/statement_data/data/.../20975338.json\"`"}},"statement_list":{"title":"对账单列表","description":"列出可获取的账户对账单（日报/月报），返回 list[]{id, type, date, status}，用 id 调用 statement_export 下载","properties":{"statement_type":"对账单类型：`\"daily\"`（默认，日报）或 `\"monthly\"`（月报）","start_date":"起始日期（`yyyy-mm-dd`）。`daily` 默认 30 天前，`monthly` 默认 12 个月前","limit":"返回条数。`daily` 默认 30，`monthly` 默认 12"}},"stock_positions":{"title":"股票持仓","description":"查询所有渠道下的当前股票持仓，返回 list[].stock_info[]{symbol, symbol_name, quantity, available_quantity, currency, cost_price, market}"},"dca_history":{"title":"定投执行历史","description":"按 plan_id 查询定投计划的扣款执行历史，返回 executions[]{date, quantity, amount, price, status, order_id}","properties":{"plan_id":"定投计划 ID","page":"页码（默认 1）","limit":"每页条数（默认 20）"}},"dca_list":{"title":"定投计划列表","description":"列出定投计划，返回 plans[]{plan_id, symbol, amount, currency, frequency, status, next_execution_date}","properties":{"status":"按状态筛选：`Active`、`Suspended`、`Finished`，省略则返回全部","symbol":"按证券筛选，例如 `\"AAPL.US\"`，省略则返回全部计划","page":"页码（默认 1）","limit":"每页条数（默认 20）"}},"dca_stats":{"title":"定投统计","description":"获取定投投资统计汇总，返回 {total_invested, total_value, total_return, return_rate, plan_count, items[]{symbol, invested, value, return_rate}}","properties":{"symbol":"按证券筛选，例如 `\"AAPL.US\"`，省略则返回所有计划的合计统计"}},"estimate_max_purchase_quantity":{"title":"最大可买估算","description":"估算指定证券的最大可买/可卖数量，返回 {cash_max_qty, margin_max_qty}","properties":{"symbol":"证券代码","side":"买卖方向：`Buy`（买入）或 `Sell`（卖出）","order_type":"委托类型：`LO`（限价单）/ `ELO`（增强限价单）/ `MO`（市价单）/ `AO`（竞价单）/ `ALO`（竞价限价单）","price":"委托价格（限价类委托需要）"}},"history_executions":{"title":"历史成交","description":"查询指定日期区间内的历史成交记录，返回 executions[]{order_id, symbol, side, quantity, price, trade_done_at}","properties":{"symbol":"按证券筛选（可选）","start_at":"起始时间（RFC3339 格式）","end_at":"结束时间（RFC3339 格式）"}},"history_orders":{"title":"历史委托","description":"查询指定日期区间内的历史委托（不含当日），返回 orders[]{order_id, symbol, side, status, quantity, price, submitted_at}","properties":{"symbol":"按证券筛选（可选）","start_at":"起始时间（RFC3339 格式）","end_at":"结束时间（RFC3339 格式）"}},"order_detail":{"title":"委托详情","description":"查询单个委托详情，返回 {order_id, symbol, status, side, order_type, quantity, price, executed_quantity, executed_price, submitted_at, time_in_force, msg}","properties":{"order_id":"委托单号"}},"today_executions":{"title":"当日成交","description":"查询当日成交（filled），返回 executions[]{order_id, symbol, side, quantity, price, trade_done_at}。可按 symbol 或 order_id 筛选","properties":{"symbol":"按证券筛选，例如 `\"700.HK\"`","order_id":"按指定委托单号筛选"}},"today_orders":{"title":"当日委托","description":"查询当日委托，返回 orders[]{order_id, symbol, side, order_type, status, quantity, price, submitted_at, executed_quantity, executed_price}","properties":{"symbol":"按证券筛选，例如 `\"700.HK\"`，省略则返回当日全部委托"}},"cancel_order":{"title":"撤销委托","description":"按 order_id 撤销未成交的委托，成功返回 \"order cancelled\"；已成交或已撤销则报错","properties":{"order_id":"委托单号"}},"dca_create":{"title":"创建定投计划","description":"创建定投（DCA）计划。frequency: Daily/Weekly/Monthly；周频对应 day_of_week（Mon–Fri），月频对应 day_of_month（1-28）","properties":{"symbol":"证券代码，例如 `\"AAPL.US\"`","amount":"每期投入金额，例如 `\"100\"`","frequency":"定投频率：`Daily`（每日）、`Weekly`（每周）、`Monthly`（每月）","day_of_week":"周频时指定的周几：`Mon`、`Tue`、`Wed`、`Thu`、`Fri`","day_of_month":"月频时指定的日期（1-28）","allow_margin":"是否允许使用融资（默认 `false`）"}},"dca_pause":{"title":"暂停定投计划","description":"按 plan_id 暂停定投计划，计划停止执行直至恢复。如需临时暂停请使用此接口（永久终止用 dca_stop）","properties":{"plan_id":"定投计划 ID"}},"dca_resume":{"title":"恢复定投计划","description":"按 plan_id 恢复已暂停的定投计划，按原有周期继续自动执行","properties":{"plan_id":"定投计划 ID"}},"dca_stop":{"title":"终止定投计划","description":"按 plan_id 永久终止定投计划，操作不可撤销。如需临时暂停请使用 dca_pause","properties":{"plan_id":"定投计划 ID"}},"dca_update":{"title":"更新定投计划","description":"按 plan_id 更新定投计划，可修改 amount、frequency（Daily/Weekly/Monthly）、day_of_week（Mon-Fri）或 day_of_month（1-28）","properties":{"plan_id":"待更新的定投计划 ID","amount":"新的每期投入金额","frequency":"新的定投频率：`Daily`、`Weekly`、`Monthly`","day_of_week":"周频时指定的周几：`Mon`、`Tue`、`Wed`、`Thu`、`Fri`","day_of_month":"月频时指定的日期（1-28）","allow_margin":"是否允许使用融资"}},"replace_order":{"title":"修改委托","description":"修改未成交委托的数量、价格、触发价或追踪止损参数，成功返回 \"order replaced\"","properties":{"order_id":"委托单号","quantity":"新的委托数量","price":"新的委托价格","trigger_price":"新的触发价","limit_offset":"新的限价偏移量","trailing_amount":"新的跟踪止损金额","trailing_percent":"新的跟踪止损百分比"}},"submit_order":{"title":"提交委托","description":"提交买卖委托。order_type：LO（限价）/ ELO（港股增强限价）/ MO（市价）/ AO（港股竞价）/ ALO（港股竞价限价）/ ODD（港股碎股）/ LIT（触价限价）/ MIT（触价市价）/ TSLPAMT（按金额追踪止损）/ TSLPPCT（按百分比追踪止损）/ SLO（港股特别限价）；side：Buy/Sell；time_in_force：Day/GTC/GTD","properties":{"symbol":"证券代码","order_type":"委托类型（港股全部支持；美股仅支持 `LO` / `MO` / `LIT` / `MIT` / `TSLPAMT` / `TSLPPCT`）：<br>- `LO`（限价单）：需 `submitted_price`<br>- `ELO`（增强限价单，港股）：需 `submitted_price`<br>- `MO`（市价单）：无需价格<br>- `AO`（竞价单，港股）：以竞价价成交，无需价格<br>- `ALO`（竞价限价单，港股）：需 `submitted_price`<br>- `ODD`（碎股单，港股）：需 `submitted_price`，用于非标准手数<br>- `LIT`（触价限价）：需 `submitted_price` 与 `trigger_price`，行情触及触发价时激活<br>- `MIT`（触价市价）：仅需 `trigger_price`，触及后按市价成交<br>- `TSLPAMT`（按金额跟踪止损限价）：需 `trailing_amount` 与 `limit_offset`<br>- `TSLPPCT`（按百分比跟踪止损限价）：需 `trailing_percent`（0-1）与 `limit_offset`<br>- `SLO`（特别限价单，港股）：需 `submitted_price`，提交后不可改单","side":"买卖方向：`Buy`（买入）或 `Sell`（卖出）","submitted_quantity":"委托数量","time_in_force":"委托有效期：`Day`（当日有效）、`GTC`（撤单前有效）、`GTD`（指定日期前有效，需 `expire_date`）","submitted_price":"委托限价。`LO` / `ELO` / `ALO` / `ODD` / `LIT` / `SLO` 必填","trigger_price":"触发价。`LIT` / `MIT` / `TSLPAMT` / `TSLPPCT` 必填","limit_offset":"相对跟踪止损价的限价偏移量。`TSLPAMT` / `TSLPPCT` 必填","trailing_amount":"跟踪金额（绝对价格距离），`TSLPAMT` 必填","trailing_percent":"跟踪百分比（小数形式，例如 `0.05` 表示 5%），`TSLPPCT` 必填","expire_date":"到期日期（`yyyy-mm-dd`），`time_in_force=GTD` 时必填","outside_rth":"盘前盘后设置：`RTH_ONLY`（仅常规交易时段）、`ANY_TIME`（含盘前盘后任意时段）、`OVERNIGHT`（夜盘，仅美股）","remark":"委托备注（最多 255 字符）"}},"ah_premium":{"title":"A/H 溢价","description":"获取 A/H 股溢价历史 K 线数据，返回 items[]{timestamp, open, high, low, close}，表示溢价百分比","properties":{"symbol":"证券代码，例如 `\"700.HK\"`","period":"K 线周期：`1m`、`5m`、`15m`、`30m`、`60m`、`day`（默认）、`week`、`month`、`year`","count":"返回的 K 线数量（默认 100）"}},"ah_premium_intraday":{"title":"A/H 溢价（分时）","description":"获取 A/H 股溢价当日分时数据，返回 items[]{timestamp, premium_rate}，逐分钟展示溢价百分比","properties":{"symbol":"证券代码，例如 `\"700.HK\"`"}},"alert_add":{"title":"新增价格预警","description":"新增价格预警，返回已创建的预警对象。condition：price_rise/price_fall（绝对价格）或 percent_rise/percent_fall（涨跌幅）；frequency：once/daily/every","properties":{"symbol":"证券代码，例如 `\"700.HK\"`","condition":"预警条件：`price_rise`、`price_fall`、`percent_rise`、`percent_fall`","price":"阈值价格或百分比数值","frequency":"预警频率：`once`（触发一次后停用）、`daily`（每日一次）、`every`（每次满足条件都触发）"}},"alert_delete":{"title":"删除价格预警","description":"按 alert_id（来自 alert_list 的数字字符串）删除价格预警","properties":{"alert_id":"预警指标 id"}},"alert_disable":{"title":"停用价格预警","description":"按 alert_id 停用价格预警，返回 {alert_id, enabled: false}","properties":{"alert_id":"预警指标 id"}},"alert_enable":{"title":"启用价格预警","description":"按 alert_id 启用价格预警，返回 {alert_id, enabled: true}","properties":{"alert_id":"预警指标 id"}},"alert_list":{"title":"价格预警列表","description":"获取所有已配置的价格预警，返回 lists[]{counter_id, indicators[]{id, condition, price, frequency, enabled, triggered_at}}"},"anomaly":{"title":"市场异动","description":"获取市场异动提醒（价量异常变动）。market: HK/US/CN/SG。symbol: 可选，筛选特定股票。count: 返回数量（默认 50，最多 100）。返回 changes[]{symbol, name, change_rate, volume, ...}, all_off。","properties":{"market":"市场代码：HK、US、CN、SG","symbol":"可选证券代码，如 AAPL.US 或 700.HK，筛选特定股票的异动","count":"返回数量，默认 50，最多 100"}},"broker_holding":{"title":"券商持仓","description":"获取指定证券的主要券商持仓数据，返回 items[]{broker_name, holding_quantity, holding_change, holding_ratio}","properties":{"symbol":"证券代码，例如 `\"700.HK\"`","period":"时间窗口：`rct_1`（近 1 日，默认）、`rct_5`（近 5 日）、`rct_20`（近 20 日）、`rct_60`（近 60 日）"}},"broker_holding_daily":{"title":"券商持仓（日度）","description":"获取指定券商（broker_id）对某证券的逐日持仓历史，返回 items[]{date, holding_quantity, holding_change, holding_ratio}","properties":{"symbol":"证券代码，例如 `\"700.HK\"`","broker_id":"券商参与者编号"}},"broker_holding_detail":{"title":"券商持仓明细","description":"获取完整的券商持仓明细列表，返回 items[]{broker_id, broker_name, holding_quantity, holding_ratio, holding_change, date}","properties":{"symbol":"证券代码，例如 `\"700.HK\"`"}},"brokers":{"title":"经纪商队列","description":"获取港股经纪商买卖盘队列（仅港股），返回 bid_brokers/ask_brokers[]{position, broker_ids}，通过 participants 工具将 broker_id 映射为名称","properties":{"symbol":"证券代码，例如 `\"700.HK\"`"}},"calc_indexes":{"title":"指标计算","description":"批量计算证券的行情/财务指标（PE、PB、股息率、最新价、换手率等），传入 symbols 和 indexes 列表，返回各标的的指标值","properties":{"symbols":"证券代码，例如 `[\"700.HK\", \"AAPL.US\"]`","indexes":"待计算指标：`LastDone`、`ChangeValue`、`ChangeRate`、`Volume`、`Turnover`、`YtdChangeRate`、`TurnoverRate`、`TotalMarketValue`、`CapitalFlow`、`Amplitude`、`VolumeRatio`、`PeTtmRatio`、`PbRatio`、`DividendRatioTtm`、`FiveDayChangeRate`、`TenDayChangeRate`、`HalfYearChangeRate`、`FiveMinutesChangeRate`、`ExpiryDate`、`StrikePrice`、`UpperStrikePrice`、`LowerStrikePrice`、`OutstandingQty`、`OutstandingRatio`、`Premium`、`ItmOtm`、`ImpliedVolatility`、`WarrantDelta`、`CallPrice`、`ToCallPrice`、`EffectiveLeverage`、`LeverageRatio`、`ConversionRatio`、`BalancePoint`、`OpenInterest`、`Delta`、`Gamma`、`Theta`、`Vega`、`Rho`"}},"candlesticks":{"title":"K 线数据","description":"获取 K 线数据（OHLCV）。period：1m/5m/15m/30m/60m/day/week/month/year；trade_sessions：intraday（默认，仅正常时段）或 all（含盘前盘后）","properties":{"symbol":"证券代码","period":"K 线周期：`1m`、`5m`、`15m`、`30m`、`60m`、`day`、`week`、`month`、`year`","count":"K 线数量（最多 1000）","forward_adjust":"是否对拆股 / 派息进行前复权","trade_sessions":"交易时段：`intraday`（仅常规时段）或 `all`（含盘前盘后）"}},"capital_distribution":{"title":"资金分布","description":"获取资金分布（大/中/小单流入流出），返回 {timestamp, capital_in{large, medium, small}, capital_out{large, medium, small}}","properties":{"symbol":"证券代码，例如 `\"700.HK\"`"}},"capital_flow":{"title":"资金流向","description":"获取资金净流入/流出当日时间序列，返回 items[]{timestamp, inflow, outflow, net_flow}","properties":{"symbol":"证券代码，例如 `\"700.HK\"`"}},"company":{"title":"公司概况","description":"获取公司概况，返回 name、description、employees、CEO、founded_year、website、exchange、industry、market_cap 等信息","properties":{"symbol":"证券代码，例如 `\"700.HK\"`"}},"consensus":{"title":"一致预期","description":"获取分析师一致预期，返回 items[]{period, revenue_estimate, eps_estimate, net_income_estimate, analyst_count, last_updated}","properties":{"symbol":"证券代码，例如 `\"700.HK\"`"}},"constituent":{"title":"指数成份股 / ETF 资产分布","description":"获取指数成份股或 ETF 资产分布。指数（如 HSI.HK、.DJI.US）返回 constituents[]{symbol, name, last_done（最新价）, change_rate, market_cap, weight}。ETF（如 QQQ.US、2800.HK）返回资产分布 info[]，按 asset_type 分组：1=Holdings（前十大持仓，含 code、symbol、holding_detail）/ 2=Regional（地区分布）/ 3=AssetClass（资产类别，如股票/债券/现金）/ 4=Industry（行业分布）。每组含 report_date 与 lists[]{name, position_ratio, name_locales}；Holdings 组额外含 code、symbol 及 holding_detail{industry_name, index_name, holding_type_name}","properties":{"symbol":"指数或 ETF 代码，例如 `\"HSI.HK\"`、`\"QQQ.US\"`"}},"corp_action":{"title":"公司行动","description":"获取公司行动信息（拆股、回购、更名等），返回 items[]{action_type, effective_date, ratio, description}","properties":{"symbol":"证券代码，例如 `\"700.HK\"`"}},"dca_check":{"title":"检查定投支持","description":"检查证券是否支持定投（DCA），返回 items[]{symbol, support_dca, reason}","properties":{"symbols":"待检查的证券代码，例如 `[\"AAPL.US\", \"TSLA.US\"]`"}},"depth":{"title":"盘口深度","description":"获取买卖盘深度（最多 10 档），返回 {bids[]{position, price, volume, order_num}, asks[]{position, price, volume, order_num}}","properties":{"symbol":"证券代码，例如 `\"700.HK\"`"}},"dividend":{"title":"派息历史","description":"获取证券的派息历史，返回 items[]{ex_date（除权日）, pay_date（派发日）, record_date, dividend_type, amount, currency, status}","properties":{"symbol":"证券代码，例如 `\"700.HK\"`"}},"dividend_detail":{"title":"派息明细","description":"获取详细派息分红方案，返回 details[]{period, cash_dividend, stock_dividend, record_date, ex_date, pay_date, currency}","properties":{"symbol":"证券代码，例如 `\"700.HK\"`"}},"exchange_rate":{"title":"汇率","description":"获取全部支持币种的汇率，返回 list[]{from_currency, to_currency, rate, timestamp}，覆盖 USD/HKD/CNY/SGD 等"},"executive":{"title":"高管与董事","description":"获取公司高管及董事会成员信息，返回 members[]{name, title, appointed_date, age, biography, compensation}","properties":{"symbol":"证券代码，例如 `\"700.HK\"`"}},"filings":{"title":"监管公告","description":"获取监管文件公告（8-K、10-Q、10-K 等），返回 items[]{id, title, type, language, filing_date, url}","properties":{"symbol":"证券代码，例如 `\"700.HK\"`"}},"finance_calendar":{"title":"财经日历","description":"获取财经日历事件。category：report（财报+业绩）/ dividend（除息日与派发日）/ split（拆股/反拆）/ ipo / macrodata（CPI、非农、议息等）/ closed（休市日）；market：HK/US/CN/SG/JP/UK/DE/AU。日期范围建议不超过 2 周；如需查询更长时间段，请拆分为多次调用以避免数据截断。","properties":{"market":"市场代码：HK、US、CN、SG，省略则查询所有市场","start":"起始日期（`yyyy-mm-dd`）","end":"结束日期（`yyyy-mm-dd`）","category":"事件类别：<br>- `financial`：业绩 / 财报公告<br>- `report`：财报披露排期<br>- `dividend`：除息日与派发日<br>- `ipo`：IPO 上市日期<br>- `macrodata`：宏观数据发布（GDP、CPI 等）<br>- `closed`：市场休市 / 停牌日期"}},"financial_report":{"title":"财务报表","description":"获取财务报告（利润表/资产负债表/现金流量表）。kind：IS/BS/CF/ALL；report_type：af（年报）/saf（半年报）/q1/q2/q3/qf（季报全量）","properties":{"symbol":"证券代码，例如 `\"AAPL.US\"`","kind":"报表种类：`IS`（利润表）、`BS`（资产负债表）、`CF`（现金流量表）、`ALL`（默认全部）","report_type":"报告期：`af`（年度）、`saf`（半年度）、`q1` / `q2` / `q3`（季度）、`qf`（季度全量）"}},"forecast_eps":{"title":"EPS 预测","description":"获取 EPS 预测及分析师预期历史，返回 items[]{forecast_start_date, forecast_end_date, eps_estimate, eps_actual, surprise_pct, analyst_count}","properties":{"symbol":"证券代码，例如 `\"700.HK\"`"}},"fund_holder":{"title":"持仓基金","description":"获取持有指定证券的基金及 ETF，返回 fund_holders[]{fund_name, fund_symbol, shares, ratio, change, reported_at}","properties":{"symbol":"证券代码，例如 `\"700.HK\"`"}},"history_candlesticks_by_date":{"title":"历史 K 线（按日期）","description":"按日期区间获取历史 K 线（OHLCV）数据。period：1m/5m/15m/30m/60m/day/week/month/year","properties":{"symbol":"证券代码","period":"K 线周期：`1m`、`5m`、`15m`、`30m`、`60m`、`day`、`week`、`month`、`year`","forward_adjust":"是否对拆股 / 派息进行前复权","start":"起始日期（`yyyy-mm-dd`），可选","end":"结束日期（`yyyy-mm-dd`），可选","trade_sessions":"交易时段：`intraday`（仅常规时段）或 `all`（含盘前盘后）"}},"history_candlesticks_by_offset":{"title":"历史 K 线（按偏移）","description":"以参考时间为锚点按偏移量获取历史 K 线（OHLCV）数据。period：1m/5m/15m/30m/60m/day/week/month/year","properties":{"symbol":"证券代码","period":"K 线周期：`1m`、`5m`、`15m`、`30m`、`60m`、`day`、`week`、`month`、`year`","forward_adjust":"是否对拆股 / 派息进行前复权","forward":"查询方向：`true` 向后（向未来），`false` 向前（向过去）","time":"参考时间（`yyyy-mm-ddTHH:MM:SS`），省略则以最新时间为起点","count":"K 线数量（最多 1000）","trade_sessions":"交易时段：`intraday`（仅常规时段）或 `all`（含盘前盘后）"}},"history_market_temperature":{"title":"历史市场温度","description":"获取市场情绪温度历史时间序列，返回 {type, list[]{temperature, description, valuation, sentiment, timestamp}}","properties":{"market":"市场代码：HK、US、CN、SG","start":"起始日期（`yyyy-mm-dd`）","end":"结束日期（`yyyy-mm-dd`）"}},"industry_valuation":{"title":"行业估值","description":"获取同行业可比公司估值对比，返回 list[]{symbol, name, pe, pb, ps, dividend_yield, history[]{date, pe, pb}}","properties":{"symbol":"证券代码，例如 `\"700.HK\"`"}},"industry_valuation_dist":{"title":"行业估值分布","description":"获取行业 PE/PB/PS 估值分布，返回 distributions{pe/pb/ps}{min, p25, median, p75, max, current_percentile}，显示个股在行业中的分位","properties":{"symbol":"证券代码，例如 `\"700.HK\"`"}},"institution_rating":{"title":"机构评级","description":"获取机构评级汇总，返回 analyst{buy, outperform, hold, underperform, sell 家数, target_price, consensus_rating} 及评级列表","properties":{"symbol":"证券代码，例如 `\"700.HK\"`"}},"institution_rating_detail":{"title":"机构评级明细","description":"获取机构评级与目标价历史明细，返回 target.list[]{analyst, firm, rating, target_price, timestamp}","properties":{"symbol":"证券代码，例如 `\"700.HK\"`"}},"intraday":{"title":"分时数据","description":"获取分时（逐分钟）价格/成交量数据。trade_sessions：intraday（默认，仅正常时段）或 all（含盘前盘后）","properties":{"symbol":"证券代码，例如 `\"700.HK\"`","trade_sessions":"包含的交易时段：`intraday`（默认，仅常规时段）或 `all`（含盘前盘后）"}},"invest_relation":{"title":"投资者关系","description":"获取投资者关系事件与公告，返回 items[]{title, event_type, event_date, url, description}","properties":{"symbol":"证券代码，例如 `\"700.HK\"`"}},"market_status":{"title":"市场状态","description":"获取所有市场当前交易状态，返回 market_time[]{market, trade_status（Trading/Closed/Mid-Day Break/Pre-Market/Post-Market/Overnight 等）, timestamp}"},"market_temperature":{"title":"市场温度","description":"获取当前市场情绪温度，返回 {temperature（0-100）, description, valuation（0-100）, sentiment（0-100）, timestamp}","properties":{"market":"市场代码：HK、US、CN、SG"}},"news":{"title":"资讯","description":"获取证券相关最新新闻，返回 items[]{id, title, source, publish_time, summary, url, related_symbols[]}","properties":{"symbol":"证券代码，例如 `\"700.HK\"`"}},"now":{"title":"当前时间","description":"获取当前 UTC 时间（RFC3339 格式），用于在发起日期相关查询前确认当前日期"},"operating":{"title":"经营业绩","description":"获取公司经营指标（仅港股），返回 items[]{period, metric_name, value, unit}，如客运量、货运量、门店数等","properties":{"symbol":"证券代码，例如 `\"700.HK\"`"}},"option_chain_expiry_date_list":{"title":"期权到期日列表","description":"获取期权链可选到期日列表，返回 expiry_dates[]（yyyy-mm-dd）。配合 option_chain_info_by_date 查询行权价和 Greeks","properties":{"symbol":"证券代码，例如 `\"700.HK\"`"}},"option_chain_info_by_date":{"title":"期权链","description":"获取指定到期日的期权链，返回 strikePrices[]{strike_price, call{symbol, last_done, iv, delta, gamma}, put{symbol, last_done, iv, delta, gamma}}","properties":{"symbol":"证券代码","date":"到期日（`yyyy-mm-dd`）"}},"option_quote":{"title":"期权报价","description":"获取期权行情（最多 500 个），返回各标的：last_done（最新价）, prev_close, open, high, low, volume（成交量）, turnover（成交额）, implied_volatility（隐含波动率）, delta/gamma/theta/vega/rho（Greeks）, open_interest（未平仓量）","properties":{"symbols":"证券代码，例如 `[\"700.HK\", \"AAPL.US\"]`"}},"option_volume":{"title":"期权成交量","description":"获取美股实时期权认购/认沽成交量统计，返回 {call_volume, put_volume, put_call_ratio, call_oi, put_oi} 及活跃合约列表","properties":{"symbol":"标的代码（仅美股），例如 `\"AAPL.US\"`"}},"option_volume_daily":{"title":"期权成交量（日度）","description":"获取美股逐日期权成交量历史，返回 items[]{date, call_volume, put_volume, put_call_vol_ratio, call_oi, put_oi, put_call_oi_ratio}","properties":{"symbol":"标的代码（仅美股），例如 `\"AAPL.US\"`","count":"返回的交易日数量（默认 20）"}},"participants":{"title":"市场参与者","description":"获取港股市场参与者（券商）信息，返回 participants[]{broker_ids[], name_en, name_cn, name_hk}，用于解析经纪商队列数据"},"quote":{"title":"行情快照","description":"获取最新行情快照，返回各标的：last_done（最新价）, prev_close（昨收）, open（开盘价）, high/low（最高/最低价）, volume（成交量）, turnover（成交额）, change_rate, change_value, trade_status, timestamp","properties":{"symbols":"证券代码，例如 `[\"700.HK\", \"AAPL.US\"]`"}},"shareholder":{"title":"机构股东","description":"获取证券的机构股东信息，返回 shareholders[]{institution, shares, ratio, change, change_type, reported_at}","properties":{"symbol":"证券代码，例如 `\"700.HK\"`"}},"sharelist_add":{"title":"加入分享股单","description":"向社区分享股单中添加证券。symbols 为股票代码列表（如 [\"AAPL.US\"]），id 为股单 ID。成功返回更新后的股单。","properties":{"id":"分享股单 ID","symbols":"证券代码，例如 `[\"AAPL.US\", \"700.HK\"]`"}},"sharelist_create":{"title":"创建分享股单","description":"新建社区分享股单，返回创建的股单对象（含 id、name、description）","properties":{"name":"股单名称（若未传 `description`，名称同时作为描述）","description":"股单描述，省略时默认与 `name` 相同"}},"sharelist_delete":{"title":"删除分享股单","description":"按 id 删除自建社区分享股单（已订阅他人的股单不可删除）","properties":{"id":"分享股单 ID"}},"sharelist_detail":{"title":"分享股单详情","description":"按 id 获取社区分享股单详情，返回 {id, name, description, constituents[]{symbol, name, last_done, change_rate}, 订阅状态}","properties":{"id":"分享股单 ID"}},"sharelist_list":{"title":"分享股单列表","description":"列出用户自建及已订阅的社区分享股单，返回 lists[]{id, name, description, symbol_count, is_owner, follower_count}","properties":{"count":"返回数量（默认 20）"}},"sharelist_popular":{"title":"热门分享股单","description":"获取热门/流行社区分享股单，返回 lists[]{id, name, description, symbol_count, follower_count, creator}，按热度排序","properties":{"count":"返回数量（默认 20）"}},"sharelist_remove":{"title":"移出分享股单","description":"从社区分享股单中移除指定证券。symbols 为要移除的股票代码列表，id 为股单 ID。成功返回更新后的股单。","properties":{"id":"分享股单 ID","symbols":"证券代码，例如 `[\"AAPL.US\", \"700.HK\"]`"}},"sharelist_sort":{"title":"分享股单排序","description":"调整社区分享股单中证券的排列顺序（按目标顺序传入 symbols）","properties":{"id":"分享股单 ID","symbols":"证券代码，例如 `[\"AAPL.US\", \"700.HK\"]`"}},"short_positions":{"title":"做空持仓","description":"获取港股或美股的卖空持仓历史（未平仓空头头寸）。市场由 symbol 后缀自动判断。count: 1–100（默认20）。统一返回 data[]{timestamp(RFC3339), short_shares(空头持仓股数), rate(小数比率 如0.009=0.9%), close}。仅美股：avg_daily_vol(日均成交量), days_to_cover(回补天数)。仅港股：balance(港元空头余额)。美股来源：FINRA 双周报。港股来源：HKEX 每日。","properties":{"symbol":"证券代码，如 AAPL.US（美股）或 700.HK（港股），市场由后缀自动判断","count":"返回记录数，1–100，默认 20"}},"static_info":{"title":"证券基础信息","description":"获取证券基础信息，返回各标的：symbol, name_cn, name_en, exchange（如 NASDAQ）, type（如 US_Stock）, lot_size（每手股数）, listed_date, delisted","properties":{"symbols":"证券代码，例如 `[\"700.HK\", \"AAPL.US\"]`"}},"topic":{"title":"讨论列表","description":"获取证券相关的社区讨论，返回 items[]{id, title, author, created_at, like_count, comment_count, content_summary}","properties":{"symbol":"证券代码，例如 `\"700.HK\"`"}},"topic_create":{"title":"发布讨论","description":"发布社区讨论。topic_type=\"post\"（默认）为纯文本；\"article\" 需非空 title，正文支持 Markdown","properties":{"title":"讨论标题。`topic_type=\"article\"` 时必填，`\"post\"` 时可选","body":"讨论正文。`post` 仅支持纯文本，`article` 支持 Markdown","symbols":"相关证券代码，例如 `[\"700.HK\", \"TSLA.US\"]`（最多 10 个）","topic_type":"讨论类型：`post`（默认，纯文本）或 `article`（Markdown，需 `title`）"}},"topic_create_reply":{"title":"发布讨论回复","description":"对讨论发表回复。传入 reply_to_id 表示楼中楼回复，省略则为顶层回复","properties":{"topic_id":"待回复的讨论 ID","body":"回复正文（仅支持纯文本）","reply_to_id":"可选的父回复 ID，用于楼中楼回复，从 `topic_replies` 获取；省略则为顶层回复"}},"topic_detail":{"title":"讨论详情","description":"按 topic_id 获取讨论详情，返回 {id, title, content, author, created_at, like_count, comment_count, symbols[]}","properties":{"topic_id":"讨论 ID"}},"topic_replies":{"title":"讨论回复","description":"分页获取讨论的回复（page 默认 1，size 默认 20，范围 1-50）","properties":{"topic_id":"讨论 ID","page":"页码（从 1 开始，默认 1）","size":"每页条数（1-50，默认 20）"}},"trade_stats":{"title":"成交统计","description":"获取成交统计（主动买/主动卖/中性盘成交量分布），返回 items[]{price_range, buy_volume, sell_volume, neutral_volume}","properties":{"symbol":"证券代码，例如 `\"700.HK\"`"}},"trades":{"title":"最近成交","description":"获取最近逐笔成交（最多 1000 条），返回 trades[]{price, volume, timestamp, trade_type, direction}","properties":{"symbol":"证券代码","count":"返回的最大条数（最多 1000）"}},"trading_days":{"title":"交易日列表","description":"获取指定市场在日期区间内的交易日，返回 trading_days[] 和 half_trading_days[]（格式 yyyy-mm-dd）","properties":{"market":"市场代码：HK、US、CN、SG","start":"起始日期（`yyyy-mm-dd`）","end":"结束日期（`yyyy-mm-dd`）"}},"trading_session":{"title":"交易时段","description":"获取所有市场的交易时段安排，返回 market_sessions[]{market, trade_sessions[]{beg_time, end_time, trade_session_type}}"},"valuation":{"title":"估值","description":"获取估值概览及同业对比，返回 metrics.pe/pb/ps/dividend_yield{current, industry_avg, 5yr_avg, percentile} 及同业对比列表","properties":{"symbol":"证券代码，例如 `\"700.HK\"`"}},"valuation_history":{"title":"估值历史","description":"获取详细估值历史时间序列，返回 history.metrics{pe/pb/ps/dividend_yield}[]{timestamp, value}，用于长期分位分析","properties":{"symbol":"证券代码，例如 `\"700.HK\"`"}},"warrant_issuers":{"title":"权证发行商","description":"获取港股窝轮/牛熊证发行商信息，返回 issuers[]{id, name_en, name_cn}，id 可用于 warrant_list 的发行商筛选"},"warrant_list":{"title":"权证列表","description":"按条件筛选标的的窝轮/牛熊证列表，返回 warrants[]{symbol, name, last_done, change_rate, implied_volatility, expiry_date, strike_price, leverage_ratio, outstanding_ratio}","properties":{"symbol":"标的代码，例如 `\"700.HK\"`","sort_by":"排序字段：`LastDone`、`ChangeRate`、`ChangeValue`、`Volume`、`Turnover`、`ExpiryDate`、`StrikePrice`、`UpperStrikePrice`、`LowerStrikePrice`、`OutstandingQuantity`、`OutstandingRatio`、`Premium`、`ItmOtm`、`ImpliedVolatility`、`Delta`","sort_order":"排序方向：`Ascending`（升序）或 `Descending`（降序）","warrant_type":"按品种筛选（可选）：`Call`（认购证）、`Put`（认沽证）、`Bull`（牛证）、`Bear`（熊证）、`Inline`（界内证）","issuer":"按发行商 ID 筛选（可选），`issuer_id` 来自 `warrant_issuers`","expiry_date":"按到期时段筛选（可选）：`LT_3`（<3 个月）、`Between_3_6`（3-6 个月）、`Between_6_12`（6-12 个月）、`GT_12`（>12 个月）","price_type":"按界内 / 界外筛选（可选）：`In`（界内）、`Out`（界外），仅适用于界内证","status":"按状态筛选（可选）：`Suspend`（停牌）、`PrepareList`（待上市）、`Normal`（正常交易）"}},"warrant_quote":{"title":"权证报价","description":"获取窝轮/牛熊证行情，返回各标的：last_done（最新价）, prev_close, open, high, low, volume（成交量）, turnover（成交额）, implied_volatility（隐含波动率）, delta, leverage_ratio, effective_leverage","properties":{"symbols":"证券代码，例如 `[\"700.HK\", \"AAPL.US\"]`"}},"quant_run":{"title":"量化指标脚本运行","description":"在服务端对历史 K 线数据运行量化指标脚本，以 JSON 形式返回计算的指标/绘图值。周期：1m/5m/15m/30m/1h/day/week/month/year（默认 day）；input 为 JSON 数组，顺序需与脚本中 input.*() 调用一致","properties":{"symbol":"证券代码，`<CODE>.<MARKET>` 格式，例如 `TSLA.US`、`700.HK`","period":"K 线周期：`1m`、`5m`、`15m`、`30m`、`1h`、`day`、`week`、`month`、`year`（默认 `day`）","start":"K 线区间起始日期（YYYY-MM-DD）","end":"K 线区间结束日期（YYYY-MM-DD）","script":"指标脚本源代码","input":"脚本输入参数（JSON 数组字符串），顺序需与脚本中 `input.*()` 调用一致，例如 `\"[14,2.0]\"`"}},"news_search":{"title":"新闻搜索","description":"按关键词搜索新闻文章，返回 news_list[]{id, title, description, source_name, publish_at（RFC3339 时间格式）, score}","properties":{"keyword":"搜索关键词","limit":"最多返回条数（默认 20）"}},"topic_search":{"title":"社区话题搜索","description":"按关键词搜索社区帖子/话题，返回 id、作者、时间及摘要","properties":{"keyword":"搜索关键词","limit":"最多返回条数（默认 20）"}},"financial_statement":{"title":"财务报表","description":"获取证券财务报表（利润表/资产负债表/现金流量表）。kind：IS/BS/CF/ALL（默认）；report：af（年报）/saf（半年报）/qf（季报）/q1/q2/q3","properties":{"symbol":"证券代码，例如 `\"AAPL.US\"`","kind":"报表类型：`IS`（利润表）、`BS`（资产负债表）、`CF`（现金流量表）、`ALL`（全部，默认）","report":"报告期：`af`（年报）、`saf`（半年报）、`qf`（季报）、`q1`/`q2`/`q3`"}},"financial_report_latest":{"title":"最新财务报告","description":"获取证券最新财务报告摘要，返回 {period, revenue, net_income, eps, roe, gross_margin, report_date} 等主要财务指标","properties":{"symbol":"证券代码，例如 `\"AAPL.US\"`"}},"valuation_rank":{"title":"估值分位","description":"获取证券在指定日期区间内每日估值分位（PE/PB/PS/股息率行业百分位）。start/end 格式：yyyymmdd","properties":{"symbol":"证券代码，例如 `\"AAPL.US\"`","start":"起始日期，yyyymmdd 格式（默认近 30 天）","end":"结束日期，yyyymmdd 格式（默认今日）"}},"institution_rating_history":{"title":"机构评级历史","description":"获取机构评级历史，返回 target_history[]{firm, analyst, old_target, new_target, date} 及 evaluate_history[]{firm, old_rating, new_rating, date}","properties":{"symbol":"证券代码，例如 `\"AAPL.US\"`"}},"institution_rating_industry_rank":{"title":"机构评级行业排名","description":"获取同行业各证券的机构评级排名对比，返回 list[]{symbol, name, buy_count, sell_count, consensus_rating, target_price}，支持分页","properties":{"symbol":"证券代码，例如 `\"AAPL.US\"`","page":"页码（默认 1）","size":"每页条数（默认 20）"}},"short_margin":{"title":"卖空保证金","description":"获取当前账户卖空保证金存款明细，返回各空头持仓的 margin_amount、margin_rate、interest_rate、symbol、quantity"},"bank_cards":{"title":"绑定银行卡","description":"列出当前账户绑定的提款银行卡，返回 cards[]{id, bank_name, account_number（脱敏）, currency, status}"},"withdrawals":{"title":"提款记录","description":"获取当前账户提款历史，返回 items[]{id, amount, currency, status, created_at, bank_name, account_number（脱敏）}","properties":{"page":"页码（默认 1）","size":"每页条数（默认 20）"}},"deposits":{"title":"入款记录","description":"获取当前账户入款历史，返回 items[]{id, amount, currency, status, created_at, updated_at}。states：逗号分隔的状态（Pending/Finished/Failed）；currencies：逗号分隔的货币代码","properties":{"page":"页码（默认 1）","size":"每页条数（默认 20）","states":"入款状态过滤（逗号分隔）","currencies":"货币代码过滤（逗号分隔），例如 `\"USD,HKD\"`"}},"ipo_subscriptions":{"title":"IPO 认购列表","description":"列出港股和美股当前处于认购/预申请阶段的 IPO，返回 items[]{symbol, name, market, sub_start_date, sub_end_date, listing_date, issue_price, min_lot_size}"},"ipo_calendar":{"title":"IPO 日历","description":"显示 IPO 日历，返回 items[]{symbol, name, market, sub_start_date, sub_end_date, listing_date, status}，含即将上市及近期已上市的 IPO"},"ipo_listed":{"title":"IPO 已上市列表","description":"列出港股和美股近期已上市的 IPO，返回 items[]{symbol, name, listing_date, issue_price, first_day_close, first_day_return, volume, market}","properties":{"page":"页码（默认 1）","size":"每页条数（默认 20）"}},"ipo_detail":{"title":"IPO 详情","description":"查看 IPO 详情，返回 profile（业务简介）、timeline[]{event, date}、认购资格（eligibility）、pricing_range、lot_size、配股规则","properties":{"symbol":"证券代码，例如 `\"6871.HK\"` 或 `\"ARM.US\"`","market":"市场：`HK` 或 `US`（默认根据代码后缀推断）"}},"ipo_orders":{"title":"IPO 订单列表","description":"列出当前账户的 IPO 订单（有效和历史），返回 orders[]{order_id, symbol, market, quantity, total_amount, status, submitted_at}，可按 symbol/market/status 过滤","properties":{"symbol":"按证券代码过滤，例如 `\"6871.HK\"`","market":"按市场过滤：`HK` 或 `US`","status":"按订单状态过滤","page":"页码（默认 1）","size":"每页条数（默认 20）"}},"ipo_order_detail":{"title":"IPO 订单详情","description":"按 order_id 查看 IPO 订单详细信息，返回 {order_id, symbol, market, quantity, allotted_quantity, total_amount, status, submitted_at}","properties":{"order_id":"IPO 订单 ID"}},"ipo_profit_loss":{"title":"IPO 盈亏","description":"查看账户 IPO 打新盈亏汇总及逐笔明细，返回 {total_cost, total_value, total_return, items[]{symbol, cost, current_value, return_rate}}。period：all/ytd/1y/3y","properties":{"period":"时间范围：`all`（全部，默认）、`ytd`（今年）、`1y`（近一年）、`3y`（近三年）","page":"页码（默认 1）","size":"每页条数（默认 20）"}},"business_segments":{"title":"主营业务分部","description":"获取当期主营业务分部营收占比快照，返回各分部名称、占比、总营收及货币单位","properties":{"symbol":"证券代码，例如 `\"AAPL.US\"`"}},"business_segments_history":{"title":"主营业务分部历史","description":"获取主营业务分部营收历史趋势，返回 historical[]{date, total, currency, business[{name, percent, value}], regionals[{name, percent, value}]}","properties":{"symbol":"证券代码，例如 `\"AAPL.US\"`","report":"报告期：`qf`（季报）、`saf`（中报）、`af`（年报）"}},"institutional_views":{"title":"机构观点月度时序","description":"获取机构评级月度分布时序，返回 months[]{date, buy, outperform, hold, underperform, sell, total}，用于评级趋势分析","properties":{"symbol":"证券代码，例如 `\"AAPL.US\"`"}},"industry_rank":{"title":"行业排行榜","description":"按市场（US/HK/CN/SG）和指标排列行业。indicator：0=领涨 1=今日走势 2=人气 3=市值 4=营收 5=营收增长率 6=净利润 7=净利润增长率。sort_type：0=单级 1=多层。返回 items[]{counter_id（如 BK/US/IN00258）, name, chg, lists[]}，counter_id 可直接传入 industry_peers","properties":{"market":"市场代码：US、HK、CN、SG","indicator":"排列指标：0=领涨、1=今日走势、2=人气、3=市值、4=营收、5=营收增长率、6=净利润、7=净利润增长率","sort_type":"排序类型：0=单级、1=多层"}},"industry_peers":{"title":"行业同业分组树","description":"获取行业分组的层级同业树，接受来自 industry_rank 的 BK counter_id（如 BK/US/IN00258），返回 chain{name, counter_id, stock_num, chg, ytd_chg, next[...]} 和 top{name, market}","properties":{"symbol":"来自 industry_rank 的 BK counter_id，例如 `\"BK/US/IN00258\"`"}},"financial_report_snapshot":{"title":"财报快照","description":"获取财报快照：report_desc（文字摘要）、fo_revenue/fo_ebit/fo_eps（实际 vs 预期，含同比/超预期描述）、fr_* 财务比率（ROE、利润率、资产负债、现金流）。report：qf/saf/af","properties":{"symbol":"证券代码，例如 `\"AAPL.US\"`","report":"报告期：`qf`（季报）、`saf`（半年报）、`af`（年报）"}},"shareholder_top":{"title":"Top20 大股东","description":"获取前20大股东（机构、个人、内部人士）的多期持仓信息。返回 info[]{period, share_holders[]{object_id, name, title, shares_held, percent_shares_held, shares_changed, filing_date}}。用 object_id 传入 shareholder_detail 查看该股东的完整交易记录。","properties":{"symbol":"证券代码，如 AAPL.US"}},"shareholder_detail":{"title":"股东持仓详情","description":"获取指定股东的持仓历史与交易明细。需要来自 shareholder_top 的 object_id。返回 name, owner_source（Company/Institution/Person/Insider）, tradings[]{period, accum_buy, accum_sell, net_buy, trading_details[]{trading_date, trading_type, trading_shares, trading_price, security_type, filing_date}}, holding_summary, holding_periods, trading_periods。注意：机构股东（13F申报）的 trading_details[] 为空，仅个人/内部人（Form 4）有交易明细。","properties":{"symbol":"证券代码，如 AAPL.US","object_id":"股东 object_id，来自 shareholder_top 返回的数据"}},"valuation_comparison":{"title":"多股股票对比","description":"股票估值对比。模式A（单股）：只传 symbol，服务端自动返回该股票及同行业推荐对标股。模式B（多股）：传 symbol 作为主股 + comparison_symbols（逗号分隔，如 'MSFT.US,GOOGL.US'）进行指定股票对比。currency: USD/HKD/CNY。返回 list[]{symbol, name, market_value, price_close, pe, pb, ps, history[]{date, pe, pb, ps}}。","properties":{"symbol":"要比较的证券代码，如 AAPL.US","currency":"货币单位：USD/HKD/CNY","comparison_symbols":"对比标的，逗号分隔，最多 4 个，如 MSFT.US,GOOGL.US"}},"screener_strategy":{"title":"策略详情","description":"运行前查看策略的过滤条件详情。返回 market, filter{filters[]{key, min, max, tech_values}}。如需直接执行策略，使用 screener_search 的 strategy_id 参数。","properties":{"id":"策略 ID，来自 screener_recommend_strategies 或 screener_user_strategies 的 screeners[].id"}},"screener_search":{"title":"策略选股","description":"执行选股查询。market: US|HK|CN|SG（模式B必填；模式A使用策略内置市场）。模式A：传 strategy_id（来自 screener_recommend_strategies）自动运行策略。模式B：conditions=[{\"key\":\"KEY\",\"min\":\"10\",\"max\":\"50\",\"tech_values\":{}},...] 直接透传给 API。 extra_returns=[\"key\",...] 追加展示列；sort_by_key 指定排序字段；sort_order: asc|desc（默认 desc）；page: 从0开始（默认0）。返回 {total, items[]{symbol, name, indicators[]{key, name, value, unit}}}，每条结果默认包含 prevclose、prevchg、marketcap、salesgrowthyoy、pettm、pbmrq、industry 七列。基本面 key：pettm pbmrq roe roa netmargin salesgrowthyoy netincomegrowthyoy marketcap(亿) circulating_marketcap(亿) prevclose prevchg(%) divyld la epsttm netincome(亿) sales(亿) turnover_rate balance(万)。技术 key（tech_values 见 screener_indicators）：macd_day/week rsi_day/week kdj_day/week boll_day/week。注意：key 由平台动态维护，不确定时先调 screener_indicators 确认。","properties":{"market":"市场：US/HK/CN/SG。模式B必填；模式A可不传（策略已内置市场）"}},"screener_indicators":{"title":"选股指标配置","description":"获取全部可用选股指标的 key、单位和默认值域。技术指标（MACD/RSI/KDJ/BOLL）含 tech_values 字段，列出可选参数值（如 macd_day 的 category: goldenfork/deadcross/upzero）。可选 symbol（如 AAPL.US）过滤特定股票的指标。返回 groups[]{group_name, indicators[]{id, key, name, unit, default_range{min,max}, tech_values?{param:[{value,label},...]}}}。","properties":{"symbol":"可选证券代码，用于筛选该股票支持的指标，如 AAPL.US"}},"screener_recommend_strategies":{"title":"平台预设选股策略","description":"获取平台预设的选股策略列表。market: US|HK|CN|SG（默认 US）。返回 strategys[]{id, name, description, market, three_months_chg, risk}。将 id 传入 screener_search 的 strategy_id 可直接运行该策略；传入 screener_strategy 可查看策略的过滤条件。"},"screener_user_strategies":{"title":"我的选股策略","description":"获取当前用户已保存的选股策略列表。market: US|HK|CN|SG（默认 US）。返回 strategys[]{id, name, description, market, three_months_chg, risk}。将 id 传入 screener_search 的 strategy_id 可直接运行该策略；传入 screener_strategy 可查看策略的过滤条件。","properties":{"market":"市场筛选：US/HK/CN/SG，默认 US"}},"top_movers":{"title":"热股异动","description":"获取价格波动超过近20日标准差的异动股票及关联新闻原因。markets: 逗号分隔的 HK/US/CN/SG（不传 = 全市场）。sort: 0=时间 1=涨跌幅 2=热度（默认）。limit: 每页数量（默认20）。next_params: 分页游标，传上一次返回的 next_params 对象。返回 events[]{timestamp(RFC3339), alert_reason, alert_type, stock{symbol, name, change(小数如0.0445=+4.45%), last_done, labels[], intro}}, updated_at, next_params。","properties":{"markets":"市场筛选，逗号分隔，支持 HK/US/CN/SG，不传返回全市场","sort":"排序方式：0=按时间（最新优先）1=按涨跌幅（幅度最大优先）2=按热度（默认）","date":"查询日期，格式 YYYY-MM-DD，不传默认今日","limit":"每页返回数量，默认 20，最多 100","next_params":"翻页游标，将上一次响应的 next_params 原样传入即可获取下一页，首页不传"}},"rank_categories":{"title":"热度榜分类配置","description":"获取热度排行榜的分类配置。返回 first_tags[]{key, name, second_tags[]{key, name, market}}。将 second_tags[].key（如 hot_all-us）传入 rank_list 获取对应榜单。"},"rank_list":{"title":"热度榜股票列表","description":"按热度榜 key 获取股票排名列表。key 来自 rank_categories 的 second_tags[].key（如 hot_all-us、hot_up-hk、trade_heat-us）。market: 从 key 后缀推断或显式传入。size: 返回数量（默认 20）。返回 lists[]{symbol, name, last_done, chg(小数), inflow, market_cap, pre_post_price, pre_post_chg, amplitude, turnover_rate, volume_rate, five_day_chg, ten_day_chg, twenty_day_chg, this_year_chg, industry, intro}, updated_at。","properties":{"key":"榜单 key，来自 rank_categories 的 second_tags[].key，如 hot_all-us、hot_up-hk","market":"市场覆盖：US/HK/CN/SG，默认从 key 后缀推断","size":"返回数量，默认 20","need_article":"是否返回关联新闻，默认 false"}},"short_trades":{"title":"做空成交","description":"获取港股或美股的每日卖空成交量历史。市场由 symbol 后缀自动判断。last_timestamp: Unix 秒（不传则取最新）。page_size: 1–100（默认20）。统一返回 data[]{timestamp(RFC3339), short_vol(当日卖空股数), rate(小数比率 如0.36=36%), close}。仅美股：nasdaq_vol(纳斯达克卖空量), nyse_vol(纽交所卖空量)。仅港股：balance(港元), market_vol(当日市场总成交量)。美股来源：FINRA/NASDAQ。港股来源：HKEX。","properties":{"symbol":"证券代码，如 AAPL.US（美股）或 700.HK（港股），市场由后缀自动判断","last_timestamp":"查询截止时间戳（秒），传当前时间戳获取最新数据","page_size":"每页数量，1–100，默认 20"}},"authenticate":{"title":"授权认证","description":"当你尚未取得长桥凭据时使用（例如客户端无法完成浏览器 OAuth 流程）。用户在 https://open.longbridge.com/connect 生成一次性授权码并粘贴给你，将其作为 `auth_code` 传入。成功后服务端会返回访问令牌，请在后续请求中作为 Bearer 凭据使用，即可解锁全部工具。若你未授权且用户尚未提供授权码，请引导其前往 https://open.longbridge.com/connect 生成。","properties":{"auth_code":"用户在 https://open.longbridge.com/connect 生成的一次性 OAuth 授权码，5 分钟内有效且仅可使用一次。"}}},"scopes":{"Watchlist":{"name":"自选列表","description":"用于管理用户的自选列表（获取/创建/更新/删除），并支持查询指定自选列表包含的标的清单以便展示与维护。"},"Account & Positions":{"name":"账户资产与资金明细查询","description":"提供账户资产与资金相关信息的查询能力，包含基金持仓、股票持仓、账户现金/资金信息，以及资金流水历史明细，用于资产总览、持仓展示与账务对账分析。"},"Trade Order Lookup":{"name":"交易查询","description":"覆盖下单后的订单生命周期与执行能力，包括订单详情与当日/历史订单查询，以及当日/历史成交回报查询，并提供下单前的最大可买数量预估。"},"Trade Execution":{"name":"交易下单","description":"执行交易，下单，撤单等功能，以及定投下单。"},"General":{"name":"通用","description":"通用工具，覆盖市场数据、行情、基本面、提醒、定投、股单、IPO 及社区内容。"}}},"zh-HK":{"$schema":"../tools.schema.json","server_instructions":"長橋 MCP 服務 —— 提供市場數據、交易與金融分析工具。","tools":{"create_watchlist_group":{"title":"新建自選分組","description":"新建自選分組，返回 {id, name}。可選傳入 securities（如 [\"AAPL.US\"]）預填入證券","properties":{"name":"分組名稱","securities":"要加入的證券代碼，例如 `[\"700.HK\", \"AAPL.US\"]`"}},"delete_watchlist_group":{"title":"刪除自選分組","description":"按分組 id 刪除自選分組。purge=true 時同時從其他分組中移除該分組包含的證券","properties":{"id":"自選分組 id","purge":"是否同時從其他分組中清除這些證券"}},"security_list":{"title":"證券列表","description":"獲取指定市場的證券列表。支援市場：US、HK、CN、SG。category 當前僅支援 \"Overnight\"（預設）。page：頁碼（從1開始，預設1）。count：每頁筆數（預設50）。返回 {total, page, count, items[]{symbol, name_en, name_cn}}。","properties":{"market":"市場代碼：US、HK、CN、SG","category":"類別篩選，當前僅支援 \"Overnight\"（預設）","page":"頁碼，從1開始，預設1","count":"每頁返回筆數，預設50"}},"update_watchlist_group":{"title":"更新自選分組","description":"更新自選分組：重命名（name）或修改成員證券（securities + mode: add/remove/replace）","properties":{"id":"自選分組 id","name":"新的分組名稱（可選）","securities":"證券代碼列表（可選）","mode":"證券更新模式：`add`（新增）、`remove`（移除）或 `replace`（替換，預設）"}},"watchlist":{"title":"自選列表","description":"獲取所有自選分組及其包含的證券，返回 groups[]{id, name, securities[]{symbol, name, watched_price, watched_at}}"},"account_balance":{"title":"帳戶餘額","description":"查詢帳戶現金餘額與資產概覽，返回 balances[]{currency, total_cash, max_finance_amount, remaining_finance_amount, risk_level, margin_call}","properties":{"currency":"按幣種代碼篩選（如 `\"USD\"`、`\"HKD\"`），省略則返回所有幣種"}},"cash_flow":{"title":"資金流水","description":"查詢資金流水記錄（出入金、派息等），返回 items[]{transaction_type, amount, currency, balance, created_at, remark}","properties":{"start_at":"起始時間（RFC3339 時間格式）","end_at":"結束時間（RFC3339 時間格式）"}},"fund_positions":{"title":"基金持倉","description":"查詢當前基金持倉，返回 list[].fund_info[]{symbol, symbol_name, currency, holding_units, current_net_asset_value, cost_net_asset_value, net_asset_value_day}"},"margin_ratio":{"title":"保證金比率","description":"查詢標的保證金比率，返回 {im_factor（初始保證金）, mm_factor（維持保證金）, fm_factor（強平保證金）}","properties":{"symbol":"證券代碼，例如 `\"700.HK\"`"}},"profit_analysis":{"title":"盈虧分析","description":"獲取組合盈虧分析彙總。start/end（yyyy-mm-dd）須成對傳入，只傳其中之一會返回空結果","properties":{"start":"起始日期（`yyyy-mm-dd`）。必須與 `end` 成對傳入，只傳其一會返回空結果","end":"結束日期（`yyyy-mm-dd`）。必須與 `start` 成對傳入，只傳其一會返回空結果"}},"profit_analysis_detail":{"title":"盈虧分析明細","description":"獲取指定標的詳細盈虧分析。start/end（yyyy-mm-dd）須成對傳入，只傳其中之一會返回空結果","properties":{"symbol":"證券代碼，例如 `\"700.HK\"`","start":"起始日期（`yyyy-mm-dd`）。必須與 `end` 成對傳入，只傳其一會返回空結果","end":"結束日期（`yyyy-mm-dd`）。必須與 `start` 成對傳入，只傳其一會返回空結果"}},"statement_export":{"title":"對帳單導出","description":"獲取對帳單文件的預簽名下載 URL（file_key 來自 statement_list），返回 {url}，訪問該 URL 即可獲取對帳單 JSON","properties":{"file_key":"來自 `statement_list` 的文件 key，例如 `\"/statement_data/data/.../20975338.json\"`"}},"statement_list":{"title":"對帳單列表","description":"列出可獲取的帳戶對帳單（日報/月報），返回 list[]{id, type, date, status}，用 id 調用 statement_export 下載","properties":{"statement_type":"對帳單類型：`\"daily\"`（預設，日報）或 `\"monthly\"`（月報）","start_date":"起始日期（`yyyy-mm-dd`）。`daily` 預設 30 天前，`monthly` 預設 12 個月前","limit":"返回條數。`daily` 預設 30，`monthly` 預設 12"}},"stock_positions":{"title":"股票持倉","description":"查詢所有渠道下的當前股票持倉，返回 list[].stock_info[]{symbol, symbol_name, quantity, available_quantity, currency, cost_price, market}"},"dca_history":{"title":"定投執行歷史","description":"按 plan_id 查詢定投計劃的扣款執行歷史，返回 executions[]{date, quantity, amount, price, status, order_id}","properties":{"plan_id":"定投計劃 ID","page":"頁碼（預設 1）","limit":"每頁條數（預設 20）"}},"dca_list":{"title":"定投計劃列表","description":"列出定投計劃，返回 plans[]{plan_id, symbol, amount, currency, frequency, status, next_execution_date}","properties":{"status":"按狀態篩選：`Active`、`Suspended`、`Finished`，省略則返回全部","symbol":"按證券篩選，例如 `\"AAPL.US\"`，省略則返回全部計劃","page":"頁碼（預設 1）","limit":"每頁條數（預設 20）"}},"dca_stats":{"title":"定投統計","description":"獲取定投投資統計彙總，返回 {total_invested, total_value, total_return, return_rate, plan_count, items[]{symbol, invested, value, return_rate}}","properties":{"symbol":"按證券篩選，例如 `\"AAPL.US\"`，省略則返回所有計劃的合計統計"}},"estimate_max_purchase_quantity":{"title":"最大可買估算","description":"估算指定證券的最大可買/可賣數量，返回 {cash_max_qty, margin_max_qty}","properties":{"symbol":"證券代碼","side":"買賣方向：`Buy`（買入）或 `Sell`（賣出）","order_type":"委託類型：`LO`（限價單）/ `ELO`（增強限價單）/ `MO`（市價單）/ `AO`（競價單）/ `ALO`（競價限價單）","price":"委託價格（限價類委託需要）"}},"history_executions":{"title":"歷史成交","description":"查詢指定日期區間內的歷史成交記錄，返回 executions[]{order_id, symbol, side, quantity, price, trade_done_at}","properties":{"symbol":"按證券篩選（可選）","start_at":"起始時間（RFC3339 時間格式）","end_at":"結束時間（RFC3339 時間格式）"}},"history_orders":{"title":"歷史委託","description":"查詢指定日期區間內的歷史委託（不含當日），返回 orders[]{order_id, symbol, side, status, quantity, price, submitted_at}","properties":{"symbol":"按證券篩選（可選）","start_at":"起始時間（RFC3339 時間格式）","end_at":"結束時間（RFC3339 時間格式）"}},"order_detail":{"title":"委託詳情","description":"查詢單個委託詳情，返回 {order_id, symbol, status, side, order_type, quantity, price, executed_quantity, executed_price, submitted_at, time_in_force, msg}","properties":{"order_id":"委託單號"}},"today_executions":{"title":"當日成交","description":"查詢當日成交（filled），返回 executions[]{order_id, symbol, side, quantity, price, trade_done_at}。可按 symbol 或 order_id 篩選","properties":{"symbol":"按證券篩選，例如 `\"700.HK\"`","order_id":"按指定委託單號篩選"}},"today_orders":{"title":"當日委託","description":"查詢當日委託，返回 orders[]{order_id, symbol, side, order_type, status, quantity, price, submitted_at, executed_quantity, executed_price}","properties":{"symbol":"按證券篩選，例如 `\"700.HK\"`，省略則返回當日全部委託"}},"cancel_order":{"title":"撤銷委託","description":"按 order_id 撤銷未成交的委託，成功返回 \"order cancelled\"；已成交或已撤銷則報錯","properties":{"order_id":"委託單號"}},"dca_create":{"title":"創建定投計劃","description":"創建定投（DCA）計劃。frequency：Daily/Weekly/Monthly；週頻對應 day_of_week（Mon–Fri），月頻對應 day_of_month（1-28）","properties":{"symbol":"證券代碼，例如 `\"AAPL.US\"`","amount":"每期投入金額，例如 `\"100\"`","frequency":"定投頻率：`Daily`（每日）、`Weekly`（每週）、`Monthly`（每月）","day_of_week":"週頻時指定的週幾：`Mon`、`Tue`、`Wed`、`Thu`、`Fri`","day_of_month":"月頻時指定的日期（1-28）","allow_margin":"是否允許使用融資（預設 `false`）"}},"dca_pause":{"title":"暫停定投計劃","description":"按 plan_id 暫停定投計劃，計劃停止執行直至恢復。如需臨時暫停請使用此接口（永久終止用 dca_stop）","properties":{"plan_id":"定投計劃 ID"}},"dca_resume":{"title":"恢復定投計劃","description":"按 plan_id 恢復已暫停的定投計劃，按原有週期繼續自動執行","properties":{"plan_id":"定投計劃 ID"}},"dca_stop":{"title":"終止定投計劃","description":"按 plan_id 永久終止定投計劃，操作不可撤銷。如需臨時暫停請使用 dca_pause","properties":{"plan_id":"定投計劃 ID"}},"dca_update":{"title":"更新定投計劃","description":"按 plan_id 更新定投計劃，可修改 amount、frequency（Daily/Weekly/Monthly）、day_of_week（Mon-Fri）或 day_of_month（1-28）","properties":{"plan_id":"待更新的定投計劃 ID","amount":"新的每期投入金額","frequency":"新的定投頻率：`Daily`、`Weekly`、`Monthly`","day_of_week":"週頻時指定的週幾：`Mon`、`Tue`、`Wed`、`Thu`、`Fri`","day_of_month":"月頻時指定的日期（1-28）","allow_margin":"是否允許使用融資"}},"replace_order":{"title":"修改委託","description":"修改未成交委託的數量、價格、觸發價或追蹤止損參數，成功返回 \"order replaced\"","properties":{"order_id":"委託單號","quantity":"新的委託數量","price":"新的委託價格","trigger_price":"新的觸發價","limit_offset":"新的限價偏移量","trailing_amount":"新的追蹤止損金額","trailing_percent":"新的追蹤止損百分比"}},"submit_order":{"title":"提交委託","description":"提交買賣委託。order_type：LO（限價）/ ELO（港股增強限價）/ MO（市價）/ AO（港股競價）/ ALO（港股競價限價）/ ODD（港股碎股）/ LIT（觸價限價）/ MIT（觸價市價）/ TSLPAMT（按金額追蹤止損）/ TSLPPCT（按百分比追蹤止損）/ SLO（港股特別限價）；side：Buy/Sell；time_in_force：Day/GTC/GTD","properties":{"symbol":"證券代碼","order_type":"委託類型（港股全部支援；美股僅支援 `LO` / `MO` / `LIT` / `MIT` / `TSLPAMT` / `TSLPPCT`）：<br>- `LO`（限價單）：需 `submitted_price`<br>- `ELO`（增強限價單，港股）：需 `submitted_price`<br>- `MO`（市價單）：無需價格<br>- `AO`（競價單，港股）：以競價價成交，無需價格<br>- `ALO`（競價限價單，港股）：需 `submitted_price`<br>- `ODD`（碎股單，港股）：需 `submitted_price`，用於非標準手數<br>- `LIT`（觸價限價）：需 `submitted_price` 與 `trigger_price`，行情觸及觸發價時激活<br>- `MIT`（觸價市價）：僅需 `trigger_price`，觸及後按市價成交<br>- `TSLPAMT`（按金額追蹤止損限價）：需 `trailing_amount` 與 `limit_offset`<br>- `TSLPPCT`（按百分比追蹤止損限價）：需 `trailing_percent`（0-1）與 `limit_offset`<br>- `SLO`（特別限價單，港股）：需 `submitted_price`，提交後不可改單","side":"買賣方向：`Buy`（買入）或 `Sell`（賣出）","submitted_quantity":"委託數量","time_in_force":"委託有效期：`Day`（當日有效）、`GTC`（撤單前有效）、`GTD`（指定日期前有效，需 `expire_date`）","submitted_price":"委託限價。`LO` / `ELO` / `ALO` / `ODD` / `LIT` / `SLO` 必填","trigger_price":"觸發價。`LIT` / `MIT` / `TSLPAMT` / `TSLPPCT` 必填","limit_offset":"相對追蹤止損價的限價偏移量。`TSLPAMT` / `TSLPPCT` 必填","trailing_amount":"追蹤金額（絕對價格距離），`TSLPAMT` 必填","trailing_percent":"追蹤百分比（小數形式，例如 `0.05` 表示 5%），`TSLPPCT` 必填","expire_date":"到期日期（`yyyy-mm-dd`），`time_in_force=GTD` 時必填","outside_rth":"盤前盤後設置：`RTH_ONLY`（僅常規交易時段）、`ANY_TIME`（含盤前盤後任意時段）、`OVERNIGHT`（夜盤，僅美股）","remark":"委託備註（最多 255 字符）"}},"ah_premium":{"title":"A/H 溢價","description":"獲取 A/H 股溢價歷史 K 線數據，返回 items[]{timestamp, open, high, low, close}，表示溢價百分比","properties":{"symbol":"證券代碼，例如 `\"700.HK\"`","period":"K 線週期：`1m`、`5m`、`15m`、`30m`、`60m`、`day`（預設）、`week`、`month`、`year`","count":"返回的 K 線數量（預設 100）"}},"ah_premium_intraday":{"title":"A/H 溢價（分時）","description":"獲取 A/H 股溢價當日分時數據，返回 items[]{timestamp, premium_rate}，逐分鐘展示溢價百分比","properties":{"symbol":"證券代碼，例如 `\"700.HK\"`"}},"alert_add":{"title":"新增價格預警","description":"新增價格預警，返回已創建的預警對象。condition：price_rise/price_fall（絕對價格）或 percent_rise/percent_fall（升跌幅）；frequency：once/daily/every","properties":{"symbol":"證券代碼，例如 `\"700.HK\"`","condition":"預警條件：`price_rise`、`price_fall`、`percent_rise`、`percent_fall`","price":"閾值價格或百分比數值","frequency":"預警頻率：`once`（觸發一次後停用）、`daily`（每日一次）、`every`（每次滿足條件都觸發）"}},"alert_delete":{"title":"刪除價格預警","description":"按 alert_id（來自 alert_list 的數字字符串）刪除價格預警","properties":{"alert_id":"預警指標 id"}},"alert_disable":{"title":"停用價格預警","description":"按 alert_id 停用價格預警，返回 {alert_id, enabled: false}","properties":{"alert_id":"預警指標 id"}},"alert_enable":{"title":"啟用價格預警","description":"按 alert_id 啟用價格預警，返回 {alert_id, enabled: true}","properties":{"alert_id":"預警指標 id"}},"alert_list":{"title":"價格預警列表","description":"獲取所有已配置的價格預警，返回 lists[]{counter_id, indicators[]{id, condition, price, frequency, enabled, triggered_at}}"},"anomaly":{"title":"市場異動","description":"獲取市場異動提醒（價量異常變動）。market: HK/US/CN/SG。symbol: 可選，篩選特定股票。count: 返回數量（預設 50，最多 100）。返回 changes[]{symbol, name, change_rate, volume, ...}, all_off。","properties":{"market":"市場代碼：HK、US、CN、SG","symbol":"可選證券代碼，如 AAPL.US 或 700.HK，篩選特定股票的異動","count":"返回數量，預設 50，最多 100"}},"broker_holding":{"title":"券商持倉","description":"獲取指定證券的主要券商持倉數據，返回 items[]{broker_name, holding_quantity, holding_change, holding_ratio}","properties":{"symbol":"證券代碼，例如 `\"700.HK\"`","period":"時間窗口：`rct_1`（近 1 日，預設）、`rct_5`（近 5 日）、`rct_20`（近 20 日）、`rct_60`（近 60 日）"}},"broker_holding_daily":{"title":"券商持倉（日度）","description":"獲取指定券商（broker_id）對某證券的逐日持倉歷史，返回 items[]{date, holding_quantity, holding_change, holding_ratio}","properties":{"symbol":"證券代碼，例如 `\"700.HK\"`","broker_id":"券商參與者編號"}},"broker_holding_detail":{"title":"券商持倉明細","description":"獲取完整的券商持倉明細列表，返回 items[]{broker_id, broker_name, holding_quantity, holding_ratio, holding_change, date}","properties":{"symbol":"證券代碼，例如 `\"700.HK\"`"}},"brokers":{"title":"經紀商隊列","description":"獲取港股經紀商買賣盤隊列（僅港股），返回 bid_brokers/ask_brokers[]{position, broker_ids}，通過 participants 工具將 broker_id 映射為名稱","properties":{"symbol":"證券代碼，例如 `\"700.HK\"`"}},"calc_indexes":{"title":"指標計算","description":"批量計算證券的行情/財務指標（PE、PB、股息率、最新價、換手率等），傳入 symbols 和 indexes 列表，返回各標的的指標值","properties":{"symbols":"證券代碼，例如 `[\"700.HK\", \"AAPL.US\"]`","indexes":"待計算指標：`LastDone`、`ChangeValue`、`ChangeRate`、`Volume`、`Turnover`、`YtdChangeRate`、`TurnoverRate`、`TotalMarketValue`、`CapitalFlow`、`Amplitude`、`VolumeRatio`、`PeTtmRatio`、`PbRatio`、`DividendRatioTtm`、`FiveDayChangeRate`、`TenDayChangeRate`、`HalfYearChangeRate`、`FiveMinutesChangeRate`、`ExpiryDate`、`StrikePrice`、`UpperStrikePrice`、`LowerStrikePrice`、`OutstandingQty`、`OutstandingRatio`、`Premium`、`ItmOtm`、`ImpliedVolatility`、`WarrantDelta`、`CallPrice`、`ToCallPrice`、`EffectiveLeverage`、`LeverageRatio`、`ConversionRatio`、`BalancePoint`、`OpenInterest`、`Delta`、`Gamma`、`Theta`、`Vega`、`Rho`"}},"candlesticks":{"title":"K 線數據","description":"獲取 K 線數據（OHLCV）。period：1m/5m/15m/30m/60m/day/week/month/year；trade_sessions：intraday（預設，僅正常時段）或 all（含盤前盤後）","properties":{"symbol":"證券代碼","period":"K 線週期：`1m`、`5m`、`15m`、`30m`、`60m`、`day`、`week`、`month`、`year`","count":"K 線數量（最多 1000）","forward_adjust":"是否對拆股 / 派息進行前復權","trade_sessions":"交易時段：`intraday`（僅常規時段）或 `all`（含盤前盤後）"}},"capital_distribution":{"title":"資金分佈","description":"獲取資金分佈（大/中/小單流入流出），返回 {timestamp, capital_in{large, medium, small}, capital_out{large, medium, small}}","properties":{"symbol":"證券代碼，例如 `\"700.HK\"`"}},"capital_flow":{"title":"資金流向","description":"獲取資金淨流入/流出當日時間序列，返回 items[]{timestamp, inflow, outflow, net_flow}","properties":{"symbol":"證券代碼，例如 `\"700.HK\"`"}},"company":{"title":"公司概況","description":"獲取公司概況，返回 name、description、employees、CEO、founded_year、website、exchange、industry、market_cap 等信息","properties":{"symbol":"證券代碼，例如 `\"700.HK\"`"}},"consensus":{"title":"一致預期","description":"獲取分析師一致預期，返回 items[]{period, revenue_estimate, eps_estimate, net_income_estimate, analyst_count, last_updated}","properties":{"symbol":"證券代碼，例如 `\"700.HK\"`"}},"constituent":{"title":"指數成份股 / ETF 資產分佈","description":"獲取指數成份股或 ETF 資產分佈。指數（如 HSI.HK、.DJI.US）返回 constituents[]{symbol, name, last_done（最新價）, change_rate, market_cap, weight}。ETF（如 QQQ.US、2800.HK）返回資產分佈 info[]，按 asset_type 分組：1=Holdings（前十大持倉，含 code、symbol、holding_detail）/ 2=Regional（地區分佈）/ 3=AssetClass（資產類別，如股票/債券/現金）/ 4=Industry（行業分佈）。每組含 report_date 與 lists[]{name, position_ratio, name_locales}；Holdings 組額外含 code、symbol 及 holding_detail{industry_name, index_name, holding_type_name}","properties":{"symbol":"指數或 ETF 代碼，例如 `\"HSI.HK\"`、`\"QQQ.US\"`"}},"corp_action":{"title":"公司行動","description":"獲取公司行動信息（拆股、回購、更名等），返回 items[]{action_type, effective_date, ratio, description}","properties":{"symbol":"證券代碼，例如 `\"700.HK\"`"}},"dca_check":{"title":"檢查定投支援","description":"檢查證券是否支援定投（DCA），返回 items[]{symbol, support_dca, reason}","properties":{"symbols":"待檢查的證券代碼，例如 `[\"AAPL.US\", \"TSLA.US\"]`"}},"depth":{"title":"盤口深度","description":"獲取買賣盤深度（最多 10 檔），返回 {bids[]{position, price, volume, order_num}, asks[]{position, price, volume, order_num}}","properties":{"symbol":"證券代碼，例如 `\"700.HK\"`"}},"dividend":{"title":"派息歷史","description":"獲取證券的派息歷史，返回 items[]{ex_date（除權日）, pay_date（派發日）, record_date, dividend_type, amount, currency, status}","properties":{"symbol":"證券代碼，例如 `\"700.HK\"`"}},"dividend_detail":{"title":"派息明細","description":"獲取詳細派息分紅方案，返回 details[]{period, cash_dividend, stock_dividend, record_date, ex_date, pay_date, currency}","properties":{"symbol":"證券代碼，例如 `\"700.HK\"`"}},"exchange_rate":{"title":"匯率","description":"獲取全部支援幣種的匯率，返回 list[]{from_currency, to_currency, rate, timestamp}，覆蓋 USD/HKD/CNY/SGD 等"},"executive":{"title":"高管與董事","description":"獲取公司高管及董事會成員信息，返回 members[]{name, title, appointed_date, age, biography, compensation}","properties":{"symbol":"證券代碼，例如 `\"700.HK\"`"}},"filings":{"title":"監管公告","description":"獲取監管文件公告（8-K、10-Q、10-K 等），返回 items[]{id, title, type, language, filing_date, url}","properties":{"symbol":"證券代碼，例如 `\"700.HK\"`"}},"finance_calendar":{"title":"財經日曆","description":"獲取財經日曆事件。category：report（財報+業績）/ dividend（除息日與派發日）/ split（拆股/反拆）/ ipo / macrodata（CPI、非農、議息等）/ closed（休市日）；market：HK/US/CN/SG/JP/UK/DE/AU。日期範圍建議不超過 2 週；如需查詢更長時間段，請拆分為多次呼叫以避免資料截斷。","properties":{"market":"市場代碼：HK、US、CN、SG，省略則查詢所有市場","start":"起始日期（`yyyy-mm-dd`）","end":"結束日期（`yyyy-mm-dd`）","category":"事件類別：<br>- `financial`：業績 / 財報公告<br>- `report`：財報披露排期<br>- `dividend`：除息日與派發日<br>- `ipo`：IPO 上市日期<br>- `macrodata`：宏觀數據發佈（GDP、CPI 等）<br>- `closed`：市場休市 / 停牌日期"}},"financial_report":{"title":"財務報表","description":"獲取財務報告（損益表/資產負債表/現金流量表）。kind：IS/BS/CF/ALL；report_type：af（年報）/saf（半年報）/q1/q2/q3/qf（季報全量）","properties":{"symbol":"證券代碼，例如 `\"AAPL.US\"`","kind":"報表種類：`IS`（損益表）、`BS`（資產負債表）、`CF`（現金流量表）、`ALL`（預設全部）","report_type":"報告期：`af`（年度）、`saf`（半年度）、`q1` / `q2` / `q3`（季度）、`qf`（季度全量）"}},"forecast_eps":{"title":"EPS 預測","description":"獲取 EPS 預測及分析師預期歷史，返回 items[]{forecast_start_date, forecast_end_date, eps_estimate, eps_actual, surprise_pct, analyst_count}","properties":{"symbol":"證券代碼，例如 `\"700.HK\"`"}},"fund_holder":{"title":"持倉基金","description":"獲取持有指定證券的基金及 ETF，返回 fund_holders[]{fund_name, fund_symbol, shares, ratio, change, reported_at}","properties":{"symbol":"證券代碼，例如 `\"700.HK\"`"}},"history_candlesticks_by_date":{"title":"歷史 K 線（按日期）","description":"按日期區間獲取歷史 K 線（OHLCV）數據。period：1m/5m/15m/30m/60m/day/week/month/year","properties":{"symbol":"證券代碼","period":"K 線週期：`1m`、`5m`、`15m`、`30m`、`60m`、`day`、`week`、`month`、`year`","forward_adjust":"是否對拆股 / 派息進行前復權","start":"起始日期（`yyyy-mm-dd`），可選","end":"結束日期（`yyyy-mm-dd`），可選","trade_sessions":"交易時段：`intraday`（僅常規時段）或 `all`（含盤前盤後）"}},"history_candlesticks_by_offset":{"title":"歷史 K 線（按偏移）","description":"以參考時間為錨點按偏移量獲取歷史 K 線（OHLCV）數據。period：1m/5m/15m/30m/60m/day/week/month/year","properties":{"symbol":"證券代碼","period":"K 線週期：`1m`、`5m`、`15m`、`30m`、`60m`、`day`、`week`、`month`、`year`","forward_adjust":"是否對拆股 / 派息進行前復權","forward":"查詢方向：`true` 向後（向未來），`false` 向前（向過去）","time":"參考時間（`yyyy-mm-ddTHH:MM:SS`），省略則以最新時間為起點","count":"K 線數量（最多 1000）","trade_sessions":"交易時段：`intraday`（僅常規時段）或 `all`（含盤前盤後）"}},"history_market_temperature":{"title":"歷史市場溫度","description":"獲取市場情緒溫度歷史時間序列，返回 {type, list[]{temperature, description, valuation, sentiment, timestamp}}","properties":{"market":"市場代碼：HK、US、CN、SG","start":"起始日期（`yyyy-mm-dd`）","end":"結束日期（`yyyy-mm-dd`）"}},"industry_valuation":{"title":"行業估值","description":"獲取同行業可比公司估值對比，返回 list[]{symbol, name, pe, pb, ps, dividend_yield, history[]{date, pe, pb}}","properties":{"symbol":"證券代碼，例如 `\"700.HK\"`"}},"industry_valuation_dist":{"title":"行業估值分佈","description":"獲取行業 PE/PB/PS 估值分佈，返回 distributions{pe/pb/ps}{min, p25, median, p75, max, current_percentile}，顯示個股在行業中的分位","properties":{"symbol":"證券代碼，例如 `\"700.HK\"`"}},"institution_rating":{"title":"機構評級","description":"獲取機構評級彙總，返回 analyst{buy, outperform, hold, underperform, sell 家數, target_price, consensus_rating} 及評級列表","properties":{"symbol":"證券代碼，例如 `\"700.HK\"`"}},"institution_rating_detail":{"title":"機構評級明細","description":"獲取機構評級與目標價歷史明細，返回 target.list[]{analyst, firm, rating, target_price, timestamp}","properties":{"symbol":"證券代碼，例如 `\"700.HK\"`"}},"intraday":{"title":"分時數據","description":"獲取分時（逐分鐘）價格/成交量數據。trade_sessions：intraday（預設，僅正常時段）或 all（含盤前盤後）","properties":{"symbol":"證券代碼，例如 `\"700.HK\"`","trade_sessions":"包含的交易時段：`intraday`（預設，僅常規時段）或 `all`（含盤前盤後）"}},"invest_relation":{"title":"投資者關係","description":"獲取投資者關係事件與公告，返回 items[]{title, event_type, event_date, url, description}","properties":{"symbol":"證券代碼，例如 `\"700.HK\"`"}},"market_status":{"title":"市場狀態","description":"獲取所有市場當前交易狀態，返回 market_time[]{market, trade_status（Trading/Closed/Mid-Day Break/Pre-Market/Post-Market/Overnight 等）, timestamp}"},"market_temperature":{"title":"市場溫度","description":"獲取當前市場情緒溫度，返回 {temperature（0-100）, description, valuation（0-100）, sentiment（0-100）, timestamp}","properties":{"market":"市場代碼：HK、US、CN、SG"}},"news":{"title":"資訊","description":"獲取證券相關最新新聞，返回 items[]{id, title, source, publish_time, summary, url, related_symbols[]}","properties":{"symbol":"證券代碼，例如 `\"700.HK\"`"}},"now":{"title":"當前時間","description":"獲取當前 UTC 時間（RFC3339 時間格式），用於在發起日期相關查詢前確認當前日期"},"operating":{"title":"經營業績","description":"獲取公司經營指標（僅港股），返回 items[]{period, metric_name, value, unit}，如客運量、貨運量、門店數等","properties":{"symbol":"證券代碼，例如 `\"700.HK\"`"}},"option_chain_expiry_date_list":{"title":"期權到期日列表","description":"獲取期權鏈可選到期日列表，返回 expiry_dates[]（yyyy-mm-dd）。配合 option_chain_info_by_date 查詢行權價和 Greeks","properties":{"symbol":"證券代碼，例如 `\"700.HK\"`"}},"option_chain_info_by_date":{"title":"期權鏈","description":"獲取指定到期日的期權鏈，返回 strikePrices[]{strike_price, call{symbol, last_done, iv, delta, gamma}, put{symbol, last_done, iv, delta, gamma}}","properties":{"symbol":"證券代碼","date":"到期日（`yyyy-mm-dd`）"}},"option_quote":{"title":"期權報價","description":"獲取期權行情（最多 500 個），返回各標的：last_done（最新價）, prev_close, open, high, low, volume（成交量）, turnover（成交額）, implied_volatility（隱含波動率）, delta/gamma/theta/vega/rho（Greeks）, open_interest（未平倉量）","properties":{"symbols":"證券代碼，例如 `[\"700.HK\", \"AAPL.US\"]`"}},"option_volume":{"title":"期權成交量","description":"獲取美股實時期權認購/認沽成交量統計，返回 {call_volume, put_volume, put_call_ratio, call_oi, put_oi} 及活躍合約列表","properties":{"symbol":"標的代碼（僅美股），例如 `\"AAPL.US\"`"}},"option_volume_daily":{"title":"期權成交量（日度）","description":"獲取美股逐日期權成交量歷史，返回 items[]{date, call_volume, put_volume, put_call_vol_ratio, call_oi, put_oi, put_call_oi_ratio}","properties":{"symbol":"標的代碼（僅美股），例如 `\"AAPL.US\"`","count":"返回的交易日數量（預設 20）"}},"participants":{"title":"市場參與者","description":"獲取港股市場參與者（券商）信息，返回 participants[]{broker_ids[], name_en, name_cn, name_hk}，用於解析經紀商隊列數據"},"quote":{"title":"行情快照","description":"獲取最新行情快照，返回各標的：last_done（最新價）, prev_close（昨收）, open（開盤價）, high/low（最高/最低價）, volume（成交量）, turnover（成交額）, change_rate, change_value, trade_status, timestamp","properties":{"symbols":"證券代碼，例如 `[\"700.HK\", \"AAPL.US\"]`"}},"shareholder":{"title":"機構股東","description":"獲取證券的機構股東信息，返回 shareholders[]{institution, shares, ratio, change, change_type, reported_at}","properties":{"symbol":"證券代碼，例如 `\"700.HK\"`"}},"sharelist_add":{"title":"加入分享股單","description":"向社區分享股單中添加證券。symbols 為股票代碼列表（如 [\"AAPL.US\"]），id 為股單 ID。成功返回更新後的股單。","properties":{"id":"分享股單 ID","symbols":"證券代碼，例如 `[\"AAPL.US\", \"700.HK\"]`"}},"sharelist_create":{"title":"創建分享股單","description":"新建社區分享股單，返回創建的股單對象（含 id、name、description）","properties":{"name":"股單名稱（若未傳 `description`，名稱同時作為描述）","description":"股單描述，省略時預設與 `name` 相同"}},"sharelist_delete":{"title":"刪除分享股單","description":"按 id 刪除自建社區分享股單（已訂閱他人的股單不可刪除）","properties":{"id":"分享股單 ID"}},"sharelist_detail":{"title":"分享股單詳情","description":"按 id 獲取社區分享股單詳情，返回 {id, name, description, constituents[]{symbol, name, last_done, change_rate}, 訂閱狀態}","properties":{"id":"分享股單 ID"}},"sharelist_list":{"title":"分享股單列表","description":"列出用戶自建及已訂閱的社區分享股單，返回 lists[]{id, name, description, symbol_count, is_owner, follower_count}","properties":{"count":"返回數量（預設 20）"}},"sharelist_popular":{"title":"熱門分享股單","description":"獲取熱門/流行社區分享股單，返回 lists[]{id, name, description, symbol_count, follower_count, creator}，按熱度排序","properties":{"count":"返回數量（預設 20）"}},"sharelist_remove":{"title":"移出分享股單","description":"從社區分享股單中移除指定證券。symbols 為要移除的股票代碼列表，id 為股單 ID。成功返回更新後的股單。","properties":{"id":"分享股單 ID","symbols":"證券代碼，例如 `[\"AAPL.US\", \"700.HK\"]`"}},"sharelist_sort":{"title":"分享股單排序","description":"調整社區分享股單中證券的排列順序（按目標順序傳入 symbols）","properties":{"id":"分享股單 ID","symbols":"證券代碼，例如 `[\"AAPL.US\", \"700.HK\"]`"}},"short_positions":{"title":"做空持倉","description":"獲取港股或美股的賣空持倉歷史（未平倉空頭頭寸）。市場由 symbol 後綴自動判斷。count: 1–100（預設20）。統一返回 data[]{timestamp(RFC3339), short_shares(空頭持倉股數), rate(小數比率 如0.009=0.9%), close}。僅美股：avg_daily_vol(日均成交量), days_to_cover(回補天數)。僅港股：balance(港元空頭餘額)。美股來源：FINRA 雙週報。港股來源：HKEX 每日。","properties":{"symbol":"證券代碼，如 AAPL.US（美股）或 700.HK（港股），市場由後綴自動判斷","count":"返回記錄數，1–100，預設 20"}},"static_info":{"title":"證券基礎信息","description":"獲取證券基礎信息，返回各標的：symbol, name_cn, name_en, exchange（如 NASDAQ）, type（如 US_Stock）, lot_size（每手股數）, listed_date, delisted","properties":{"symbols":"證券代碼，例如 `[\"700.HK\", \"AAPL.US\"]`"}},"topic":{"title":"討論列表","description":"獲取證券相關的社區討論，返回 items[]{id, title, author, created_at, like_count, comment_count, content_summary}","properties":{"symbol":"證券代碼，例如 `\"700.HK\"`"}},"topic_create":{"title":"發佈討論","description":"發佈社區討論。topic_type=\"post\"（預設）為純文本；\"article\" 需非空 title，正文支援 Markdown","properties":{"title":"討論標題。`topic_type=\"article\"` 時必填，`\"post\"` 時可選","body":"討論正文。`post` 僅支援純文本，`article` 支援 Markdown","symbols":"相關證券代碼，例如 `[\"700.HK\", \"TSLA.US\"]`（最多 10 個）","topic_type":"討論類型：`post`（預設，純文本）或 `article`（Markdown，需 `title`）"}},"topic_create_reply":{"title":"發佈討論回覆","description":"對討論發表回覆。傳入 reply_to_id 表示樓中樓回覆，省略則為頂層回覆","properties":{"topic_id":"待回覆的討論 ID","body":"回覆正文（僅支援純文本）","reply_to_id":"可選的父回覆 ID，用於樓中樓回覆，從 `topic_replies` 獲取；省略則為頂層回覆"}},"topic_detail":{"title":"討論詳情","description":"按 topic_id 獲取討論詳情，返回 {id, title, content, author, created_at, like_count, comment_count, symbols[]}","properties":{"topic_id":"討論 ID"}},"topic_replies":{"title":"討論回覆","description":"分頁獲取討論的回覆（page 預設 1，size 預設 20，範圍 1-50）","properties":{"topic_id":"討論 ID","page":"頁碼（從 1 開始，預設 1）","size":"每頁條數（1-50，預設 20）"}},"trade_stats":{"title":"成交統計","description":"獲取成交統計（主動買/主動賣/中性盤成交量分佈），返回 items[]{price_range, buy_volume, sell_volume, neutral_volume}","properties":{"symbol":"證券代碼，例如 `\"700.HK\"`"}},"trades":{"title":"最近成交","description":"獲取最近逐筆成交（最多 1000 條），返回 trades[]{price, volume, timestamp, trade_type, direction}","properties":{"symbol":"證券代碼","count":"返回的最大條數（最多 1000）"}},"trading_days":{"title":"交易日列表","description":"獲取指定市場在日期區間內的交易日，返回 trading_days[] 和 half_trading_days[]（格式 yyyy-mm-dd）","properties":{"market":"市場代碼：HK、US、CN、SG","start":"起始日期（`yyyy-mm-dd`）","end":"結束日期（`yyyy-mm-dd`）"}},"trading_session":{"title":"交易時段","description":"獲取所有市場的交易時段安排，返回 market_sessions[]{market, trade_sessions[]{beg_time, end_time, trade_session_type}}"},"valuation":{"title":"估值","description":"獲取估值概覽及同業對比，返回 metrics.pe/pb/ps/dividend_yield{current, industry_avg, 5yr_avg, percentile} 及同業對比列表","properties":{"symbol":"證券代碼，例如 `\"700.HK\"`"}},"valuation_history":{"title":"估值歷史","description":"獲取詳細估值歷史時間序列，返回 history.metrics{pe/pb/ps/dividend_yield}[]{timestamp, value}，用於長期分位分析","properties":{"symbol":"證券代碼，例如 `\"700.HK\"`"}},"warrant_issuers":{"title":"權證發行商","description":"獲取港股窩輪/牛熊證發行商信息，返回 issuers[]{id, name_en, name_cn}，id 可用於 warrant_list 的發行商篩選"},"warrant_list":{"title":"權證列表","description":"按條件篩選標的的窩輪/牛熊證列表，返回 warrants[]{symbol, name, last_done, change_rate, implied_volatility, expiry_date, strike_price, leverage_ratio, outstanding_ratio}","properties":{"symbol":"標的代碼，例如 `\"700.HK\"`","sort_by":"排序字段：`LastDone`、`ChangeRate`、`ChangeValue`、`Volume`、`Turnover`、`ExpiryDate`、`StrikePrice`、`UpperStrikePrice`、`LowerStrikePrice`、`OutstandingQuantity`、`OutstandingRatio`、`Premium`、`ItmOtm`、`ImpliedVolatility`、`Delta`","sort_order":"排序方向：`Ascending`（升序）或 `Descending`（降序）","warrant_type":"按品種篩選（可選）：`Call`（認購證）、`Put`（認沽證）、`Bull`（牛證）、`Bear`（熊證）、`Inline`（界內證）","issuer":"按發行商 ID 篩選（可選），`issuer_id` 來自 `warrant_issuers`","expiry_date":"按到期時段篩選（可選）：`LT_3`（<3 個月）、`Between_3_6`（3-6 個月）、`Between_6_12`（6-12 個月）、`GT_12`（>12 個月）","price_type":"按界內 / 界外篩選（可選）：`In`（界內）、`Out`（界外），僅適用於界內證","status":"按狀態篩選（可選）：`Suspend`（停牌）、`PrepareList`（待上市）、`Normal`（正常交易）"}},"warrant_quote":{"title":"權證報價","description":"獲取窩輪/牛熊證行情，返回各標的：last_done（最新價）, prev_close, open, high, low, volume（成交量）, turnover（成交額）, implied_volatility（隱含波動率）, delta, leverage_ratio, effective_leverage","properties":{"symbols":"證券代碼，例如 `[\"700.HK\", \"AAPL.US\"]`"}},"quant_run":{"title":"量化指標腳本運行","description":"在服務端對歷史 K 線數據運行量化指標腳本，以 JSON 形式返回計算的指標/繪圖值。週期：1m/5m/15m/30m/1h/day/week/month/year（預設 day）；input 為 JSON 數組，順序需與腳本中 input.*() 調用一致","properties":{"symbol":"證券代碼，`<CODE>.<MARKET>` 格式，例如 `TSLA.US`、`700.HK`","period":"K 線週期：`1m`、`5m`、`15m`、`30m`、`1h`、`day`、`week`、`month`、`year`（預設 `day`）","start":"K 線區間起始日期（YYYY-MM-DD）","end":"K 線區間結束日期（YYYY-MM-DD）","script":"指標腳本源代碼","input":"腳本輸入參數（JSON 數組字符串），順序需與腳本中 `input.*()` 調用一致，例如 `\"[14,2.0]\"`"}},"news_search":{"title":"新聞搜尋","description":"按關鍵詞搜尋新聞文章，返回 news_list[]{id, title, description, source_name, publish_at（RFC3339 時間格式）, score}","properties":{"keyword":"搜尋關鍵詞","limit":"最多返回條數（預設 20）"}},"topic_search":{"title":"社區話題搜尋","description":"按關鍵詞搜尋社區帖子/話題，返回 id、作者、時間及摘要","properties":{"keyword":"搜尋關鍵詞","limit":"最多返回條數（預設 20）"}},"financial_statement":{"title":"財務報表","description":"獲取證券財務報表（損益表/資產負債表/現金流量表）。kind：IS/BS/CF/ALL（預設）；report：af（年報）/saf（半年報）/qf（季報）/q1/q2/q3","properties":{"symbol":"證券代碼，例如 `\"AAPL.US\"`","kind":"報表類型：`IS`（損益表）、`BS`（資產負債表）、`CF`（現金流量表）、`ALL`（全部，預設）","report":"報告期：`af`（年報）、`saf`（半年報）、`qf`（季報）、`q1`/`q2`/`q3`"}},"financial_report_latest":{"title":"最新財務報告","description":"獲取證券最新財務報告摘要，返回 {period, revenue, net_income, eps, roe, gross_margin, report_date} 等主要財務指標","properties":{"symbol":"證券代碼，例如 `\"AAPL.US\"`"}},"valuation_rank":{"title":"估值分位","description":"獲取證券在指定日期區間內每日估值分位（PE/PB/PS/股息率行業百分位）。start/end 格式：yyyymmdd","properties":{"symbol":"證券代碼，例如 `\"AAPL.US\"`","start":"起始日期，yyyymmdd 格式（預設近 30 天）","end":"結束日期，yyyymmdd 格式（預設今日）"}},"institution_rating_history":{"title":"機構評級歷史","description":"獲取機構評級歷史，返回 target_history[]{firm, analyst, old_target, new_target, date} 及 evaluate_history[]{firm, old_rating, new_rating, date}","properties":{"symbol":"證券代碼，例如 `\"AAPL.US\"`"}},"institution_rating_industry_rank":{"title":"機構評級行業排名","description":"獲取同行業各證券的機構評級排名對比，返回 list[]{symbol, name, buy_count, sell_count, consensus_rating, target_price}，支援分頁","properties":{"symbol":"證券代碼，例如 `\"AAPL.US\"`","page":"頁碼（預設 1）","size":"每頁條數（預設 20）"}},"short_margin":{"title":"沽空保證金","description":"獲取當前帳戶沽空保證金存款明細，返回各空頭持倉的 margin_amount、margin_rate、interest_rate、symbol、quantity"},"bank_cards":{"title":"綁定銀行卡","description":"列出當前帳戶綁定的提款銀行卡，返回 cards[]{id, bank_name, account_number（脫敏）, currency, status}"},"withdrawals":{"title":"提款記錄","description":"獲取當前帳戶提款歷史，返回 items[]{id, amount, currency, status, created_at, bank_name, account_number（脫敏）}","properties":{"page":"頁碼（預設 1）","size":"每頁條數（預設 20）"}},"deposits":{"title":"入款記錄","description":"獲取當前帳戶入款歷史，返回 items[]{id, amount, currency, status, created_at, updated_at}。states：逗號分隔的狀態（Pending/Finished/Failed）；currencies：逗號分隔的貨幣代碼","properties":{"page":"頁碼（預設 1）","size":"每頁條數（預設 20）","states":"入款狀態過濾（逗號分隔）","currencies":"貨幣代碼過濾（逗號分隔），例如 `\"USD,HKD\"`"}},"ipo_subscriptions":{"title":"IPO 認購列表","description":"列出港股和美股當前處於認購/預申請階段的 IPO，返回 items[]{symbol, name, market, sub_start_date, sub_end_date, listing_date, issue_price, min_lot_size}"},"ipo_calendar":{"title":"IPO 日曆","description":"顯示 IPO 日曆，返回 items[]{symbol, name, market, sub_start_date, sub_end_date, listing_date, status}，含即將上市及近期已上市的 IPO"},"ipo_listed":{"title":"IPO 已上市列表","description":"列出港股和美股近期已上市的 IPO，返回 items[]{symbol, name, listing_date, issue_price, first_day_close, first_day_return, volume, market}","properties":{"page":"頁碼（預設 1）","size":"每頁條數（預設 20）"}},"ipo_detail":{"title":"IPO 詳情","description":"查看 IPO 詳情，返回 profile（業務簡介）、timeline[]{event, date}、認購資格（eligibility）、pricing_range、lot_size、配股規則","properties":{"symbol":"證券代碼，例如 `\"6871.HK\"` 或 `\"ARM.US\"`","market":"市場：`HK` 或 `US`（預設根據代碼後綴推斷）"}},"ipo_orders":{"title":"IPO 訂單列表","description":"列出當前帳戶的 IPO 訂單（有效和歷史），返回 orders[]{order_id, symbol, market, quantity, total_amount, status, submitted_at}，可按 symbol/market/status 過濾","properties":{"symbol":"按證券代碼過濾，例如 `\"6871.HK\"`","market":"按市場過濾：`HK` 或 `US`","status":"按訂單狀態過濾","page":"頁碼（預設 1）","size":"每頁條數（預設 20）"}},"ipo_order_detail":{"title":"IPO 訂單詳情","description":"按 order_id 查看 IPO 訂單詳細信息，返回 {order_id, symbol, market, quantity, allotted_quantity, total_amount, status, submitted_at}","properties":{"order_id":"IPO 訂單 ID"}},"ipo_profit_loss":{"title":"IPO 盈虧","description":"查看帳戶 IPO 打新盈虧彙總及逐筆明細，返回 {total_cost, total_value, total_return, items[]{symbol, cost, current_value, return_rate}}。period：all/ytd/1y/3y","properties":{"period":"時間範圍：`all`（全部，預設）、`ytd`（今年）、`1y`（近一年）、`3y`（近三年）","page":"頁碼（預設 1）","size":"每頁條數（預設 20）"}},"business_segments":{"title":"主營業務分部","description":"獲取當期主營業務分部營收佔比快照，返回各分部名稱、佔比、總營收及貨幣單位","properties":{"symbol":"證券代碼，例如 `\"AAPL.US\"`"}},"business_segments_history":{"title":"主營業務分部歷史","description":"獲取主營業務分部營收歷史趨勢，返回 historical[]{date, total, currency, business[{name, percent, value}], regionals[{name, percent, value}]}","properties":{"symbol":"證券代碼，例如 `\"AAPL.US\"`","report":"報告期：`qf`（季報）、`saf`（中報）、`af`（年報）"}},"institutional_views":{"title":"機構觀點月度時序","description":"獲取機構評級月度分佈時序，返回 months[]{date, buy, outperform, hold, underperform, sell, total}，用於評級趨勢分析","properties":{"symbol":"證券代碼，例如 `\"AAPL.US\"`"}},"industry_rank":{"title":"行業排行榜","description":"按市場（US/HK/CN/SG）和指標排列行業。indicator：0=領漲 1=今日走勢 2=人氣 3=市值 4=營收 5=營收增長率 6=淨利潤 7=淨利潤增長率。sort_type：0=單級 1=多層。返回 items[]{counter_id（如 BK/US/IN00258）, name, chg, lists[]}，counter_id 可直接傳入 industry_peers","properties":{"market":"市場代碼：US、HK、CN、SG","indicator":"排列指標：0=領漲、1=今日走勢、2=人氣、3=市值、4=營收、5=營收增長率、6=淨利潤、7=淨利潤增長率","sort_type":"排序類型：0=單級、1=多層"}},"industry_peers":{"title":"行業同業分組樹","description":"獲取行業分組的層級同業樹，接受來自 industry_rank 的 BK counter_id（如 BK/US/IN00258），返回 chain{name, counter_id, stock_num, chg, ytd_chg, next[...]} 和 top{name, market}","properties":{"symbol":"來自 industry_rank 的 BK counter_id，例如 `\"BK/US/IN00258\"`"}},"financial_report_snapshot":{"title":"財報快照","description":"獲取財報快照：report_desc（文字摘要）、fo_revenue/fo_ebit/fo_eps（實際 vs 預期，含同比/超預期描述）、fr_* 財務比率（ROE、利潤率、資產負債、現金流）。report：qf/saf/af","properties":{"symbol":"證券代碼，例如 `\"AAPL.US\"`","report":"報告期：`qf`（季報）、`saf`（半年報）、`af`（年報）"}},"shareholder_top":{"title":"Top20 大股東","description":"獲取前20大股東（機構、個人、內部人士）的多期持倉資訊。返回 info[]{period, share_holders[]{object_id, name, title, shares_held, percent_shares_held, shares_changed, filing_date}}。用 object_id 傳入 shareholder_detail 查看該股東的完整交易記錄。","properties":{"symbol":"證券代碼，如 AAPL.US"}},"shareholder_detail":{"title":"股東持倉詳情","description":"獲取指定股東的持倉歷史與交易明細。需要來自 shareholder_top 的 object_id。返回 name, owner_source（Company/Institution/Person/Insider）, tradings[]{period, accum_buy, accum_sell, net_buy, trading_details[]{trading_date, trading_type, trading_shares, trading_price, security_type, filing_date}}, holding_summary, holding_periods, trading_periods。注意：機構股東（13F申報）的 trading_details[] 為空，僅個人/內部人（Form 4）有交易明細。","properties":{"symbol":"證券代碼，如 AAPL.US","object_id":"股東 object_id，來自 shareholder_top 返回的數據"}},"valuation_comparison":{"title":"多股股票對比","description":"股票估值對比。模式A（單股）：只傳 symbol，服務端自動返回該股票及同行業推薦對標股。模式B（多股）：傳 symbol 作為主股 + comparison_symbols（逗號分隔，如 'MSFT.US,GOOGL.US'）進行指定股票對比。currency: USD/HKD/CNY。返回 list[]{symbol, name, market_value, price_close, pe, pb, ps, history[]{date, pe, pb, ps}}。","properties":{"symbol":"要比較的證券代碼，如 AAPL.US","currency":"貨幣單位：USD/HKD/CNY","comparison_symbols":"對比標的，逗號分隔，最多 4 個，如 MSFT.US,GOOGL.US"}},"screener_strategy":{"title":"策略詳情","description":"執行前查看策略的篩選條件詳情。返回 market, filter{filters[]{key, min, max, tech_values}}。如需直接執行策略，使用 screener_search 的 strategy_id 參數。","properties":{"id":"策略 ID，來自 screener_recommend_strategies 或 screener_user_strategies 的 screeners[].id"}},"screener_search":{"title":"策略選股","description":"執行選股查詢。market: US|HK|CN|SG（模式B必填；模式A使用策略內建市場）。模式A：傳 strategy_id（來自 screener_recommend_strategies）自動執行策略。模式B：conditions=[{\"key\":\"KEY\",\"min\":\"10\",\"max\":\"50\",\"tech_values\":{}},...] 直接透傳給 API。 extra_returns=[\"key\",...] 追加展示欄；sort_by_key 指定排序欄位；sort_order: asc|desc（預設 desc）；page: 從0開始（預設0）。返回 {total, items[]{symbol, name, indicators[]{key, name, value, unit}}}，每條結果預設包含 prevclose、prevchg、marketcap、salesgrowthyoy、pettm、pbmrq、industry 七欄。基本面 key：pettm pbmrq roe roa netmargin salesgrowthyoy netincomegrowthyoy marketcap(億) circulating_marketcap(億) prevclose prevchg(%) divyld la epsttm netincome(億) sales(億) turnover_rate balance(萬)。技術 key（tech_values 見 screener_indicators）：macd_day/week rsi_day/week kdj_day/week boll_day/week。注意：key 由平台動態維護，不確定時先調 screener_indicators 確認。","properties":{"market":"市場：US/HK/CN/SG。模式B必填；模式A可不傳（策略已內建市場）"}},"screener_indicators":{"title":"選股指標配置","description":"獲取全部可用選股指標的 key、單位和預設值域。技術指標（MACD/RSI/KDJ/BOLL）含 tech_values 欄位，列出可選參數值（如 macd_day 的 category: goldenfork/deadcross/upzero）。可選 symbol（如 AAPL.US）過濾特定股票的指標。返回 groups[]{group_name, indicators[]{id, key, name, unit, default_range{min,max}, tech_values?{param:[{value,label},...]}}}。","properties":{"symbol":"可選證券代碼，用於篩選該股票支援的指標，如 AAPL.US"}},"screener_recommend_strategies":{"title":"平台預設選股策略","description":"獲取平台預設的選股策略列表。market: US|HK|CN|SG（預設 US）。返回 strategys[]{id, name, description, market, three_months_chg, risk}。將 id 傳入 screener_search 的 strategy_id 可直接執行該策略；傳入 screener_strategy 可查看策略的篩選條件。"},"screener_user_strategies":{"title":"我的選股策略","description":"獲取當前用戶已儲存的選股策略列表。market: US|HK|CN|SG（預設 US）。返回 strategys[]{id, name, description, market, three_months_chg, risk}。將 id 傳入 screener_search 的 strategy_id 可直接執行該策略；傳入 screener_strategy 可查看策略的篩選條件。","properties":{"market":"市場篩選：US/HK/CN/SG，預設 US"}},"top_movers":{"title":"熱股異動","description":"獲取價格波動超過近20日標準差的異動股票及關聯新聞原因。markets: 逗號分隔的 HK/US/CN/SG（不傳 = 全市場）。sort: 0=時間 1=漲跌幅 2=熱度（預設）。limit: 每頁數量（預設20）。next_params: 分頁游標，傳上一次返回的 next_params 物件。返回 events[]{timestamp(RFC3339), alert_reason, alert_type, stock{symbol, name, change(小數如0.0445=+4.45%), last_done, labels[], intro}}, updated_at, next_params。","properties":{"markets":"市場篩選，逗號分隔，支援 HK/US/CN/SG，不傳返回全市場","sort":"排序方式：0=按時間（最新優先）1=按漲跌幅（幅度最大優先）2=按熱度（預設）","date":"查詢日期，格式 YYYY-MM-DD，不傳預設今日","limit":"每頁返回數量，預設 20，最多 100","next_params":"翻頁游標，將上一次回應的 next_params 原樣傳入即可取得下一頁，首頁不傳"}},"rank_categories":{"title":"熱度榜分類配置","description":"獲取熱度排行榜的分類配置。返回 first_tags[]{key, name, second_tags[]{key, name, market}}。將 second_tags[].key（如 hot_all-us）傳入 rank_list 獲取對應榜單。"},"rank_list":{"title":"熱度榜股票列表","description":"按熱度榜 key 獲取股票排名列表。key 來自 rank_categories 的 second_tags[].key（如 hot_all-us、hot_up-hk、trade_heat-us）。market: 從 key 後綴推斷或顯式傳入。size: 返回數量（預設 20）。返回 lists[]{symbol, name, last_done, chg(小數), inflow, market_cap, pre_post_price, pre_post_chg, amplitude, turnover_rate, volume_rate, five_day_chg, ten_day_chg, twenty_day_chg, this_year_chg, industry, intro}, updated_at。","properties":{"key":"榜單 key，來自 rank_categories 的 second_tags[].key，如 hot_all-us、hot_up-hk","market":"市場覆蓋：US/HK/CN/SG，預設從 key 後綴推斷","size":"返回數量，預設 20","need_article":"是否返回關聯新聞，預設 false"}},"short_trades":{"title":"做空成交","description":"獲取港股或美股的每日賣空成交量歷史。市場由 symbol 後綴自動判斷。last_timestamp: Unix 秒（不傳則取最新）。page_size: 1–100（預設20）。統一返回 data[]{timestamp(RFC3339), short_vol(當日賣空股數), rate(小數比率 如0.36=36%), close}。僅美股：nasdaq_vol(納斯達克賣空量), nyse_vol(紐交所賣空量)。僅港股：balance(港元), market_vol(當日市場總成交量)。美股來源：FINRA/NASDAQ。港股來源：HKEX。","properties":{"symbol":"證券代碼，如 AAPL.US（美股）或 700.HK（港股），市場由後綴自動判斷","last_timestamp":"查詢截止時間戳（秒），傳當前時間戳取得最新數據","page_size":"每頁數量，1–100，預設 20"}},"authenticate":{"title":"授權認證","description":"當你尚未取得長橋憑據時使用（例如客戶端無法完成瀏覽器 OAuth 流程）。用戶在 https://open.longbridge.com/connect 生成一次性授權碼並貼給你，將其作為 `auth_code` 傳入。成功後服務端會返回存取權杖，請在後續請求中作為 Bearer 憑據使用，即可解鎖全部工具。若你未授權且用戶尚未提供授權碼，請引導其前往 https://open.longbridge.com/connect 生成。","properties":{"auth_code":"用戶在 https://open.longbridge.com/connect 生成的一次性 OAuth 授權碼，5 分鐘內有效且僅可使用一次。"}}},"scopes":{"Watchlist":{"name":"自選列表","description":"用於管理用戶的自選列表（獲取/創建/更新/刪除），並支持查詢指定自選列表包含的標的清單以便展示與維護。"},"Account & Positions":{"name":"賬戶資產與資金明細查詢","description":"提供賬戶資產與資金相關信息的查詢能力，包含基金持倉、股票持倉、賬戶現金/資金信息，以及資金流水歷史明細，用於資產總覽、持倉展示與賬務對賬分析。"},"Trade Order Lookup":{"name":"交易查詢","description":"覆蓋下單後的訂單生命週期與執行能力，包括訂單詳情與當日/歷史訂單查詢，以及當日/歷史成交回報查詢，並提供下單前的最大可買數量預估。"},"Trade Execution":{"name":"交易下單","description":"執行交易，下單，撤單等功能，以及定投下單。"},"General":{"name":"通用","description":"通用工具，覆蓋市場數據、行情、基本面、提醒、定投、股單、IPO 及社區內容。"}}}}}