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 — Make your first x402 call
// Install the x402 client npm install x402-client // Make a paid API call — payment is automatic import { createClient } from "x402-client"; const client = createClient({ baseUrl: "https://gateway.spraay.app", privateKey: process.env.EVM_PRIVATE_KEY, // Wallet with USDC on Base }); // 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: ... } // Batch send USDC to 50 wallets — pays $0.02 USDC const tx = await client.post("/api/v1/batch/execute", { token: "USDC", recipients: [{ address: "0x...", amount: "10.00" }, /* ... */] });
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
3 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" );
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" );
Managed Compute
8 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" );
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" );
Geospatial
12 endpointsPOST Geocode
Geocode an address or place to lat/lng coordinates. Powered by OpenStreetMap.
/api/v1/geo/geocode
$0.005 USDC
▼
Description
Geocode an address or place to lat/lng coordinates. Powered by OpenStreetMap.
Request
const result = await client.post( "/api/v1/geo/geocode", {...} );
POST Reverse Geocode
Reverse geocode lat/lng to an address. Powered by OpenStreetMap.
/api/v1/geo/reverse-geocode
$0.005 USDC
▼
Description
Reverse geocode lat/lng to an address. Powered by OpenStreetMap.
Request
const result = await client.post( "/api/v1/geo/reverse-geocode", {...} );
POST Route
Turn-by-turn directions between waypoints with distance and duration. Driving, cycling, walking.
/api/v1/geo/route
$0.01 USDC
▼
Description
Turn-by-turn directions between waypoints with distance and duration. Driving, cycling, walking.
Request
const result = await client.post( "/api/v1/geo/route", {...} );
POST Isochrone
Reachability polygon — area reachable within N seconds from a point. Delivery zones, coverage areas.
/api/v1/geo/isochrone
$0.02 USDC
▼
Description
Reachability polygon — area reachable within N seconds from a point. Delivery zones, coverage areas.
Request
const result = await client.post( "/api/v1/geo/isochrone", {...} );
POST Elevation
Terrain elevation at one or more coordinates. SRTM 30m resolution.
/api/v1/geo/elevation
$0.003 USDC
▼
Description
Terrain elevation at one or more coordinates. SRTM 30m resolution.
Request
const result = await client.post( "/api/v1/geo/elevation", {...} );
POST Weather
Current weather and 24h forecast at coordinates. Temperature, wind, humidity, precipitation.
/api/v1/geo/weather
$0.01 USDC
▼
Description
Current weather and 24h forecast at coordinates. Temperature, wind, humidity, precipitation.
Request
const result = await client.post( "/api/v1/geo/weather", {...} );
POST Weather Alerts
Severe weather alerts at coordinates — storms, floods, heat, wind advisories.
/api/v1/geo/weather-alerts
$0.01 USDC
▼
Description
Severe weather alerts at coordinates — storms, floods, heat, wind advisories.
Request
const result = await client.post( "/api/v1/geo/weather-alerts", {...} );
POST Flight Status
Real-time flight status, departure/arrival times, gates, aircraft, and delays. AeroDataBox.
/api/v1/geo/flight-status
$0.05 USDC
▼
Description
Real-time flight status, departure/arrival times, gates, aircraft, and delays. AeroDataBox.
Request
const result = await client.post( "/api/v1/geo/flight-status", {...} );
POST Airport Info
Airport details — location, timezone, elevation, IATA/ICAO codes, country. AeroDataBox.
/api/v1/geo/airport-info
$0.03 USDC
▼
Description
Airport details — location, timezone, elevation, IATA/ICAO codes, country. AeroDataBox.
Request
const result = await client.post( "/api/v1/geo/airport-info", {...} );
POST Distance Matrix
Distance and duration matrix between multiple origin-destination pairs. Fleet dispatch, nearest facility.
/api/v1/geo/distance-matrix
$0.02 USDC
▼
Description
Distance and duration matrix between multiple origin-destination pairs. Fleet dispatch, nearest facility.
Request
const result = await client.post( "/api/v1/geo/distance-matrix", {...} );
POST Nearby
Find points of interest near coordinates — gas stations, hospitals, helipads, etc.
/api/v1/geo/nearby
$0.005 USDC
▼
Description
Find points of interest near coordinates — gas stations, hospitals, helipads, etc.
Request
const result = await client.post( "/api/v1/geo/nearby", {...} );
POST Timezone
Country and timezone info at coordinates.
/api/v1/geo/timezone
$0.003 USDC
▼
Description
Country and timezone info at coordinates.
Request
const result = await client.post( "/api/v1/geo/timezone", {...} );
Connect via
MCP Server
110+ tools for Claude Desktop, Cursor, Cline. Install from 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.