Hanzo

Hanzo Cap Table

Equity management and cap table platform

Hanzo Cap Table

Hanzo Cap Table is an equity management platform for startups and growth-stage companies. Manage share classes, stock options, SAFEs, convertible notes, and equity plans with full audit trails and built-in e-signing.

Features

  • Share Classes: Common, preferred, and custom share classes
  • Stock Options: ISO and NSO option grants with vesting schedules
  • SAFEs: Y Combinator SAFE management with conversion modeling
  • Convertible Notes: Track notes with interest, caps, and discounts
  • Equity Plans: Option pools and equity incentive plans
  • Vesting Schedules: Cliff, linear, and custom vesting
  • 409A Valuations: Track fair market value history
  • E-Signing: Built-in document signing for equity grants
  • Data Rooms: Integrated document management
  • Hanzo IAM SSO: Single sign-on via Hanzo identity

Endpoints

EnvironmentURL
Productionhttps://captable.hanzo.ai

Architecture

+---------------------------------------------------------------+
|                     HANZO CAP TABLE                             |
+---------------------------------------------------------------+
|                                                                |
|  +-----------------------+  +-------------------------------+  |
|  |    Securities         |  |       Stakeholders            |  |
|  |  +------+  +-------+  |  |  +--------+  +-------------+  |  |
|  |  |Shares|  |Options|  |  |  |Founders|  | Investors   |  |  |
|  |  +------+  +-------+  |  |  +--------+  +-------------+  |  |
|  +-----------------------+  +-------------------------------+  |
|                                                                |
|  +-----------------------+  +-------------------------------+  |
|  |    Instruments        |  |       Compliance              |  |
|  |  +------+  +-------+  |  |  +--------+  +-------------+  |  |
|  |  | SAFE |  | Notes |  |  |  | 409A   |  | Audit Log   |  |  |
|  |  +------+  +-------+  |  |  +--------+  +-------------+  |  |
|  +-----------------------+  +-------------------------------+  |
|                                                                |
+---------------------------------------------------------------+

Quick Start

Create a Company

Set up your company profile with incorporation details:

const company = await fetch('https://captable.hanzo.ai/api/company', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${apiToken}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: 'Acme Corp',
    incorporationDate: '2024-01-15',
    incorporationState: 'DE',
    incorporationCountry: 'US'
  })
})

Create Share Classes

// Common stock
await fetch('https://captable.hanzo.ai/api/share-classes', {
  method: 'POST',
  headers: { 'Authorization': `Bearer ${apiToken}` },
  body: JSON.stringify({
    name: 'Common Stock',
    classType: 'COMMON',
    authorizedShares: 10000000,
    parValue: 0.0001,
    votesPerShare: 1
  })
})

// Preferred stock
await fetch('https://captable.hanzo.ai/api/share-classes', {
  method: 'POST',
  headers: { 'Authorization': `Bearer ${apiToken}` },
  body: JSON.stringify({
    name: 'Series Seed Preferred',
    classType: 'PREFERRED',
    authorizedShares: 2000000,
    parValue: 0.0001,
    liquidationPreference: 1.0,
    conversionRatio: 1.0
  })
})

Issue Shares

await fetch('https://captable.hanzo.ai/api/shares/issue', {
  method: 'POST',
  headers: { 'Authorization': `Bearer ${apiToken}` },
  body: JSON.stringify({
    stakeholderId: 'founder-1',
    shareClassId: 'common-stock-id',
    quantity: 5000000,
    pricePerShare: 0.0001,
    vestingSchedule: {
      type: 'CLIFF_LINEAR',
      cliffMonths: 12,
      totalMonths: 48,
      startDate: '2024-01-15'
    }
  })
})

Create a SAFE

await fetch('https://captable.hanzo.ai/api/safes', {
  method: 'POST',
  headers: { 'Authorization': `Bearer ${apiToken}` },
  body: JSON.stringify({
    investorId: 'investor-1',
    investmentAmount: 500000,
    valuationCap: 10000000,
    discount: 0.20,
    proRata: true,
    mfn: true,
    safeType: 'POST_MONEY'
  })
})

Securities Types

TypeDescription
Common StockStandard voting shares
Preferred StockSenior shares with preferences
Stock Options (ISO)Incentive stock options (tax-advantaged)
Stock Options (NSO)Non-qualified stock options
RSUsRestricted stock units
SAFEsSimple Agreement for Future Equity
Convertible NotesDebt instruments convertible to equity
WarrantsRight to purchase shares at a set price

Vesting Schedules

ScheduleDescription
CLIFF_LINEARCliff period then monthly vesting
LINEAREqual monthly vesting from start
BACK_WEIGHTEDAccelerating vesting over time
CUSTOMCustom milestone-based vesting
IMMEDIATEFully vested on grant

Standard 4-Year with 1-Year Cliff

Year 1: 0% → 25% (cliff)
Year 2: 25% → 50% (monthly)
Year 3: 50% → 75% (monthly)
Year 4: 75% → 100% (monthly)

Cap Table Reports

Ownership Summary

View current ownership percentages across all stakeholders, including fully-diluted calculations.

Waterfall Analysis

Model liquidation scenarios to understand payout distributions at various exit valuations.

Round Modeling

Project dilution and ownership changes for future financing rounds.

Authentication

Hanzo Cap Table supports multiple authentication methods:

  • Hanzo IAM: SSO via https://hanzo.id (recommended)
  • Google OAuth: Sign in with Google
  • Passkeys: WebAuthn/FIDO2 authentication

IAM Integration

# Environment variables
HANZO_IAM_URL=https://hanzo.id
HANZO_IAM_CLIENT_ID=app-captable
HANZO_IAM_CLIENT_SECRET=<from-kms>

Self-Hosting

Docker

docker run -d \
  --name hanzo-captable \
  -p 3000:3000 \
  -e DATABASE_URL=postgres://... \
  -e NEXTAUTH_URL=https://captable.yourdomain.com \
  -e HANZO_IAM_URL=https://hanzo.id \
  -e HANZO_IAM_CLIENT_ID=app-captable \
  ghcr.io/hanzoai/captable:latest

Environment Variables

VariableDescription
DATABASE_URLPostgreSQL connection string
NEXTAUTH_URLPublic URL of the application
NEXTAUTH_SECRETNextAuth encryption secret
HANZO_IAM_URLHanzo IAM server URL
HANZO_IAM_CLIENT_IDIAM application client ID
HANZO_IAM_CLIENT_SECRETIAM application client secret
SMTP_HOSTEmail server host
STRIPE_SECRET_KEYStripe billing key

API Reference

Share Classes

  • POST /api/share-classes - Create share class
  • GET /api/share-classes - List share classes
  • PATCH /api/share-classes/:id - Update share class

Stakeholders

  • POST /api/stakeholders - Add stakeholder
  • GET /api/stakeholders - List stakeholders
  • GET /api/stakeholders/:id - Get stakeholder details

Securities

  • POST /api/shares/issue - Issue shares
  • POST /api/options/grant - Grant options
  • POST /api/safes - Create SAFE
  • POST /api/convertible-notes - Create convertible note

Reports

  • GET /api/reports/captable - Current cap table
  • GET /api/reports/waterfall - Waterfall analysis
  • GET /api/reports/409a - 409A valuation history

Next Steps

Document signing platform

Secure document sharing and analytics

Identity and access management

How is this guide?

Last updated on

On this page