Source profileQuality 90/100

HKUDS/Vibe-Trading/agent/src/skills/adr-hshare/SKILL.md

adr-hshare

ADR/H-share/A-share cross-listing premium analysis — track pricing gaps between US-listed ADRs, HK-listed H-shares, and A-shares for arbitrage signals, dual-listing valuation, and delisting risk assessment.

Source repository stars
29,558
Declared platforms
0
Static risk flags
0
Last source update
2026-08-04
Source checked
2026-08-04

Decision brief

What it does—and where it fits

ADR/H-share/A-share cross-listing premium analysis — track pricing gaps between US-listed ADRs, HK-listed H-shares, and A-shares for arbitrage signals, dual-listing valuation, and delisting risk assessment.

Best for

    Not for

    • Tasks that require unconfirmed production actions or broad system permissions.
    • Environments where the pinned source and install steps cannot be inspected.

    Compatibility matrix

    Platform support, with evidence labels

    PlatformStatusEvidenceWhat to check
    CodexNot declaredNo explicit evidencePortability before use
    Claude CodeNot declaredNo explicit evidencePortability before use
    CursorNot declaredNo explicit evidencePortability before use
    Gemini CLINot declaredNo explicit evidencePortability before use
    Open the compatibility checker

    Installation

    Inspect first. Install second.

    The source command is displayed only when detected. A safe inspection prompt is always available so your agent can explain every action before execution.

    Source-detected install commandSource
    npx skills add https://github.com/HKUDS/Vibe-Trading --skill "agent/src/skills/adr-hshare"
    Safe inspection promptEditorial

    Inspect the Agent Skill "adr-hshare" from https://github.com/HKUDS/Vibe-Trading/blob/3a752d5a8ed088633040893de1cc9e6dc712596f/agent/src/skills/adr-hshare/SKILL.md at commit 3a752d5a8ed088633040893de1cc9e6dc712596f. List every install step, command, network request, credential, file read/write, external action, and rollback step. Explain whether it fits my task. Do not install or execute anything until I approve.

    Workflow

    What the source asks the agent to do

    1. 01

      4. Delisting Risk Assessment

      HFCAA (Holding Foreign Companies Accountable Act) framework:

      HFCAA (Holding Foreign Companies Accountable Act) framework:Since 2022, PCAOB gained access to audit workpapers of Chinese companies. Key risks:Delisting risk indicators: python delistingriskfactors = { "pcaobstatus": "inspected", inspected / pending / blocked "secidentifiedyears": 0, 0, 1, 2, or 3 (3 = delist) "hashklisting": True, Backup listing reduces impac…
    2. 02

      Core Concepts

      AH Premium = (A-share price / H-share price in CNY terms - 1) × 100%

      AH Premium = (A-share price / H-share price in CNY terms - 1) × 100%python def calculateahpremium(apricecny, hpricehkd, usdcny, usdhkd): """Calculate AH premium for a dual-listed stock.""" hpricecny = hpricehkd (usdcny / usdhkd) Convert HKD to CNY ahpremium = (apricecny / hpricecny - 1)…
    3. 03

      1. Cross-Listing Structures

      Review the “1. Cross-Listing Structures” section in the pinned source before continuing.

      Review and apply the “1. Cross-Listing Structures” source section.
    4. 04

      2. AH Premium Analysis

      AH Premium = (A-share price / H-share price in CNY terms - 1) × 100%

      AH Premium = (A-share price / H-share price in CNY terms - 1) × 100%python def calculateahpremium(apricecny, hpricehkd, usdcny, usdhkd): """Calculate AH premium for a dual-listed stock.""" hpricecny = hpricehkd (usdcny / usdhkd) Convert HKD to CNY ahpremium = (apricecny / hpricecny - 1)…
    5. 05

      Example: PetroChina

      Review the “Example: PetroChina” section in the pinned source before continuing.

      Review and apply the “Example: PetroChina” source section.

    Permission review

    Static risk signals and limitations

    No configured static risk pattern was detected

    This is not proof of safety. Runtime behavior, indirect dependencies, and hidden external systems are outside the static scan.

    Evidence record

    Why each signal appears

    EvidenceSourceComputedTestedEditorial
    SignalValueEvidence typeMeaning
    Quality score90/100ComputedDocumentation, specificity, maintenance, and trust rules
    Repository stars29,558SourceRepository attention, not individual Skill quality
    Compatibility0 platformsSourceDeclared in the catalog source record
    Usage guideautomated source guideEditorialGenerated or reviewed according to the visible evidence level

    Pinned source

    Provenance and original SKILL.md

    Repository
    HKUDS/Vibe-Trading
    Skill path
    agent/src/skills/adr-hshare/SKILL.md
    Commit
    3a752d5a8ed088633040893de1cc9e6dc712596f
    License
    MIT
    Collected
    2026-08-04
    Default branch
    main
    View the original SKILL.md

    ADR / H-Share / A-Share Cross-Listing Analysis

    Overview

    Many Chinese companies are listed on multiple exchanges — A-shares in Shanghai/Shenzhen, H-shares in Hong Kong, and ADRs in the US. Pricing gaps between these listings create arbitrage opportunities and reveal market-specific sentiment differences. This skill provides frameworks for analyzing cross-listing premiums, identifying arbitrage signals, and assessing delisting risk for US-listed Chinese ADRs.

    Core Concepts

    1. Cross-Listing Structures

    StructureDescriptionExamples
    A + H dual-listedSame company listed on both A-share and HK exchangePetroChina (601857.SH / 0857.HK), ICBC (601398.SH / 1398.HK)
    H + ADR dual-listedHK-listed with US ADRAlibaba (9988.HK / BABA), JD.com (9618.HK / JD)
    A + H + ADR triple-listedAll three marketsChina Life (601628.SH / 2628.HK / LFC)
    HK primary + US secondaryPrimary listing in HK, secondary ADRTencent (0700.HK / TCEHY OTC)
    US primary → HK secondaryOriginally US, added HK listingAlibaba (BABA → 9988.HK), Baidu (BIDU → 9888.HK)

    2. AH Premium Analysis

    AH Premium = (A-share price / H-share price in CNY terms - 1) × 100%

    def calculate_ah_premium(a_price_cny, h_price_hkd, usdcny, usdhkd):
        """Calculate AH premium for a dual-listed stock."""
        h_price_cny = h_price_hkd * (usdcny / usdhkd)  # Convert HKD to CNY
        ah_premium = (a_price_cny / h_price_cny - 1) * 100
        return ah_premium
    
    # Example: PetroChina
    # A-share: 8.50 CNY, H-share: 6.20 HKD
    # USDCNY: 7.25, USDHKD: 7.82
    # H in CNY: 6.20 * (7.25/7.82) = 5.75 CNY
    # AH Premium: (8.50/5.75 - 1) * 100 = 47.8%
    

    AH Premium signal interpretation:

    Premium LevelInterpretationAction
    >50%Extreme A-share premium; A-share speculative bubble or H-share extreme undervaluationStrong: buy H, sell/avoid A
    30-50%Elevated premium; normal for high-retail-participation namesModerate: favor H if fundamentals same
    10-30%Normal range for most AH pairsNeutral; no strong arbitrage signal
    0-10%Compressed premium; A-shares relatively cheapUnusual; investigate catalyst
    <0%H-share premium over A-shareVery rare; usually near-term event-driven

    Structural drivers of AH premium:

    1. Liquidity premium: A-shares have much higher retail participation and turnover → liquidity premium
    2. Access premium: A-shares were historically hard for foreigners to access → scarcity premium
    3. Currency expectations: CNY depreciation expectations widen the premium
    4. Regulatory arbitrage: different trading rules (T+1 in A-shares vs T+0 in HK)
    5. Investor composition: A-share retail speculative premium vs HK institutional valuation discipline

    3. ADR Premium/Discount Analysis

    ADR premium = (ADR price in USD / HK equivalent in USD - 1) × 100%

    def calculate_adr_premium(adr_price_usd, hk_price_hkd, adr_ratio, usdhkd):
        """
        Calculate ADR premium over HK listing.
        adr_ratio: number of HK shares per 1 ADR (e.g., BABA: 1 ADR = 8 HK shares)
        """
        hk_equivalent_usd = (hk_price_hkd * adr_ratio) / usdhkd
        premium = (adr_price_usd / hk_equivalent_usd - 1) * 100
        return premium
    
    # Example: Alibaba
    # BABA ADR: $85.00, 9988.HK: HKD 82.50
    # ADR ratio: 1 ADR = 8 HK shares
    # HK equivalent: (82.50 * 8) / 7.82 = $84.40
    # ADR premium: (85.00/84.40 - 1) * 100 = 0.71%
    

    Key ADR conversion ratios:

    CompanyADR TickerHK TickerADR Ratio (HK:ADR)ADR Exchange
    AlibabaBABA9988.HK8:1NYSE
    JD.comJD9618.HK2:1NASDAQ
    BaiduBIDU9888.HK8:1NASDAQ
    BilibiliBILI9626.HK1:1NASDAQ
    NIONIO9866.HK1:1NYSE
    XPengXPEV9868.HK2:1NYSE
    Li AutoLI2015.HK2:1NASDAQ
    NetEaseNTES9999.HK5:1NASDAQ
    Trip.comTCOM9961.HK1:1NASDAQ
    PinduoduoPDDN/A (US-only)N/ANASDAQ

    ADR premium drivers:

    • US trading hours sentiment (earnings releases, macro data during US hours)
    • US-specific regulatory events (SEC, PCAOB audits)
    • Liquidity premium (ADR often more liquid for global funds)
    • Time zone gap: ADR closes at HK's open → overnight gap creates premium/discount

    4. Delisting Risk Assessment

    HFCAA (Holding Foreign Companies Accountable Act) framework:

    Since 2022, PCAOB gained access to audit workpapers of Chinese companies. Key risks:

    Risk LevelCriteriaImpact
    LowPCAOB inspection completed, no issuesADR status stable
    MediumPCAOB inspection completed, deficiencies notedMonitor for resolution
    HighPCAOB access revoked or restricted3-year delisting countdown activated
    CriticalOn SEC "identified issuer" list for 3 consecutive yearsForced delisting

    Delisting risk indicators:

    delisting_risk_factors = {
        "pcaob_status": "inspected",     # inspected / pending / blocked
        "sec_identified_years": 0,        # 0, 1, 2, or 3 (3 = delist)
        "has_hk_listing": True,           # Backup listing reduces impact
        "hk_listing_type": "primary",     # primary (can be in Connect) vs secondary
        "vie_structure": True,            # Variable Interest Entity adds legal risk
        "state_owned": False,             # SOE status adds geopolitical risk
    }
    
    # Companies with HK primary listing (BABA, JD, BIDU, NTES, etc.) have
    # a safety net if US delisting occurs → fungible conversion ADR → HK shares
    # Companies with US-only listing (PDD until HK listing) face higher risk
    

    5. Cross-Listing Arbitrage Strategies

    Strategy 1: AH Premium Mean-Reversion

    # When AH premium for a specific stock diverges significantly from its historical average
    ah_premium_current = 45  # current premium
    ah_premium_mean_12m = 35  # 12-month average
    ah_premium_std = 8        # standard deviation
    
    z_score = (ah_premium_current - ah_premium_mean_12m) / ah_premium_std
    
    if z_score > 2.0:
        signal = "fade_premium"  # A-share overvalued vs H; buy H, avoid A
    elif z_score < -2.0:
        signal = "buy_premium"   # A-share undervalued vs H; buy A, avoid H
    else:
        signal = "neutral"
    

    Strategy 2: ADR-HK Intraday Arbitrage

    • During overlapping trading hours (HK morning = US pre-market via ADR), price gaps can appear
    • Professional arbitrageurs use ADR↔HK fungible conversion to capture these gaps
    • For research purposes: tracking ADR premium trend indicates which market is leading sentiment

    Strategy 3: Event-Driven Cross-Listing

    • New HK listing announcement (US→HK): ADR typically dips 2-5% on dilution fear, then recovers
    • MSCI / FTSE index inclusion of HK listing: triggers passive fund buying in HK
    • Stock Connect inclusion (HK primary listing eligible): triggers mainland institutional buying

    Data Access

    import yfinance as yf
    
    # Fetch ADR and HK prices simultaneously
    baba_adr = yf.download("BABA", start="2025-01-01", end="2026-03-30", progress=False)
    baba_hk = yf.download("9988.HK", start="2025-01-01", end="2026-03-30", progress=False)
    
    # For A+H pairs
    petrochina_a = yf.download("601857.SS", start="2025-01-01", end="2026-03-30", progress=False)
    petrochina_h = yf.download("0857.HK", start="2025-01-01", end="2026-03-30", progress=False)
    
    # FX rates for premium calculation
    cny = yf.download("CNY=X", start="2025-01-01", end="2026-03-30", progress=False)  # USD/CNY
    hkd = yf.download("HKD=X", start="2025-01-01", end="2026-03-30", progress=False)  # USD/HKD
    
    # AH Premium Index (HSAHP)
    # Not directly on yfinance; use Hang Seng website or Tushare
    

    Output Format

    ## Cross-Listing Analysis — [Company Name]
    
    ### Listing Structure
    - **A-share**: [code] @ [price CNY]
    - **H-share**: [code] @ [price HKD]
    - **ADR**: [ticker] @ [price USD] (ratio: X HK shares = 1 ADR)
    
    ### Premium/Discount
    - **AH Premium**: [X%] (12m avg: X%, z-score: X.X)
    - **ADR-HK Premium**: [X%] (5d avg: X%)
    - **Direction**: [AH premium widening / narrowing / stable]
    
    ### Valuation Comparison
    | Metric | A-share | H-share | ADR |
    |--------|---------|---------|-----|
    | PE (TTM) | XX.X | XX.X | XX.X |
    | PB | X.X | X.X | X.X |
    | Dividend yield | X.X% | X.X% | X.X% |
    
    ### Delisting Risk (ADR)
    - **PCAOB status**: [inspected / pending]
    - **SEC identified years**: [0/1/2/3]
    - **HK backup**: [yes-primary / yes-secondary / no]
    - **Risk level**: [low / medium / high / critical]
    
    ### Arbitrage Signal
    - **AH premium z-score**: [X.X] → [fade premium / neutral / buy premium]
    - **Best market to buy**: [A / H / ADR] — rationale
    - **Catalyst**: [index inclusion, Connect eligibility, earnings]
    
    ### Investment Implication
    - **Preferred listing**: [H-share / ADR / A-share] for new position
    - **Risk**: [delisting, FX, regulatory, liquidity]
    

    Notes

    • AH premium arbitrage is not freely executable: A-shares and H-shares are NOT fungible (no direct conversion), so true arbitrage requires separate capital pools
    • ADR↔HK conversion IS possible for most dual-listed names (via depositary bank), but takes 2-3 business days and involves fees
    • Currency risk (CNY, HKD, USD) is a major driver of cross-listing premiums; always hedge or account for FX when comparing
    • VIE (Variable Interest Entity) structure adds a layer of legal risk for many Chinese ADRs; this is a structural risk, not a trading signal
    • Stock Connect eligibility requirements mean not all HK-listed Chinese companies are accessible to mainland investors
    • This framework is for research purposes only and does not constitute investment advice

    Alternatives

    Compare before choosing

    Computed 10042,968

    coreyhaines31/marketingskills

    ab-testing

    When the user wants to plan, design, or implement an A/B test or experiment, or build a growth experimentation program. Also use when the user mentions "A/B test," "split test," "experiment," "test this change," "variant copy," "multivariate test," "hypothesis," "should I test this," "which version is better," "test two versions," "statistical significance," "how long should I run this test," "growth experiments," "experiment velocity," "experiment backlog," "ICE score," "experimentation program

    Computed 10042,968

    coreyhaines31/marketingskills

    churn-prevention

    When the user wants to reduce churn, build cancellation flows, set up save offers, recover failed payments, or implement retention strategies. Also use when the user mentions 'churn,' 'cancel flow,' 'offboarding,' 'save offer,' 'dunning,' 'failed payment recovery,' 'win-back,' 'retention,' 'exit survey,' 'pause subscription,' 'involuntary churn,' 'people keep canceling,' 'churn rate is too high,' 'how do I keep users,' or 'customers are leaving.' Use this whenever someone is losing subscribers o

    Computed 10023,781

    alirezarezvani/claude-skills

    app-store-optimization

    App Store Optimization (ASO) toolkit for researching keywords, analyzing competitor rankings, generating metadata suggestions, and improving app visibility on Apple App Store and Google Play Store. Use when the user asks about ASO, app store rankings, app metadata, app titles and descriptions, app store listings, app visibility, or mobile app marketing on iOS or Android. Supports keyword research and scoring, competitor keyword analysis, metadata optimization, A/B test planning, launch checklist

    Computed 10014,225

    wanshuiyin/Auto-claude-code-research-in-sleep

    citation-audit

    Use it for operations and research tasks; the detail page covers purpose, installation, and practical steps.