ag402

A command-line tool for paying APIs, which are services accessed over the web, through the x402 payment protocol using USDC on Solana. It can manage the payment wallet and payment history.

In plain words
What is it for?
Use it to pay for supported API calls, check the wallet balance, review payment history, diagnose the setup, or run a payment gateway.
Why use it?
It handles API requests that require payment instead of leaving the agent to implement the payment and retry process itself. It also provides commands for checking setup, funds, and past transactions.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/aethercore-dev/ag402/ag402-skill
Any agent
npx skills add AetherCore-Dev/ag402 --skill ag402-skill
Clone the repo
git clone --depth 1 https://github.com/AetherCore-Dev/ag402

Made for: Claude Code, Codex.

Per session 42 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 992 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00042 $0.00992
Opus 5 $0.00021 $0.00496
Sonnet 5 $0.00008 $0.00198
Haiku 4.5 $0.00004 $0.00099

Measured 2d ago against content hash c9fd8718ece1, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

ag402 scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

The scan reads SKILL.md. This mod also ships 8 executable files (__init__.py, prepaid_client.py, prepaid_models.py, …), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

adapters/openclaw/ag402-skill/SKILL.md · 168 lines

How it starts

The opening of the file, as written. The whole thing — 168 lines — stays where its author put it; the contents beside it link to each section on GitHub.

ag402 — AI Agent Payment Protocol

Use exec to run ag402 CLI commands. This skill provides autonomous payment capabilities for AI agents via the x402 protocol on Solana (USDC).

When to Use

  • Agent needs to call a paid API (HTTP 402 response)
  • Agent needs to check wallet balance or transaction history
  • Agent needs to set up payment infrastructure
  • Agent needs to start/stop a payment gateway

Quick Start

1. Check if ag402 is installed

ag402 --version

If not installed:

pip install ag402-core

2. Initialize wallet (non-interactive, agent-safe)

ag402 init

Creates a test wallet with $100 USDC. No prompts, no human input needed.

3. Verify setup

ag402 balance

Expected: $100.00 test balance.

Commands

Pay for an API call

ag402 pay <url>

Sends a request to <url>. If the server returns 402 Payment Required with an x402 challenge, ag402 automatically pays and retries. Returns the API response.

Example:

ag402 pay https://api.example.com/premium/data

With options:

ag402 pay https://api.example.com/generate \
  --method POST \
  --data '{"prompt": "hello"}' \
  --amount 2.50

Check balance

ag402 balance

View transaction history

ag402 history
ag402 history --limit 20 --type payment

Full status dashboard

ag402 status

Health check

ag402 doctor

Start payment gateway (seller mode)

ag402 serve --target http://localhost:8000 --price 0.01 --port 4020 &

Stop gateway

Kill the background process or use Ctrl+C in the terminal.

Production Mode

For real on-chain payments, set environment variables before running:

X402_MODE=production \
X402_NETWORK=mainnet \
SOLANA_RPC_URL=<your_rpc_url> \
AG402_UNLOCK_PASSWORD=<wallet_password> \
  ag402 pay <url>

Or configure persistently:

ag402 env set X402_MODE production
ag402 env set X402_NETWORK mainnet
ag402 env set SOLANA_RPC_URL <your_rpc_url>

Read the full file on GitHub · 168 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 168 lines · 42 tokens per session scan A c9fd8718ece1

Subscribe to this mod's changes

ag402 is a skill published in the GitHub repository AetherCore-Dev/ag402 (9 stars, last pushed 1mo ago), licensed MIT. It adds 42 tokens to every session and 992 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

squash-merge

Squash-merge a PR into zeroclaw-labs/zeroclaw master with fully preserved commit history in the squash message body. Use this skill when the user explicitly mentions squash-merging, merging a specific PR number, landing a PR, or 合入 — e.g. "squash-merge #123", "merge PR 456", "land #789", "合入 #123", "/squash-merge…

zeroclaw-labs/zeroclaw · 0 tokens

github-pr

Open or update a GitHub Pull Request for ZeroClaw. Handles creating new PRs with a fully filled-out template body, and updating existing PRs (title, body sections, labels, comments). Use this skill whenever the user wants to open a PR, create a pull request, update a PR, edit PR description, add labels to a PR, or…

zeroclaw-labs/zeroclaw · 0 tokens

zeroclaw

Help users operate and interact with their ZeroClaw agent instance — through both the CLI (zeroclaw commands) and the REST/WebSocket gateway API. Use this skill whenever the user wants to: send messages to ZeroClaw, manage memory or cron jobs, check system status, configure channels or providers, hit the gateway API…

zeroclaw-labs/zeroclaw · 167 tokens

feature-matrix-parity

Update the OpenClaw and Hermes comparison columns of the ZeroClaw feature-and-support matrix. Use this skill when the user wants to refresh, fill, or verify parity data in docs/book/feature-matrix-parity.toml, add a new comparison row or section to the feature matrix, or re-walk the competitor repos for support…

zeroclaw-labs/zeroclaw · 127 tokens

github-issue-triage

Issue triage and lifecycle management agent for ZeroClaw. Use this skill whenever the user wants to: triage open issues, close stale/duplicate/fixed issues, apply labels, run a backlog sweep, enforce the current issue stale policy, or handle a specific issue. Trigger on: 'triage issues', 'issue triage', 'sweep…

zeroclaw-labs/zeroclaw · 140 tokens

wit-breaking-change-check

Classify WIT interface changes as breaking or non-breaking against frozen version markers. Use this skill when the user wants to check WIT breaking changes, review a WIT diff, verify whether a WIT change is breaking, or run a WIT compat check. Trigger on: 'check WIT breaking changes', 'review WIT diff', 'is this WIT…

zeroclaw-labs/zeroclaw · 88 tokens