Crypto Tax Reporting for XPR Network
核心功能
本Skill提供一套完整的加密货币税务报告解决方案，专为XPR Network链上活动设计。支持两个主要司法管辖区：新西兰（NZ）和美国（US），覆盖不同的税务规则和申报要求。
主要工作流程
| 步骤 | 工具 | 功能说明 |
|------|------|----------|
| 1 | `tax_get_balances` | 获取税务年度期初/期末余额 |
| 2 | `tax_get_dex_trades` | 提取Metal X DEX完整交易历史 |
| 3 | `tax_get_transfers` | 获取链上转账记录并自动分类 |
| 4 | `tax_get_rates` | 获取各代币本地货币汇率 |
| 5 | `tax_calculate_gains` | 使用FIFO或平均成本法计算应税损益 |
| 6 | `tax_generate_report` | 生成完整税务报告（含税级估算）|
或使用tax_generate_report一键自动执行全部流程。
显著优点
1. 区域化税务规则支持：
- 新西兰：无资本利得税，常规交易者按收入征税；税务年度4月1日-次年3月31日
- 美国：区分短期（<1年，按普通收入）和长期资本利得，使用2024联邦单身申报人税率档
2. 智能交易分类：自动识别16+种链上活动类型，包括质押奖励、借贷利息、DEX交易、NFT买卖、长期质押等
3. 精准定价机制：优先从DEX交易比率推导价格，其次前向填充，CoinGecko作为后备，稳定币使用外汇汇率
4. 多格式交付：生成Markdown格式PDF报告，同时提供处置明细和收入事件CSV文件
5. 安全设计：所有工具均为只读，仅查询API和计算，绝不执行任何交易
潜在局限
- 仅包含已完成的DEX成交单，不含 pending 订单
- NFT支持仅限直接买卖，不含拍卖
- Metal Lending清算事件未完全支持
- 托管支付跟踪但未完全分类
- 历史价格准确性依赖DEX交易活跃度和CoinGecko数据可用性
- 美国报告不含州税和净投资所得税（NIIT）
适用人群
- XPR Network活跃用户：定期进行DEX交易、质押、借贷的持币者
- 新西兰/美国税务居民：需要按当地法规申报加密资产税务的个人
- 专业交易者：需要详细交易记录和成本基础计算的高频用户
- 合规优先用户：希望保留IRD要求的7年记录的新西兰纳税人
常规风险提示
> ⚠️ 重要免责声明：本工具生成的报告仅供参考，不构成税务建议。用户应咨询持证税务专业人士。新西兰纳税人建议保存CSV导出文件以满足IRD 7年记录保存要求。
- 税务计算基于链上数据和外部API，可能存在数据缺口或价格偏差
- 不同司法管辖区的税法复杂且可能变更，需自行核实最新规定
- 建议配置
COINGECKO_API_KEY以获取完整历史价格数据（免费Demo key可移除365天限制） - 交付流程必须完整执行：PDF + CSV上传 +
xpr_deliver_job调用，缺一不可