{
  "openapi": "3.1.0",
  "info": {
    "title": "VenturePulse API",
    "description": "Startup funding intelligence API. VC round data, investor matching, pitch deck scoring, term sheet decoding, cap table modeling, global accelerator directory, market sizing, legal formation, comparable deals, and due diligence prep. All endpoints require x402 payment (USDC on Base mainnet) via the PAYMENT-SIGNATURE header.",
    "version": "1.0.0",
    "contact": {
      "url": "https://venturepulse.vercel.app",
      "email": "info@theaslangroupllc.com"
    }
  },
  "servers": [
    { "url": "https://venturepulse-nine.vercel.app" }
  ],
  "components": {
    "securitySchemes": {
      "x402": {
        "type": "apiKey",
        "in": "header",
        "name": "PAYMENT-SIGNATURE",
        "description": "x402 payment signature (USDC on Base mainnet). Send a GET request without this header to receive a 402 with payment requirements. Sign the payment and retry."
      }
    }
  },
  "security": [{ "x402": [] }],
  "paths": {
    "/api/startup/funding-search": {
      "get": {
        "summary": "VC funding round intelligence",
        "description": "Search recent VC funding rounds by sector, stage, and region. Returns recent deals with amounts and lead investors, active investor list with thesis, funding trends, and current investor sentiment.",
        "operationId": "fundingSearch",
        "parameters": [
          { "name": "sector", "in": "query", "required": false, "schema": { "type": "string", "default": "any" }, "description": "fintech | saas | biotech | ai | climate | consumer | b2b | deeptech | any" },
          { "name": "stage", "in": "query", "required": false, "schema": { "type": "string", "default": "any" }, "description": "pre-seed | seed | series-a | series-b | growth | any" },
          { "name": "region", "in": "query", "required": false, "schema": { "type": "string", "default": "global" }, "description": "us | eu | uk | apac | latam | mena | africa | global" },
          { "name": "lang", "in": "query", "required": false, "schema": { "type": "string", "default": "en" }, "description": "en | es | fr | de | ja | pt | it | nl | ko | zh | ar" }
        ],
        "responses": {
          "200": { "description": "Funding round intelligence with recent deals, active investors, and market sentiment" },
          "402": { "description": "Payment required — x402 payment requirements in PAYMENT-REQUIRED header" }
        }
      }
    },
    "/api/startup/investor-match": {
      "get": {
        "summary": "Investor matching engine",
        "description": "Given a startup description, returns matched VCs, angels, and CVCs with thesis alignment, check sizes, portfolio examples, approach tips, and global coverage across US, EU, UK, APAC, LATAM, MENA, Africa.",
        "operationId": "investorMatch",
        "parameters": [
          { "name": "description", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Plain English description of your startup — what it does, for whom, how it makes money" },
          { "name": "stage", "in": "query", "required": false, "schema": { "type": "string", "default": "seed" }, "description": "pre-seed | seed | series-a | series-b" },
          { "name": "sector", "in": "query", "required": false, "schema": { "type": "string", "default": "any" }, "description": "fintech | saas | biotech | ai | climate | consumer | b2b | deeptech | any" },
          { "name": "region", "in": "query", "required": false, "schema": { "type": "string", "default": "global" }, "description": "us | eu | uk | apac | latam | mena | africa | global" },
          { "name": "check_size", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Target check size in USD — e.g. 500000" },
          { "name": "lang", "in": "query", "required": false, "schema": { "type": "string", "default": "en" } }
        ],
        "responses": {
          "200": { "description": "Matched investors with thesis, check sizes, portfolio examples, and approach tips" },
          "402": { "description": "Payment required" }
        }
      }
    },
    "/api/startup/pitch-score": {
      "get": {
        "summary": "Pitch deck scoring",
        "description": "Score a pitch deck or company description against Sequoia, a16z, and YC evaluation frameworks across 8 dimensions: problem, solution, market size, business model, traction, team, moat, and ask. Returns specific improvement notes and exact VC challenge questions.",
        "operationId": "pitchScore",
        "parameters": [
          { "name": "description", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Paste your pitch deck text, executive summary, or detailed company description" },
          { "name": "stage", "in": "query", "required": false, "schema": { "type": "string", "default": "seed" }, "description": "pre-seed | seed | series-a | series-b" },
          { "name": "sector", "in": "query", "required": false, "schema": { "type": "string", "default": "any" }, "description": "fintech | saas | biotech | ai | climate | consumer | b2b | deeptech | any" },
          { "name": "lang", "in": "query", "required": false, "schema": { "type": "string", "default": "en" } }
        ],
        "responses": {
          "200": { "description": "Pitch score across 8 dimensions with specific improvement notes and VC challenge questions" },
          "402": { "description": "Payment required" }
        }
      }
    },
    "/api/startup/term-sheet": {
      "get": {
        "summary": "Term sheet decoder",
        "description": "Decode any term sheet into plain English. Explains every clause, flags founder-hostile terms (participating preferred, full-ratchet anti-dilution, >1x liquidation preference), compares against market norms, and provides specific negotiation guidance.",
        "operationId": "termSheet",
        "parameters": [
          { "name": "terms", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Paste the full term sheet text or describe specific clauses to decode" },
          { "name": "stage", "in": "query", "required": false, "schema": { "type": "string", "default": "seed" }, "description": "pre-seed | seed | series-a | series-b" },
          { "name": "is_safe", "in": "query", "required": false, "schema": { "type": "string", "default": "false" }, "description": "true | false — whether this is a SAFE note" },
          { "name": "lang", "in": "query", "required": false, "schema": { "type": "string", "default": "en" } }
        ],
        "responses": {
          "200": { "description": "Term sheet analysis with red flags, market norms, and negotiation guidance" },
          "402": { "description": "Payment required" }
        }
      }
    },
    "/api/startup/cap-table": {
      "get": {
        "summary": "Cap table dilution modeler",
        "description": "Model cap table dilution across funding rounds. Input current ownership percentages and proposed round details; returns post-round ownership table, dilution percentages, option pool impact, and exit scenarios at multiple valuations.",
        "operationId": "capTable",
        "parameters": [
          { "name": "founders_pct", "in": "query", "required": true, "schema": { "type": "number" }, "description": "Current founder ownership percentage — e.g. 80" },
          { "name": "raise_usd", "in": "query", "required": true, "schema": { "type": "number" }, "description": "Amount being raised in USD — e.g. 2000000" },
          { "name": "pre_money_usd", "in": "query", "required": true, "schema": { "type": "number" }, "description": "Pre-money valuation in USD — e.g. 8000000" },
          { "name": "existing_investors_pct", "in": "query", "required": false, "schema": { "type": "number", "default": 0 }, "description": "Existing investor ownership percentage" },
          { "name": "option_pool_pct", "in": "query", "required": false, "schema": { "type": "number", "default": 10 }, "description": "Current option pool percentage" },
          { "name": "option_pool_increase_pct", "in": "query", "required": false, "schema": { "type": "number", "default": 0 }, "description": "New option pool percentage required by investors" },
          { "name": "structure", "in": "query", "required": false, "schema": { "type": "string", "default": "priced" }, "description": "priced | safe | note" },
          { "name": "stage", "in": "query", "required": false, "schema": { "type": "string", "default": "seed" } },
          { "name": "sector", "in": "query", "required": false, "schema": { "type": "string", "default": "any" } },
          { "name": "lang", "in": "query", "required": false, "schema": { "type": "string", "default": "en" } }
        ],
        "responses": {
          "200": { "description": "Post-round cap table with dilution percentages and exit scenario modeling" },
          "402": { "description": "Payment required" }
        }
      }
    },
    "/api/startup/accelerator": {
      "get": {
        "summary": "Global accelerator directory",
        "description": "Find the best accelerator and incubator programs for your startup globally. Covers YC, Techstars, 500 Global, Antler, Entrepreneur First, and 50+ regional programs across EU, APAC, LATAM, MENA, Africa with equity terms, funding amounts, deadlines, and acceptance rates.",
        "operationId": "accelerator",
        "parameters": [
          { "name": "sector", "in": "query", "required": false, "schema": { "type": "string", "default": "any" }, "description": "fintech | saas | biotech | ai | climate | consumer | b2b | deeptech | any" },
          { "name": "stage", "in": "query", "required": false, "schema": { "type": "string", "default": "pre-seed" }, "description": "idea | pre-seed | seed | series-a" },
          { "name": "region", "in": "query", "required": false, "schema": { "type": "string", "default": "global" }, "description": "us | eu | uk | apac | latam | mena | africa | global" },
          { "name": "equity_max", "in": "query", "required": false, "schema": { "type": "number", "default": 10 }, "description": "Maximum equity percentage willing to give up — e.g. 7" },
          { "name": "lang", "in": "query", "required": false, "schema": { "type": "string", "default": "en" } }
        ],
        "responses": {
          "200": { "description": "Matched accelerator programs with equity terms, deadlines, acceptance rates, and application tips" },
          "402": { "description": "Payment required" }
        }
      }
    },
    "/api/startup/market-size": {
      "get": {
        "summary": "TAM/SAM/SOM market size analysis",
        "description": "Build a credible market size analysis that survives VC scrutiny. Returns TAM, SAM, and SOM with both top-down and bottom-up methodologies, growth rates, comparable company data, VC stress-test questions, and how to defend each number.",
        "operationId": "marketSize",
        "parameters": [
          { "name": "description", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Describe your market or product — what you sell, to whom, in what geography" },
          { "name": "geography", "in": "query", "required": false, "schema": { "type": "string", "default": "global" }, "description": "global | us | eu | uk | apac | latam | mena | africa | specific country" },
          { "name": "approach", "in": "query", "required": false, "schema": { "type": "string", "default": "both" }, "description": "top-down | bottom-up | both" },
          { "name": "lang", "in": "query", "required": false, "schema": { "type": "string", "default": "en" } }
        ],
        "responses": {
          "200": { "description": "TAM/SAM/SOM analysis with methodology, growth rates, VC stress-tests, and defense guidance" },
          "402": { "description": "Payment required" }
        }
      }
    },
    "/api/startup/legal-formation": {
      "get": {
        "summary": "Startup legal formation guide",
        "description": "Country-specific startup formation guidance for 15+ jurisdictions. Covers structure selection, key documents, formation steps and costs, investor tax incentives (SEIS/EIS UK, QSBS US, ESIC Australia), startup visas, and recommended formation services.",
        "operationId": "legalFormation",
        "parameters": [
          { "name": "country", "in": "query", "required": true, "schema": { "type": "string" }, "description": "US | UK | CA | AU | SG | IE | DE | FR | IN | BR | NL | SE | IL | NZ | JP | KR" },
          { "name": "founder_locations", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Where founders are located — e.g. US, Germany (default: same as country)" },
          { "name": "target_markets", "in": "query", "required": false, "schema": { "type": "string", "default": "global" }, "description": "Where you plan to sell — e.g. US, EU" },
          { "name": "lang", "in": "query", "required": false, "schema": { "type": "string", "default": "en" } }
        ],
        "responses": {
          "200": { "description": "Formation guide with structure recommendation, steps, costs, tax incentives, and formation services" },
          "402": { "description": "Payment required" }
        }
      }
    },
    "/api/startup/comparable": {
      "get": {
        "summary": "Comparable deal benchmarks",
        "description": "What companies at your stage, sector, and region raised — round sizes, pre-money valuations, dilution percentages, lead investor types, and time-to-close benchmarks from publicly available funding data.",
        "operationId": "comparable",
        "parameters": [
          { "name": "description", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Brief description of your startup — sector, model, geography" },
          { "name": "stage", "in": "query", "required": false, "schema": { "type": "string", "default": "seed" }, "description": "pre-seed | seed | series-a | series-b" },
          { "name": "sector", "in": "query", "required": false, "schema": { "type": "string", "default": "any" }, "description": "fintech | saas | biotech | ai | climate | consumer | b2b | deeptech | any" },
          { "name": "region", "in": "query", "required": false, "schema": { "type": "string", "default": "global" }, "description": "us | eu | uk | apac | latam | mena | africa | global" },
          { "name": "lang", "in": "query", "required": false, "schema": { "type": "string", "default": "en" } }
        ],
        "responses": {
          "200": { "description": "Comparable deal benchmarks with specific company examples and median statistics" },
          "402": { "description": "Payment required" }
        }
      }
    },
    "/api/startup/due-diligence": {
      "get": {
        "summary": "Investor due diligence prep",
        "description": "Prepare for investor due diligence. Returns data room folder structure with must-have documents, what VCs verify at each stage, red flags that kill deals, sector-specific requirements, legal and financial checklists, and data room tool recommendations.",
        "operationId": "dueDiligence",
        "parameters": [
          { "name": "stage", "in": "query", "required": false, "schema": { "type": "string", "default": "seed" }, "description": "seed | series-a | series-b | growth" },
          { "name": "sector", "in": "query", "required": false, "schema": { "type": "string", "default": "any" }, "description": "fintech | saas | biotech | ai | climate | consumer | b2b | deeptech | any" },
          { "name": "region", "in": "query", "required": false, "schema": { "type": "string", "default": "global" }, "description": "us | eu | uk | apac | global" },
          { "name": "focus", "in": "query", "required": false, "schema": { "type": "string", "default": "all" }, "description": "legal | financial | technical | all" },
          { "name": "lang", "in": "query", "required": false, "schema": { "type": "string", "default": "en" } }
        ],
        "responses": {
          "200": { "description": "Due diligence preparation guide with data room structure, checklists, and deal-killer red flags" },
          "402": { "description": "Payment required" }
        }
      }
    }
  }
}
