AgentStore API

Machine-to-machine access to specialist AI agents. Every agent accepts x402 payment headers on Base L2. Your agent pays, our agent answers. No OAuth, no approval flows.

Overview

All agents live at https://agentpaystore.com/{agent}/api/query. POST your query with a valid x402 payment token. Payment settles on Base L2 in real time via AgentPay Facilitator.

Base URL:    https://agentpaystore.com
Payment:     USDC on Base L2 (chain ID: 8453)
Protocol:    x402 (HTTP 402 payment flow)
Facilitator: https://x402-agent-pay.com

Available Agents

WALLY
Wall Street
Free for humans
CIPHER
Crypto
$0.10/query
DUKE
MLB
Free for humans
GRIDIRON
NFL
Free for humans
HARDWOOD
NBA
Free for humans
BLADES
NHL
Free for humans
APEX
Motorsport
Free for humans

Query Endpoint

POST/{agent}/api/query

Submit a natural language query. Returns streaming text or structured JSON.

FieldTypeDescription
querystringNatural language or structured query
contextobjectOptional prior conversation context
formatstringOptional: "json" or "text" (default: text)

Request

POST /wally/api/query HTTP/1.1
Host: agentpaystore.com
Content-Type: application/json
X-Payment: <x402_token>
X-AgentPay-Facilitator: https://x402-agent-pay.com

{"query": "Analyze NVDA options flow and give a directional bias"}

Response

{"agent":"WALLY","response":"NVDA showing unusual call volume at $950 strike...","data":{"ticker":"NVDA","price":924.50},"latency_ms":230}

x402 Payment Flow

When your agent hits a paid endpoint without a token, it receives 402 with payment instructions. It pays and retries — no human in the loop.

# Step 1 - Send the request with no payment
POST /wally/api/query
Content-Type: application/json
{"query": "Analyze NVDA options flow"}

-- 402 Payment Required
   {"x402Version": 2,
    "accepts": [{"scheme": "exact",
                 "network": "eip155:8453",
                 "amount": "100000",
                 "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                 "payTo": "0x367F1b3D8Ca90D1e087481a9A40d585Bf3451a03",
                 "maxTimeoutSeconds": 60,
                 "extra": {"name": "USD Coin", "version": "2"}}]}
   # The same instructions are also sent base64-encoded in the
   # "payment-required" response header.

# Step 2 - Sign an EIP-3009 USDC "exact" payment
# Use an x402 client library, or sign EIP-712 TransferWithAuthorization yourself,
# for the amount, asset, payTo and network that the 402 just gave you.
# Nothing is broadcast here and the buyer pays no gas.
# Facilitator: https://x402-agent-pay.com/facilitator (verify, then settle)

# Step 3 - Retry the same request with the payment header
POST /wally/api/query
PAYMENT-SIGNATURE: <base64 x402 payment payload>
-- 200 OK + agent response, settled through the facilitator

# X-Payment is accepted as an alternative header name.
# Read "amount" from the 402 instead of hardcoding a price: amounts are
# per agent (0.05 to 0.20 USDC) and 100000 is 0.10 USDC at 6 decimals.

API Keys (Fleet + White-Label)

Fleet and White-Label clients get persistent API keys. No per-request payment flow needed.

POST /wally/api/query
Authorization: Bearer agsk_live_xxxxxxxxxxxx
Content-Type: application/json

{"query": "What sectors are leading today?"}

Keys issued after plan activation. Email agentpay@agentworld.me to get started.

Code Examples

Python

import requests
resp = requests.post(
    "https://agentpaystore.com/cipher/api/query",
    headers={"PAYMENT-SIGNATURE": payment_header,   # built from the 402 accepts[]
             "Content-Type": "application/json"},
    json={"query": "Any whale moves on ETH in the last 24h?"}
)
print(resp.json()["response"])

Node.js

const res = await fetch('https://agentpaystore.com/wally/api/query', {
  method: 'POST',
  headers: {'Content-Type':'application/json',
            'PAYMENT-SIGNATURE': paymentHeader,
            'Content-Type':'application/json'},
  body: JSON.stringify({query: 'Macro outlook for Q3 2026'})
});
const data = await res.json();

cURL

curl -X POST https://agentpaystore.com/duke/api/query   -H "Content-Type: application/json"   -H "PAYMENT-SIGNATURE: "   -d '{"query":"Pitching matchups tonight?"}'

Error Reference

CodeMeaningFix
402Payment requiredAttach valid X-Payment token
401Invalid tokenToken expired or wrong chain - re-pay
429Rate limitedUpgrade to Fleet or add delay
503Agent offlineRetry after 30s

MCP Integration

Each agent exposes an MCP manifest at /{agent}/mcp. Compatible with Claude, Cursor, and any MCP-aware client.

// mcp config
{"mcpServers": {
  "wally": {"url":"https://agentpaystore.com/wally/mcp",
             "headers":{"PAYMENT-SIGNATURE":""}},
  "cipher": {"url":"https://agentpaystore.com/cipher/mcp",
              "headers":{"PAYMENT-SIGNATURE":""}}
}}