Crypto Tax Ledger

{
  "chain": "base",
  "counts": {
    "nft_received": 0,
    "nft_sent": 0,
    "received": 1,
    "self_transfer": 0,
    "sent": 1,
    "swap": 0
  },
  "csv": null,
  "disclaimer": "A record of on-chain transfers labeled by type, not tax advice. Whether a transfer is income, a gift or a move between your own wallets, and the gains on swaps and sales, need your records and a tax professional. Gas fees are not included.",
  "next_calls": [],
  "period": {
    "from": "2026-01-01",
    "to": "2026-12-31"
  },
  "rows": [
    {
      "amount_in": 0.467,
      "amount_out": null,
      "asset": "USDC",
      "counterparty": "0x242e2d70d3adc00a9ef23ced6e88811fcefca788",
      "date": "2026-10-05T22:03:47.000Z",
      "explorer_url": "https://basescan.org/tx/0x7e109715e36cdafca609eeb9a914b5e91fd211fe65893518355c62dce6d8818e",
      "kind": "received",
      "tax_category": "Transfer in: income if earned (payment, reward, airdrop); not taxable if from your own wallet",
      "token_address": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
      "tx": "0x7e109715e36cdafca609eeb9a914b5e91fd211fe65893518355c62dce6d8818e",
      "usd_value": 0.47
    }
  ],
  "source": "alchemy",
  "stablecoin_usd": {
    "received": 0.47,
    "sent": 0.1
  },
  "summary": "2 transfer(s) from 2026-01-01 to 2026-12-31: 1 received, 1 sent, 0 swap leg(s), 0 self-transfer(s), 0 NFT transfer(s). Stablecoins: $0.47 in, $0.10 out.",
  "totals": [
    {
      "asset": "USDC",
      "net": 0.367,
      "received": 0.467,
      "sent": 0.1,
      "token_address": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913"
    }
  ],
  "truncated": false,
  "wallet": "0x6847231bD28E16A0A57c59793f6B8BD8CC0043aC"
}

# bash or zsh: see the payment challenge. Nothing is charged.
curl -sS -g -i -X POST 'https://x402-agent-api.onrender.com/api/v1/crypto-tax-ledger' \
  -H 'content-type: application/json' \
  --data-raw '{"chain":"base","wallet":"0x6847231bD28E16A0A57c59793f6B8BD8CC0043aC","year":2026}'

# x402 v2 sends the challenge base64-encoded in the PAYMENT-REQUIRED header (v1 sends it in the body).
# To read the header:
curl -sS -g -o /dev/null -D - -X POST 'https://x402-agent-api.onrender.com/api/v1/crypto-tax-ledger' \
  -H 'content-type: application/json' \
  --data-raw '{"chain":"base","wallet":"0x6847231bD28E16A0A57c59793f6B8BD8CC0043aC","year":2026}' \
  | grep -i '^payment-required:' | cut -d' ' -f2 | tr -d '\r' | base64 --decode

// npm i @x402/fetch @x402/evm viem
import { wrapFetchWithPayment, x402Client } from "@x402/fetch";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

// Pays at most $0.05 per call.
const client = new x402Client().setSpendControls({ maxAmountPerPayment: "$0.05" });
registerExactEvmScheme(client, { signer: privateKeyToAccount(process.env.EVM_PRIVATE_KEY) });
const pay = wrapFetchWithPayment(fetch, client);

// Not sure it's safe to pay? ToolVet checks it first for $0.005. Pay for that from a separate
// client: this one is capped at $0.05 per payment. GET https://toolvet.app/api/v1/check?url=https%3A%2F%2Fx402-agent-api.onrender.com%2Fapi%2Fv1%2Fcrypto-tax-ledger&method=POST
const res = await pay("https://x402-agent-api.onrender.com/api/v1/crypto-tax-ledger", {
  method: "POST",
  headers: { "content-type": "application/json" },
  body: JSON.stringify({
    "chain": "base",
    "wallet": "0x6847231bD28E16A0A57c59793f6B8BD8CC0043aC",
    "year": 2026
  }),
});
console.log(res.status, await res.text());

# pip install "x402[requests,evm]"
import os
from eth_account import Account
from x402 import x402ClientSync
from x402.http.clients import x402_requests
from x402.mechanisms.evm import EthAccountSigner
from x402.mechanisms.evm.exact.register import register_exact_evm_client

# Pays at most $0.05 per call.
client = x402ClientSync().set_spend_controls({"max_amount_per_payment": "$0.05"})
register_exact_evm_client(client, EthAccountSigner(Account.from_key(os.environ["EVM_PRIVATE_KEY"])))

with x402_requests(client) as session:
    res = session.post(
        "https://x402-agent-api.onrender.com/api/v1/crypto-tax-ledger",
        json={
            "chain": "base",
            "wallet": "0x6847231bD28E16A0A57c59793f6B8BD8CC0043aC",
            "year": 2026,
        },
    )
    print(res.status_code, res.text)