# Send XPR Crypto Tax to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "xpr-tax",
    "name": "XPR Crypto Tax",
    "source": "tencent",
    "type": "skill",
    "category": "数据分析",
    "sourceUrl": "https://clawhub.ai/paulgnz/xpr-tax",
    "canonicalUrl": "https://clawhub.ai/paulgnz/xpr-tax",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/xpr-tax",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=xpr-tax",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "dist/index.js",
      "skill.json",
      "src/index.ts"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/xpr-tax"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/xpr-tax",
    "downloadUrl": "https://openagent3.xyz/downloads/xpr-tax",
    "agentUrl": "https://openagent3.xyz/skills/xpr-tax/agent",
    "manifestUrl": "https://openagent3.xyz/skills/xpr-tax/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/xpr-tax/agent.md"
  }
}
```
## Documentation

### Crypto Tax Reporting

You have tools to generate crypto tax reports from on-chain XPR Network activity. Supports New Zealand (NZ) and United States (US).

### Key Facts

NZ tax year: April 1 – March 31 (e.g. "2025" = Apr 2024 – Mar 2025)
US tax year: January 1 – December 31 (calendar year, e.g. "2024" = Jan 2024 – Dec 2024)
NZ has NO capital gains tax — all crypto gains are taxed as income if you're a regular trader
US HAS capital gains tax — short-term (<1 year) taxed as ordinary income, long-term at lower rates. Uses 2024 Single filer federal brackets. Does not include state taxes or NIIT.
Cost basis methods: FIFO (first-in-first-out) or Average Cost
All tools are read-only — they query APIs and calculate, never transact
Default region is NZ — pass region: "US" for US tax reports

### Typical Workflow

For a full tax report, the recommended sequence is:

tax_get_balances — opening balances (start of tax year) and closing balances (end of tax year)
tax_get_dex_trades — all Metal X DEX trading history for the period
tax_get_transfers — on-chain transfers, auto-categorized (staking rewards, lending, swaps, NFT sales, etc.)
tax_get_rates — local currency conversion rates for each token
tax_calculate_gains — compute taxable gains/losses using FIFO or Average Cost
tax_generate_report — full report with tax brackets and estimated tax

Or use tax_generate_report directly for a one-shot report that orchestrates all steps automatically.

### Data Sources (Mainnet Only)

Saltant API — historical balance snapshots (liquid, staked, lending, yield farm)
Metal X API — DEX trade history in CSV format (only filled trades)
Hyperion API — raw on-chain transfer/action history
CoinGecko API — historical and current crypto prices (set COINGECKO_API_KEY in .env for full historical access)

### Transfer Categories

Transfers are auto-categorized by sender/receiver:

CategoryDetectionstaking_rewardfrom eosio or eosio.vpaylending_depositto lending.loanlending_withdrawalfrom lending.loanlending_interestfrom lending.loan with interest memoswap_depositto proton.swapsswap_withdrawalfrom proton.swapslong_staketo longstaking (XPR long staking)long_unstakefrom longstakingloan_staketo lock.token or yield.farms (LOAN/SLOAN staking)loan_unstakefrom lock.token or yield.farmsdex_depositto dex or metalxdex_withdrawalfrom dex or metalxnft_salefrom atomicmarketnft_purchaseto atomicmarketburnto eosio.null (token burn = realized loss)escrowto/from agentescrowtransfereverything else

### Staking Income Rules

Block producer rewards (staking_reward): Full amount is income at time of receipt
Long staking (XPR via longstaking): Only the excess over the staked amount is income. E.g. stake 100 XPR, unstake 150 XPR → income of 50 XPR
LOAN staking (via lock.token/yield.farms): Same excess-only rule as long staking
Lending interest: Full amount from lending.loan with interest memo is income

### Stablecoin Handling

XUSDC and XMD are pegged to USD — their local currency value uses forex rates (USD/NZD) directly, without CoinGecko. This is more accurate than market-based pricing for stablecoins.

### Rate Sources (Priority Order)

DEX trades — derives token prices from TOKEN/XMD trade ratios (most accurate, no API limits)
Forward-fill — gaps between DEX trade dates use nearest prior known rate
CoinGecko — fallback for dates with no DEX data. Without API key: limited to 365 days. With COINGECKO_API_KEY: unlimited history
Forex — stablecoins use USD→NZD conversion rate

### Delivering the Report

tax_generate_report returns a report_markdown field — a pre-formatted Markdown document with balance sheets, trading summary, income breakdown, tax brackets, and disclaimer. To deliver it:

Upload report_markdown via store_deliverable with content_type: "application/pdf" — this is the primary deliverable
Upload csv_exports.disposals via store_deliverable with content_type: "text/csv" — disposals CSV
Upload csv_exports.income via store_deliverable with content_type: "text/csv" — income events CSV
Call xpr_deliver_job with ALL URLs comma-separated (PDF first): "https://ipfs.io/ipfs/QmPDF...,https://ipfs.io/ipfs/QmDisposals...,https://ipfs.io/ipfs/QmIncome..."

IMPORTANT: You MUST complete ALL steps (upload + deliver) in a single run. Do NOT stop after uploading the PDF — you must also upload the CSVs and call xpr_deliver_job. The job is not complete until xpr_deliver_job is called.

The frontend displays the primary file (PDF) prominently and lists additional files as download links.

### Known Limitations

Only filled DEX trades are included (not pending orders)
NFT: only buy/sell supported (not auctions)
Liquidations on Metal Lending are not supported
Escrow payments are tracked but not fully categorized
Historical pricing accuracy depends on DEX trade activity and CoinGecko data availability

### Important Notes

Always include the disclaimer from the report — this is not tax advice
Suggest users save CSV exports for the IRD 7-year record requirement
The region parameter defaults to "NZ" on all tools — pass a different region code when other regions are added
Set COINGECKO_API_KEY in .env for best historical pricing (free Demo key removes 365-day limit)
For tokens not on CoinGecko, the tool derives prices from Metal X DEX trade ratios
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: paulgnz
- Version: 1.0.0
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-23T16:43:11.935Z
- Expires at: 2026-04-30T16:43:11.935Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/xpr-tax)
- [Send to Agent page](https://openagent3.xyz/skills/xpr-tax/agent)
- [JSON manifest](https://openagent3.xyz/skills/xpr-tax/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/xpr-tax/agent.md)
- [Download page](https://openagent3.xyz/downloads/xpr-tax)