What an investor ultimately owns (UBO)
ownership_investor_uboLook up the companies an investor ultimately owns, directly or through subholdings, with current and prior-month shares, percentage, and value by investor ID.
Instructions
The companies one investor ultimately owns, directly and through holding companies (subholdings), with shares, percentage and value now and a month earlier. The investor-side view of ownership_ubo. Investor id from ownership_shareholders_monthly (holders[].investor.id).
Monthly data: first_available_date and last_available_date bound report_date. Works best for individuals; corporate investors often answer empty holdings. Values IDR.
Returns (Stockbit's data field): data{id, name, type{raw}, classification{raw ('Individual'|'Corporate')}, location, nationality, domicile, report_date, first_available_date, last_available_date, grand_total{percentage, total_shares, value, change}, holdings[{company{id, symbol, name}, shareholding{total_shares, percentage, value, price, subholdings[]}, previous_shareholding, change}]}. Corporate investors often answer empty holdings.
Endpoint: GET exodus /insider/ubo.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"investor_id": "<investor_id>"
},
"name": "ownership_investor_ubo"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| investor_id | Yes | Investor id (holders[].investor.id from ownership_shareholders_monthly, or search/v2 insiders[].id). | |
| report_date | No | YYYY-MM-DD end-of-month; omit for the latest. |