io.github.AwakeWeb3/papertax

Tools

• buy_report

  Buy the full report for one wallet and tax year ($29 up to 500 events, $59 up to 5,000, $99 above; upgrades charge the difference). method "card" charges the account owner's saved card: needs Authorization: Bearer ptx_… and the owner's opt-in; set max_price_cents to cap it. method "usdc" returns a quote: send exactly that USDC amount on HyperEVM (chain 999) to the given address, then call again with quote_id and tx_hash. (x402 clients can instead pay in USDC on Base or Solana at GET https://papertax.xyz/api/buy?address=…&year=….) Returns an unlock_token and export links. This spends money: confirm with the user first.

  shallow
• create_verified_pnl

  Read a wallet's results for one tax year from the chain and return a public, signed link (https://papertax.xyz/v/…) with a share image, for posting on X or anywhere else. Free, and nothing is stored. Dollar amounts are included only when amounts is true. With private true (the default) the wallet address is left out of the link and the page; with private false the page shows it, so check with the user first. It proves what the wallet did, not who owns it.

  shallow
• explain_tax_treatment

  papertax's default treatment notes for Australia, the US, the UK, Canada, New Zealand, Japan or Spain, optionally for one event type. Not tax advice.

  shallow
• export_tax_file

  Koinly universal CSV, Crypto Tax Calculator advanced CSV, Cryptact custom file (JST, priced in yen by Cryptact), plain-text accountant summary, or the audit pack (audit = JSON with every figure tied to its transaction hash, a rules version and a data fingerprint; auditpdf = the printable PDF). Live wallets need paid access (API key or paid report). Large files are cut short with a download link.

  shallow
• get_games

  How papertax games work (Edge, Climb, and 1v1 and Pit rooms on real papertrade positions, with crews and weekly leaderboards), this week's boards (top 10 named players or crews; wallets are never shown), open and live rooms, and the Bulls vs Bears tally. Read-only; playing needs the website and a wallet.

  shallow
• get_launchpad_info

  Status and design notes for the papertax token launchpad and the $TAX token. Both are paused: nothing is deployed (not even on testnet), and there is nothing to launch, stake, claim or buy. Use this to answer questions about the pause or how the launchpad was designed (pool fee split, $TAX allocation). Official news comes only from X @papertaxdev. With an address, also returns that wallet's current PAPER stake on papertrade (public on-chain data); this says nothing about any future airdrop.

  shallow
• get_ledger_events

  Individual ledger rows with default tax classification: perp opens, closes, liquidations and funding; spot buys and sells; vault deposits and withdrawals; staking rewards; HyperEVM swaps and protocol deposits; transfers; papertrade mints and staking. Filter by event type or venue. Without paid access, live wallets return the first 10 rows.

  shallow
• get_tax_summary

  Free. Per-venue realised gains and losses, fees, funding, liquidations, open positions and items needing review for one wallet and tax year, plus trading analytics (fee and funding drag, liquidation review, net after costs by market and month). For live wallets, report gives the event count, the full report's price for this caller, whether they already have access, and how to buy it.

  shallow

Embed this server’s score

Tool count and median score across every tool in this server’s corpus — honest in a way a single cherry-picked tool’s badge wouldn’t be.

[![Vouch score](https://vouch.tools/api/servers/a8d593a4-786d-4946-b74d-4f26b0814e28/badge.svg)](https://vouch.tools/servers/a8d593a4-786d-4946-b74d-4f26b0814e28)