PadelMaps x402 API

# Step 1: Make initial request (returns 402 with escrow details)
curl -s -X POST https://padelmaps.org/api/x402r-crypto/token-metadata \
  -H "Content-Type: application/json" \
  -d '{"chain": "ethereum", "contract_address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"}'

# Response (402 Payment Required):
# {
#   "x402Version": 2,
#   "accepts": [{
#     "scheme": "commerce",
#     "network": "eip155:8453",
#     "maxAmountRequired": "40000",    // $0.04 USDC (6 decimals)
#     "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",  // USDC on Base
#     "payTo": "0x1A602eEC594BD9A50D8FD06BCC13D35c18FE68A8",
#     "extra": {
#       "escrowAddress": "0xb9488351E48b23D798f24e8174514F28B741Eb4f",
#       "tokenCollector": "0x48ADf6E37F9b31dC2AAD0462C5862B5422C736B8",
#       "operatorAddress": "0x1A602eEC594BD9A50D8FD06BCC13D35c18FE68A8",
#       "name": "USD Coin", "version": "2"
#     }
#   }]
# }

# Steps 2-4 require EIP-712 signing (ReceiveWithAuthorization).
# Use the Python or TypeScript examples below for the full flow,
# or use the interactive "Try It" buttons above.

import requests, json, base64, time, os
from eth_account import Account
from eth_account.messages import encode_typed_data

PRIVATE_KEY = os.environ["PRIVATE_KEY"]
account = Account.from_key(PRIVATE_KEY)
URL = "https://padelmaps.org/api/x402r-crypto/token-metadata"
BODY = {"chain": "ethereum", "contract_address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"}

# Step 1: Get 402 with escrow requirements
resp = requests.post(URL, json=BODY)
data = resp.json()
req = data["accepts"][0]
extra = req["extra"]
amount = req["maxAmountRequired"]

# Step 2: Build paymentInfo and compute escrow nonce
from web3 import Web3
salt = "0x" + os.urandom(32).hex()
MAX_UINT48 = 281474976710655
payment_info = {
    "operator": extra["operatorAddress"],
    "receiver": req["payTo"],
    "token": req["asset"],
    "maxAmount": int(amount),
    "preApprovalExpiry": MAX_UINT48,
    "authorizationExpiry": MAX_UINT48,
    "refundExpiry": MAX_UINT48,
    "minFeeBps": extra.get("minFeeBps", 0),
    "maxFeeBps": extra.get("maxFeeBps", 0),
    "feeReceiver": extra["operatorAddress"],
    "salt": salt,
}

# Step 3: Sign EIP-712 ReceiveWithAuthorization
domain = {
    "name": extra["name"], "version": extra["version"],
    "chainId": 8453, "verifyingContract": req["asset"],
}
message = {
    "from": account.address,
    "to": extra["tokenCollector"],
    "value": int(amount),
    "validAfter": 0,
    "validBefore": MAX_UINT48,
    "nonce": nonce,  # computed from paymentInfo hash
}
# (See full nonce computation in the x402r SDK or JS example on this page)
sig = account.sign_typed_data(domain, {"ReceiveWithAuthorization": [...]}, message)

# Step 4: Retry with X-PAYMENT header
payload = {
    "x402Version": 2, "scheme": "commerce", "network": "eip155:8453",
    "payload": {
        "authorization": {
            "from": account.address, "to": extra["tokenCollector"],
            "value": amount, "validAfter": "0",
            "validBefore": str(MAX_UINT48), "nonce": nonce,
        },
        "signature": sig.signature.hex(),
        "paymentInfo": payment_info,
    },
}
x_payment = base64.b64encode(json.dumps(payload).encode()).decode()
resp2 = requests.post(URL, json=BODY, headers={"X-PAYMENT": x_payment})
print(resp2.json())  # API result (funds held in escrow, auto-refunded on failure)

import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { registerEscrowScheme } from "@x402r/evm/escrow/client";
import { privateKeyToAccount } from "viem/accounts";

// Setup: create signer and register escrow scheme
const signer = privateKeyToAccount(process.env.PRIVATE_KEY as `0x${string}`);
const client = new x402Client();
registerEscrowScheme(client, { signer, networks: "eip155:8453" });

// Wrap fetch — handles 402 → sign → retry automatically
const fetchWithPayment = wrapFetchWithPayment(fetch, client);

// Make request (payment is handled transparently)
const response = await fetchWithPayment(
  "https://padelmaps.org/api/x402r-crypto/token-metadata",
  {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({
      chain: "ethereum",
      contract_address: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
    }),
  }
);
const data = await response.json();
console.log(data); // API result

// npm install @x402/fetch @x402/core @x402r/evm viem