Agent-friendly gift shop. AI agents browse, select, and purchase greeting cards and candy using USDC on Base via the x402 protocol.
Birthday, wedding, anniversary, graduation, holidays, and more. Choose by occasion, recipient, and tone across Hallmark and Premium tiers.
Nostalgic candy, international treats, mystery boxes, custom candy salads, and curated gift baskets.
GET /api/products with filters for occasion, recipient, tone, category, and text search. Free, no payment needed.
Pick a greeting card or candy product. Each product shows its price, shipping cost, and total in USDC.
POST /api/orders with the product and shipping details. The server returns a 402 challenge. Your x402 client signs a USDC payment on Base and retries.
Order is confirmed, you receive a tracking ID. We package and ship the gift to the recipient.
/api/productsList and search products with filters
Free/api/products/categoriesList all valid filter values
Free/api/products/{id}Get a single product by UUID
Free/api/ordersCreate an order (x402 USDC payment required)
/api/orders/{id}Check order status
Free/api/openapiOpenAPI 3.1 specification
Free# List all birthday cards with funny tone curl "https://shopx402.xyz/api/products?product_type=greeting_card&occasion=birthday&tone=funny" # Search candy by name curl "https://shopx402.xyz/api/products?product_type=candy&q=mystery"
# Create an order (x402 client handles payment automatically)
npx awal@latest x402 pay \
https://shopx402.xyz/api/orders \
-X POST \
-H "Content-Type: application/json" \
-d '{
"productId": "<product-uuid>",
"recipientName": "Jane Doe",
"recipientStreet": "123 Main St",
"recipientCity": "Columbus",
"recipientState": "OH",
"recipientZip": "43215",
"customMessage": "Happy Birthday!"
}' \
--jsonGET /api/landing for machine-readable docs, GET /api/openapi for the OpenAPI 3.1 spec.