用途:为活跃的 Solana 交易者提供实时税务负债分析,在交易过程中同步维护税务台账,让每笔决策都能看到其税务后果。
主要能力:按比例成本基础处理部分卖出(卖出部分按比例分摊成本,剩余代币保留原始单位成本);收益分类引擎区分短期(<1年)与长期(>=1年)资本利得,并跟踪各批次距长期门槛的剩余天数;季度税务预估,按累进税率估算联邦税并支持配置州税率;税务感知信号,包括长期门槛提醒、止盈触发的短期负债、可收割的未实现亏损、择时价值与洗售警告;税后盈亏视图,展示税前与税后收益及年初至今累计负债。支持 FIFO、LIFO 和特定识别三种会计方法,并以 SOL/USD 汇率将 SOL 计价交易折算为美元。
使用方式:需 Python 3.10+,核心跟踪仅用标准库,无需外部依赖;需准备历史 SOL/USD 价格与结构化交易记录(时间戳、方向、代币、数量、价格)。通过 from tax_tracker import TaxTracker, Trade 创建跟踪器,配置会计方法、联邦边际税率、州税率与长期资本利得率,用 add_trade 记录买卖,用 position_summary 查看已实现收益、剩余成本基础与收益分类,用 get_signals 获取税务信号。scripts/tax_tracker.py 提供演示实现,可用 --demo 运行。
适用场景:日内交易者税务跟踪、波段交易者的部分止盈、长期持有者门槛监控、税损收割、年终税务规划、多代币组合管理。
限制:仅支持美国联邦与州税规则,暂无国际税务支持;不处理质押奖励、空投或 DeFi 收益作为收入事件;洗售规则仅提示不自动执行;代币互换按卖出加买入两笔应税事件处理;不生成官方税表。计算结果仅供信息跟踪,不构成税务建议,申报前应咨询专业税务人士。