AgentCash — Paid API Access

Call any x402-protected API with automatic payment. No API keys or subscriptions required.

Wallet

| Task | Command | |------|---------| | Check balance | npx agentcash@latest wallet info | | Redeem invite code | npx agentcash@latest wallet redeem <code> | | Deposit | Send USDC (Base or Solana) to your wallet address |

If your balance is 0, tell the user they need to deposit USDC (Base or Solana) to their wallet address or redeem an invite code.

Using Services

1. Discover endpoints on a service

npx agentcash@latest discover <origin>

Example: npx agentcash@latest discover https://stableenrich.dev

Read the output carefully — it includes endpoint paths, pricing, required parameters, and usage instructions. Read the instructions field — it has critical endpoint-specific guidance.

2. Check a specific endpoint (optional)

npx agentcash@latest check <endpoint-url>

Returns full request/response JSON schemas and pricing.

3. Make a paid request

# POST
npx agentcash@latest fetch <url> -m POST -b '{"key": "value"}'

# GET
npx agentcash@latest fetch '<url>?param=value'

Payment is automatic: sends request, gets 402 challenge, signs USDC payment, retries with credential, returns result.

4. Fetch with wallet authentication (for async jobs)

** Important: Always use the same network for the corresponding fetch and fetch-auth requests.**

• Base (eip155:8453) for USDC on Base
• Solana (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp) for USDC on Solana
• Network can be specified with the --payment-network flag.

npx agentcash@latest fetch-auth <url>

Some endpoints use SIWX (Sign-In With X) wallet authentication instead of x402 payment. Use fetch-auth for these — it signs a wallet proof automatically. Common pattern for async services (stablestudio.dev, stablesocial.dev): fetch to submit a job (paid), then fetch-auth to poll for results (authenticated, not paid).

Available Services

| Origin | What it does | |--------|-------------| | stableenrich.dev | Apollo (people/org search), Exa (web search), Firecrawl (scraping), Google Maps, Clado (LinkedIn), Serper (news/shopping), WhitePages, Hunter (email verification) | | stablesocial.dev | Social media data: TikTok, Instagram, Facebook, Reddit, LinkedIn ($0.06/call, async two-step) | | stablestudio.dev | AI image/video generation: GPT Image, Flux, Grok, Nano Banana, Sora, Veo, Seedance, Wan | | stableupload.dev | Pay-per-upload file hosting (10MB/$0.02, 100MB/$0.20, 1GB/$2.00, 6-month TTL) | | stableemail.dev | Send emails ($0.02), forwarding inboxes ($1/mo), custom subdomains ($5) | | stablephone.dev | AI phone calls ($0.54), phone numbers ($20), top-ups ($15) | | stablejobs.dev | Job search via Coresignal | | stabletravel.dev | Travel search |

Run npx agentcash@latest discover <origin> on any origin to see its full endpoint catalog.

Important Rules

• Always discover before guessing. Endpoint paths include provider prefixes (e.g. /api/apollo/people-search, not /people-search). Run discover first.
• Read the instructions field. Discovery output includes endpoint-specific guidance — required field ordering, multi-step workflows, polling patterns, etc.
• Payments settle on success only. Failed requests (non-2xx) don't cost anything.
• Check balance before expensive operations. Video generation can cost $1-3 per call.

Tips

• Use npx agentcash@latest check <url> when unsure about request/response format.
• Add --format json for machine-readable output, --format pretty for human-readable.
• Network: Base (eip155:8453) or Solana (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp), Currency: USDC.

Troubleshooting

| Issue | Solution | |-------|----------| | "Insufficient balance" | Check balance, deposit USDC or redeem invite code | | "Payment failed" | Transient error — retry the request | | "Invalid invite code" | Code already used or doesn't exist | | Balance not updating | Wait for Base or Solana network confirmation (~2 sec) |