Back to skills
SkillHub ClubShip Full StackFull Stack

pinion-balance

Get ETH and USDC balances for any Ethereum address on Base. Costs $0.01 USDC via x402.

Packaged view

This page reorganizes the original catalog entry around fit, installability, and workflow context first. The original raw source lives below.

Stars
356
Hot score
99
Updated
March 20, 2026
Overall rating
C3.4
Composite score
3.4
Best-practice grade
B81.2

Install command

npx @skill-hub/cli install chu2bard-pinion-os-balance

Repository

chu2bard/pinion-os

Skill path: skills/balance

Get ETH and USDC balances for any Ethereum address on Base. Costs $0.01 USDC via x402.

Open repository

Best for

Primary workflow: Ship Full Stack.

Technical facets: Full Stack.

Target audience: everyone.

License: Unknown.

Original source

Catalog source: SkillHub Club.

Repository owner: chu2bard.

This is still a mirrored public skill entry. Review the repository before installing into production workflows.

What it helps with

  • Install pinion-balance into Claude Code, Codex CLI, Gemini CLI, or OpenCode workflows
  • Review https://github.com/chu2bard/pinion-os before adding pinion-balance to shared team environments
  • Use pinion-balance for development workflows

Works across

Claude CodeCodex CLIGemini CLIOpenCode

Favorites: 0.

Sub-skills: 0.

Aggregator: No.

Original source / Raw SKILL.md

---
name: pinion-balance
description: Get ETH and USDC balances for any Ethereum address on Base. Costs $0.01 USDC via x402.
---

# 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

```bash
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

```json
{
  "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.
pinion-balance | SkillHub