{
  "name": "TaxPulse",
  "description": "Global tax code intelligence API. 11 endpoints: 190+ country tax overviews, 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 — 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 — corporate and individual rates across 38+ member countries",
    "Official national tax authority websites — IRS, HMRC, CRA, ATO, DGFIP, BZSt, IRAS, and 150+ others",
    "Tax Foundation — international tax competitiveness index and comparative data",
    "OECD MLI Tracker — Multilateral Instrument modifications to tax treaties",
    "OECD CARF — Crypto Asset Reporting Framework standards",
    "Tavily — real-time synthesis of official government and authoritative sources",
    "Claude Sonnet — 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 — 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.10, "payment_required": true },
    { "path": "/api/tax/compare", "method": "GET", "description": "Side-by-side tax comparison of 2–3 countries — 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 — 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 — 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 — 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 — 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 — 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 — 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.10, "payment_required": true },
    { "path": "/api/crypto/wallet-review", "method": "GET", "description": "Citation-verified crypto wallet tax review — 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… 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.00, "payment_required": true },
    { "path": "/api/crypto/wallet-sleuth", "method": "GET", "description": "On-chain wallet investigation — 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…"}, {"name": "chain", "required": false, "note": "default ethereum"}, {"name": "depth", "required": false, "note": "funding-trace depth 1-5, default 3"}], "price_usd": 1.50, "payment_required": true },
    { "path": "/api/crypto/wallet-guard", "method": "GET", "description": "Wallet drainer-protection scan — 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…"}, {"name": "chains", "required": false, "note": "CSV, default all"}], "price_usd": 0.50, "payment_required": true },
    { "path": "/api/crypto/verification-stats", "method": "GET", "description": "Live citation-gate track record — 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 — standing 30-day monitor on one EVM wallet: 15-min sweeps across 6 chains, alerts on transfers ≥ 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…"}, {"name": "threshold_usd", "required": false, "note": "default 10000"}, {"name": "webhook", "required": false, "note": "public https URL"}, {"name": "chains", "required": false}], "price_usd": 5.00, "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 }
  ],
  "agent_workflow_examples": [
    "Relocation planning: /compare (candidate countries) → /nomad (optimize base) → /expat (home country obligations) → /country (deep dive on winner)",
    "Crypto optimization: /crypto (jurisdiction comparison) → /country (chosen jurisdiction) → /nomad (establish residency)",
    "Corporate setup: /structure (design structure) → /treaty (holding country treaties) → /country (entity jurisdictions) → /vat (compliance obligations)",
    "Expat compliance: /expat → /treaty (home vs host) → /country (host country rates)",
    "SaaS global expansion: /vat (all markets) → /structure (IP holding) → /country (incorporation jurisdiction)"
  ],
  "key_differentiators": [
    "190+ countries covered — not just US/UK/EU",
    "Crypto CARF/DAC8 reporting — 2026 global exchange reporting is coming",
    "US expat coverage — 9M Americans abroad paying billions in avoidable compliance fees",
    "Digital nomad intelligence — 35M+ nomads globally seeking tax optimization",
    "Pillar Two awareness — €750M+ 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"
}