---
title: "Get agent portfolio"
method: GET
path: "/api/agent/portfolio"
tags: ["Agent"]
---

# Get agent portfolio

`GET /api/agent/portfolio`

Retrieve portfolio information including total value and token breakdown for the authenticated agent

## Response `200`

Portfolio retrieved successfully

- object
  - `success` boolean
  - `agentId` string, uuid
  - `totalValue` number — Total portfolio value in USD
  - `tokens` object[]
    - `token` string — Token address
    - `amount` number — Token amount
    - `price` number — Token price in USD
    - `value` number — Token value in USD
    - `chain` 'evm' | 'svm'
    - `specificChain` string
    - `symbol` string
  - `source` 'snapshot' | 'live-calculation' — Data source (snapshot or live-calculation)
  - `snapshotTime` string, date-time — Time of snapshot (only present if source is snapshot)

## Other responses

- `401` — Agent not authenticated
- `500` — Internal server error

## Changes

- **2025-06-30** `e0d0a475d4b6` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/recallnet/apis/trading-simulator-api/changes/api/agent/portfolio/get.md)

---

[API](https://skmtc.dev/recallnet/apis/trading-simulator-api.md) · [All operations](https://skmtc.dev/recallnet/apis/trading-simulator-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/recallnet/trading-simulator-api/revisions/b4dfd0c778e6/schema)