DocsAPIInvestments

Add token investment

Records the purchase of tokens. Tokens sit outside the cap table: they add to invested capital and acquisition cost and are valued at share_price (the price paid per token) until a token_price valuation or a Token sale proceed marked as valuation basis replaces it – but they never change the fund's shareholding. shares_acquired is the number of tokens and share_class names the token.

POST
/investments/tokens
Body

Example: 10

Example: 2023-06-15

Example: Original

Example: 1000000

Example: USD

Example: 0.85

Example: 250000.5

Example: AAVE

Request Body

application/jsonOptional
portfolio_company_idRequiredstring

Portfolio company the investment belongs to (required) – this is what ties the investment to a fund

Pattern: "^\\d+$"
dateRequiredstring

Date of the investment – when the shares were registered, or the contribution paid in

Pattern: "^\\d{4}-\\d{2}-\\d{2}$"
investment_typestring

Whether this is the fund's first cheque or a follow-on

Value in: "Original" | "Follow-on"
invested_capitalnumber

Capital invested, in the fund's currency

investment_costsarray<object>

Transaction costs booked against the deal

cashflowsarray<object>

How the invested capital was paid in. Must add up to invested_capital.

fieldsobject

Custom fields

currencystring

ISO 4217 currency of the token price

Minimum length: 3Maximum length: 3
share_pricenumber

Price paid per token

shares_acquirednumber

Tokens acquired by the fund. Fractional amounts are allowed.

share_classstring

The token acquired (ticker or name)

Credentials

Bearer
curl -X POST "https://api.fundra.com/v1/investments/tokens" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "portfolio_company_id": "10",
    "date": "2023-06-15",
    "investment_type": "Original",
    "invested_capital": 1000000,
    "investment_costs": [
      {
        "date": "2023-06-15",
        "amount": 1000000
      }
    ],
    "cashflows": [
      {
        "date": "2023-06-15",
        "amount": 1000000
      }
    ],
    "fields": {
      "property1": null,
      "property2": null
    },
    "currency": "USD",
    "share_price": 0.85,
    "shares_acquired": 250000.5,
    "share_class": "AAVE"
  }'

Investment created

{
  "data": {
    "id": "1",
    "uuid": "V1StGXR8",
    "portfolio_company_id": "10",
    "funding_round_id": "5",
    "instrument_type": "primary",
    "date": "2023-06-15",
    "investment_type": "Original",
    "funds_role": "Lead",
    "invested_capital": 1000000,
    "currency": "USD",
    "share_price": 10.5,
    "share_price_discount": 0.1,
    "share_type": "preferred",
    "share_class": "Series A",
    "shares_acquired": 95238,
    "shares_issued": 190476,
    "shares_outstanding": 1190476,
    "esop": 100000,
    "options_held": 0,
    "is_internal_round": false,
    "expiration_date": "2026-06-15",
    "conversion_date": "2024-01-31",
    "convertible_currency": "USD",
    "convertible_value": 500000,
    "convertible_total": 2000000,
    "convertible_cap": 10000000,
    "convertible_cap_type": "pre-money",
    "convertible_discount": 0.2,
    "convertible_interest": 25000,
    "investment_costs": [
      {
        "date": "2023-06-15",
        "amount": 1000000
      }
    ],
    "cashflows": [
      {
        "date": "2023-06-15",
        "amount": 1000000
      }
    ],
    "fields": {
      "property1": null,
      "property2": null
    },
    "created_at": "2023-06-16T10:30:00Z",
    "updated_at": "2023-06-20T14:45:00Z"
  }
}

Previous

Delete investmentDELETE

Next

Update token investmentPATCH