{
  "name": "TaxPulse",
  "description": "Global tax code intelligence API. 15 endpoints: 190+ country tax overviews, citation-verified US state-tax answers (CA + NY), multi-country comparison, digital nomad optimization, bilateral tax treaty analysis, international corporate structuring, crypto tax by jurisdiction, expat obligations (FBAR/FATCA/FEIE/non-dom), VAT/GST compliance \u2014 plus citation-verified crypto wallet tax reviews (US/UK/DE/IN), on-chain wallet investigation, and drainer-protection approval scans. Powered by OECD data, official tax authorities, and Claude. Pay-per-query via x402 on Base.",
  "url": "https://taxpulse.theaslangroupllc.com",
  "version": "1.0.0",
  "capabilities": [
    "country-tax-overview",
    "multi-country-comparison",
    "digital-nomad-optimization",
    "tax-treaty-analysis",
    "corporate-structuring",
    "crypto-tax-by-jurisdiction",
    "expat-compliance",
    "vat-gst-intelligence",
    "fbar-fatca-guidance",
    "oecd-data-synthesis",
    "beps-compliance-analysis",
    "pillar-two-assessment",
    "crypto-wallet-tax-review",
    "onchain-wallet-investigation",
    "wallet-drainer-protection"
  ],
  "target_users": [
    "digital nomads seeking zero-tax jurisdictions and territorial systems",
    "expats needing FBAR/FATCA/FEIE guidance (especially Americans abroad)",
    "crypto investors optimizing capital gains treatment by jurisdiction",
    "entrepreneurs and founders choosing where to incorporate",
    "multinationals designing holding company and IP structures",
    "tax professionals needing rapid cross-border reference intelligence",
    "SaaS and e-commerce businesses managing global VAT/GST compliance",
    "investors planning cross-border portfolio structuring",
    "HNWIs exploring residency programs and exit planning",
    "AI agents performing international tax research on behalf of clients"
  ],
  "data_sources": [
    "OECD Tax Database \u2014 corporate and individual rates across 38+ member countries",
    "Official national tax authority websites \u2014 IRS, HMRC, CRA, ATO, DGFIP, BZSt, IRAS, and 150+ others",
    "Tax Foundation \u2014 international tax competitiveness index and comparative data",
    "OECD MLI Tracker \u2014 Multilateral Instrument modifications to tax treaties",
    "OECD CARF \u2014 Crypto Asset Reporting Framework standards",
    "Tavily \u2014 real-time synthesis of official government and authoritative sources",
    "Claude Sonnet \u2014 synthesis, analysis, and structured intelligence generation"
  ],
  "payment": {
    "protocol": "x402",
    "network": "eip155:8453",
    "asset": "USDC",
    "contract": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "payTo": "0x50ab2018c06c6E4eAA9BA52057Eb55eD284912fc"
  },
  "endpoints": [
    {
      "path": "/api/tax/country",
      "method": "GET",
      "description": "Full tax system overview for any country \u2014 income brackets, corporate rate, capital gains, crypto classification, VAT/GST, residency triggers, special programs (NHR/IFICI, Beckham Law, HNWI, territorial systems), verdict by taxpayer type.",
      "parameters": [
        {
          "name": "country",
          "required": true
        },
        {
          "name": "scenario",
          "required": false
        },
        {
          "name": "lang",
          "required": false
        }
      ],
      "price_usd": 0.1,
      "payment_required": true
    },
    {
      "path": "/api/tax/compare",
      "method": "GET",
      "description": "Side-by-side tax comparison of 2\u20133 countries \u2014 comparison matrix across 12+ dimensions, winner by use case (nomad/entrepreneur/investor/retiree/holding_company), and optimal multi-jurisdiction structure.",
      "parameters": [
        {
          "name": "countries",
          "required": false,
          "note": "comma-separated or use country1/country2/country3"
        },
        {
          "name": "scenario",
          "required": false
        },
        {
          "name": "lang",
          "required": false
        }
      ],
      "price_usd": 0.12,
      "payment_required": true
    },
    {
      "path": "/api/tax/nomad",
      "method": "GET",
      "description": "Digital nomad tax optimization \u2014 territorial vs worldwide systems, top 10+ jurisdictions with program details, 183-day rule traps, home country obligations by nationality (US FEIE/FBAR, UK SRT, Canadian departure), practical action plan.",
      "parameters": [
        {
          "name": "nationality",
          "required": false
        },
        {
          "name": "income_type",
          "required": false
        },
        {
          "name": "income_level",
          "required": false
        },
        {
          "name": "focus",
          "required": false
        },
        {
          "name": "lang",
          "required": false
        }
      ],
      "price_usd": 0.12,
      "payment_required": true
    },
    {
      "path": "/api/tax/treaty",
      "method": "GET",
      "description": "Bilateral tax treaty analysis \u2014 withholding rates for dividends/interest/royalties, capital gains rules, residency tiebreaker, MLI/BEPS modifications, anti-avoidance (PPT/LOB), practical transaction scenarios.",
      "parameters": [
        {
          "name": "country1",
          "required": true,
          "note": "resident country"
        },
        {
          "name": "country2",
          "required": true,
          "note": "source country"
        },
        {
          "name": "transaction_type",
          "required": false
        },
        {
          "name": "lang",
          "required": false
        }
      ],
      "price_usd": 0.12,
      "payment_required": true
    },
    {
      "path": "/api/tax/structure",
      "method": "GET",
      "description": "International corporate tax structuring \u2014 holding company jurisdictions, IP box regimes (Netherlands 9%, Ireland KDB, Luxembourg, Malta), BEPS substance requirements, CFC rules by shareholder nationality, transfer pricing, Pillar Two.",
      "parameters": [
        {
          "name": "objective",
          "required": false
        },
        {
          "name": "business_type",
          "required": false
        },
        {
          "name": "annual_revenue",
          "required": false
        },
        {
          "name": "shareholders",
          "required": false
        },
        {
          "name": "jurisdictions",
          "required": false
        },
        {
          "name": "lang",
          "required": false
        }
      ],
      "price_usd": 0.15,
      "payment_required": true
    },
    {
      "path": "/api/tax/crypto",
      "method": "GET",
      "description": "Crypto tax treatment across 15+ jurisdictions \u2014 Germany 0% after 1yr, UAE 0%, Japan up to 55%, US property rules, staking/DeFi/NFT treatment, CARF/DAC8 reporting obligations launching 2026.",
      "parameters": [
        {
          "name": "country",
          "required": false
        },
        {
          "name": "activity",
          "required": false
        },
        {
          "name": "assets",
          "required": false
        },
        {
          "name": "lang",
          "required": false
        }
      ],
      "price_usd": 0.12,
      "payment_required": true
    },
    {
      "path": "/api/tax/expat",
      "method": "GET",
      "description": "Expat tax compliance by nationality \u2014 Americans: FBAR (criminal penalties), FATCA Form 8938, FEIE ~$126k; UK: non-dom reform 2025, SRT; Canada: deemed disposition; Australia: CGT departure; exit tax rules.",
      "parameters": [
        {
          "name": "nationality",
          "required": true
        },
        {
          "name": "destination",
          "required": false
        },
        {
          "name": "situation",
          "required": false
        },
        {
          "name": "lang",
          "required": false
        }
      ],
      "price_usd": 0.12,
      "payment_required": true
    },
    {
      "path": "/api/tax/vat",
      "method": "GET",
      "description": "Global VAT/GST intelligence \u2014 170+ jurisdictions, digital services rules (non-residents often register from first sale), EU OSS/IOSS, marketplace platform obligations, ViDA e-invoicing, DAC7 platform reporting.",
      "parameters": [
        {
          "name": "country",
          "required": false
        },
        {
          "name": "sector",
          "required": false
        },
        {
          "name": "business_type",
          "required": false
        },
        {
          "name": "lang",
          "required": false
        }
      ],
      "price_usd": 0.1,
      "payment_required": true
    },
    {
      "path": "/api/tax/state",
      "method": "GET",
      "description": "US STATE income-tax answers citation-verified against the actual state-law corpus \u2014 California (R&TC/18 CCR/FTB/OTA; static two-era IRC conformity, NOL suspension, residency safe harbors) and New York (Tax Law/20 NYCRR/DTF/Tax Appeals Tribunal; rolling conformity + OBBBA decoupling N-26-1, convenience-of-the-employer rule, statutory residency, \u00a7620 resident-credit trap, PTET, NYC/Yonkers). Every finding passes an existence + claim-support verification gate; failures are dropped, never shown. Params: state (CA|NY), question, tax_year. $0.50.",
      "price_usdc": 0.5
    },
    {
      "path": "/api/crypto/wallet-review",
      "method": "GET",
      "description": "Citation-verified crypto wallet tax review \u2014 wallet addresses + jurisdiction in, a professional report grounded in primary tax law (statutes, rulings, case law) with per-finding machine-verified citations a CPA can check and sign. Covers US, UK, Germany, India, Canada, Australia, Japan, Brazil, Singapore.",
      "parameters": [
        {
          "name": "addresses",
          "required": true,
          "note": "comma-separated, EVM 0x\u2026 and/or Solana, max 5"
        },
        {
          "name": "country",
          "required": true,
          "note": "US | UK | DE | IN | CA | AU | JP | BR | SG"
        },
        {
          "name": "chains",
          "required": false
        },
        {
          "name": "tax_year",
          "required": false
        }
      ],
      "price_usd": 12.0,
      "payment_required": true
    },
    {
      "path": "/api/crypto/wallet-sleuth",
      "method": "GET",
      "description": "On-chain wallet investigation \u2014 entity resolution, funding-path trace, top counterparties, sibling (same-funder) wallets, and sanction/phishing/mixer risk screening, each finding with an explorer evidence link.",
      "parameters": [
        {
          "name": "address",
          "required": true,
          "note": "EVM 0x\u2026"
        },
        {
          "name": "chain",
          "required": false,
          "note": "default ethereum"
        },
        {
          "name": "depth",
          "required": false,
          "note": "funding-trace depth 1-5, default 3"
        }
      ],
      "price_usd": 1.5,
      "payment_required": true
    },
    {
      "path": "/api/crypto/wallet-guard",
      "method": "GET",
      "description": "Wallet drainer-protection scan \u2014 enumerates every live token approval (ERC-20/721/1155) across major EVM chains, risk-ranks each spender, returns a prioritized revocation action list. 100% deterministic, no LLM.",
      "parameters": [
        {
          "name": "address",
          "required": true,
          "note": "EVM 0x\u2026"
        },
        {
          "name": "chains",
          "required": false,
          "note": "CSV, default all"
        }
      ],
      "price_usd": 0.5,
      "payment_required": true
    },
    {
      "path": "/api/crypto/wallet-snapshot",
      "method": "GET",
      "description": "Wallet snapshot (lite tier) \u2014 deterministic on-chain stats for one address across major EVM chains: tx count, token-transfer count, wallet age, native balance, account type, risk-flag count. No investigation narrative or approval enumeration; upsells to wallet-guard/wallet-sleuth/wallet-review.",
      "parameters": [
        {
          "name": "address",
          "required": true,
          "note": "EVM 0x\u2026"
        },
        {
          "name": "chains",
          "required": false,
          "note": "CSV, default all"
        }
      ],
      "price_usd": 0.25,
      "payment_required": true
    },
    {
      "path": "/api/crypto/verification-stats",
      "method": "GET",
      "description": "Live citation-gate track record \u2014 findings generated vs. blocked by machine citation-verification across all paid wallet-reviews (blocked = removed, never shown unverified). Check before buying wallet-review.",
      "parameters": [],
      "price_usd": 0,
      "payment_required": false
    },
    {
      "path": "/api/crypto/wallet-watch",
      "method": "GET",
      "description": "Whale-watch \u2014 standing 30-day monitor on one EVM wallet: 15-min sweeps across 6 chains, alerts on transfers \u2265 your USD threshold via webhook and/or polling. Anonymous: watch_id + read_token are the only credentials.",
      "parameters": [
        {
          "name": "address",
          "required": true,
          "note": "EVM 0x\u2026"
        },
        {
          "name": "threshold_usd",
          "required": false,
          "note": "default 10000"
        },
        {
          "name": "webhook",
          "required": false,
          "note": "public https URL"
        },
        {
          "name": "chains",
          "required": false
        }
      ],
      "price_usd": 5.0,
      "payment_required": true
    },
    {
      "path": "/api/crypto/wallet-watch-status",
      "method": "GET",
      "description": "Poll a whale-watch: sweep health + last 100 alerts. Auth = watch_id + read_token from registration.",
      "parameters": [
        {
          "name": "watch_id",
          "required": true
        },
        {
          "name": "token",
          "required": true
        }
      ],
      "price_usd": 0,
      "payment_required": false
    },
    {
      "path": "/api/tax/529-check",
      "method": "GET",
      "description": "529 withdrawal/rollover checker \u2014 K-12/credentialing/Roth gates + CA non-conformity traps (2.5%)",
      "parameters": [
        {
          "name": "country",
          "required": true
        },
        {
          "name": "scenario",
          "required": false
        },
        {
          "name": "lang",
          "required": false
        }
      ],
      "price_usd": 0.5,
      "payment_required": true
    },
    {
      "path": "/api/tax/529-check-lite",
      "method": "GET",
      "description": "529 withdrawal/rollover checker (lite tier) \u2014 same deterministic engine as the full product: verdict + one-line federal headline + California-trap flag. Full breakdown, all flags, and citations are the $0.50 full product.",
      "parameters": [
        {
          "name": "purpose",
          "required": true
        },
        {
          "name": "amount",
          "required": true
        },
        {
          "name": "state",
          "required": false
        }
      ],
      "price_usd": 0.25,
      "payment_required": true
    },
    {
      "path": "/api/tax/aotc-recovery",
      "method": "GET",
      "description": "Missed AOTC recovery \u2014 open 1040-X window screen, up to $2,500/yr + 40% refundable",
      "parameters": [
        {
          "name": "country",
          "required": true
        },
        {
          "name": "scenario",
          "required": false
        },
        {
          "name": "lang",
          "required": false
        }
      ],
      "price_usd": 0.5,
      "payment_required": true
    }
  ],
  "agent_workflow_examples": [
    "Relocation planning: /compare (candidate countries) \u2192 /nomad (optimize base) \u2192 /expat (home country obligations) \u2192 /country (deep dive on winner)",
    "Crypto optimization: /crypto (jurisdiction comparison) \u2192 /country (chosen jurisdiction) \u2192 /nomad (establish residency)",
    "Corporate setup: /structure (design structure) \u2192 /treaty (holding country treaties) \u2192 /country (entity jurisdictions) \u2192 /vat (compliance obligations)",
    "Expat compliance: /expat \u2192 /treaty (home vs host) \u2192 /country (host country rates)",
    "SaaS global expansion: /vat (all markets) \u2192 /structure (IP holding) \u2192 /country (incorporation jurisdiction)"
  ],
  "key_differentiators": [
    "190+ countries covered \u2014 not just US/UK/EU",
    "Crypto CARF/DAC8 reporting \u2014 2026 global exchange reporting is coming",
    "US expat coverage \u2014 9M Americans abroad paying billions in avoidable compliance fees",
    "Digital nomad intelligence \u2014 35M+ nomads globally seeking tax optimization",
    "Pillar Two awareness \u2014 \u20ac750M+ groups face 15% global minimum tax",
    "All responses in any language via ?lang= parameter"
  ],
  "openapi": "https://taxpulse.theaslangroupllc.com/openapi.json",
  "llms_txt": "https://taxpulse.theaslangroupllc.com/llms.txt",
  "contact": "https://taxpulse.theaslangroupllc.com"
}