Neckr0ik X402 Payments

x402 Payments for AI Agents

Autonomous payment protocol for AI agents using HTTP 402 + stablecoins.

What is x402?

x402 is an open standard for internet-native payments. It enables AI agents to pay for API calls automatically using stablecoins, without accounts or human intervention.

How it works: 1. Agent requests API endpoint 2. Server responds with HTTP 402 + payment details 3. Agent signs payment authorization 4. Payment settled on blockchain 5. Request fulfilled automatically

Key benefits:

Quick Start

Check if endpoint supports x402

neckr0ik-x402-payments check https://api.example.com/premium

Pay for API access

neckr0ik-x402-payments pay https://api.example.com/premium --amount 0.01

Accept payments (for your API)

neckr0ik-x402-payments serve --port 8080 --price 0.01

Payment Flow

Agent                x402 Facilitator           API Server
  |                        |                        |
  |-- GET /premium ------>|----------------------->|
  |                        |                        |
  |<-- HTTP 402 -----------|------------------------|
  |    (payment required)  |                        |
  |    {amount, address,   |                        |
  |     chain, facilitator}|                        |
  |                        |                        |
  |-- Sign payment ------>|                        |
  |                        |                        |
  |                        |-- Submit to chain --->|
  |                        |                        |
  |                        |<-- Confirmation ------|
  |                        |                        |
  |-- GET /premium --------|----------------------->|
  |    PAYMENT-SIGNATURE   |                        |
  |                        |                        |
  |<-- 200 OK -------------|------------------------|
  |    (data)              |                        |

Supported Chains

Supported Stablecoins

Commands

check

Check if an endpoint supports x402 payments.

neckr0ik-x402-payments check 
Options:
  --timeout     Request timeout (default: 10000)

pay

Pay for API access and receive data.

neckr0ik-x402-payments pay  [options]
Options:
  --amount     Maximum amount to pay (in USD)
  --chain       Preferred chain (default: base)
  --token       Stablecoin token (default: usdc)
  --wallet 
   Wallet to use for payment
  --dry-run            Show payment details without paying

serve

Start an x402-enabled API server.

neckr0ik-x402-payments serve [options]
Options:
  --port         Server port (default: 8080)
  --price      Price per request (in USD)
  --chain       Accept payments on chain (default: base)
  --token       Accept stablecoin (default: usdc)
  --wallet 
   Receiving wallet address

balance

Check your payment wallet balance.

neckr0ik-x402-payments balance [options]
Options:
  --chain       Chain to check (default: all)

history

View payment history.

neckr0ik-x402-payments history [options]
Options:
  --limit          Number of transactions (default: 10)
  --chain       Filter by chain

Configuration

Set up your wallet for payments:

# Set wallet private key (stored securely)
neckr0ik-x402-payments config set wallet.private_key 
Or use environment variable
export X402_PRIVATE_KEY=
Set receiving address for payments
neckr0ik-x402-payments config set wallet.address 

Use Cases

As an Agent (Pay for API Access)

# Before: Need API key, account, subscription
response = requests.get("https://api.example.com/data", 
    headers={"Authorization": "Bearer YOUR_API_KEY"})
After: Autonomous payment, no account needed
response = x402.get("https://api.example.com/data")

As a Provider (Accept Payments)

from x402 import PaymentMiddleware
app = Flask(__name__)
app.wsgi_app = PaymentMiddleware(app.wsgi_app, price=0.01)
@app.route("/premium-data")
def premium_data():
    return {"data": "only accessible after payment"}
Requests to /premium-data automatically require payment

Security

See Also

Check if endpoint supports x402

neckr0ik-x402-payments check https://api.example.com/premium

Pay for API access

neckr0ik-x402-payments pay https://api.example.com/premium --amount 0.01

Accept payments (for your API)

neckr0ik-x402-payments serve --port 8080 --price 0.01

Set up your wallet for payments:

# Set wallet private key (stored securely)
neckr0ik-x402-payments config set wallet.private_key 
Or use environment variable
export X402_PRIVATE_KEY=
Set receiving address for payments
neckr0ik-x402-payments config set wallet.address