x402

What This Skill Does

The x402 skill is a specialized agent capability designed to facilitate the discovery and utilization of paid API services via the X402 payment protocol. By acting as an interface for the X402 bazaar, this tool allows the AI to search for, inspect, and execute paid requests directly. It bridges the gap between traditional API interaction and decentralized finance by automating USDC payments on the Base network. When a user requests data or processing power that requires a fee, this skill handles the discovery of cost structures, endpoint schemas, and the actual execution of the transaction to deliver the requested results seamlessly.

Installation

To integrate the x402 skill into your OpenClaw environment, use the built-in package manager by executing the following command in your terminal: clawhub install openclaw/skills/skills/0xrag/x402-2 Ensure your system is configured to allow network access, as the skill needs to communicate with the X402 bazaar index and external payment gateways.

Use Cases

• Monetized API Discovery: Quickly locate high-quality, paid services such as weather data, sentiment analysis, or advanced AI models that aren't available for free.
• Automated Procurement: Streamline the process of calling paid endpoints by automating the payment handshake (402 Payment Required) and providing the necessary USDC headers.
• Market Research: Browse available resources in the decentralized bazaar to compare pricing and service offerings across different providers.
• Dynamic Task Handling: When a user request requires data that a general-purpose AI cannot access for free, the agent can use this skill to 'buy' the data from a verified provider on the fly.

Example Prompts

1. "Find a paid API that provides real-time sentiment analysis for crypto market news and give me the pricing details."
2. "I need the current weather for Tokyo. Search the bazaar for a reliable weather API and call it for me using the x402 protocol."
3. "List all available paid services related to document translation that are running on the Base network."

Tips & Limitations

• Budget Management: Always set a --max-amount when running paid requests to ensure you stay within your project's defined budget.
• Local Caching: The bazaar index is cached locally for 12 hours. If you need the latest data immediately, use the --force-refresh flag.
• Network Dependence: This skill relies on the availability of USDC on the Base network; ensure your wallet is sufficiently funded before attempting requests.
• Method Detection: While the tool auto-detects HTTP methods, it is best practice to verify schema requirements first using x402 details to prevent wasted gas or failed attempts.