pinion-balance

Balance Lookup

Returns ETH and USDC balances for any address on Base mainnet.

Endpoint

GET https://pinionos.com/skill/balance/:address

Price: $0.01 USDC per call (x402 on Base)

Parameters

Parameter	Type	Required	Description
address	string	yes	Ethereum address (0x, 40 hex chars)

Example Request

curl https://pinionos.com/skill/balance/0x101Cd32b9bEEE93845Ead7Bc604a5F1873330acf

The first request returns HTTP 402 with payment requirements. Sign a USDC TransferWithAuthorization (EIP-3009) and retry with the X-PAYMENT header.

Example Response

{
  "address": "0x101Cd32b9bEEE93845Ead7Bc604a5F1873330acf",
  "network": "base",
  "balances": {
    "ETH": "0.042100",
    "USDC": "12.50"
  },
  "timestamp": "2026-02-16T12:00:00.000Z"
}

When to Use

• Check any wallet's ETH and USDC holdings on Base before sending or trading.
• Verify an agent's funding level.
• Confirm a payment was received.