tax

What This Skill Does

The Tax skill for OpenClaw is a powerful, read-only analytical tool designed specifically for XPR Network users to streamline the complexities of crypto taxation. It offers comprehensive support for reporting on-chain activity, featuring specialized logic for both New Zealand (NZ) and United States (US) tax jurisdictions. By leveraging data from the Saltant, Metal X, Hyperion, and CoinGecko APIs, the agent aggregates on-chain transfers, DEX trades, and staking rewards to calculate your tax obligations.

The skill supports multiple accounting methods, including FIFO (First-In-First-Out) and Average Cost, ensuring compliance with regional tax requirements. It automatically categorizes transactions—such as staking rewards, NFT sales, and lending interest—using a pre-defined taxonomy of XPR Network contract addresses. This allows users to move from raw blockchain data to a structured report without manual spreadsheets.

Installation

To integrate this skill into your environment, run the following command in your terminal within the OpenClaw directory:

clawhub install openclaw/skills/skills/paulgnz/xpr-tax

Ensure you have set your COINGECKO_API_KEY in your .env file to enable full historical price lookups, which are critical for accurate capital gains calculations.

Use Cases

• End-of-Year Compliance: Generate a comprehensive summary of all realized gains and losses for your annual tax filing.
• Portfolio Auditing: Review historical performance across different DeFi protocols, including yield farms and lending markets, to understand the tax impact of your strategy.
• Cross-Jurisdictional Analysis: Quickly compare how your trading activity translates to tax liability under different regional rulesets (NZ vs. US).
• Yield Tracking: Isolate staking and lending rewards to correctly classify income versus capital growth.

Example Prompts

1. "Generate a US crypto tax report for the 2024 tax year using the FIFO method for my wallet address XPR123..."
2. "What were my total staking rewards in NZD for the New Zealand 2025 tax year?"
3. "Show me a summary of my gains and losses from Metal X DEX trades for the current calendar year."

Tips & Limitations

• Read-Only Security: This skill never executes transactions. It is a strictly read-only reporting tool, meaning it cannot interact with your private keys or initiate transfers.
• Regional Nuance: Remember that New Zealand does not have a formal capital gains tax, and most crypto activity is treated as income. The US model heavily relies on capital gains categorization; ensure you select the correct region.
• Dependencies: The tool relies on historical API availability. If a specific chain event is missing from the underlying indexers (Hyperion/Saltant), the report may require manual reconciliation.
• Disclaimer: While designed for accuracy, this tool provides estimates. Always verify reports with a qualified tax professional before filing.