trusted-market-bridge

name: trusted-market-bridge description: Fetch A-share Hong Kong and US market evidence via Longbridge for market data price action FX ADR/AH premium filings news consensus financial snapshots and market-screen signals.

Trusted Market Bridge

Fetch A-share, Hong Kong, and US market evidence via Longbridge for market data, price action, valuation, FX, ADR/AH premium, filings, news, consensus, financial snapshots, and market-screen signals.

This is an operations bridge, not a research conclusion skill. It can be invoked directly by the user or used implicitly by research skills that need a clean provider boundary.

In the global source policy, this bridge is the default trusted third-party layer for market-snapshot fields after topic-local evidence cache / financial-data and before generic web fallback. It does not replace primary public for disclosure-fact truth.

What This Skill Is For

Use this skill when the task is to retrieve or normalize provider-derived market evidence for:

• latest market quote / price data
• price action / recent range / simple kline summary
• valuation snapshot
• FX snapshot for currency normalization
• ADR / A-share / H-share premium framing
• recent news
• filing index / recent disclosures
• analyst consensus / revisions / target-price context
• financial snapshot for quick reference
• market-screen signals for candidate generation and anomaly-driven prioritization

This skill is intentionally narrow. It does not write a thesis, rank ideas, build a model, or infer company truth from provider pages.

Supported Markets

This bridge supports the following markets (Longbridge MCP coverage, verified 2026-06-09):

If the requested symbol belongs to Japan, Korea, or any unsupported market:

• state that Longbridge is not covered for that market
• return unsupported_market
• fall back to the existing buy-side source and fallback logic unless the user explicitly asked for longbridge_only

Supported Domains

This bridge may return evidence for:

• market_quote — latest OHLCV + turnover + trade status
• price_action — candlestick series + intraday minute data
• kline_snapshot — quick K-line range summary
• valuation_snapshot — PE/PB/PS/dividend_yield + industry percentile
• valuation_peer — valuation comparison with auto-selected peers
• valuation_history — multi-year PE/PB/PS time series
• valuation_rank — daily valuation percentile rank
• industry_valuation — peer valuation comparison
• industry_valuation_dist — PE/PB/PS distribution (min/p25/median/p75/max)
• fx_snapshot — all USD-cross exchange rates
• adr_ah_premium — A+H premium (dual-listed stocks only)
• news — latest news articles with titles + URLs
• filings — SEC/exchange filing index with file URLs
• consensus — analyst revenue/EBIT/EPS estimates with actual vs estimate comparison
• forecast_eps — EPS forecast trend over time
• financial_statement — structured IS/BS/CF with multi-year YoY
• financial_snapshot — latest key indicators (revenue/net_profit/ROE/EPS)
• financial_snapshot_detail — actual vs estimate + ratios + cash flow
• business_segments — geographic/segment revenue breakdown
• company_profile — name/employees/CEO/industry/profile
• calendar — earnings/dividend/split/IPO/macro/closed events
• shareholder — institutional + insider shareholders
• shareholder_top — top 20 shareholders
• executive — management team with bios
• institution_rating — analyst ratings + target prices
• institutional_views — monthly rating distribution
• broker_holding — HKEX CCASS broker flow (HK only)
• dividend — dividend history
• operating — operating metrics (HK only)
• market_temperature — market sentiment 0-100
• market_status — trading session status
• top_movers — price events with news context
• screener — stock screening
• industry_peers — sub-sector peer tree

MCP Tool Mapping

Longbridge is accessed via MCP (145 tools, 15 categories). All tools verified 2026-06-09 against live data (AAPL.US + 700.HK).

Core Market Data

Valuation

Fundamentals & Financials

Note: financial_report_latest is the best first stop for a quick financial snapshot. Use financial_report_snapshot when you need estimate comparison + cash flow detail. Use financial_statement only when you need multi-year structured line-item tables.

Consensus & Estimates

News, Filings & Events

Shareholders & Management

Market-Specific

Screen & Search

Symbol Format

Installation

# Claude Code (global)
claude mcp add --transport http --scope user longbridge https://openapi.longbridge.com/mcp
# Then /mcp → longbridge → Authenticate

# Codex
codex mcp add longbridge --url https://openapi.longbridge.com/mcp
codex mcp login longbridge

It must reject unsupported requests such as:

• business facts
• segment truth
• undisclosed drivers
• management intent
• full actuals source-of-record extraction

Evidence Contract

Bridge-derived evidence must preserve:

• provider: Longbridge Securities
• symbol
• market
• as-of timestamp
• domain
• fallback reason when fallback is used

Use clickable short anchors in the form [LBG1](https://longbridge.example.com/quote/NVDA.US) in body tables or bullets. The body anchor target must exactly match the ## Resources target. Expand full metadata only once in the final ## Resources section.

Example:

| Field | Value | Ev |
|---|---|---|
| Price | 125.40 | [LBG1](https://...) |

## Resources
- [LBG1](https://...) = Longbridge Securities | market_quote | NVDA.US | as-of 2026-05-25 09:30 ET

Do not rewrite bridge-derived evidence as company disclosed, management said, or other primary-public wording unless the underlying source is actually a primary filing or disclosure and that distinction is preserved.

Input Shape

When using this skill, normalize the request to:

Interpretation:

• auto: use Longbridge if the market and domain are supported; otherwise return an honest fallback signal
• longbridge_only: do not fall back silently; fail explicitly if unsupported or unavailable
• off: do not use Longbridge

Output Shape

Return an evidence bundle, not a research artifact:

## Bridge Status
- status: ok / unavailable / scope_restricted / ambiguous / unsupported_market / stale / not_allowed
- provider: Longbridge Securities
- symbol: [symbol]
- market: [market]
- as-of: [timestamp]

## Evidence
- [domain-specific facts with [LBG1](https://longbridge.example.com/quote/NVDA.US) anchors]

## Resources
- [LBG1](https://longbridge.example.com/quote/NVDA.US) = Longbridge Securities | market_quote | NVDA.US | as-of 2026-05-25 09:30 ET | fallback reason: topic-local market snapshot cache unavailable

When unsupported or unavailable, say so plainly and include the reason. When the bridge is scope_restricted, the default user-facing behavior is web fallback plus a short fallback note in ## Resources, not a hard stop.

FX And Premium Boundary

fx_snapshot and adr_ah_premium are allowed only as:

• currency normalization context
• ADR-vs-local or A/H premium framing
• cross-market valuation context
• quick premium / discount snapshots with explicit as-of timestamps

They are not:

• authoritative proof of share-class equivalence
• a substitute for verified ADR ratio or conversion mechanics
• a substitute for borrow, bid-ask, settlement, capital-control, or accounting-basis sourcing

If a downstream task needs verified share-class mapping, conversion truth, borrow detail, or access constraints, keep using the existing buy-side source hierarchy and preserve [来源待补] when no reliable source is available.

Financial Snapshot Boundary

financial_snapshot is allowed only as:

• quick reference
• latest summary check
• filing-adjacent fast context
• fallback assist for research skills

It is not:

• a substitute for financial-data
• a source-of-record actuals pack
• a basis for full three-statement modeling

If a downstream task needs source-tracked actuals or model-grade field mapping, route to financial-data, 3-statement-model, dcf-model, or model-update.

Market Screen Boundary

market_screen is allowed only as:

• candidate generation
• anomaly-aware prioritization
• market-screen convenience output for downstream ranking or triage

It is not:

• a thesis
• business-fact truth
• proof of company exposure without separate sourcing

Downstream consumers may use market_screen to narrow the funnel or explain why a candidate entered the screen, but they must still source business linkage, disclosure facts, and company-specific truth separately.

Routing

Data routing is managed by the unified capability matrix, not by per-skill routing tables.

• Runtime routing: python .scripts/shared/route.py <TICKER> <capability> — resolves capability → full source chain
• Capability registry: .references/routing/capability-matrix.json — single source of truth for all source priorities
• Section-level mapping: .references/routing/bridge-skill-map.md — which skill section needs which capability

This bridge is one source (longbridge_mcp) in the matrix. Its capabilities, coverage markets, and tool mapping are defined in the matrix under sources.longbridge_mcp and tool_map.longbridge_mcp.

Failure Discipline

Honest failures are mandatory:

• unsupported_market
• not_allowed
• unavailable
• scope_restricted
• ambiguous
• stale

Do not pretend Longbridge covers a market or field that it does not cover. In auto mode, scope_restricted should normally degrade into the existing web / internet market-source fallback and be disclosed at the end via fallback reason: Longbridge scope_restricted for [domain]; used internet market source.