AINumbers.co Equity API

The equity API from AINumbers.co — 1 operation(s) for equity.

Operations 1

POST /v1/tools/calc_equity_exit_waterfall Equity Exit Waterfall Modeler #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/ainumbers-co:ainumbers-co-equity-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

ainumbers-co-equity-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: AINumbers.co Fintech Intelligence Suite Equity API
  version: 1.0.0
  description: '**1255 fintech intelligence tools** covering ISO 20022, A2A payments, CFPB §1033, EU AI Act, DORA, MiCA, AML/KYC, BaaS, DLT/tokenization, ESG/climate finance, agentic payments (AP2, ACP, x402, Visa TAP, Mastercard Agent Pay), PQC migration, sanctions screening, and OpenChainGraph v0.4 computation chains.


    ## Transport


    > **The live transport is MCP JSON-RPC 2.0 at `https://mcp.ainumbers.co/mcp` — not REST.**

    >

    > This OpenAPI file is a **descriptive data-room artifact** — a machine-readable index of all tools and their input/output schemas. The REST paths (`POST /v1/tools/{name}`) described here are a projection; they become functional only if the optional REST shim (Area 2 Path B) is deployed.

    >

    > To call tools today, connect via the official MCP client SDKs. TypeScript: `@modelcontextprotocol/sdk`. Python: `mcp`.


    ## Architecture


    All tools run **entirely client-side** (browser JavaScript). Zero PII. Zero server calls after page load. Deterministic, reproducible outputs. Licensed CC BY 4.0.


    OpenChainGraph v0.4 compute-binding nodes additionally run **server-side on the MCP Worker** and emit verifiable artifacts with `execution_hash` (WebCrypto SHA-256 over RFC 8785 canonical JSON).'
  contact:
    name: Post Oak Labs
    url: https://postoaklabs.com
    email: tim@postoaklabs.com
  license:
    name: CC BY 4.0
    url: https://creativecommons.org/licenses/by/4.0/
servers:
- url: https://ainumbers.co
  description: Static browser-based tool host (DreamHost). Tools run client-side — no REST gateway is active on this origin. See x-mcp for the live MCP endpoint.
tags:
- name: equity
paths:
  /v1/tools/calc_equity_exit_waterfall:
    post:
      operationId: calc_equity_exit_waterfall
      summary: Equity Exit Waterfall Modeler
      description: 'Equity exit proceeds after a liquidation-preference waterfall for startup employees and founders: the preference stack layer by layer, non-participating conversion or capped participation, the common pool, your gross and net proceeds after option strike, taxable gain per IRC §1001 and the break-even exit valuation. Port of Apex #141 (al_id AL-148). Port of ApexLogics tool 141-equity-exit-waterfall (https://apexlogics.org/tools/141-equity-exit-waterfall/ fetched 2026-10-06, AL-148), tasking APEXPORT-141 (GRADES PASS-PENDING-XV 2026-10-07, Builder-verifies-at-land 18/18 vectors re-executed 2026-10-21), landed by APEX-PORT-141-LAND-1.


        **Tool URL:** https://ainumbers.co/chaingraph/art-754-equity-exit-waterfall.html

        **AP2/Policy Mandate export:** yes'
      tags:
      - equity
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - exit_valuation_usd
              - total_preferred_invested_usd
              - preferred_ownership_pct
              - liquidation_preference_multiple
              - participation_type
              - participation_cap_multiple
              - your_role
              - your_ownership_pct
              - your_option_strike_total_usd
              - your_cost_basis_usd
              properties:
                exit_valuation_usd:
                  type: number
                  description: Total exit valuation in USD. Must be positive.
                total_preferred_invested_usd:
                  type: number
                  description: Aggregate liquidation preference amount (total preferred invested) in USD.
                preferred_ownership_pct:
                  type: number
                  description: Preferred ownership percentage (fully-diluted), 0-100.
                liquidation_preference_multiple:
                  type: number
                  description: Liquidation preference multiple (e.g., 1, 1.5, 2, 3).
                participation_type:
                  type: string
                  description: 'Participation type: ''non'', ''full'', or ''capped''.'
                  enum:
                  - non
                  - full
                  - capped
                participation_cap_multiple:
                  type: number
                  description: Participation cap as multiple of invested (e.g., 3 means 3x invested).
                your_role:
                  type: string
                  description: 'Your role: ''common'', ''founder'', ''employee'', or ''preferred''.'
                  enum:
                  - common
                  - founder
                  - employee
                  - preferred
                your_ownership_pct:
                  type: number
                  description: Your ownership percentage (fully-diluted), 0-100.
                your_option_strike_total_usd:
                  type: number
                  description: Total option exercise cost in USD. Enter 0 for RSAs or vested stock.
                your_cost_basis_usd:
                  type: number
                  description: Your cost basis for tax gain calculation in USD.
      responses:
        '200':
          description: Successful tool execution result
          content:
            application/json:
              schema:
                type: object
                properties:
                  break_even_exit_usd:
                    type:
                    - number
                    - 'null'
                  common_pool_usd:
                    type:
                    - number
                    - 'null'
                  compliance_flags:
                    type: array
                    items:
                      type: string
                  exit_valuation_usd:
                    type: number
                  layers:
                    type:
                    - array
                    - 'null'
                  liquidation_preference_multiple:
                    type: number
                  liquidation_preference_usd:
                    type:
                    - number
                    - 'null'
                  notes:
                    type: array
                    items:
                      type: string
                  participation_cap_multiple:
                    type: number
                  participation_type:
                    type: string
                    enum:
                    - capped
                    - full
                    - non
                  preferred_ownership_fraction:
                    type: number
                  preferred_total_usd:
                    type:
                    - number
                    - 'null'
                  refusal_reason:
                    type:
                    - 'null'
                    - string
                  switches:
                    type: object
                    properties:
                      apex_faithful_mode:
                        type: boolean
                      pref_wins_warning_threshold:
                        type: number
                      refuse_non_finite_input:
                        type: boolean
                    required:
                    - apex_faithful_mode
                    - pref_wins_warning_threshold
                    - refuse_non_finite_input
                    additionalProperties: false
                  total_preferred_invested_usd:
                    type: number
                  warnings:
                    type: array
                    items:
                      type: string
                  your_cost_basis_usd:
                    type: number
                  your_gross_proceeds_usd:
                    type:
                    - number
                    - 'null'
                  your_net_proceeds_usd:
                    type:
                    - number
                    - 'null'
                  your_option_strike_total_usd:
                    type: number
                  your_ownership_fraction:
                    type: number
                  your_role:
                    type: string
                    enum:
                    - common
                    - employee
                    - preferred
                  your_taxable_gain_usd:
                    type:
                    - number
                    - 'null'
                required:
                - break_even_exit_usd
                - common_pool_usd
                - compliance_flags
                - exit_valuation_usd
                - layers
                - liquidation_preference_multiple
                - liquidation_preference_usd
                - notes
                - participation_cap_multiple
                - participation_type
                - preferred_ownership_fraction
                - preferred_total_usd
                - refusal_reason
                - switches
                - total_preferred_invested_usd
                - warnings
                - your_cost_basis_usd
                - your_gross_proceeds_usd
                - your_net_proceeds_usd
                - your_option_strike_total_usd
                - your_ownership_fraction
                - your_role
                - your_taxable_gain_usd
                additionalProperties: false
                x-derived-from: fixture
      x-mcp-tool-name: calc_equity_exit_waterfall
      x-tool-url: https://ainumbers.co/chaingraph/art-754-equity-exit-waterfall.html
      x-source: manifest
      x-ap2-export: true
x-mcp:
  transport: MCP JSON-RPC 2.0 (streamable HTTP)
  endpoint: https://mcp.ainumbers.co/mcp
  protocol_version: '2025-11-25'
  authentication: none
  registry: co.ainumbers/tools (official MCP registry)
  note: Connect any MCP-compatible client (Claude, ChatGPT, custom agent) directly to this endpoint. The REST paths in this file are descriptive only — they do not exist on the live server unless the REST shim is deployed.