---
title: "Get agent funds"
method: POST
path: "/user/{appId}/agent-funds"
tags: ["User"]
---

# Get agent funds

`POST /user/{appId}/agent-funds`

Returns the token balances held by the agent smart account for a user and app combination

## Path parameters

- `appId` number, required

## Request body

- GetAgentFundsRequest
  - `userControllerAddress` string, required — The Ethereum address of the user controller wallet
  - `networks` string[], required — Networks to query for token balances

## Response `200`

Agent funds returned successfully

- GetAgentFundsResponse
  - `agentAddress` string, required — The derived agent smart account address
  - `tokens` object[], required — List of tokens held by the agent
    - `address` string, required — Wallet address that holds the token
    - `network` string, required — Network identifier
    - `tokenAddress` string, required — Token contract address
    - `tokenBalance` string, required — Token balance in wei/smallest unit
    - `tokenMetadata` object
      - `decimals` number, required — Token decimals
      - `logo` string, nullable, required — Token logo URL
      - `name` string, required — Token name
      - `symbol` string, required — Token symbol
    - `tokenPrices` object[]
      - `currency` string, required — Price currency
      - `value` string, required — Price value
      - `lastUpdatedAt` string, required — Last price update timestamp
    - `error` string, nullable — Error message if applicable
  - `pageKey` string — Pagination key for fetching more results

## Other responses

- `400` — Bad request
- `404` — App not found
- `default` — Error

---

[API](https://skmtc.net/lit-protocol/apis/vincent-registry-api.md) · [All operations](https://skmtc.net/lit-protocol/apis/vincent-registry-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lit-protocol/vincent-registry-api/versions/825608de85fb/schema)