Get Wallet Balance

Fetch the current native asset balance and a list of token balances for a connected wallet. Use this before assigning a wallet to an agent to verify there is sufficient capital for trading.

Endpoint

GET /v1/wallets/{wallet_id}/balance

Path parameters

string

required

Unique identifier of the connected wallet.

Example request

curl -H "Authorization: Bearer $ELUUP_API_KEY" \
  "https://api.eluup.ai/v1/wallets/wallet_1aB3cD5e/balance"

Response

string

Wallet identifier.

float

Native asset balance (ETH on Base, BNB on BNB Chain) expressed in USD.

array

Array of token balance objects.

string

Token contract address.

string

Token symbol.

float

Token balance in the token’s native units.

float

Token balance expressed in USD.

integer

Unix timestamp of the last balance refresh.

Example response

{
  "wallet_id": "wallet_1aB3cD5e",
  "native_balance_usd": 1250.45,
  "token_balances": [
    {
      "token_address": "0x532f27101965dd16442E59d40670FaF5eBB142E4",
      "token_symbol": "BRETT",
      "balance": 150000.0,
      "balance_usd": 5130.00
    },
    {
      "token_address": "0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed",
      "token_symbol": "DEGEN",
      "balance": 500000.0,
      "balance_usd": 1050.00
    }
  ],
  "updated_at": 1716400000
}

⌘I

Overview

Signals

Agents

Trades

Wallets

Account

Get Wallet Balance

Endpoint

Path parameters

Example request

Response

Example response

​Endpoint

​Path parameters

​Example request

​Response

​Example response

Endpoint

Path parameters

Example request

Response

Example response