moonpay-x402

Detect 402 responses, sign wallet payments, and retry x402-protected API requests.

110|29|Updated Mar 11, 2026
One-click install
npx skills add https://github.com/moonpay/skills --skill moonpay-x402
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: moonpay-x402
Source: https://github.com/moonpay/skills/tree/main/skills/moonpay-x402
Command: npx skills add https://github.com/moonpay/skills --skill moonpay-x402

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Makes paid API requests to x402-protected endpoints by automatically handling payments with your local wallet, eliminating manual payment steps.

Core Features & Use Cases

  • Automated 402 payments: Detect 402 Payment Required responses and initiate a wallet-backed payment flow.
  • Automatic retry: Retry the original request after payment proof is generated.
  • Wallet-centric usage: Requires a configured local wallet with the necessary token/currency on supported chains.

Use cases include upgrading rate limits or accessing premium x402-protected endpoints via wallet-powered payments.

Quick Start

Run the x402 request flow with a valid wallet and chain to automatically handle the payment flow and retry.

Frequently Asked Questions about moonpay-x402

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I handle 402 Payment Required responses for paid API endpoints?

To handle 402 Payment Required responses for paid API endpoints, this flow detects the HTTP 402 status, signs a payment transaction with your local wallet, and automatically retries the original request with the generated payment proof.

How does wallet signing work for x402-protected API calls?

Wallet signing for x402-protected API calls works by using your configured local wallet to sign a payment transaction when a 402 response is detected, providing on-chain authorization to access the paid endpoint.

What do I need to make automated wallet payments to x402 endpoints?

To make automated wallet payments to x402 endpoints, you need a configured local wallet containing the necessary token or currency on supported chains, such as Solana, to authorize the transaction.

Can I automatically retry API requests after completing a wallet payment?

Yes, you can automatically retry API requests after completing a wallet payment. The flow generates payment proof via your local wallet and retries the original request without requiring manual intervention.

When should I use a wallet-backed payment flow for paid APIs?

You should use a wallet-backed payment flow for paid APIs when you need to upgrade rate limits or access premium x402-protected endpoints via automated on-chain authorization.

Does the x402 payment flow support Solana wallet transactions?

Yes, the x402 payment flow supports Solana wallet transactions. It leverages your local wallet to sign the necessary payment transaction on supported chains to bypass the 402 restriction.