{"uid":"cap_pg7FihKzQ20suvUNhNx5n","slug":"crypto-tax-ledger-base-ethereum-wallet-tax-report-1ace0881","name":"Crypto Tax Ledger – Base & Ethereum Wallet Tax Report","description":"Crypto tax report for any wallet (Base, Ethereum): every transfer in a tax year labeled for a CPA (income, disposal, swap/trade, self-transfer, NFT), amounts, counterparties, stablecoin USD values, per-asset totals, CSV export. For tax prep, bookkeeping and accounting agents. $0.05 USDC per call.","url":"https://x402-agent-api.onrender.com/api/v1/crypto-tax-ledger?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"to":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"End date (inclusive, UTC), instead of `year`."},"via":{"type":"string","maxLength":64,"description":"Optional: the tool whose next_calls suggested this call (filled in for you)."},"from":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Start date (inclusive, UTC), instead of `year`."},"year":{"type":"integer","maximum":2100,"minimum":2015,"description":"Tax year (calendar, UTC). Default: the current year. Use `from`/`to` for another period."},"chain":{"enum":["base","ethereum"],"type":"string","default":"base","description":"\"base\" (default) or \"ethereum\"."},"wallet":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"The wallet to report on, e.g. 0x6847231bD28E16A0A57c59793f6B8BD8CC0043aC."},"include_csv":{"type":"boolean","default":false,"description":"Also return the rows as CSV text, ready for a spreadsheet or a CPA."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_EWJKpCWt_Jksntq7wB8ip","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Generates a labeled crypto tax report for a given wallet address on Base or Ethereum, categorizing every transfer in a tax year for CPA-ready output with CSV export.","exampleAgentPrompt":"Pull a full crypto tax report for my Ethereum wallet 0x6847231bD28E16A0A57c59793f6B8BD8CC0043aC for the 2023 tax year, label every transfer as income, disposal, swap, self-transfer, or NFT, and include a CSV export I can hand to my CPA.","exampleUseCases":[{"title":"Annual crypto tax prep for CPA","prompt":"Generate a complete tax ledger for my Base wallet 0x6847231bD28E16A0A57c59793f6B8BD8CC0043aC for the 2023 tax year — label every transaction as income, disposal, swap, or self-transfer and give me a CSV I can send to my accountant."},{"title":"DeFi bookkeeping for a specific period","prompt":"I need to reconcile all on-chain activity for Ethereum wallet 0xAbCd1234...5678 between January 1 2024 and June 30 2024 — classify each transfer, show the counterparties and USD values for stablecoins, and give me the per-asset totals."},{"title":"NFT transaction tax classification","prompt":"Pull all NFT-related transfers from my Base wallet 0x6847231bD28E16A0A57c59793f6B8BD8CC0043aC for the full 2022 tax year, labeled by category so I know which ones are taxable disposals versus self-transfers."}],"resultDescription":"Returns a structured tax ledger containing every on-chain transfer for the specified wallet and period, each labeled with a tax category (income, disposal, swap/trade, self-transfer, or NFT), counterparty addresses, amounts, stablecoin USD equivalents, and per-asset totals. Optionally includes CSV-formatted rows ready for import into a spreadsheet or delivery to a CPA.","failureModes":["Invalid wallet address format (must be 0x followed by 40 hex characters) returns validation error","Unsupported chain value (only 'base' or 'ethereum' accepted) returns enum validation error","Year out of supported range (below 2015 or above 2100) returns validation error","Conflicting use of both 'year' and 'from'/'to' parameters may cause unexpected behavior","Wallet with no transaction history returns empty ledger","Network or RPC unavailability for the specified chain may cause timeout or partial results","Insufficient USDC payment (requires $0.05 USDC via x402 protocol) results in 402 Payment Required"],"whenToPreferThis":"Choose this endpoint when you need a comprehensive, CPA-ready crypto tax report for a single wallet on Base or Ethereum, especially when you need transfer categorization (income, disposal, swap, NFT), counterparty identification, stablecoin USD valuations, and CSV export in one call. Prefer this over generic blockchain explorers when the output must be structured for tax filing or bookkeeping workflows rather than raw transaction data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T06:37:37.466Z","isFirstParty":false,"canonicalSlug":"crypto-tax-ledger-base-ethereum-wallet-tax-report-1ace0881"}