v1

latestOpenAPI 3.0.02026-07-175152156.1 KB
User

Get agent funds

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

post/user/{appId}/agent-funds

Path parameters

appIdnumber required

ID of the target application

Request body

userControllerAddressstring required

The Ethereum address of the user controller wallet

networksstring[] required

Networks to query for token balances

Example request

{
  "userControllerAddress": "0x123456789012345678901234567890123456abcd",
  "networks": [
    "base-mainnet",
    "base-sepolia"
  ]
}

Response

Agent funds returned successfully

agentAddressstring required

The derived agent smart account address

pageKeystring

Pagination key for fetching more results

Example response

{
  "agentAddress": "0x123456789012345678901234567890123456abcd",
  "tokens": [
    {
      "network": "base-mainnet",
      "tokenMetadata": {
        "decimals": 18,
        "name": "USD Coin",
        "symbol": "USDC"
      },
      "tokenPrices": [
        {
          "currency": "usd",
          "value": "1.00",
          "lastUpdatedAt": "2024-01-01T00:00:00Z"
        }
      ]
    }
  ]
}