← Back to Blog

How to Check Polygon Wallet Balance with an AI Agent

Polygon is the leading blockchain for NFTs, gaming, and enterprise adoption — home to projects from Starbucks, Reddit, Nike, and thousands of gaming studios. Run an AI agent to query MATIC balances, track gaming token holdings, and verify NFT ownership across Polygon wallets without writing a 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 Polygon RPC endpoint — no separate account needed (included in the config below)
• A text editor — nothing else

---

Create the Project Folder

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

The Skill Files

SKILL.md

---
name: polygon-agent
description: Check Polygon 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 MATIC balance for the configured wallet address.
Report the address and balance in MATIC. Nothing else.

agent.yaml

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

The Config File

polygon-bor.publicnode.com provides a free Polygon PoS RPC — no rate-limit signup required:

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

2 Windows

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

3 macOS

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

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

4 Linux

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

• NFT collection ownership verification — Confirm that a wallet holds a specific NFT before granting access to token-gated content, event tickets, or membership benefits. Polygon hosts millions of NFT contracts from major brands.
• Gaming studio token treasury monitoring — Track the in-game token reserves and MATIC holdings of gaming studio wallets. Flag treasury drawdowns that exceed expected spending rates for any given week.
• Enterprise loyalty programme management — Companies like Starbucks run customer loyalty programmes on Polygon. Monitor the token distribution wallet to verify that reward accruals and redemptions match the programme ledger.
• MATIC staking reward reconciliation — Automatically verify that delegator wallets are accumulating MATIC staking rewards at the expected rate. Surface discrepancies between expected and actual reward accruals for audit teams.
• Supply chain provenance token tracking — Polygon is used by enterprises for supply chain tokenisation. Track the wallet holding provenance tokens for a product batch to verify custody hasn't transferred unexpectedly.
• Creator economy revenue monitoring — Digital artists and content creators receiving royalties on Polygon can monitor their royalty wallet balance and surface anomalies in secondary market payout timing.