← Back to Blog

How to Check Optimism Wallet Balance with an AI Agent

Optimism is the home of Retroactive Public Goods Funding (RetroPGF), the Superchain ecosystem, and some of the most sophisticated DAO governance in all of web3. Whether you're a DAO contributor tracking treasury multi-sig balances, a grant recipient monitoring an allocation wallet, or a Superchain developer watching cross-chain ETH flows, an AI agent on Optimism gives you the intelligence you need — without a data team.

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

---

Create the Project Folder

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

The Skill Files

SKILL.md

---
name: optimism-agent
description: Check ETH balance on Optimism
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 the Optimism network.
Report the address and ETH balance. Nothing else.

agent.yaml

name: Optimism Agent
description: Check ETH balance on Optimism
connectors:
  - connection_name: Optimism
    connection_type: web3
skills:
  - path: ./
    trigger_type: auto

The Config File

Optimism uses ETH as its native gas token. The optimism.publicnode.com endpoint is a free, production-grade RPC with no signup required:

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

2 Windows

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

3 macOS

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

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

4 Linux

chmod +x oe-runtime-linux
./oe-runtime-linux ./optimism-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": {}}'

DAO & Superchain Use Cases on Optimism

• DAO treasury multi-sig monitoring — Optimism DAOs — including the Optimism Collective itself — hold ETH in Gnosis Safe multi-sig wallets for protocol spending. Monitor these treasury addresses and alert when balances move unexpectedly or when reserves fall below minimum operational thresholds defined by governance.
• RetroPGF grant allocation tracking — Recipients of Retroactive Public Goods Funding receive ETH to their wallets in batches. Monitor grant recipient addresses to confirm allocations arrived as intended and track subsequent spending patterns to verify funds are being used for stated public goods purposes.
• Superchain cross-chain bridge monitoring — The Superchain connects OP Stack chains (Base, Mode, Zora, and others) through shared infrastructure. Monitor the ETH held in bridge contracts on Optimism that facilitate cross-chain transfers and flag unusual deviations from normal liquidity levels.
• Protocol governance spending audits — Optimism governance approves spending proposals that draw from the protocol treasury. Track the ETH balances of approved spending wallets to confirm disbursements match governance decisions and identify any discrepancies requiring explanation.
• Public goods project runway tracking — Open source projects funded through RetroPGF need to manage their ETH runway carefully. Set up automated balance checks to alert when a project's operating wallet falls below a defined runway threshold — before it runs out and work stalls.
• Sequencer revenue and fee wallet analysis — Optimism generates sequencer revenue from L2 transaction fees. Researchers and investors tracking the health of the Optimism protocol can monitor the fee recipient wallet balances as a leading indicator of network activity and economic sustainability.