AgentAPI — AI Agent Native API Provider
AgentAPI is an API provider built for the agentic era. No API keys, no signups, no monthly subscriptions. Just pay with USDC per request via the x402 protocol and instantly access 337+ external APIs.
Traditional API providers: Sign up → Generate API key → Subscribe to a plan → Manage rate limits → Rotate keys
AgentAPI: Have a wallet → Call the endpoint → Pay per request. Done.
AI Agents can autonomously discover available endpoints, pay the exact cost per call, and get results — all without human intervention or pre-provisioned credentials.
Available Endpoints
Path Price Description
/finance/seeking-alpha/v2/auto-complete
$0.001 Seeking Alpha auto-complete
/finance/seeking-alpha/market/get-realtime-quotes
$0.001 Get realtime quotes
/finance/yahoo-finance/v6/finance/quote
$0.001 Yahoo Finance quote
/social/tiktok/search/search-user
$0.001 Search TikTok users
/social/tiktok/search/search-sound
$0.001 Search TikTok sounds
/data/social/twitter/followers
$0.001 Get Twitter followers
/data/social/twitter/timeline
$0.001 Get Twitter timeline
/data/social/twitter/tweets
$0.001 Get Twitter tweets
/realty/properties/v3/list
$0.001 List properties for sale/rent
/realty/locations/v2/auto-complete
$0.001 Location auto-complete
/search/google
$0.001 Google search results
/news/crypto/listings/latest
$0.001 Latest crypto news
Server URL: https://agentapi-production.up.railway.app
Prerequisites & Setup
- awal CLI Authentication
The awal CLI (npx awal@latest ) handles wallet operations and x402 payments. You must authenticate before making paid API calls.
Check status:
npx awal@latest status
If not authenticated, use the email OTP flow:
Step 1: Send OTP to your email
npx awal@latest auth login user@example.com
Output: flowId: abc123...
Step 2: Verify with the 6-digit code from email
npx awal@latest auth verify abc123 123456
Confirm authentication
npx awal@latest status
See the authenticate-wallet skill for details.
- Fund the Wallet
Check your USDC balance:
npx awal@latest balance
If insufficient, fund via Coinbase Onramp:
npx awal@latest show
This opens the wallet companion UI where you can fund with Apple Pay, debit card, bank transfer, or Coinbase account. Alternatively, send USDC on Base directly to your wallet address:
npx awal@latest address
See the fund skill for details.
Summary
Requirement Check Skill
Wallet authenticated npx awal@latest status
authenticate-wallet
USDC balance npx awal@latest balance
fund
Usage
All requests are made via npx awal@latest x402 pay , which handles USDC payment automatically.
Finance — Get Realtime Quotes
npx awal@latest x402 pay "https://agentapi-production.up.railway.app/finance/seeking-alpha/market/get-realtime-quotes?symbols=aapl,tsla"
Finance — Yahoo Finance Quote
npx awal@latest x402 pay "https://agentapi-production.up.railway.app/finance/yahoo-finance/v6/finance/quote?symbols=aapl"
Social TikTok — Search Users
npx awal@latest x402 pay "https://agentapi-production.up.railway.app/social/tiktok/search/search-user?query=crypto"
Social TikTok — Search Sounds
npx awal@latest x402 pay "https://agentapi-production.up.railway.app/social/tiktok/search/search-sound?query=music"
Twitter — Get Followers
npx awal@latest x402 pay "https://agentapi-production.up.railway.app/data/social/twitter/followers?id=44196397&count=20"
The id parameter is the Twitter user ID (numeric).
Twitter — Get Timeline
npx awal@latest x402 pay "https://agentapi-production.up.railway.app/data/social/twitter/timeline?id=44196397"
Twitter — Get Tweets
npx awal@latest x402 pay "https://agentapi-production.up.railway.app/data/social/twitter/tweets?id=44196397"
Google Search
npx awal@latest x402 pay "https://agentapi-production.up.railway.app/search/google?query=bitcoin+price"
Real Estate — List Properties
npx awal@latest x402 pay "https://agentapi-production.up.railway.app/realty/properties/v3/list" -X POST -d '{"city": "San Francisco, CA"}'
Note: Real estate list endpoint uses POST with a JSON body. Use -X POST -d '{...}' to send the request body.
Real Estate — Location Auto-Complete
npx awal@latest x402 pay "https://agentapi-production.up.railway.app/realty/locations/v2/auto-complete?input=San+Francisco"
Response Examples
Finance Quote (/finance/seeking-alpha/market/get-realtime-quotes )
{ "result": { "quotes": [ { "symbol": "AAPL", "price": 178.52, "change": 2.34, "change_percent": 1.33 } ] } }
Twitter Followers (/data/social/twitter/followers )
{ "result": { "users": [ { "id": "123456789", "name": "John Doe", "username": "johndoe", "followers_count": 1000, "profile_image_url": "https://..." } ] } }
Google Search (/search/google )
{ "result": { "results": [ { "title": "Bitcoin Price", "link": "https://example.com/bitcoin", "snippet": "Bitcoin is trading at..." } ] } }
Real Estate Property Detail (/realty/properties/v3/detail )
{ "result": { "property_id": "12345", "listing_id": "67890", "price": 1250000, "address": { "street": "123 Main St", "city": "San Francisco", "state": "CA", "zip_code": "94102" }, "beds": 3, "baths": 2, "sqft": 1800 } }
Service Catalog
Retrieve the full list of available endpoints and their prices:
curl https://agentapi-production.up.railway.app/catalog
Returns:
[ { "path": "/finance/seeking-alpha/v2/auto-complete", "method": "GET", "price": "$0.001", "description": "Seeking Alpha auto-complete" }, { "path": "/social/tiktok/search/search-user", "method": "GET", "price": "$0.001", "description": "Search TikTok users" }, { "path": "/realty/properties/v3/list", "method": "POST", "price": "$0.001", "description": "List properties for sale/rent" }, ... ]
Total: 337+ endpoints across Finance (269), Social (28), Real Estate (12), News (7).
Health Check
curl https://agentapi-production.up.railway.app/health
Returns: {"status": "ok"}
Troubleshooting
Error Cause Fix
HTTP 402 Payment required Use npx awal@latest x402 pay instead of plain curl to make the request
HTTP 502 Upstream API error The backend service may be temporarily unavailable. Retry after a few seconds
"not signed in"
Wallet not authenticated Run npx awal@latest auth login <email> to authenticate. See authenticate-wallet skill
"insufficient balance"
Not enough USDC Run npx awal@latest show to fund the wallet. See fund skill
Empty response Invalid parameters Check query parameters — e.g. Twitter endpoints require ?id= (numeric user ID)
Real Estate 400 Missing request body List properties endpoint requires POST with JSON body: -X POST -d '{"city": "..."}'