← Back to Blog

How to Check Avalanche Wallet Balance with an AI Agent

Avalanche's subnet architecture makes it the blockchain of choice for enterprises building private chains, gaming platforms, and institutional financial products. Run an AI agent to monitor AVAX wallet balances, track validator staking rewards, and generate treasury reports across the Avalanche C-Chain — without writing a single line of code.

What You Need

• Node.js 18+ installed, or the OE Runtime binary from openenthrium.com/runtime
• An API key from OpenAI, Anthropic, or any supported LLM provider
• A free public Avalanche RPC endpoint — no separate account needed (included in the config below)
• A text editor — nothing else

---

Create the Project Folder

Create a folder called avalanche-agent/ and add these two files:

The Skill Files

SKILL.md

---
name: avalanche-agent
description: Check Avalanche wallet balance
license: Apache-2.0
metadata:
  author: Open Enthrium
  version: "1.0"
---

You are a blockchain data agent. Use the tools to fetch data and respond concisely.

## Step 1: Check Balance
Get the AVAX balance for the configured wallet address.
Report the address and balance in AVAX. Nothing else.

agent.yaml

name: Avalanche Agent
description: Check Avalanche wallet balance
connectors:
  - connection_name: Avalanche
    connection_type: web3
skills:
  - path: ./
    trigger_type: auto

The Config File

avalanche-c-chain.publicnode.com connects to the Avalanche C-Chain — the EVM-compatible chain where AVAX balances and DeFi protocols live:

{
  "llm": {
    "provider": "openai",
    "model": "gpt-4o",
    "apiKey": "sk-..."
  },
  "server": {
    "enabled": false,
    "port": 3333,
    "apiKey": "your-secret-api-key"
  },
  "connectors": [
    {
      "connection_name": "Avalanche",
      "connection_type": "web3",
      "baseUrl": "https://avalanche-c-chain.publicnode.com",
      "walletAddress": "0xYOUR_WALLET_ADDRESS"
    }
  ]
}

Download OE Runtime

Run the Agent

From the parent folder containing your skill directory:

	Method	Best for	Download
1	npx recommended	No install needed — always runs the latest version	—
2	Windows .exe	Download once, run offline on Windows	⊞ Windows (.exe)
3	macOS binary	Download once, run offline on Mac	 macOS
4	Linux binary	Server deployments, cron jobs, Docker	🐧 Linux
5	API Server integration	Call from any app, webhook, or automation pipeline	📮 Postman Collection

1 npx recommended

npx -y @openenthrium/oe-runtime@latest ./avalanche-agent

2 Windows

oe-runtime-win.exe ./avalanche-agent

3 macOS

chmod +x oe-runtime-macos
./oe-runtime-macos ./avalanche-agent

First run blocked? System Settings → Privacy & Security → Allow Anyway.

4 Linux

chmod +x oe-runtime-linux
./oe-runtime-linux ./avalanche-agent

5 API Server integration

Add a "server" block to oe-config.json, then start with --serve:

{
  "llm": { ... },
  "server": { "enabled": true, "port": 3333, "apiKey": "your-secret-key" },
  "connectors": [ ... ]
}

npx -y @openenthrium/oe-runtime@latest --serve --config oe-config.json

Run with inline YAML:

curl -X POST http://localhost:3333/run \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-secret-key" \
  -d '{"yaml": "...", "params": {}}'

Or run from a file on the server:

curl -X POST http://localhost:3333/run-file \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-secret-key" \
  -d '{"file": "/path/to/agent.yaml", "params": {}}'

Enterprise Use Cases on Avalanche

• Enterprise subnet treasury monitoring — Companies building private Avalanche subnets hold AVAX in C-Chain wallets for cross-subnet bridging and gas. Monitor these treasury wallets and alert when reserves fall below operational thresholds.
• Validator staking reward reconciliation — Avalanche validators earn AVAX staking rewards on the P-Chain, but many hold their stake management wallets on the C-Chain. Reconcile expected versus actual reward accruals for institutional staking operations.
• Institutional fund custody verification — Asset managers holding AVAX in institutional custody wallets need periodic balance verification for NAV calculations. Run automated balance checks without exposing private keys to a third-party reporting service.
• Gaming subnet asset tracking — Gaming platforms like DeFi Kingdoms use Avalanche subnets for in-game economies. Monitor the C-Chain wallets of game studios for AVAX reserves used to fund subnet operations and player reward pools.
• Cross-subnet bridge monitoring — Track the AVAX held in bridge wallet contracts between the C-Chain and enterprise subnets. Flag unusual balance changes that could indicate bridge congestion or unexpected liquidity drains.
• Compliance reporting for regulated entities — Financial institutions operating on Avalanche for tokenised assets require regular wallet balance attestations for regulatory reporting. Automate these checks to reduce manual reconciliation overhead.