x402 Primitives Catalog
The full-stack pay-per-call API for crypto infrastructure. Every endpoint is x402-native — agents and developers pay USDC per request on Base & Solana. No API keys, no accounts, no subscriptions.
Quick Start — Install the MCP server in one line
// ── Option A · MCP server (recommended) ────────────────── // One line. Works in Claude Code, Cursor, Cline & any MCP client — 183 tools. claude mcp add spraay -s user -- npx -y spraay-x402-mcp // First run auto-creates a wallet at ~/.spraay/.session — no // EVM_PRIVATE_KEY needed. It also checks for updates on startup. // Fund that wallet with USDC on Base, then just call any tool. // ── Option B · Direct x402 client ──────────────────────── import { createClient } from "x402-client"; const client = createClient({ baseUrl: "https://gateway.spraay.app", // Optional — omit to use the auto-provisioned ~/.spraay/.session wallet privateKey: process.env.EVM_PRIVATE_KEY, }); // Fetch live ETH price — pays $0.005 USDC automatically const prices = await client.get("/api/v1/oracle/prices"); console.log(prices); // { ETH: 2847.50, BTC: ... }
Free Tier
21 endpointsGET Catalog
Index of every free-to-call endpoint with paths and params. No wallet, no payment.
/free
FREE
▼
Description
Index of every free-to-call endpoint with paths and params. No wallet, no payment.
Request
const result = await client.get( "/free" );
GET Prices
USDC / ETH / SOL spot prices (cached 60s).
/free/prices
FREE
▼
Description
USDC / ETH / SOL spot prices (cached 60s).
Request
const result = await client.get( "/free/prices" );
GET Gas
Live gas prices across 7 EVM chains via Alchemy (cached 15s).
/free/gas
FREE
▼
Description
Live gas prices across 7 EVM chains via Alchemy (cached 15s).
Request
const result = await client.get( "/free/gas" );
GET Chain Status
Block height & liveness for 7 EVM chains (cached 30s).
/free/chain-status
FREE
▼
Description
Block height & liveness for 7 EVM chains (cached 30s).
Request
const result = await client.get( "/free/chain-status" );
GET Nonce
EVM nonce / transaction count for any address.
/free/nonce
FREE
▼
Description
EVM nonce / transaction count for any address.
Request
const result = await client.get( "/free/nonce" );
GET Resolve
ENS & Basename → address resolution.
/free/resolve
FREE
▼
Description
ENS & Basename → address resolution.
Request
const result = await client.get( "/free/resolve" );
GET Validate Address
Multi-chain address checksum validation.
/free/validate-address
FREE
▼
Description
Multi-chain address checksum validation.
Request
const result = await client.get( "/free/validate-address" );
GET Convert
Fiat ↔ crypto conversion (unit math + spot rates).
/free/convert
FREE
▼
Description
Fiat ↔ crypto conversion (unit math + spot rates).
Request
const result = await client.get( "/free/convert" );
GET UUID
Generate up to 100 UUID v4 identifiers.
/free/uuid
FREE
▼
Description
Generate up to 100 UUID v4 identifiers.
Request
const result = await client.get( "/free/uuid" );
GET Timestamp
Current Unix timestamp.
/free/timestamp
FREE
▼
Description
Current Unix timestamp.
Request
const result = await client.get( "/free/timestamp" );
POST x402 Check
Probe any URL for x402 payment support.
/free/x402-check
FREE
▼
Description
Probe any URL for x402 payment support.
Request
const result = await client.post( "/free/x402-check", {...} );
POST Validate Batch
BPA 1.0 payload schema validation (dry run).
/free/validate-batch
FREE
▼
Description
BPA 1.0 payload schema validation (dry run).
Request
const result = await client.post( "/free/validate-batch", {...} );
GET Estimate Batch
Rough batch-payment cost estimate (no live quote).
/free/estimate-batch
FREE
▼
Description
Rough batch-payment cost estimate (no live quote).
Request
const result = await client.get( "/free/estimate-batch" );
GET Agent Card
ERC-8004 agent registry lookup.
/free/agent-card
FREE
▼
Description
ERC-8004 agent registry lookup.
Request
const result = await client.get( "/free/agent-card" );
POST Chat
Free AI chat (open-weight models)
/free/chat
FREE
▼
Description
Free AI chat (open-weight models)
Request
const result = await client.post( "/free/chat", {...} );
GET Chat Models
Free model catalog
/free/chat/models
FREE
▼
Description
Free model catalog
Request
const result = await client.get( "/free/chat/models" );
GET Models
Full model catalog (free mirror of the paid list).
/free/models
FREE
▼
Description
Full model catalog (free mirror of the paid list).
Request
const result = await client.get( "/free/models" );
GET DEX Trending
Trending tokens & pairs across DEXes via DexScreener.
/free/dex/trending
FREE
▼
Description
Trending tokens & pairs across DEXes via DexScreener.
Request
const result = await client.get( "/free/dex/trending" );
GET DEX Search
Search DEX pairs across all chains via DexScreener.
/free/dex/search
FREE
▼
Description
Search DEX pairs across all chains via DexScreener.
Request
const result = await client.get( "/free/dex/search" );
GET DEX Tokens
All DEX pairs for a given token address.
/free/dex/tokens
FREE
▼
Description
All DEX pairs for a given token address.
Request
const result = await client.get( "/free/dex/tokens" );
GET DEX Pairs
Detailed data for a specific DEX pair on a chain.
/free/dex/pairs
FREE
▼
Description
Detailed data for a specific DEX pair on a chain.
Request
const result = await client.get( "/free/dex/pairs" );
AI Inference
2 endpointsPOST Completions
OpenAI-compatible chat completions. 200+ models via BlockRun + OpenRouter. Streaming, function calling, vision.
/api/v1/chat/completions
$0.04 USDC
▼
Description
OpenAI-compatible chat completions. 200+ models via BlockRun + OpenRouter. Streaming, function calling, vision.
Request
const result = await client.post( "/api/v1/chat/completions", {...} );
GET Models
List all available AI models with pricing and capability metadata.
/api/v1/models
$0.001 USDC
▼
Description
List all available AI models with pricing and capability metadata.
Request
const result = await client.get( "/api/v1/models" );
Bittensor — Decentralized AI
4 endpointsGET Models
List decentralized AI models on Bittensor. OpenAI /v1/models compatible.
/bittensor/v1/models
$0.001 USDC
▼
Description
List decentralized AI models on Bittensor. OpenAI /v1/models compatible.
Request
const result = await client.get( "/bittensor/v1/models" );
POST Completions
Chat completions via Bittensor SN64 (Chutes). 43+ models, fully OpenAI-compatible.
/bittensor/v1/chat/completions
$0.03 USDC
▼
Description
Chat completions via Bittensor SN64 (Chutes). 43+ models, fully OpenAI-compatible.
Request
const result = await client.post( "/bittensor/v1/chat/completions", {...} );
POST Generations
Image generation via Bittensor SN19 (Nineteen AI). OpenAI-compatible.
/bittensor/v1/images/generations
$0.05 USDC
▼
Description
Image generation via Bittensor SN19 (Nineteen AI). OpenAI-compatible.
Request
const result = await client.post( "/bittensor/v1/images/generations", {...} );
POST Embeddings
Text embeddings via Bittensor. OpenAI /v1/embeddings compatible.
/bittensor/v1/embeddings
$0.005 USDC
▼
Description
Text embeddings via Bittensor. OpenAI /v1/embeddings compatible.
Request
const result = await client.post( "/bittensor/v1/embeddings", {...} );
Oracle, Prices & FX
4 endpointsGET Prices
Aggregated oracle price feed across multiple sources.
/api/v1/oracle/prices
$0.008 USDC
▼
Description
Aggregated oracle price feed across multiple sources.
Request
const result = await client.get( "/api/v1/oracle/prices" );
GET Gas
Real-time gas prices for Base and other supported EVM chains.
/api/v1/oracle/gas
$0.005 USDC
▼
Description
Real-time gas prices for Base and other supported EVM chains.
Request
const result = await client.get( "/api/v1/oracle/gas" );
GET Fx
Stablecoin FX rates: USDC, USDT, DAI, EURC, pyUSD, and more.
/api/v1/oracle/fx
$0.008 USDC
▼
Description
Stablecoin FX rates: USDC, USDT, DAI, EURC, pyUSD, and more.
Request
const result = await client.get( "/api/v1/oracle/fx" );
GET Prices
Multi-token price feed across major assets. Cached, low-latency.
/api/v1/prices
$0.002 USDC
▼
Description
Multi-token price feed across major assets. Cached, low-latency.
Request
const result = await client.get( "/api/v1/prices" );
Wallet Analytics
2 endpointsGET Wallet
Wallet profile: balances, top tokens, activity tier, age, risk signals.
/api/v1/analytics/wallet
$0.01 USDC
▼
Description
Wallet profile: balances, top tokens, activity tier, age, risk signals.
Request
const result = await client.get( "/api/v1/analytics/wallet" );
GET Txhistory
Transaction history for any address across supported chains.
/api/v1/analytics/txhistory
$0.008 USDC
▼
Description
Transaction history for any address across supported chains.
Request
const result = await client.get( "/api/v1/analytics/txhistory" );
Data, Balances & Discovery
2 endpointsGET Balances
Multi-chain balance lookup for any address.
/api/v1/balances
$0.005 USDC
▼
Description
Multi-chain balance lookup for any address.
Request
const result = await client.get( "/api/v1/balances" );
GET Tokens
FREE — list of supported tokens across all chains.
/api/v1/tokens
FREE
▼
Description
FREE — list of supported tokens across all chains.
Request
const result = await client.get( "/api/v1/tokens" );
Search & RAG
3 endpointsPOST Web
Web search powered by Tavily. Returns ranked URLs with snippets.
/api/v1/search/web
$0.02 USDC
▼
Description
Web search powered by Tavily. Returns ranked URLs with snippets.
Request
const result = await client.post( "/api/v1/search/web", {...} );
POST Extract
Extract clean readable content from one or more URLs.
/api/v1/search/extract
$0.02 USDC
▼
Description
Extract clean readable content from one or more URLs.
Request
const result = await client.post( "/api/v1/search/extract", {...} );
POST Qna
Question-answering over fresh web results. RAG out of the box.
/api/v1/search/qna
$0.03 USDC
▼
Description
Question-answering over fresh web results. RAG out of the box.
Request
const result = await client.post( "/api/v1/search/qna", {...} );
On-chain AI Inference
4 endpointsPOST Classify Address
Classify a wallet address: exchange, contract, EOA, MEV bot, etc.
/api/v1/inference/classify-address
$0.03 USDC
▼
Description
Classify a wallet address: exchange, contract, EOA, MEV bot, etc.
Request
const result = await client.post( "/api/v1/inference/classify-address", {...} );
POST Classify Tx
Classify a transaction by intent: swap, transfer, mint, exploit, etc.
/api/v1/inference/classify-tx
$0.03 USDC
▼
Description
Classify a transaction by intent: swap, transfer, mint, exploit, etc.
Request
const result = await client.post( "/api/v1/inference/classify-tx", {...} );
POST Explain Contract
AI-generated plain-English explanation of a smart contract.
/api/v1/inference/explain-contract
$0.03 USDC
▼
Description
AI-generated plain-English explanation of a smart contract.
Request
const result = await client.post( "/api/v1/inference/explain-contract", {...} );
POST Summarize
Intelligence briefing: AI summary of arbitrary on-chain context.
/api/v1/inference/summarize
$0.03 USDC
▼
Description
Intelligence briefing: AI summary of arbitrary on-chain context.
Request
const result = await client.post( "/api/v1/inference/summarize", {...} );
Notifications
3 endpointsPOST Email
Send transactional email (payment confirmations, alerts, receipts). AgentMail-backed.
/api/v1/notify/email
$0.01 USDC
▼
Description
Send transactional email (payment confirmations, alerts, receipts). AgentMail-backed.
Request
const result = await client.post( "/api/v1/notify/email", {...} );
POST Sms
Send SMS notification for payment confirmations and alerts.
/api/v1/notify/sms
$0.02 USDC
▼
Description
Send SMS notification for payment confirmations and alerts.
Request
const result = await client.post( "/api/v1/notify/sms", {...} );
GET Status
Check delivery status of a sent email or SMS notification.
/api/v1/notify/status
$0.002 USDC
▼
Description
Check delivery status of a sent email or SMS notification.
Request
const result = await client.get( "/api/v1/notify/status" );
Webhooks
4 endpointsPOST Register
Register a webhook URL to receive event notifications (payments, escrows, etc.).
/api/v1/webhook/register
$0.01 USDC
▼
Description
Register a webhook URL to receive event notifications (payments, escrows, etc.).
Request
const result = await client.post( "/api/v1/webhook/register", {...} );
POST Test
Send a test event to a registered webhook to verify delivery.
/api/v1/webhook/test
$0.005 USDC
▼
Description
Send a test event to a registered webhook to verify delivery.
Request
const result = await client.post( "/api/v1/webhook/test", {...} );
GET List
List all webhooks registered to your account/wallet.
/api/v1/webhook/list
$0.002 USDC
▼
Description
List all webhooks registered to your account/wallet.
Request
const result = await client.get( "/api/v1/webhook/list" );
POST Delete
Delete a registered webhook by ID.
/api/v1/webhook/delete
$0.002 USDC
▼
Description
Delete a registered webhook by ID.
Request
const result = await client.post( "/api/v1/webhook/delete", {...} );
XMTP Messaging
2 endpointsPOST Send
Send an end-to-end encrypted XMTP message to any wallet address.
/api/v1/xmtp/send
$0.01 USDC
▼
Description
Send an end-to-end encrypted XMTP message to any wallet address.
Request
const result = await client.post( "/api/v1/xmtp/send", {...} );
GET Inbox
Read XMTP messages from your inbox.
/api/v1/xmtp/inbox
$0.01 USDC
▼
Description
Read XMTP messages from your inbox.
Request
const result = await client.get( "/api/v1/xmtp/inbox" );
Escrow
6 endpointsPOST Create
Create an on-chain escrow agreement between two parties.
/api/v1/escrow/create
$0.10 USDC
▼
Description
Create an on-chain escrow agreement between two parties.
Request
const result = await client.post( "/api/v1/escrow/create", {...} );
GET List
List your active and historical escrows.
/api/v1/escrow/list
$0.02 USDC
▼
Description
List your active and historical escrows.
Request
const result = await client.get( "/api/v1/escrow/list" );
GET Escrow
Fetch escrow details and status by ID.
/api/v1/escrow/:id
$0.001 USDC
▼
Description
Fetch escrow details and status by ID.
Request
const result = await client.get( "/api/v1/escrow/:id" );
POST Fund
Fund an existing escrow agreement with USDC or supported token.
/api/v1/escrow/fund
$0.02 USDC
▼
Description
Fund an existing escrow agreement with USDC or supported token.
Request
const result = await client.post( "/api/v1/escrow/fund", {...} );
POST Release
Release escrow funds to the recipient after conditions are met.
/api/v1/escrow/release
$0.08 USDC
▼
Description
Release escrow funds to the recipient after conditions are met.
Request
const result = await client.post( "/api/v1/escrow/release", {...} );
POST Cancel
Cancel an escrow before funding or by mutual agreement.
/api/v1/escrow/cancel
$0.02 USDC
▼
Description
Cancel an escrow before funding or by mutual agreement.
Request
const result = await client.post( "/api/v1/escrow/cancel", {...} );
Swap
3 endpointsGET Quote
Get a swap quote across Uniswap V3, Aerodrome, and other DEXes on Base.
/api/v1/swap/quote
$0.008 USDC
▼
Description
Get a swap quote across Uniswap V3, Aerodrome, and other DEXes on Base.
Request
const result = await client.get( "/api/v1/swap/quote" );
GET Tokens
List supported swap tokens with addresses, decimals, and metadata.
/api/v1/swap/tokens
$0.001 USDC
▼
Description
List supported swap tokens with addresses, decimals, and metadata.
Request
const result = await client.get( "/api/v1/swap/tokens" );
POST Execute
Execute a token swap on Base via the MangoSwap router.
/api/v1/swap/execute
$0.015 USDC
▼
Description
Execute a token swap on Base via the MangoSwap router.
Request
const result = await client.post( "/api/v1/swap/execute", {...} );
Bridge
2 endpointsGET Quote
Cross-chain bridge quote across LiFi-aggregated routes.
/api/v1/bridge/quote
$0.05 USDC
▼
Description
Cross-chain bridge quote across LiFi-aggregated routes.
Request
const result = await client.get( "/api/v1/bridge/quote" );
GET Chains
List supported source/destination chains for bridging.
/api/v1/bridge/chains
$0.002 USDC
▼
Description
List supported source/destination chains for bridging.
Request
const result = await client.get( "/api/v1/bridge/chains" );
Payroll
3 endpointsPOST Execute
Execute a payroll run — batch USDC/stablecoin payments to employees.
/api/v1/payroll/execute
$0.10 USDC
▼
Description
Execute a payroll run — batch USDC/stablecoin payments to employees.
Request
const result = await client.post( "/api/v1/payroll/execute", {...} );
POST Estimate
Estimate payroll batch cost and fees before execution.
/api/v1/payroll/estimate
$0.003 USDC
▼
Description
Estimate payroll batch cost and fees before execution.
Request
const result = await client.post( "/api/v1/payroll/estimate", {...} );
GET Tokens
List supported payroll tokens (USDC, USDT, DAI, EURC, etc.).
/api/v1/payroll/tokens
$0.002 USDC
▼
Description
List supported payroll tokens (USDC, USDT, DAI, EURC, etc.).
Request
const result = await client.get( "/api/v1/payroll/tokens" );
Invoicing
3 endpointsPOST Create
Create an x402 payment-gated invoice. Shareable link, auto-settles to wallet.
/api/v1/invoice/create
$0.05 USDC
▼
Description
Create an x402 payment-gated invoice. Shareable link, auto-settles to wallet.
Request
const result = await client.post( "/api/v1/invoice/create", {...} );
GET List
List your created invoices with status and payment history.
/api/v1/invoice/list
$0.01 USDC
▼
Description
List your created invoices with status and payment history.
Request
const result = await client.get( "/api/v1/invoice/list" );
GET Invoice
Fetch invoice details and payment status by ID.
/api/v1/invoice/:id
$0.001 USDC
▼
Description
Fetch invoice details and payment status by ID.
Request
const result = await client.get( "/api/v1/invoice/:id" );
Batch Payments (EVM)
2 endpointsThese endpoints implement Batch Payments for Agents (BPA) 1.0 — the open specification for agent batch disbursement. Read the spec →
POST Execute
Execute a batch payment on any of 8 EVM chains (Base, Ethereum, Arbitrum, Polygon, BNB, Avalanche, Unichain, Plasma, BOB). Native + ERC-20.
/api/v1/batch/execute
$0.02 USDC
▼
Description
Execute a batch payment on any of 8 EVM chains (Base, Ethereum, Arbitrum, Polygon, BNB, Avalanche, Unichain, Plasma, BOB). Native + ERC-20.
Request
const result = await client.post( "/api/v1/batch/execute", {...} );
POST Estimate
Estimate gas cost and fees for an EVM batch payment before execution.
/api/v1/batch/estimate
$0.001 USDC
▼
Description
Estimate gas cost and fees for an EVM batch payment before execution.
Request
const result = await client.post( "/api/v1/batch/estimate", {...} );
XRP Ledger Payments
3 endpointsPOST Batch
Execute a batch payment on the XRP Ledger. Native XRP + issued currencies.
/api/v1/xrp/batch
$0.02 USDC
▼
Description
Execute a batch payment on the XRP Ledger. Native XRP + issued currencies.
Request
const result = await client.post( "/api/v1/xrp/batch", {...} );
POST Estimate
Estimate XRPL ledger fee + reserve for a batch payment.
/api/v1/xrp/estimate
$0.001 USDC
▼
Description
Estimate XRPL ledger fee + reserve for a batch payment.
Request
const result = await client.post( "/api/v1/xrp/estimate", {...} );
GET Info
XRPL network info: server state, fee tier, ledger index.
/api/v1/xrp/info
$0.001 USDC
▼
Description
XRPL network info: server state, fee tier, ledger index.
Request
const result = await client.get( "/api/v1/xrp/info" );
Stellar Payments
2 endpointsPOST Batch
Execute a batch payment on the Stellar network. XLM + Stellar assets.
/api/v1/stellar/batch
$0.02 USDC
▼
Description
Execute a batch payment on the Stellar network. XLM + Stellar assets.
Request
const result = await client.post( "/api/v1/stellar/batch", {...} );
POST Estimate
Estimate Stellar base fee and operation count for a batch payment.
/api/v1/stellar/estimate
$0.001 USDC
▼
Description
Estimate Stellar base fee and operation count for a batch payment.
Request
const result = await client.post( "/api/v1/stellar/estimate", {...} );
RPC
2 endpointsPOST Call
Forward a JSON-RPC call to any of 7 supported chains via Alchemy-backed nodes.
/api/v1/rpc/call
$0.001 USDC
▼
Description
Forward a JSON-RPC call to any of 7 supported chains via Alchemy-backed nodes.
Request
const result = await client.post( "/api/v1/rpc/call", {...} );
GET Chains
List supported RPC chains with chain IDs and capabilities.
/api/v1/rpc/chains
$0.001 USDC
▼
Description
List supported RPC chains with chain IDs and capabilities.
Request
const result = await client.get( "/api/v1/rpc/chains" );
Storage (IPFS)
3 endpointsPOST Pin
Pin content to IPFS via Pinata. Returns CID and gateway URL.
/api/v1/storage/pin
$0.01 USDC
▼
Description
Pin content to IPFS via Pinata. Returns CID and gateway URL.
Request
const result = await client.post( "/api/v1/storage/pin", {...} );
GET Get
Fetch pinned content by CID from IPFS.
/api/v1/storage/get
$0.005 USDC
▼
Description
Fetch pinned content by CID from IPFS.
Request
const result = await client.get( "/api/v1/storage/get" );
GET Status
Check pin status for a stored CID.
/api/v1/storage/status
$0.002 USDC
▼
Description
Check pin status for a stored CID.
Request
const result = await client.get( "/api/v1/storage/status" );
Cron & Scheduling
3 endpointsPOST Create
Schedule a recurring or one-shot job (payments, webhooks, calls).
/api/v1/cron/create
$0.01 USDC
▼
Description
Schedule a recurring or one-shot job (payments, webhooks, calls).
Request
const result = await client.post( "/api/v1/cron/create", {...} );
GET List
List your active scheduled jobs.
/api/v1/cron/list
$0.002 USDC
▼
Description
List your active scheduled jobs.
Request
const result = await client.get( "/api/v1/cron/list" );
POST Cancel
Cancel a scheduled job by ID.
/api/v1/cron/cancel
$0.002 USDC
▼
Description
Cancel a scheduled job by ID.
Request
const result = await client.post( "/api/v1/cron/cancel", {...} );
Logs
2 endpointsPOST Ingest
Ingest a structured log entry for audit and observability.
/api/v1/logs/ingest
$0.002 USDC
▼
Description
Ingest a structured log entry for audit and observability.
Request
const result = await client.post( "/api/v1/logs/ingest", {...} );
GET Query
Query ingested logs with filters (time range, level, tags).
/api/v1/logs/query
$0.005 USDC
▼
Description
Query ingested logs with filters (time range, level, tags).
Request
const result = await client.get( "/api/v1/logs/query" );
Audit Trail
2 endpointsPOST Log
Append an immutable entry to the on-chain audit trail.
/api/v1/audit/log
$0.001 USDC
▼
Description
Append an immutable entry to the on-chain audit trail.
Request
const result = await client.post( "/api/v1/audit/log", {...} );
GET Query
Query the audit trail by actor, action, or time range.
/api/v1/audit/query
$0.03 USDC
▼
Description
Query the audit trail by actor, action, or time range.
Request
const result = await client.get( "/api/v1/audit/query" );
Tax & Reports
2 endpointsPOST Calculate
Calculate crypto tax gain/loss using FIFO method.
/api/v1/tax/calculate
$0.08 USDC
▼
Description
Calculate crypto tax gain/loss using FIFO method.
Request
const result = await client.post( "/api/v1/tax/calculate", {...} );
GET Report
Retrieve a tax report with IRS Form 8949-compatible data.
/api/v1/tax/report
$0.05 USDC
▼
Description
Retrieve a tax report with IRS Form 8949-compatible data.
Request
const result = await client.get( "/api/v1/tax/report" );
KYC / KYB
2 endpointsPOST Verify
Initiate KYC/KYB verification for compliance-gated payments.
/api/v1/kyc/verify
$0.02 USDC
▼
Description
Initiate KYC/KYB verification for compliance-gated payments.
Request
const result = await client.post( "/api/v1/kyc/verify", {...} );
GET Status
Check KYC verification status by wallet or session ID.
/api/v1/kyc/status
$0.01 USDC
▼
Description
Check KYC verification status by wallet or session ID.
Request
const result = await client.get( "/api/v1/kyc/status" );
Auth Sessions
2 endpointsPOST Session
Create an authenticated session with scoped permissions.
/api/v1/auth/session
$0.01 USDC
▼
Description
Create an authenticated session with scoped permissions.
Request
const result = await client.post( "/api/v1/auth/session", {...} );
GET Verify
Verify a session token and check its permissions.
/api/v1/auth/verify
$0.005 USDC
▼
Description
Verify a session token and check its permissions.
Request
const result = await client.get( "/api/v1/auth/verify" );
Identity Resolution
1 endpointGET Resolve
Resolve an ENS, Basename, or address to its canonical identity.
/api/v1/resolve
$0.002 USDC
▼
Description
Resolve an ENS, Basename, or address to its canonical identity.
Request
const result = await client.get( "/api/v1/resolve" );
GPU / Compute
4 endpointsPOST Run
Run GPU inference via Replicate. Image, video, audio, LLM workloads.
/api/v1/gpu/run
$0.06 USDC
▼
Description
Run GPU inference via Replicate. Image, video, audio, LLM workloads.
Request
const result = await client.post( "/api/v1/gpu/run", {...} );
GET Status
Check status of a GPU prediction job by ID.
/api/v1/gpu/status/:id
$0.005 USDC
▼
Description
Check status of a GPU prediction job by ID.
Request
const result = await client.get( "/api/v1/gpu/status/:id" );
GET Models
FREE — list curated GPU model shortcuts (Flux, SDXL, Whisper, etc.).
/api/v1/gpu/models
FREE
▼
Description
FREE — list curated GPU model shortcuts (Flux, SDXL, Whisper, etc.).
Request
const result = await client.get( "/api/v1/gpu/models" );
POST Direct Run
GPU inference via a Spraay Direct operator — instant USDC settlement to the GPU host.
/api/v1/gpu-direct/run
$0.03 USDC
▼
Description
GPU inference via a Spraay Direct operator — instant USDC settlement to the GPU host.
Request
const result = await client.post( "/api/v1/gpu-direct/run", {...} );
Robot Task Protocol (RTP)
8 endpointsPOST Register
FREE — Register a robot to the RTP network with capabilities.
/api/v1/robots/register
FREE
▼
Description
FREE — Register a robot to the RTP network with capabilities.
Request
const result = await client.post( "/api/v1/robots/register", {...} );
POST Task
Dispatch a paid task to a robot (RTP). Pays the robot operator on completion.
/api/v1/robots/task
$0.05 USDC
▼
Description
Dispatch a paid task to a robot (RTP). Pays the robot operator on completion.
Request
const result = await client.post( "/api/v1/robots/task", {...} );
POST Complete
FREE — Robot reports task completion (called by the robot, not the buyer).
/api/v1/robots/complete
FREE
▼
Description
FREE — Robot reports task completion (called by the robot, not the buyer).
Request
const result = await client.post( "/api/v1/robots/complete", {...} );
GET List
Discover registered robots by capability, location, or status.
/api/v1/robots/list
$0.005 USDC
▼
Description
Discover registered robots by capability, location, or status.
Request
const result = await client.get( "/api/v1/robots/list" );
GET Status
Poll the status of an in-flight robot task.
/api/v1/robots/status
$0.002 USDC
▼
Description
Poll the status of an in-flight robot task.
Request
const result = await client.get( "/api/v1/robots/status" );
GET Profile
Fetch a robot's public profile: capabilities, reputation, history.
/api/v1/robots/profile
$0.002 USDC
▼
Description
Fetch a robot's public profile: capabilities, reputation, history.
Request
const result = await client.get( "/api/v1/robots/profile" );
PATCH Update
FREE — Update a robot's profile or capability list.
/api/v1/robots/update
FREE
▼
Description
FREE — Update a robot's profile or capability list.
Request
const result = await client.patch( "/api/v1/robots/update", {...} );
POST Deregister
FREE — Remove a robot from the RTP network.
/api/v1/robots/deregister
FREE
▼
Description
FREE — Remove a robot from the RTP network.
Request
const result = await client.post( "/api/v1/robots/deregister", {...} );
Supply Chain Task Protocol (SCTP)
8 endpointsPOST Supplier
Register a supplier in the Supply Chain Task Protocol.
/api/v1/sctp/supplier
$0.02 USDC
▼
Description
Register a supplier in the Supply Chain Task Protocol.
Request
const result = await client.post( "/api/v1/sctp/supplier", {...} );
GET Supplier
Fetch supplier profile by ID.
/api/v1/sctp/supplier/:id
$0.005 USDC
▼
Description
Fetch supplier profile by ID.
Request
const result = await client.get( "/api/v1/sctp/supplier/:id" );
POST Po
Create a purchase order (PO) with line items and payment terms.
/api/v1/sctp/po
$0.02 USDC
▼
Description
Create a purchase order (PO) with line items and payment terms.
Request
const result = await client.post( "/api/v1/sctp/po", {...} );
GET Po
Fetch purchase order by ID.
/api/v1/sctp/po/:id
$0.005 USDC
▼
Description
Fetch purchase order by ID.
Request
const result = await client.get( "/api/v1/sctp/po/:id" );
POST Invoice
Submit a supplier invoice against a purchase order.
/api/v1/sctp/invoice
$0.02 USDC
▼
Description
Submit a supplier invoice against a purchase order.
Request
const result = await client.post( "/api/v1/sctp/invoice", {...} );
GET Invoice
Fetch supplier invoice by ID.
/api/v1/sctp/invoice/:id
$0.005 USDC
▼
Description
Fetch supplier invoice by ID.
Request
const result = await client.get( "/api/v1/sctp/invoice/:id" );
POST Verify
AI-powered invoice verification: matches PO line items and flags discrepancies.
/api/v1/sctp/invoice/verify
$0.03 USDC
▼
Description
AI-powered invoice verification: matches PO line items and flags discrepancies.
Request
const result = await client.post( "/api/v1/sctp/invoice/verify", {...} );
POST Pay
Execute a supplier payment via Spraay batch contracts.
/api/v1/sctp/pay
$0.10 USDC
▼
Description
Execute a supplier payment via Spraay batch contracts.
Request
const result = await client.post( "/api/v1/sctp/pay", {...} );
Agent Wallet (ERC-4337)
5 endpointsPOST Provision
Provision an ERC-4337 agent wallet on Base for an AI agent.
/api/v1/agent-wallet/provision
$0.05 USDC
▼
Description
Provision an ERC-4337 agent wallet on Base for an AI agent.
Request
const result = await client.post( "/api/v1/agent-wallet/provision", {...} );
POST Session Key
Add a scoped session key to an agent wallet (permissions, spend limit, expiry).
/api/v1/agent-wallet/session-key
$0.02 USDC
▼
Description
Add a scoped session key to an agent wallet (permissions, spend limit, expiry).
Request
const result = await client.post( "/api/v1/agent-wallet/session-key", {...} );
GET Info
Fetch agent wallet metadata: keys, owner, balances.
/api/v1/agent-wallet/info
$0.005 USDC
▼
Description
Fetch agent wallet metadata: keys, owner, balances.
Request
const result = await client.get( "/api/v1/agent-wallet/info" );
POST Revoke Key
Revoke a session key from an agent wallet.
/api/v1/agent-wallet/revoke-key
$0.02 USDC
▼
Description
Revoke a session key from an agent wallet.
Request
const result = await client.post( "/api/v1/agent-wallet/revoke-key", {...} );
GET Predict
Predict the deterministic address of an agent wallet before deployment.
/api/v1/agent-wallet/predict
$0.001 USDC
▼
Description
Predict the deterministic address of an agent wallet before deployment.
Request
const result = await client.get( "/api/v1/agent-wallet/predict" );
Wallet Provisioning
5 endpointsGET List Wallets
List agent wallets with pagination.
/api/v1/wallet/list
$0.002 USDC
▼
Description
List agent wallets with pagination.
Request
const result = await client.get( "/api/v1/wallet/list" );
GET Get Wallet
Get agent wallet details.
/api/v1/wallet/:walletId
$0.001 USDC
▼
Description
Get agent wallet details by wallet ID.
Request
const result = await client.get( "/api/v1/wallet/:walletId" );
GET Wallet Addresses
Get chain-specific addresses for a wallet.
/api/v1/wallet/:walletId/addresses
$0.001 USDC
▼
Description
Get chain-specific addresses for a wallet.
Request
const result = await client.get( "/api/v1/wallet/:walletId/addresses" );
POST Sign Message
Sign a message with an agent wallet.
/api/v1/wallet/sign-message
$0.005 USDC
▼
Description
Sign a message with an agent wallet.
Request
const result = await client.post( "/api/v1/wallet/sign-message", {...} );
POST Send Transaction
Sign and broadcast a transaction from an agent wallet.
/api/v1/wallet/send-transaction
$0.02 USDC
▼
Description
Sign and broadcast a transaction from an agent wallet.
Request
const result = await client.post( "/api/v1/wallet/send-transaction", {...} );
Managed Compute
10 endpointsPOST Text Inference
LLM text inference across 11 models. Auto-routed, pay per call.
/api/v1/compute/text-inference
$0.003–0.10 USDC
▼
Description
LLM text inference across 11 models. Auto-routed, pay per call.
Request
const result = await client.post( "/api/v1/compute/text-inference", {...} );
POST Image Generation
AI image generation (FLUX, SDXL). Pay per image.
/api/v1/compute/image-generation
$0.02–0.08 USDC
▼
Description
AI image generation (FLUX, SDXL). Pay per image.
Request
const result = await client.post( "/api/v1/compute/image-generation", {...} );
POST Video Generation
AI video generation. Pay per render.
/api/v1/compute/video-generation
$0.40–0.50 USDC
▼
Description
AI video generation. Pay per render.
Request
const result = await client.post( "/api/v1/compute/video-generation", {...} );
POST Text To Speech
Text to speech (TTS). Pay per synthesis.
/api/v1/compute/text-to-speech
$0.03–0.05 USDC
▼
Description
Text to speech (TTS). Pay per synthesis.
Request
const result = await client.post( "/api/v1/compute/text-to-speech", {...} );
POST Speech To Text
Speech to text (STT). Pay per transcription.
/api/v1/compute/speech-to-text
$0.02 USDC
▼
Description
Speech to text (STT). Pay per transcription.
Request
const result = await client.post( "/api/v1/compute/speech-to-text", {...} );
POST Embeddings
Text embeddings for RAG pipelines.
/api/v1/compute/embeddings
$0.005 USDC
▼
Description
Text embeddings for RAG pipelines.
Request
const result = await client.post( "/api/v1/compute/embeddings", {...} );
POST Batch
Batch compute — up to 50 jobs, 10% discount.
/api/v1/compute/batch
$0.05 USDC
▼
Description
Batch compute — up to 50 jobs, 10% discount.
Request
const result = await client.post( "/api/v1/compute/batch", {...} );
GET Status
Poll the status of a compute job by ID.
/api/v1/compute/status/:jobId
$0.001 USDC
▼
Description
Poll the status of a compute job by ID.
Request
const result = await client.get( "/api/v1/compute/status/:jobId" );
GET Models
List all compute models across text, image, video, speech & embeddings with pricing. Call first to pick a model.
/api/v1/compute/models
FREE
▼
Description
Free discovery endpoint listing all compute models across text, image, video, speech, and embeddings with pricing. Call first to pick the right model and provider.
Request
const result = await client.get( "/api/v1/compute/models" );
POST Estimate
Free price estimate for a compute job before committing — expected cost by model and input size.
/api/v1/compute/estimate
FREE
▼
Description
Free price estimation for a compute job before committing. Returns expected cost by model and input size. Call before any paid compute request to validate budget.
Request
const result = await client.post( "/api/v1/compute/estimate", {...} );
Solana — Jupiter / Helius / Pyth
6 endpointsGET Jupiter Quote
Get a Jupiter swap quote on Solana.
/api/v1/solana/jupiter/quote
$0.005 USDC
▼
Description
Get a Jupiter swap quote on Solana.
Request
const result = await client.get( "/api/v1/solana/jupiter/quote" );
POST Jupiter Swap Tx
Build a Jupiter swap transaction on Solana.
/api/v1/solana/jupiter/swap-tx
$0.01 USDC
▼
Description
Build a Jupiter swap transaction on Solana.
Request
const result = await client.post( "/api/v1/solana/jupiter/swap-tx", {...} );
GET Helius Assets By Owner
Fetch Helius DAS assets owned by an address.
/api/v1/solana/helius/assets-by-owner
$0.003 USDC
▼
Description
Fetch Helius DAS assets owned by an address.
Request
const result = await client.get( "/api/v1/solana/helius/assets-by-owner" );
GET Helius Asset
Fetch a single Helius DAS asset by ID.
/api/v1/solana/helius/asset
$0.002 USDC
▼
Description
Fetch a single Helius DAS asset by ID.
Request
const result = await client.get( "/api/v1/solana/helius/asset" );
GET Pyth Price
Pyth price feed for a single asset.
/api/v1/solana/pyth/price
$0.005 USDC
▼
Description
Pyth price feed for a single asset.
Request
const result = await client.get( "/api/v1/solana/pyth/price" );
GET Pyth Prices
Pyth batch price feed for multiple assets.
/api/v1/solana/pyth/prices
$0.008 USDC
▼
Description
Pyth batch price feed for multiple assets.
Request
const result = await client.get( "/api/v1/solana/pyth/prices" );
Portfolio
2 endpointsGET Tokens
Full token portfolio for an address across supported chains.
/api/v1/portfolio/tokens
$0.005 USDC
▼
Description
Full token portfolio for an address across supported chains.
Request
const result = await client.get( "/api/v1/portfolio/tokens" );
GET Nfts
NFT holdings for an address across supported chains.
/api/v1/portfolio/nfts
$0.005 USDC
▼
Description
NFT holdings for an address across supported chains.
Request
const result = await client.get( "/api/v1/portfolio/nfts" );
Contract Calls
2 endpointsPOST Read
Read from any smart contract via a view/pure call.
/api/v1/contract/read
$0.002 USDC
▼
Description
Read from any smart contract via a view/pure call.
Request
const result = await client.post( "/api/v1/contract/read", {...} );
POST Write
Submit a state-changing smart contract transaction.
/api/v1/contract/write
$0.01 USDC
▼
Description
Submit a state-changing smart contract transaction.
Request
const result = await client.post( "/api/v1/contract/write", {...} );
DeFi Positions
1 endpointGET Positions
Open DeFi positions for an address across supported protocols.
/api/v1/defi/positions
$0.008 USDC
▼
Description
Open DeFi positions for an address across supported protocols.
Request
const result = await client.get( "/api/v1/defi/positions" );
Compute Futures
6 endpointsPOST Deposit
Deposit USDC to open a prepaid compute credit account. Tier discounts: $10+ (5%), $50+ (10%), $200+ (15%).
/api/v1/compute-futures/deposit
$0.01 USDC
▼
Description
Deposit USDC to open a prepaid compute credit account. Tier discounts: $10+ (5%), $50+ (10%), $200+ (15%). Draw down per inference, refund unused balance anytime.
Request
const result = await client.post( "/api/v1/compute-futures/deposit", {...} );
GET Balance
Check remaining compute credit balance, tier, discount, and usage stats.
/api/v1/compute-futures/balance
$0.001 USDC
▼
Description
Check remaining compute credit balance, tier, discount, and usage stats for a futures account.
Request
const result = await client.get( "/api/v1/compute-futures/balance" );
POST Execute
Run a compute job and deduct cost from prepaid balance. No per-call x402 — uses credit balance.
/api/v1/compute-futures/execute
$0.001 USDC
▼
Description
Run a compute job (text-inference, image-gen, video-gen, TTS, STT, embeddings) and deduct cost from the prepaid balance instead of paying per call. Tier discount applied automatically.
Request
const result = await client.post( "/api/v1/compute-futures/execute", {...} );
GET History
Full usage ledger — every job, model, price, and balance change.
/api/v1/compute-futures/history
$0.002 USDC
▼
Description
Full usage ledger for a compute futures account — every job, model, price, and balance change. For accounting and reconciliation.
Request
const result = await client.get( "/api/v1/compute-futures/history" );
POST Refund
Refund unused compute credit balance to the depositor. Depositor only.
/api/v1/compute-futures/refund
$0.01 USDC
▼
Description
Refund the unused compute credit balance back to the original depositor. Only the depositor can request a refund.
Request
const result = await client.post( "/api/v1/compute-futures/refund", {...} );
GET Pricing
Tier discounts, per-model costs, and bulk discount info.
/api/v1/compute-futures/pricing
$0.001 USDC
▼
Description
Compute futures pricing — tier discounts, per-model costs, and bulk discount info. Call before deposit to evaluate tiers.
Request
const result = await client.get( "/api/v1/compute-futures/pricing" );
Research & Reference
23 endpointsGET Dictionary Define
Dictionary definition with phonetics and examples.
/api/v1/research/dictionary/define
$0.001 USDC
▼
Description
Dictionary definition with phonetics and examples.
Request
const result = await client.get( "/api/v1/research/dictionary/define" );
GET Dictionary Synonyms
Synonyms and antonyms for a word.
/api/v1/research/dictionary/synonyms
$0.001 USDC
▼
Description
Synonyms and antonyms for a word.
Request
const result = await client.get( "/api/v1/research/dictionary/synonyms" );
GET Dictionary Phonetics
Phonetic transcription and audio URL.
/api/v1/research/dictionary/phonetics
$0.001 USDC
▼
Description
Phonetic transcription and audio URL.
Request
const result = await client.get( "/api/v1/research/dictionary/phonetics" );
GET Papers Search
Search 250M+ academic papers (OpenAlex CC0).
/api/v1/research/papers/search
$0.002 USDC
▼
Description
Search 250M+ academic papers (OpenAlex CC0).
Request
const result = await client.get( "/api/v1/research/papers/search" );
GET Papers By DOI
Paper metadata by DOI (OpenAlex).
/api/v1/research/papers/by-doi
$0.001 USDC
▼
Description
Paper metadata by DOI (OpenAlex).
Request
const result = await client.get( "/api/v1/research/papers/by-doi" );
GET Papers By Author
Papers by author name or ORCID (OpenAlex).
/api/v1/research/papers/by-author
$0.002 USDC
▼
Description
Papers by author name or ORCID (OpenAlex).
Request
const result = await client.get( "/api/v1/research/papers/by-author" );
GET Papers Citations
Citation graph — cited-by count and references.
/api/v1/research/papers/citations
$0.002 USDC
▼
Description
Citation graph — cited-by count and references.
Request
const result = await client.get( "/api/v1/research/papers/citations" );
GET Papers Trending
Trending papers by topic in the last N days.
/api/v1/research/papers/trending
$0.002 USDC
▼
Description
Trending papers by topic in the last N days.
Request
const result = await client.get( "/api/v1/research/papers/trending" );
GET Preprints Search
Search arXiv preprints by keyword and category.
/api/v1/research/preprints/search
$0.002 USDC
▼
Description
Search arXiv preprints by keyword and category.
Request
const result = await client.get( "/api/v1/research/preprints/search" );
GET Preprints By ID
arXiv preprint metadata by ID.
/api/v1/research/preprints/by-id
$0.001 USDC
▼
Description
arXiv preprint metadata by ID.
Request
const result = await client.get( "/api/v1/research/preprints/by-id" );
GET Preprints Recent
Latest arXiv preprints by category.
/api/v1/research/preprints/recent
$0.002 USDC
▼
Description
Latest arXiv preprints by category.
Request
const result = await client.get( "/api/v1/research/preprints/recent" );
GET Scholarly By DOI
Full Crossref metadata for any DOI.
/api/v1/research/scholarly/by-doi
$0.001 USDC
▼
Description
Full Crossref metadata for any DOI.
Request
const result = await client.get( "/api/v1/research/scholarly/by-doi" );
GET Scholarly Search
Search 150M+ works via Crossref (CC0).
/api/v1/research/scholarly/search
$0.002 USDC
▼
Description
Search 150M+ works via Crossref (CC0).
Request
const result = await client.get( "/api/v1/research/scholarly/search" );
GET Scholarly Citations Count
Citation count and references for a DOI.
/api/v1/research/scholarly/citations-count
$0.001 USDC
▼
Description
Citation count and references for a DOI.
Request
const result = await client.get( "/api/v1/research/scholarly/citations-count" );
GET Scholarly Journal Info
Journal metadata by ISSN.
/api/v1/research/scholarly/journal-info
$0.001 USDC
▼
Description
Journal metadata by ISSN.
Request
const result = await client.get( "/api/v1/research/scholarly/journal-info" );
GET Chemistry Compound
PubChem compound by name, formula, or CID.
/api/v1/research/chemistry/compound
$0.002 USDC
▼
Description
PubChem compound by name, formula, or CID.
Request
const result = await client.get( "/api/v1/research/chemistry/compound" );
GET Chemistry Similarity
Find structurally similar compounds in PubChem.
/api/v1/research/chemistry/similarity
$0.002 USDC
▼
Description
Find structurally similar compounds in PubChem.
Request
const result = await client.get( "/api/v1/research/chemistry/similarity" );
GET Chemistry Bioactivity
Biological assay results for a PubChem compound.
/api/v1/research/chemistry/bioactivity
$0.002 USDC
▼
Description
Biological assay results for a PubChem compound.
Request
const result = await client.get( "/api/v1/research/chemistry/bioactivity" );
GET Biomedical Search
Search 36M+ biomedical papers in PubMed.
/api/v1/research/biomedical/search
$0.002 USDC
▼
Description
Search 36M+ biomedical papers in PubMed.
Request
const result = await client.get( "/api/v1/research/biomedical/search" );
GET Biomedical By PMID
Paper metadata by PubMed ID.
/api/v1/research/biomedical/by-pmid
$0.001 USDC
▼
Description
Paper metadata by PubMed ID.
Request
const result = await client.get( "/api/v1/research/biomedical/by-pmid" );
GET Demographics Census
US Census data by state, county, or zip.
/api/v1/research/demographics/census
$0.001 USDC
▼
Description
US Census data by state, county, or zip.
Request
const result = await client.get( "/api/v1/research/demographics/census" );
GET Demographics Datasets
Search Data.gov datasets by keyword.
/api/v1/research/demographics/datasets
$0.001 USDC
▼
Description
Search Data.gov datasets by keyword.
Request
const result = await client.get( "/api/v1/research/demographics/datasets" );
Safety & Trust
4 endpointsGET Address Safety
Screen recipients — phishing, sanctions, exploits, mixer usage, malicious contracts.
/api/v1/address/safety
FREE
▼
Description
Free address safety screen — phishing, sanctions, exploits, mixer usage, malicious contracts. Screen recipients before sending funds.
Request
const result = await client.get( "/api/v1/address/safety" );
GET Token Safety
Pre-trade token check — honeypot, sell tax, mint/blacklist, proxy risk (GoPlus-powered).
/api/v1/token/safety
FREE
▼
Description
Free pre-trade token safety check — honeypot, sell tax, mint/blacklist, proxy risk. GoPlus-powered with Spraay severity scoring. Called before every trade.
Request
const result = await client.get( "/api/v1/token/safety" );
GET Decode Tx
Plain-English summary + structured token transfers for any EVM transaction.
/api/v1/tx/decode
FREE
▼
Description
Free transaction decoder — plain-English summary + structured token transfers for any EVM tx. Covers swaps, transfers, approvals, wraps, NFTs, batch payments. Blockscout-powered.
Request
const result = await client.get( "/api/v1/tx/decode" );
GET Trust Score
Multi-dimensional wallet/agent trust score via ProofLayer — financial, reliability, social axes.
/api/v1/trust/score
$0.03 USDC
▼
Description
Multi-dimensional wallet/agent trust score via ProofLayer. Financial, reliability, trust, social axes + XMTP reputation + on-chain signals. Counterparty due diligence for agent-to-agent payments.
Request
const result = await client.get( "/api/v1/trust/score" );
Prediction Markets
7 endpointsGET Search
Search prediction markets across Polymarket & Kalshi in one query.
/api/v1/markets/search
$0.002 USDC
▼
Description
Search prediction markets across Polymarket & Kalshi in one query. Returns matching markets from all sources with prices and source labels.
Request
const result = await client.get( "/api/v1/markets/search" );
GET Polymarket Events
List Polymarket events with their markets, outcomes, and current prices.
/api/v1/markets/polymarket/events
$0.001 USDC
▼
Description
List Polymarket events with their markets, outcomes, and current prices.
Request
const result = await client.get( "/api/v1/markets/polymarket/events" );
GET Polymarket Market
Single Polymarket market by condition ID — outcomes, prices, volume, resolution.
/api/v1/markets/polymarket/market
$0.001 USDC
▼
Description
Single Polymarket market by condition ID — outcomes, prices, volume, resolution status.
Request
const result = await client.get( "/api/v1/markets/polymarket/market" );
GET Polymarket Order Book
Live CLOB order book (bids/asks with sizes) for a Polymarket outcome token.
/api/v1/markets/polymarket/orderbook
$0.001 USDC
▼
Description
Live CLOB order book (bids/asks with sizes) for a Polymarket outcome token.
Request
const result = await client.get( "/api/v1/markets/polymarket/orderbook" );
GET Polymarket Trades
Recent trades for a Polymarket market — price, size, side, and timestamp.
/api/v1/markets/polymarket/trades
$0.001 USDC
▼
Description
Recent trades for a Polymarket market — price, size, side, and timestamp.
Request
const result = await client.get( "/api/v1/markets/polymarket/trades" );
GET Kalshi Events
List Kalshi event contracts (regulated US markets) with tickers and prices.
/api/v1/markets/kalshi/events
$0.001 USDC
▼
Description
List Kalshi event contracts (regulated US markets) with tickers and prices.
Request
const result = await client.get( "/api/v1/markets/kalshi/events" );
GET Kalshi Market
Single Kalshi market by ticker — yes/no prices, volume, and settlement info.
/api/v1/markets/kalshi/market
$0.001 USDC
▼
Description
Single Kalshi market by ticker — yes/no prices, volume, and settlement info.
Request
const result = await client.get( "/api/v1/markets/kalshi/market" );
Stocks
4 endpointsGET Price
Real-time stock quote via Finnhub — price, daily O/H/L, prev close, change.
/api/v1/stocks/price
$0.001 USDC
▼
Description
Real-time stock quote via Finnhub — current price, daily open/high/low, previous close, and change.
Request
const result = await client.get( "/api/v1/stocks/price" );
GET History
Historical OHLC candles via Finnhub for any resolution and date range.
/api/v1/stocks/history
$0.001 USDC
▼
Description
Historical OHLC candles via Finnhub — open/high/low/close/volume series for the requested resolution and range.
Request
const result = await client.get( "/api/v1/stocks/history" );
GET Company
Company profile via Finnhub — exchange, industry, market cap, IPO date.
/api/v1/stocks/company
$0.001 USDC
▼
Description
Company profile via Finnhub — name, exchange, industry, market cap, IPO date, and more.
Request
const result = await client.get( "/api/v1/stocks/company" );
GET Search
Search a stock symbol by company name or partial ticker via Finnhub.
/api/v1/stocks/search
$0.001 USDC
▼
Description
Search a stock symbol by company name or partial ticker via Finnhub.
Request
const result = await client.get( "/api/v1/stocks/search" );
Image Generation
3 endpointsPOST Generate
Generate images from a text prompt (DALL-E 3, FLUX, or SDXL).
/api/v1/image/generate
$0.06 USDC
▼
Description
Generate images from a text prompt (DALL-E 3, FLUX, or SDXL). Returns the image directly or a job ID to poll with Status.
Request
const result = await client.post( "/api/v1/image/generate", {...} );
POST Edit
Edit an existing image with a text prompt and optional mask.
/api/v1/image/edit
$0.05 USDC
▼
Description
Edit an existing image with a text prompt and optional mask — transparent mask areas are replaced.
Request
const result = await client.post( "/api/v1/image/edit", {...} );
GET Status
Poll an image generation or edit job by ID for progress and result URLs.
/api/v1/image/status
$0.001 USDC
▼
Description
Poll an image generation or edit job by ID — returns progress/state and the result URL(s) once complete.
Request
const result = await client.get( "/api/v1/image/status" );
Connect via
MCP Server — 183 tools
One line: claude mcp add spraay -s user -- npx -y spraay-x402-mcp. Auto-creates a wallet at ~/.spraay/.session — no private key needed. Works in Claude Code, Cursor & Cline; also on Smithery.
Coinbase x402
Merged into the official Coinbase x402 ecosystem registry.
Google ADK
Official community tool — merged via ADK PR #95.
AWS Strands
Community tool — merged into the Strands Agents docs (PR #825).
Direct x402 Gateway
Hit endpoints directly with any x402 client. USDC on Base & Solana.
SDKs & Libraries
TypeScript SDK, Solana SDK, Python CLI. Open source on GitHub.
RTP Spec
Robot Task Protocol v1.0 — open standard for AI agents hiring robots via x402.
BPA Spec
Batch Payments for Agents 1.0 — the open standard our batch endpoints implement.
Live Traffic
Real-time gateway traffic and settlement metrics.