← Back to Blog

How to Check Arbitrum Wallet Balance with an AI Agent

Arbitrum is the largest Ethereum Layer 2 by total value locked — home to GMX, Uniswap v3, Camelot, and billions in institutional DeFi capital. Run an AI agent to query wallet balances, monitor DeFi exposure, and perform pre-deal counterparty checks at Ethereum security and L2 cost.

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 Arbitrum RPC endpoint — no separate account needed (included in the config below)
• A text editor — nothing else

---

Create the Project Folder

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

The Skill Files

Arbitrum's native gas token is ETH — balances are returned in ETH, not ARB:

SKILL.md

---
name: arbitrum-agent
description: Check Arbitrum 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 ETH balance for the configured wallet address on Arbitrum.
Report the address and balance in ETH. Nothing else.

agent.yaml

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

The Config File

arbitrum-one.publicnode.com is a free, reliable Arbitrum One RPC — no API key or signup:

{
  "llm": {
    "provider": "openai",
    "model": "gpt-4o",
    "apiKey": "sk-..."
  },
  "server": {
    "enabled": false,
    "port": 3333,
    "apiKey": "your-secret-api-key"
  },
  "connectors": [
    {
      "connection_name": "Arbitrum",
      "connection_type": "web3",
      "baseUrl": "https://arbitrum-one.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 ./arbitrum-agent

2 Windows

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

3 macOS

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

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

4 Linux

chmod +x oe-runtime-linux
./oe-runtime-linux ./arbitrum-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 Arbitrum

• Trading desk position monitoring — Institutional desks using GMX perpetuals on Arbitrum can monitor wallet ETH balances to track margin availability. Flag wallets approaching forced liquidation thresholds before positions are closed.
• Uniswap v3 LP fee tracking — Liquidity providers on Arbitrum's Uniswap v3 deployment can track the ETH balance of their LP wallet. Identify fee accrual patterns and optimise range positions based on balance trends.
• Pre-deal counterparty wallet analysis — Before entering a structured DeFi deal or OTC token transaction, verify that the counterparty's Arbitrum wallet history and current ETH balance align with their stated position size.
• Cross-chain fund flow tracing — Trace capital bridging from Ethereum mainnet to Arbitrum via the official bridge. Monitor the destination wallet to confirm that bridged funds arrived as expected and haven't been immediately withdrawn.
• Arbitrage desk wallet reconciliation — Quant and arbitrage teams running strategies across Arbitrum need real-time wallet balance checks to verify settlement and flag discrepancies between expected and actual ETH positions.
• Protocol fee treasury monitoring — DeFi protocols deployed on Arbitrum accumulate protocol fees in ETH. Monitor the fee collector wallet balance and generate reports on revenue accrual for investor relations and governance proposals.