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

1. 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:

bash

npx awal@latest status

If not authenticated, use the email OTP flow:

bash

# 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.

2. Fund the Wallet

Check your USDC balance:

bash

npx awal@latest balance

If insufficient, fund via Coinbase Onramp:

bash

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:

bash

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

bash

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

bash

npx awal@latest x402 pay "https://agentapi-production.up.railway.app/finance/yahoo-finance/v6/finance/quote?symbols=aapl"

Social TikTok — Search Users

bash

npx awal@latest x402 pay "https://agentapi-production.up.railway.app/social/tiktok/search/search-user?query=crypto"

Social TikTok — Search Sounds

bash

npx awal@latest x402 pay "https://agentapi-production.up.railway.app/social/tiktok/search/search-sound?query=music"

Twitter — Get Followers

bash

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

bash

npx awal@latest x402 pay "https://agentapi-production.up.railway.app/data/social/twitter/timeline?id=44196397"

Twitter — Get Tweets

bash

npx awal@latest x402 pay "https://agentapi-production.up.railway.app/data/social/twitter/tweets?id=44196397"

Google Search

bash

npx awal@latest x402 pay "https://agentapi-production.up.railway.app/search/google?query=bitcoin+price"

Real Estate — List Properties

bash

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

bash

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

)

json

{
  "result": {
    "quotes": [
      {
        "symbol": "AAPL",
        "price": 178.52,
        "change": 2.34,
        "change_percent": 1.33
      }
    ]
  }
}

Twitter Followers (

/data/social/twitter/followers

)

json

{
  "result": {
    "users": [
      {
        "id": "123456789",
        "name": "John Doe",
        "username": "johndoe",
        "followers_count": 1000,
        "profile_image_url": "https://..."
      }
    ]
  }
}

Google Search (

/search/google

)

json

{
  "result": {
    "results": [
      {
        "title": "Bitcoin Price",
        "link": "https://example.com/bitcoin",
        "snippet": "Bitcoin is trading at..."
      }
    ]
  }
}

Real Estate Property Detail (

/realty/properties/v3/detail

)

json

{
  "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:

bash

curl https://agentapi-production.up.railway.app/catalog

Returns:

json

[
  { "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

bash

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": "..."}'`

agentapi

NPX Install

Tags

SKILL.md Content

AgentAPI — AI Agent Native API Provider

Available Endpoints

Prerequisites & Setup

1. awal CLI Authentication

2. Fund the Wallet

Summary

Usage

Finance — Get Realtime Quotes

Finance — Yahoo Finance Quote

Social TikTok — Search Users

Social TikTok — Search Sounds

Twitter — Get Followers

Twitter — Get Timeline

Twitter — Get Tweets

Google Search

Real Estate — List Properties

Real Estate — Location Auto-Complete

Response Examples

Finance Quote (
`/finance/seeking-alpha/market/get-realtime-quotes`
)

Twitter Followers (
`/data/social/twitter/followers`
)

Google Search (
`/search/google`
)

Real Estate Property Detail (
`/realty/properties/v3/detail`
)

Service Catalog

Health Check

Troubleshooting

agentapi

NPX Install

Tags

SKILL.md Content

AgentAPI — AI Agent Native API Provider

Available Endpoints

Prerequisites & Setup

1. awal CLI Authentication

2. Fund the Wallet

Summary

Usage

Finance — Get Realtime Quotes

Finance — Yahoo Finance Quote

Social TikTok — Search Users

Social TikTok — Search Sounds

Twitter — Get Followers

Twitter — Get Timeline

Twitter — Get Tweets

Google Search

Real Estate — List Properties

Real Estate — Location Auto-Complete

Response Examples

Finance Quote (/finance/seeking-alpha/market/get-realtime-quotes)

Twitter Followers (/data/social/twitter/followers)

Google Search (/search/google)

Real Estate Property Detail (/realty/properties/v3/detail)

Service Catalog

Health Check

Troubleshooting

Finance Quote (
`/finance/seeking-alpha/market/get-realtime-quotes`
)

Twitter Followers (
`/data/social/twitter/followers`
)

Google Search (
`/search/google`
)

Real Estate Property Detail (
`/realty/properties/v3/detail`
)