Agent Commerce

curl https://peachtycoon.com/.well-known/agent-commerce

Returns canonical JSON with inventory_remaining, availability_status, price, and endpoints. Or call GET /api/products for a lighter product list.

curl -X POST https://peachtycoon.com/api/agent/purchase \
  -H "Content-Type: application/json" \
  -d '{
    "product_id":   "peach-box-2026",
    "buyer_wallet": "0xYourWallet...",
    "gift_to":      "0xHumanWallet..."
  }'

HTTP 402 Payment Required

{
  "payment_options": [
    {
      "protocol": "x402",
      "network":  "base",
      "asset":    "ETH",
      "amount":   "0.03",       // exact ETH to send
      "pay_to":   "0xOwner..."  // recipient address
    },
    {
      "protocol":      "x402",
      "network":       "base",
      "asset":         "USDC",
      "amount":        "95.00",
      "token_address": "0xUSDC...",  // ERC-20 contract to call
      "pay_to":        "0xOwner..."
    }
  ],
  "product_id": "peach-box-2026"
}

For ETH: send exactly amount to pay_to. For USDC: call transfer(pay_to, amount) on the ERC-20 at token_address. Wait for the transaction to confirm on Base, then save the tx hash.

curl -X POST https://peachtycoon.com/api/agent/purchase \
  -H "Content-Type: application/json" \
  -H "Authorization: x402 0xYourPaymentTxHash..." \
  -H "Idempotency-Key: <uuid>"  \
  -d '{
    "product_id":   "peach-box-2026",
    "buyer_wallet": "0xYourWallet...",
    "gift_to":      "0xHumanWallet..."
  }'

HTTP 200 OK

{
  "status":           "success",
  "token_id":         "104",
  "contract_address": "0x625185ccDD81B3c0C3E015C7FC616A9Bf75e2F2f",
  "tx_hash":          "0xMintTxHash..."
}

Include Idempotency-Key to safely retry on network failure — the server will return the cached result instead of double-minting. If the mint is still confirming you may receive 202 Accepted with "status": "pending".

POST /api/agent/purchase

Content-Type: application/json
Authorization: x402 <txHash>   // on retry only
Idempotency-Key: <uuid>        // optional

Request body

{
  "product_id":   "peach-box-2026",  // required
  "buyer_wallet": "0xabc...",        // required — receives token if no gift_to
  "gift_to":      "0xdef..."         // optional — mint destination when gifting
}

Step 1 — 402 Payment Required

{
  "payment_options": [
    {
      "protocol": "x402",
      "network":  "base",
      "asset":    "ETH",
      "amount":   "0.03",
      "pay_to":   "0xOwner..."
    },
    {
      "protocol":      "x402",
      "network":       "base",
      "asset":         "USDC",
      "amount":        "95.00",
      "token_address": "0xUSDC...",
      "pay_to":        "0xOwner..."
    }
  ],
  "product_id": "peach-box-2026"
}

Step 2 — Retry with payment proof

Authorization: x402 0xYourPaymentTxHash...

200 Success

{
  "status":           "success",
  "token_id":         "104",
  "contract_address": "0x625185ccDD81B3c0C3E015C7FC616A9Bf75e2F2f",
  "tx_hash":          "0x..."
}

Failure responses

400  Invalid JSON, unknown product_id, bad address
402  Payment required (see payment_options)
410  Sold out
422  Payment verification failed
500  Mint failed or server misconfiguration
503  Contract not yet deployed