How to query
In order to retrieve liquidity events you need an individual’s ID, obtained from the Acuris HNWI Search API:
{
{…},
"results": [
{
"id": "prime-000000"
{…},
},
{…}
]
}
You can then call the HNWI Liquidity Event API endpoint and get the related liquidity events:
curl -H 'Authorization: Bearer YOUR_API_KEY' https://api.acuris.com/individuals/{id}/liquidityevents
Response
The response includes all the potential and completed liquidity events as well as latest emoluments that contribute to the individual’s total wealth.
For each liquidity event the associated company, the type of event, its value, date, source and related content are provided.
{
"results": [
{
"wealthType": "completed",
"eventDate": "2020-05-11T00:00:00.000Z",
"valueInMillions": [
{
"currencyCode": "AUD",
"minValue": 63.1377,
"maxValue": 63.1377
},
{…}
],
"notes": "Based on the sale of 2,575,000 shares …",
"company": {
"mmgid": "prime-444135",
"name": "Virgin Galactic Holdings, Inc."
},
"type": {
"mmgid": "prime-stakesale",
"name": "Stake sale"
},
"intelligence": {
"mmgid": "prime-3033782"
}
},
{
"wealthType": "potential",
"eventDate": "2020-05-11T00:00:00.000Z",
"valueInMillions": [
{
"currencyCode": "AUD",
"minValue": 2261.6552,
"maxValue": 2261.6552
},
{…}
],
"notes": "Based on the price of USD 16.39 per share, …",
"company": {
"mmgid": "prime-444135",
"name": "Virgin Galactic Holdings, Inc."
},
"type": {
"mmgid": "prime-potstakesale",
"name": "Pot. stake sale"
},
"intelligence": {
"mmgid": "prime-3033782"
}
},
{…}
]
}
For individuals whose profile haven’t been researched by the Wealthmonitor team the response provides the name.