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.