---
title: "Get the wallet and protocol holdings of a given address"
method: GET
path: "/v1/agent/portfolio"
---

# Get the wallet and protocol holdings of a given address

`GET /v1/agent/portfolio`

## Request

- Base URL: `https://api.octav.fi` (the document declares no server; this is the origin it was published from)
- URL: `https://api.octav.fi/v1/agent/portfolio`
- Auth: none declared
- TypeScript: <https://skmtc.dev/octav/apis/octav-api/docs/v1/agent/portfolio/get.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `addresses` string, required
- `aggregated` boolean
- `includeNFTs` boolean
- `includeImages` boolean
- `includeExplorerUrls` boolean
- `waitForSync` boolean

## Response `200`

Portfolio data including wallet holdings and DeFi protocol positions

## Other responses

- `402`: Payment Required

---

[API](https://skmtc.dev/octav/apis/octav-api.md) - [All operations](https://skmtc.dev/octav/apis/octav-api/llms.txt) - [OpenAPI document](https://skmtc.dev/octav/apis/octav-api/revisions/977c80f55f7e?raw)