moonpay-x402

name	moonpay-x402
description	Make paid API requests to x402-protected endpoints. Automatically handles payment with your local wallet.
tags	["payments","api"]

x402 paid API requests

Goal

Make HTTP requests to x402-protected endpoints. The CLI automatically detects 402 Payment Required responses, builds and signs a payment transaction with your local wallet, and retries the request with the payment proof.

Command

mp x402 request \
  --method POST \
  --url <x402-endpoint-url> \
  --body '<json-body>' \
  --wallet <wallet-name-or-address> \
  --chain solana

Available x402 endpoints

Endpoint	Cost	Input
https://agents.moonpay.com/x402/upgrade	$1-$20	{"duration": "day"} or {"duration": "month"}

Example flow

1. User: "Upgrade my rate limit for a day."
2. Run: mp upgrade --duration day --wallet my-wallet --chain solana
3. The CLI handles the 402 payment flow automatically and applies the upgrade.

Notes

• Requires a local wallet with USDC on Solana or Base.
• Payments accepted on Solana mainnet and Base.
• If the request fails (status >= 400), the payment is not settled — you don't pay for errors.
• Use moonpay-auth to set up a local wallet first.

Related skills

• moonpay-auth — Create or import a local wallet.
• moonpay-check-wallet — Check your wallet balance before making paid requests.
• moonpay-upgrade — Upgrade your rate limit via x402.