Unified EVM token balance aggregation across Ethereum, Base, Polygon, and Arbitrum — one API for all chains.
One endpoint for Ethereum, Base, Polygon, Arbitrum
Native + ERC-20 tokens across all supported chains
Real-time price data included in balance responses
Optimized for real-time monitoring workflows
Fetch native + ERC-20 token balances across 4 EVM chains in a single call via getEvmBalances().
Uniblock data is combined with Zerion and Allium. Aegis deduplicates by chain:token, keeping the highest USD value.
Powers the wallet balance component in the Aegis dashboard (Nexus).
Track agent EVM holdings across Ethereum, Base, Polygon, and Arbitrum from a single query.
getEvmBalances(addr) → 4 chains
Agents operating on multiple L2s need a unified view of their balances for decision-making.
balances across Base + Arbitrum + Polygon
Verify agent balances against spending policies before authorizing transactions.
budget.check(totalUsdValue)
Aggregate balances across all agent wallets for a complete fleet treasury overview.
agents.map(a => getEvmBalances(a.addr))
import { getEvmBalances } from "@aegis-ows/integrations";
// Query across all default chains (Ethereum, Base, Polygon, Arbitrum)
const balances = await getEvmBalances("0x1234...");
// Or specify specific chains
const l2Only = await getEvmBalances("0x1234...", ["base", "arbitrum"]);
// Returns:
// [
// { chain: "Base", chainId: "eip155:8453", token: "ETH",
// balance: "0.500000", usdValue: "1500.00", source: "uniblock" },
// { chain: "Base", chainId: "eip155:8453", token: "USDC",
// balance: "100.000000", usdValue: "100.00", source: "uniblock" },
// { chain: "Arbitrum", chainId: "eip155:42161", token: "ETH",
// balance: "0.250000", usdValue: "750.00", source: "uniblock" }
// ]/token/balances?address=...&chain=...| Chain | CAIP-2 Chain ID | Uniblock Key |
|---|---|---|
| Ethereum | eip155:1 | ethereum |
| Base | eip155:8453 | base |
| Polygon | eip155:137 | polygon |
| Arbitrum | eip155:42161 | arbitrum |
Uniblock is one of three EVM data sources Aegis queries in parallel. Results are deduplicated automatically.
import { getAllBalances } from "@aegis-ows/integrations";
const balances = await getAllBalances({
evm: "0x1234...", // → Zerion + Uniblock + Allium (parallel)
solana: "2G55...", // → Solana RPC
xrp: "rHb9...", // → XRPL WebSocket
stellar: "GBZX..." // → Stellar Horizon
});
// Deduplication: same chain:token from multiple sources
// → keeps the entry with the highest USD value# Required — get from uniblock.dev
UNIBLOCK_API_KEY=your_api_key_here| Config | Value |
|---|---|
| Auth | x-api-key header |
| Base URL | https://api.uniblock.dev/v1 |
| Env Var | UNIBLOCK_API_KEY |
Infrastructure Track
Universal balance API for AI agent fleets across all EVM chains
Multi-Chain Track
Agents that optimize operations across L2s based on gas costs and balances
DeFi Track
Portfolio-aware trading agents with cross-chain position tracking
Analytics
Cross-chain agent wealth tracking and treasury management dashboard
| Function | Parameters | Returns |
|---|---|---|
| getEvmBalances | walletAddress, chains? | ChainBalance[] |