Asset Cap table

Asset Cap table summary by shareholders

To get a summary per shareholders of a portfolio company capital structure.


HTTP Method	GET
URL	For customers based in China or Hongkok, please use this URL. https://edgewebapi.chinacloudsites.cn For customers in other regions, please use https://edge-webapi.azurewebsites.net
Path	/api/CapTable/summary/shareholders/{assetId}/{asOfDate}
Request parameter	assetID: A unique string ID of the portfolio company, this can be found by requesting an asset list from this API List of asset entity objects {asOfDate} : A date string in the format YYYY-MM-DD
Reference	Public API: A company cap table break down by share holder.

Response

The returned result from this API contains an array of shareholders' holdings. Each item in an array contains information about the shareholder's name, number of shares, total contribution, and ownership. Below are field names and their definitions.

Field name	Definition
shareholderName	Shareholder's name
totalNumberOfShares	Total number of shares
totalPercentOwnership	The fully diluted percent ownership
totalContribution	Total capital contribution
totalIssuedNumberOfShares	The total number of shares issued to this shareholder, the number will be different from the fully diluted number of shares when there are options or warrants issued.
totalIssuedOwnership	The total issued percent ownership held by this shareholder, number will be different from the fully diluted percent ownership when there are options or warrants issued.
instrumentHoldings	An array containing instruments information in more details such as the instrument type, investment round, issue date and amount
shareholders	In case there are multiple shareholders with the same shareholder group, this array will contain the information breakdown into individual shareholders' holding.

Example of JSON Output

[
  {   
    "assetId": "5e38fce6cc34d70e80d7563f",
    "shareholderId": "5ee078212c2cb80a8864badd",
    "shareholderName": "Shareholdes' group name (e.g. Founders)",
    "totalNumberOfShares": 200,
    "totalPercentOwnership": 0.0196078431372549,
    "totalContribution": 1800000,
    "totalIssuedNumberOfShares": 200,
    "totalIssuedOwnership": 0.0196078431372549,
    "instrumentHoldings": [
      {
        "instrumentId": "5f0fddea51384a09f8601167",
        "instrumentName": "Common share",
        "investmentRound": "Angel",
        "issueDate": "2018-02-01",
        "numberOfShares": 200,
        "capitalContribution": 1800000,
        "isIssuedShare": true,
        "cumulativeNumberOfShares": 0,
        "ownershipPercent": 0,
        "issueType": "New issue",
        "splitRatio": 0
      }
    ],
    "shareholders": [
      {
        "assetId": "5e38fce6cc34d70e80d7563f",
        "shareholderId": "5ee07d732c2cb80a8864bae1",
        "shareholderName": "Steve Job",
        "totalNumberOfShares": 200,
        "totalPercentOwnership": 0.0196078431372549,
        "totalContribution": 1800000,
        "totalIssuedNumberOfShares": 200,
        "totalIssuedOwnership": 0.0196078431372549,
        "instrumentHoldings": [
          {
            "instrumentId": "5f0fddea51384a09f8601167",
            "instrumentName": "Common share",
            "investmentRound": "Angel",
            "issueDate": "2018-02-01",
            "numberOfShares": 200,
            "capitalContribution": 1800000,
            "isIssuedShare": true,
            "cumulativeNumberOfShares": 0,
            "ownershipPercent": 0,
            "issueType": "New issue",
            "splitRatio": 0
          }
        ],
        "shareholders": null
      }
    ]
  },
  {
    // other share holders' holding
    // ...
  }
]

Asset Cap table summary by investment round

This API provides the overall company cap table information break down by investment round including the pre/post-money valuation and price per share information.


HTTP Method	GET
URL	For customers based in China or Hongkok, please use this URL. https://edgewebapi.chinacloudsites.cn For customers in other regions, please use https://edge-webapi.azurewebsites.net
Path	/api/CapTable/summary/investmentround/{assetId}/{asOfDate}
Request parameter	assetID: A unique string ID of the portfolio company, this can be found by requesting an asset list from this API List of asset entity objects {asOfDate} : A date string in the format YYYY-MM-DD
Reference	Public API: A company cap table break down by investment round then by share holder

Response

The returned result from this API contains a JSON object which contains 3 parts

investmentRoundSummary: this part is an array of investment round summaries. Inside each round, there is information about an instrument type, investment date, capital contribution, the number of shares issued, and the shareholders participating in each round.
investmentRoundTotal: This part is the total number of the investmentRoundSummary section
investmentRoundValuation: This part contains the valuation of the company in each fundraising round. It contains the price per share, pre-money valuation and post-money valuation information

JSON output example

{
  "investmentRoundSummary": [
    {
      "assetId": "5e38fce6cc34d70e80d7563f",
      "instrumentId": "5f0fddea51384a09f8601167",
      "instrumentName": "Common share",
      "roundNames": [
        "Angel (2018-02-01)",
        "Seed (2021-01-01)"
      ],
      "issueTypes": [
        "New issue",
        "New issue"
      ],
      "shareholdersHolding": [
        {
          "shareholderId": "5ee07d732c2cb80a8864bae1",
          "shareholderName": "Founder",
          "instrumentHoldings": [
            {
              "instrumentId": "5f0fddea51384a09f8601167",
              "instrumentName": "Common share",
              "investmentRound": "Angel",
              "issueDate": "2018-02-01",
              "numberOfShares": 200,
              "capitalContribution": 1800000,
              "isIssuedShare": false,
              "cumulativeNumberOfShares": 200,
              "ownershipPercent": 1,
              "issueType": "New issue",
              "splitRatio": 0
            },
            {
              //..instrument details as of each investment round
            }
          ]
        },
        {
          // ... Other shareholder's holding in this round.
        }
      ]
    }
  ],
  "investmentRoundTotal": [
    {
      "issueType": "New issue",
      "capitalContribution": 1800000,
      "numberOfShares": 200,
      "cumulativeNumberOfShares": 200,
      "ownershipPercent": 1
    },
    {
      "issueType": "New issue",
      "capitalContribution": 1000000,
      "numberOfShares": 10000,
      "cumulativeNumberOfShares": 10200,
      "ownershipPercent": 1
    }
  ],
  "investmentRoundValuation": [
    {
      "issueType": "New issue",
      "preMoney": 0,
      "fundRaising": 1800000,
      "postMoney": 1800000,
      "pricePerShare": 9000,
      "dilutedPercent": 1
    },
    {
      "issueType": "New issue",
      "preMoney": 20000,
      "fundRaising": 1000000,
      "postMoney": 1020000,
      "pricePerShare": 100,
      "dilutedPercent": 0.9803921568627451
    }
  ]
}