{
  "name": "TaxPulse",
  "description": "Global tax code intelligence API. 8 endpoints covering 190+ countries: full 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), and VAT/GST compliance. Powered by OECD data, official tax authorities, and Claude. Pay-per-query via x402 on Base.",
  "url": "https://taxpulse-phi.vercel.app",
  "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"
  ],
  "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 }
  ],
  "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-phi.vercel.app/openapi.json",
  "llms_txt": "https://taxpulse-phi.vercel.app/llms.txt",
  "contact": "https://taxpulse-phi.vercel.app"
}