Get Vault Value

GET /v1/vault/:address/value — get the total USD value of a vault with per-token breakdown.

Get Vault Value

GET/v1/vault/:address/value

Returns the total USD value of a vault, summing all known token balances and native ETH priced via on-chain oracles. Includes a per-token breakdown with balances, prices, and individual USD values.

This is a read-only endpoint that does not require bot authentication -- any caller can query vault value by address and chain ID.

Path Parameters

Query Parameters

Response

{
  "vault": "0x05c6ab8c7b0b1bb42980d9b6a4cb666f0af424c7",
  "chainId": 84532,
  "totalValueUsd": 18.17,
  "tokens": [
    {
      "token": "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
      "symbol": "USDC",
      "balance": "14355307",
      "decimals": 6,
      "priceUsd": 1.0,
      "valueUsd": 14.36
    }
  ]
}

VaultValueToken

Error Responses

Status	Code	Description
`400`	`BAD_REQUEST`	Missing or invalid `chainId` query parameter.
`429`	`RATE_LIMITED`	Too many requests. Check the `Retry-After` header.

Example

curl

curl "https://relay.axonfi.xyz/v1/vault/0x05c6ab8c7b0b1bb42980d9b6a4cb666f0af424c7/value?chainId=84532"

Response

{
  "vault": "0x05c6ab8c7b0b1bb42980d9b6a4cb666f0af424c7",
  "chainId": 84532,
  "totalValueUsd": 18.17,
  "tokens": [
    {
      "token": "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
      "symbol": "USDC",
      "balance": "14355307",
      "decimals": 6,
      "priceUsd": 1.0,
      "valueUsd": 14.36
    },
    {
      "token": "0x4200000000000000000000000000000000000006",
      "symbol": "WETH",
      "balance": "2000000000000000",
      "decimals": 18,
      "priceUsd": 1905.0,
      "valueUsd": 3.81
    }
  ]
}

TypeScript SDK

import { AxonClient } from '@axonfi/sdk';
 
const axon = new AxonClient({
  vaultAddress: '0x05c6ab8c7b0b1bb42980d9b6a4cb666f0af424c7',
  chainId: 84532,
});
 
const value = await axon.getVaultValue();
console.log('Total vault value:', value.totalValueUsd, 'USD');
 
for (const token of value.tokens) {
  console.log(`  ${token.symbol}: $${token.valueUsd} (${token.balance} base units)`);
}