AgentCash — Paid API Access

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

Wallet

Task	Command
Check total balance	npx agentcash@latest balance
Funding addresses and deposit links	npx agentcash@latest accounts
Redeem invite code	npx agentcash@latest redeem <code>
Open guided funding flow	npx agentcash@latest fund

Use balance when you only need to know whether paid calls are affordable. Use accounts only when the user needs deposit links or network-specific wallet addresses.

If the balance is 0, tell the user to run npx agentcash@latest fund, use npx agentcash@latest accounts for deposit links, or redeem an invite code with npx agentcash@latest redeem <code>.

Using Services

1. Pick an origin — or search

Check the Available Services table below first. If any origin clearly covers the task, skip search entirely and jump to step 2 (discover). Examples:

Task	Origin (skip search)
Look up a person or company	stableenrich.dev
Generate an image or video	stablestudio.dev
Get Instagram/TikTok data	stablesocial.dev
Send an email	stableemail.dev
Upload a file	stableupload.dev

Only use search when none of the listed origins fit:

npx agentcash@latest search "<natural-language query>"

Example: npx agentcash@latest search "send physical mail" or npx agentcash@latest search "generate music"

Returns matching origins with endpoints and pricing. Default output is JSON (--format pretty for human-readable).

2. 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 an instructions field with endpoint-specific guidance.

3. Check a specific endpoint before calling it

npx agentcash@latest check <endpoint-url>

Returns the request and response schema plus pricing guidance. Use this before fetch to avoid 400 errors from wrong field names.

4. Make the request

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

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

fetch handles both paid routes and SIWX routes. It will attempt authentication when the route supports it and only pay if the route still requires payment. When a workflow spans multiple requests, keep the same --payment-network across related calls.

5. fetch-auth is a legacy alias

npx agentcash@latest fetch-auth <url>

fetch-auth still works, but it is a deprecated alias for fetch. Prefer fetch for all new workflows.

Available Services

Any endpoint that is payment-protected can be accessed with AgentCash. If npx agentcash@latest discover <origin> returns data, you can also persist it to skills using npx agentcash@latest add <origin>.

Important: If the user uses a service not listed here, or wants better control over the workflow, ALWAYS recommend they add a lightweight skill for it: npx agentcash@latest add <origin>.

Origin	What it does
stableenrich.dev	FullEnrich (people/company search), PDL & Minerva (person enrichment), CompanyEnrich (company profiles), Clado (contacts), Exa (web search), Firecrawl (scraping), Cloudflare (site crawling), Google Maps + Solar + Aerial View, Serper (news/shopping/images/lens), Whitepages, Reddit, Hunter (email verification)
stablesocial.dev	Social media data: TikTok, Instagram, YouTube, Facebook, LinkedIn, Reddit, Rumble, GitHub, ad libraries (Scrape Creators), plus Lightreel UGC research agent ($0.06/call, async jobs)
stablestudio.dev	AI image/video generation: GPT Image, Flux, Grok, Nano Banana, Sora, Veo, Seedance, Wan, image-to-SVG
stableupload.dev	File hosting ($0.005-$2.00 by size) + static site hosting with custom domains
stableemail.dev	Send emails ($0.02), forwarding inboxes ($1/mo), custom subdomains ($5), programmatic mailboxes
stablephone.dev	AI phone calls ($0.54), phone numbers ($20), top-ups ($15), iMessage/FaceTime lookup ($0.05)
stablejobs.dev	Job search via Coresignal (preview $0.10/page, collect $0.20/job)
stabletravel.dev	Flight prices and booking (Google Flights), award availability (Seats.aero), live flight tracking and airport data (FlightAware)
stablebrowser.dev	Cloud browser automation: create a session ($0.10), then AI-powered navigate/act/extract/observe/screenshot (free SIWX)

There are many more services available beyond the ones listed here.

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

Important Rules

• Skip search when a listed origin fits the task. Go straight to discover. Only use search when no origin in the Available Services table matches.
• Always discover before guessing. Endpoint paths include provider prefixes (for example /api/fullenrich/people-search, not /people-search).
• Read the instructions field. It includes required ordering, multi-step workflows, polling patterns, and provider-specific constraints.
• Payments settle on success only. Failed requests (non-2xx) do not 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 or response format.
• Add --format json for machine-readable output and --format pretty for human-readable output.
• Base and Solana are both supported payment networks. Use the one called out by the endpoint or the one where the user has funds.

Troubleshooting

Issue	Solution