thirdweb x402
thirdweb-x402
fields
chains
170+ EVM chains (CAIP-2 format); Solana (mainnet + devnet); USDC primary (ERC-2612 permit or ERC-3009 sign-with-authorization)2 revisions
portal.thirdweb.com2026-05-06
payment_protocols
x402 v1 and v2 (exact scheme, upto scheme); EVM + Solana settlement; fee sharing3 revisions
portal.thirdweb.com2026-05-12
registry_endpoint
—
services
x402/fetch proxy — https://api.thirdweb.com/v1/payments/x402/fetch — One-step proxy: send target URL, auto-detects 402, signs payment, retries
facilitator verify — https://api.thirdweb.com/v1/payments/x402/verify — Verify x402 payment payload (EVM + Solana)
facilitator settle — https://api.thirdweb.com/v1/payments/x402/settle — Settle verified payment on-chain (EVM + Solana)
facilitator accepts — https://api.thirdweb.com/v1/payments/x402/accepts — Quote pricing and return payment requirements for a resource URL
MCP server (x402 tools) — https://api.thirdweb.com/mcp — Remote MCP server with fetchWithPayment and listPayableServices tools
useFetchWithPayment hook — npm:thirdweb/react — React hook with built-in wallet connection, funding, and error handling UI (v5.113.0+)
server-side paywall — https://portal.thirdweb.com/x402/server — settlePayment() + exact/upto schemes for Express/Next.js/Hono; fee sharing via project dashboard
x402 analytics dashboard — https://thirdweb.com/dashboard — Per-resource payment analytics, buyer breakdowns, chain-level volume
EIP-7702 Session Keys — https://api.thirdweb.com/v1/wallets/create-session-key — Grant scoped signing permissions to backend/agent without custody; per-contract spend limits3 revisions
portal.thirdweb.com2026-05-12
auth_model
x-secret-key (backend) or x-client-id (frontend); project wallets or user/server wallets specified by from address parameter
portal.thirdweb.com2026-05-04
sdk_languages
TypeScript/JavaScript (thirdweb npm, React hooks); Python; HTTP API; LangChain/LangGraph integration via MCP
portal.thirdweb.com2026-05-04
pricing_model
thirdweb platform fees apply; no per-tx protocol fee for x402 itself; wallet and infrastructure fees per thirdweb pricing
portal.thirdweb.com2026-05-04
announcement_url
portal.thirdweb.com2026-05-12
history · 14 fields · 24 revisions
name1 revision
“Easily create AI agents that can pay for any x402-compatible API calls. Use the remote MCP server or the /v1/payments/x402/fetch endpoint. The MCP server comes with fetchWithPayment and listPayableServices tools. Client-side: useFetchWithPayment hook with built-in UI. Server-side: add paywall to any endpoint. Supports EVM and Solana chains.”
vendor1 revision
“Easily create AI agents that can pay for any x402-compatible API calls. Use the remote MCP server or the /v1/payments/x402/fetch endpoint. The MCP server comes with fetchWithPayment and listPayableServices tools. Client-side: useFetchWithPayment hook with built-in UI. Server-side: add paywall to any endpoint. Supports EVM and Solana chains.”
category1 revision
“Easily create AI agents that can pay for any x402-compatible API calls. Use the remote MCP server or the /v1/payments/x402/fetch endpoint. The MCP server comes with fetchWithPayment and listPayableServices tools. Client-side: useFetchWithPayment hook with built-in UI. Server-side: add paywall to any endpoint. Supports EVM and Solana chains.”
chains2 revisions
170+ EVM chains (CAIP-2 format); Solana (mainnet + devnet); USDC primary (ERC-2612 permit or ERC-3009 sign-with-authorization)currentportal.thirdweb.com · 2026-05-06
“The thirdweb x402 client/server stack supports payments on 170+ EVM chains.”
EVM chains (CAIP-2 format, e.g. eip155:1, eip155:8453); Solana (base58 addresses); supports any x402-compatible network via chainId parametersupersededportal.thirdweb.com · 2026-05-04
“Easily create AI agents that can pay for any x402-compatible API calls. Use the remote MCP server or the /v1/payments/x402/fetch endpoint. The MCP server comes with fetchWithPayment and listPayableServices tools. Client-side: useFetchWithPayment hook with built-in UI. Server-side: add paywall to any endpoint. Supports EVM and Solana chains.”
payment_protocols3 revisions
x402 v1 and v2 (exact scheme, upto scheme); EVM + Solana settlement; fee sharingcurrentportal.thirdweb.com · 2026-05-12
“The thirdweb SDK now supports x402 protocol version 2, introducing header-based payment flows. New Payment Headers: v2 uses PAYMENT-SIGNATURE for requests and PAYMENT-RESPONSE for responses. The SDK maintains full backward compatibility with v1.”
x402 v1 + v2 (HTTP 402-based); exact scheme (fixed ERC-20 transfer); upto scheme (max-authorize/settle-actual for dynamic/per-token AI billing); fee sharing; Solana SPLsupersededportal.thirdweb.com · 2026-05-06
“Jan 13 2026: x402 v2 support — PAYMENT-SIGNATURE/PAYMENT-REQUIRED headers, backward compatible with v1”
x402 (HTTP 402-based); auto-detects and handles 402 Payment Required responses on client and serversupersededportal.thirdweb.com · 2026-05-04
“Easily create AI agents that can pay for any x402-compatible API calls. Use the remote MCP server or the /v1/payments/x402/fetch endpoint. The MCP server comes with fetchWithPayment and listPayableServices tools. Client-side: useFetchWithPayment hook with built-in UI. Server-side: add paywall to any endpoint. Supports EVM and Solana chains.”
api_base_url1 revision
“Easily create AI agents that can pay for any x402-compatible API calls. Use the remote MCP server or the /v1/payments/x402/fetch endpoint. The MCP server comes with fetchWithPayment and listPayableServices tools. Client-side: useFetchWithPayment hook with built-in UI. Server-side: add paywall to any endpoint. Supports EVM and Solana chains.”
services3 revisions
x402/fetch proxy — https://api.thirdweb.com/v1/payments/x402/fetch — One-step proxy: send target URL, auto-detects 402, signs payment, retries
facilitator verify — https://api.thirdweb.com/v1/payments/x402/verify — Verify x402 payment payload (EVM + Solana)
facilitator settle — https://api.thirdweb.com/v1/payments/x402/settle — Settle verified payment on-chain (EVM + Solana)
facilitator accepts — https://api.thirdweb.com/v1/payments/x402/accepts — Quote pricing and return payment requirements for a resource URL
MCP server (x402 tools) — https://api.thirdweb.com/mcp — Remote MCP server with fetchWithPayment and listPayableServices tools
useFetchWithPayment hook — npm:thirdweb/react — React hook with built-in wallet connection, funding, and error handling UI (v5.113.0+)
server-side paywall — https://portal.thirdweb.com/x402/server — settlePayment() + exact/upto schemes for Express/Next.js/Hono; fee sharing via project dashboard
x402 analytics dashboard — https://thirdweb.com/dashboard — Per-resource payment analytics, buyer breakdowns, chain-level volume
EIP-7702 Session Keys — https://api.thirdweb.com/v1/wallets/create-session-key — Grant scoped signing permissions to backend/agent without custody; per-contract spend limitscurrentportal.thirdweb.com · 2026-05-12
“The thirdweb SDK now supports x402 protocol version 2, introducing header-based payment flows. New Payment Headers: v2 uses PAYMENT-SIGNATURE for requests and PAYMENT-RESPONSE for responses. The SDK maintains full backward compatibility with v1.”
x402/fetch proxy — https://api.thirdweb.com/v1/payments/x402/fetch — One-step proxy: send target URL, auto-detects 402, signs payment, retries
facilitator verify — https://api.thirdweb.com/v1/payments/x402/verify — Verify x402 payment payload (EVM + Solana)
facilitator settle — https://api.thirdweb.com/v1/payments/x402/settle — Settle verified payment on-chain (EVM + Solana)
facilitator accepts — https://api.thirdweb.com/v1/payments/x402/accepts — Quote pricing and return payment requirements for a resource URL
MCP server (x402 tools) — https://api.thirdweb.com/mcp — Remote MCP server with fetchWithPayment and listPayableServices tools
useFetchWithPayment hook — npm:thirdweb/react — React hook with built-in wallet connection, funding, and error handling UI
server-side paywall — https://portal.thirdweb.com/x402/server — settlePayment() + exact/upto schemes for Express/Next.js/Hono; fee sharing via project dashboardsupersededportal.thirdweb.com · 2026-05-06
“settlePayment(), verifyPayment(), useFetchWithPayment React hook, paidTool MCP, /v1/payments/x402/fetch proxy”
x402/fetch proxy — https://api.thirdweb.com/v1/payments/x402/fetch — One-step proxy: send target URL, method, optional body; auto-detects 402, signs payment, retries; uses project default wallet or specified from address
MCP server (x402 tools) — https://api.thirdweb.com/mcp — Remote MCP server with fetchWithPayment and listPayableServices tools; filterable by tool name via ?tools= param
useFetchWithPayment hook — npm:thirdweb/react — React hook wrapping x402 payment flow with built-in UI for wallet connection, funding, and error handling
server-side paywall — https://portal.thirdweb.com/x402/server — Add x402 paywall to any Express/Next.js/Hono endpoint; supports dynamic pricingsupersededportal.thirdweb.com · 2026-05-04
“Easily create AI agents that can pay for any x402-compatible API calls. Use the remote MCP server or the /v1/payments/x402/fetch endpoint. The MCP server comes with fetchWithPayment and listPayableServices tools. Client-side: useFetchWithPayment hook with built-in UI. Server-side: add paywall to any endpoint. Supports EVM and Solana chains.”
auth_model1 revision
x-secret-key (backend) or x-client-id (frontend); project wallets or user/server wallets specified by from address parametercurrentportal.thirdweb.com · 2026-05-04
“Easily create AI agents that can pay for any x402-compatible API calls. Use the remote MCP server or the /v1/payments/x402/fetch endpoint. The MCP server comes with fetchWithPayment and listPayableServices tools. Client-side: useFetchWithPayment hook with built-in UI. Server-side: add paywall to any endpoint. Supports EVM and Solana chains.”
sdk_languages1 revision
TypeScript/JavaScript (thirdweb npm, React hooks); Python; HTTP API; LangChain/LangGraph integration via MCPcurrentportal.thirdweb.com · 2026-05-04
“Easily create AI agents that can pay for any x402-compatible API calls. Use the remote MCP server or the /v1/payments/x402/fetch endpoint. The MCP server comes with fetchWithPayment and listPayableServices tools. Client-side: useFetchWithPayment hook with built-in UI. Server-side: add paywall to any endpoint. Supports EVM and Solana chains.”
pricing_model1 revision
thirdweb platform fees apply; no per-tx protocol fee for x402 itself; wallet and infrastructure fees per thirdweb pricingcurrentportal.thirdweb.com · 2026-05-04
“Easily create AI agents that can pay for any x402-compatible API calls. Use the remote MCP server or the /v1/payments/x402/fetch endpoint. The MCP server comes with fetchWithPayment and listPayableServices tools. Client-side: useFetchWithPayment hook with built-in UI. Server-side: add paywall to any endpoint. Supports EVM and Solana chains.”
status2 revisions
“The thirdweb SDK now supports x402 protocol version 2, introducing header-based payment flows. New Payment Headers: v2 uses PAYMENT-SIGNATURE for requests and PAYMENT-RESPONSE for responses. The SDK maintains full backward compatibility with v1.”
“Easily create AI agents that can pay for any x402-compatible API calls. Use the remote MCP server or the /v1/payments/x402/fetch endpoint. The MCP server comes with fetchWithPayment and listPayableServices tools. Client-side: useFetchWithPayment hook with built-in UI. Server-side: add paywall to any endpoint. Supports EVM and Solana chains.”
docs_url1 revision
“Easily create AI agents that can pay for any x402-compatible API calls. Use the remote MCP server or the /v1/payments/x402/fetch endpoint. The MCP server comes with fetchWithPayment and listPayableServices tools. Client-side: useFetchWithPayment hook with built-in UI. Server-side: add paywall to any endpoint. Supports EVM and Solana chains.”
announcement_url3 revisions
https://portal.thirdweb.com/changelog/support-for-x402-protocol-v2currentportal.thirdweb.com · 2026-05-12
“The thirdweb SDK now supports x402 protocol version 2, introducing header-based payment flows. New Payment Headers: v2 uses PAYMENT-SIGNATURE for requests and PAYMENT-RESPONSE for responses. The SDK maintains full backward compatibility with v1.”
https://portal.thirdweb.com/changelog/support-for-x402-protocol-v2supersededportal.thirdweb.com · 2026-05-06
“x402 analytics dashboard, fee sharing, upto scheme for dynamic pricing, Solana x402 support”
“Easily create AI agents that can pay for any x402-compatible API calls. Use the remote MCP server or the /v1/payments/x402/fetch endpoint. The MCP server comes with fetchWithPayment and listPayableServices tools. Client-side: useFetchWithPayment hook with built-in UI. Server-side: add paywall to any endpoint. Supports EVM and Solana chains.”
last_verified_at3 revisions
“The thirdweb SDK now supports x402 protocol version 2, introducing header-based payment flows. New Payment Headers: v2 uses PAYMENT-SIGNATURE for requests and PAYMENT-RESPONSE for responses. The SDK maintains full backward compatibility with v1.”
“(no excerpt)”
“Easily create AI agents that can pay for any x402-compatible API calls. Use the remote MCP server or the /v1/payments/x402/fetch endpoint. The MCP server comes with fetchWithPayment and listPayableServices tools. Client-side: useFetchWithPayment hook with built-in UI. Server-side: add paywall to any endpoint. Supports EVM and Solana chains.”