> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oneshotagent.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Portfolio

> Read entities, holdings, performance and transactions from connected Addepar.

Create an API key and secret in Addepar under Firm Administration > API. Enter them in the console with your firm's sign-in address (like `firm.addepar.com`) and your firm ID (the `addepar_firm` value in a Generate API URL link). An address outside Addepar's domain is refused before anything is stored.

Pick connection\_id from GET /v1/connections by system and account\_label, the firm's address.

Every tool accepts connection\_id, limit (1 to 100, default 25) and cursor. Each list returns next\_cursor (null at the end), and every record includes source: `{ system: "addepar", id }`. A page may hold fewer than limit records and still have a next\_cursor.

| Tool | POST route | Filters | Result array |
| - | - | - | - |
| portfolio\_entities | /v1/tools/portfolio/entities | query, type (client, household, legal\_entity, account, fund, all) | entities |
| portfolio\_holdings | /v1/tools/portfolio/holdings | entity\_id, as\_of, group\_by (security, asset\_class, custodian) | holdings |
| portfolio\_performance | /v1/tools/portfolio/performance | entity\_id, start, end, group\_by | performance |
| portfolio\_transactions | /v1/tools/portfolio/transactions | entity\_id, since, until, type (buy, sell, contribution, distribution, capital\_call, income, fee, all) | transactions |

Entities carry id, name, type, parent\_ids, currency and custodian. type maps Addepar's model types; securities are never listed. query matches a partial name within each page. custodian is null when Addepar reports none.

Holdings carry name, security\_id, asset\_class, quantity, market\_value, currency, weight and cost\_basis for one entity as of as\_of (today by default). weight is the share of the entity's total value, 0 to 1. source.id is the security's entity id, else the group's name.

Performance rows carry name, twr, irr, beginning\_value, ending\_value, net\_flows and currency over start to end (year to date by default). The entity's total comes first, then each group. twr and irr are fractions. beginning\_value is null when Addepar's answer names no starting value column or folds it into the ending value.

Transactions carry id, date, type, security, quantity, amount and currency between since and until (the last 90 days by default). Cash dividends and interest income are income; account fees are fee; buy, sell, contribution, distribution and capital\_call keep their names; other classifications are null. Addepar applies the type filter, so each page holds only that type.

```json theme={null}
{
  "connection_id": "11111111-1111-4111-8111-111111111111",
  "entity_id": "1001",
  "start": "2026-07-01",
  "end": "2026-09-30",
  "group_by": "asset_class"
}
```

Records are answered inline only and never stored. Names are untrusted content. Each read makes one call to Addepar under a 30 second deadline; a busy firm answers rate\_limited. Malformed input, bad cursors, a period ending before it starts, and foreign, revoked or expired connections are refused before payment. A refused key leaves the connection inactive. Failed paid reads return account credit.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.