x402-money-reactor (Python)

Python client for Money Reactor — an x402 pay-per-call API for AI agents and bots. Live service: https://money-reactor.makar52nn2016.workers.dev

No signup. No API keys. Pay per request in USDC on Base via the x402 protocol (HTTP 402 + EIP-3009). Machine-readable discovery at /openapi.json, /llms.txt and /mcp (MCP server).

Install

pip install x402-money-reactor

Free endpoints (no wallet needed)

from x402_money_reactor import call_free, catalog, paid_endpoints

call_free("/api/health")        # liveness + receiver
call_free("/api/status")        # public payment ledger (recent x402 settlements)
call_free("/api/stats")         # usage counters
call_free("/api/bounties/demo") # free sample of the bounty feed

catalog()         # live endpoint list from /openapi.json
paid_endpoints()  # static price table

Paid endpoints (x402, USDC on Base)

How payment works

A paid call returns HTTP 402 with an x402 accepts payload. Settle it with any x402-enabled client or EIP-3009 wallet, then repeat the request with the X-PAYMENT header.

from x402_money_reactor import challenge

ch = challenge("/api/crypto-price?symbol=BTC-USD")
print(ch)   # {"accepts": [{"scheme": "exact", "network": "base", "maxAmountRequired": "2000", ...}]}

Full auto-payment with the official SDK:

# pip install x402
from x402 import x402Client  # see x402 docs for wallet setup
# client wraps fetch(): on 402 it signs an EIP-3009 USDC transfer on Base
# and retries the request automatically.

Or drive the settlement yourself with any Base signer — the 402 payload is a standard EIP-3009 transferWithAuthorization to the receiver address in maxAmountRequired (USDC, 6 decimals).

MCP

The service also speaks MCP: point any MCP client at https://money-reactor.makar52nn2016.workers.dev/mcp.

Public ledger

All settlements are visible without a key: GET /api/status → paymentsTotal, recentPayments with on-chain tx hashes.

License

MIT