agentcash — Paid API Access
Call any x402-protected API with automatic payment. No API keys, no subscriptions — just a funded wallet (USDC on Base or Solana).
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)
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 jsonfor machine-readable output,--format prettyfor 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) |