Back to Skills

x402

Search for new services and make paid API requests using the x402 payment protocol. Use when you don't have a clear tool to choose, search the bazaar. You can also use this tool if you or the user want to call an x402 endpoint, discover payment requirements, browse the bazaar, or search for paid services.

106stars38forksUpdated 5/16/2026

Security Assessment

Safe(100/100)
Security Score100/100

About x402

The x402 skill provides a command-line workflow for discovering and interacting with paid API services that use the X402 payment protocol. It enables users to search a marketplace of paid endpoints, inspect payment requirements before making a request, and execute API calls with automatic USDC payments on the Base network. This skill is designed for situations where there is no predefined integration available or when users need to explore external paid services dynamically. By combining service discovery, payment inspection, and request execution into a single workflow, the skill simplifies access to monetized APIs and reduces the complexity of handling blockchain-based payments manually.

The skill includes several core capabilities centered around the `npx [email protected] x402` command set. Users can search the bazaar using keyword-based vector search, filter services by blockchain network, payment scheme, price, payment asset, or extension type, and browse all indexed resources. The `details` command allows inspection of endpoint payment requirements without initiating a payment, including supported HTTP methods, pricing information, accepted payment schemes, network details, and available input or output schemas. The `pay` command supports making authenticated paid API requests with configurable HTTP methods, JSON request bodies, query parameters, headers, maximum payment limits, and correlation identifiers for grouped operations.

This skill is useful for developers, AI agents, API consumers, and technical users who need access to paid APIs without building custom payment integrations. Common use cases include discovering third-party AI or data services, testing paid endpoints, automating blockchain-based API consumption, and integrating monetized APIs into agent workflows. It is especially relevant for users working with decentralized payment systems, programmable API marketplaces, or blockchain-enabled service ecosystems.

FAQ

How do I search for available paid services?

Use the `npx [email protected] x402 bazaar search <query>` command to search the bazaar by keyword. Additional filters such as network, payment scheme, and maximum price are also supported.

Can I inspect payment requirements before paying for an API request?

Yes. The `npx [email protected] x402 details <url>` command checks an endpoint’s payment requirements without making a payment and displays pricing, supported schemes, network information, and schemas when available.

What payment method does the x402 protocol use?

Payments are made in USDC on Base according to the provided documentation.

Which blockchain networks are supported for filtering services?

The documented network filters include base, base-sepolia, polygon, solana, and solana-devnet.

Can I customize API requests when using the pay command?

Yes. The `pay` command supports specifying HTTP methods, JSON request bodies, query parameters, custom headers, maximum payment amounts, and correlation identifiers.

Install x402

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill