SuperAPI AI Directory

china-tax-loss-harvesting

General & other

View repository

Updated 10-15 23:43

About this skill

china-tax-loss-harvesting

Purpose

Implement A-share tax loss offset — systematic tax-loss harvesting for Chinese investment portfolios.

Data Sources

Primary: iFind MCP (Tier-1 paid) / AkShare MCP (Tier-2 free alternative)

get_quote(ticker)                     → Current prices for holdings
get_historical_data(ticker)           → Cost basis / purchase history

Secondary Sources

  • Broker records — cost basis, trade history
  • Tax filings — prior year losses
  • Exchange — tax treatment rules

Workflow

Step 1: Identify Tax-Loss Positions

Loss identification:

Position Ticker Cost Basis Current Value Unrealized Loss Loss %
¥XX ¥XX ¥XX X%

Loss screening criteria:

  • Unrealized loss > 10% of cost basis
  • Loss amount significant relative to portfolio
  • Holding period appropriate for tax treatment

Step 2: Understand A-share Tax Rules

China tax treatment for securities:

Item Tax Rate Notes
Securities trading price spread Temporarily exempt (temporarily exempt) Capital gains on stocks
Dividends 20% (halved to 10% if holding >1 year, exempt if >1 year) Dividend tax
Fund distributions Temporarily exempt (some funds) Fund distributions
Trading stamp duty 0.05% (seller only) Stamp duty
Securities trading commission 0.02-0.03% Commission

Current status of capital gains tax:

  • Individuals: Capital gains on stocks are currently temporarily exempt (temporarily exempt)
  • However, losses can be used to offset gains within the same year
  • Loss carryforward rules may apply

Step 3: Calculate Tax Benefit

Tax benefit calculation:

Scenario Gain Loss Taxable Gain Tax Saved
Without TLH ¥XX — ¥XX —
With TLH ¥XX ¥XX ¥XX ¥XX
Benefit ¥XX

Note: In the current A-share environment where capital gains are largely exempt, tax-loss harvesting benefits may be limited. However:

  • Harvesting losses can be valuable if tax rules change
  • Offsetting gains within the same year
  • Potential future tax benefit if capital gains tax is introduced

Step 4: Identify Replacement Securities

Replacement criteria:

Criterion Requirement
Same sector Similar industry exposure
Similar characteristics Market cap, growth, quality
Not substantially identical Avoid wash sale rules
Tax-efficient Consider dividend treatment

Wash sale considerations (China):

  • No explicit wash sale rule currently
  • However, substantially identical securities may be disallowed
  • Best practice: 30-day waiting period

Step 5: Execution Strategy

Execution options:

Strategy Description Pros Cons
Full exit Sell and replace Clean loss realization Market risk
Partial exit Reduce position Partial benefit Partial benefit only
Swap Sell loss, buy similar Maintain exposure Timing risk
Delay Wait for recovery No transaction costs Missed opportunity

Step 6: Implementation Plan

Step-by-step plan:

Step Action Timing
1 Identify loss positions Pre-year-end
2 Evaluate replacement options Pre-year-end
3 Check wash sale rules Pre-year-end
4 Execute sales Before year-end
5 Execute purchases After sale (or simultaneously)
6 Document transactions Immediately
7 File tax forms Tax filing deadline

Step 7: Document for Tax Filing

Required documentation:

Document Content
Trade confirmations Sale and purchase tickets
Cost basis records Purchase prices, dates
Loss calculations Realized loss amounts
Replacement securities Identified alternatives
Market rationale Investment thesis

Step 8: Year-End Checklist

Year-end TLH checklist:

Date Action
Nov Review portfolio for loss positions
Dec 1-15 Identify replacement securities
Dec 15-20 Execute loss sales
Dec 20-31 Execute replacements
Dec 31 Final portfolio review
Jan File tax documentation

China-Specific TLH Considerations

Current Tax Environment

Factor Status Implication
Capital gains tax Temporarily exempt (temporarily exempt) Limited current benefit
Stamp duty 0.05% Cost on sale
Dividend tax 20% (10% for >1yr) Consider in replacement
Trading commission 0.02-0.03% Trading cost

When TLH Makes Sense in China

Scenario Benefit
Offset short-term gains Use losses against gains
Reset cost basis Lower future gains if taxed
Prepare for tax changes If capital gains taxed in future
Portfolio rebalancing Combine with rebalancing

A-share Market Timing

Consideration Guidance
Year-end effect Year-end selling pressure
Price limit restrictions May prevent execution
Liquidity Ensure liquidity for exit
Policy window Tax policy change risk

TLH for Different Client Types

Individual Investors

Consideration Guidance
Holding period >1 year for dividend tax benefit
High-frequency trading May trigger scrutiny
Amount threshold Focus on significant positions

Institutional Investors

Consideration Guidance
Transaction costs Factor in commission impact
Market impact Large position impact
Accounting treatment NAV impact timing
Compliance review Documentation requirements

Quality Checks

Before executing:

  • Loss positions identified
  • Tax benefit calculated
  • Replacement securities identified
  • Wash sale rules considered
  • Execution plan clear
  • Documentation prepared
  • Timing appropriate

Data Source Mode Switch: Set env var IFIND_DATA_SOURCE_MODE to control data source preference.

  • ifind-only (strict): Use iFind only, error if unavailable
  • ifind-fallback (default): iFind preferred, fallback to AkShare
  • akshare-only, wind-only (Wind only), wind-fallback (Wind first, fallback to iFind → AkShare): Skip iFind, use AkShare only