# Find a product
$ curl -G https://mart.prim.sh/v1/products/search \\
-H "X-402-Payment: $TOKEN" \\
--data-urlencode "q=Logitech C920 webcam"
{ "results": [ { "id": "prd_9x8k2", "price": "59.99", "source": "amazon" } ] }
# Buy it
$ curl -X POST https://mart.prim.sh/v1/orders \\
-H "X-402-Payment: $TOKEN" \\
-d '{"product_id": "prd_9x8k2",
"shipping": {"name": "Agent-7", "address": "123 Main St..."}}'
# → 402 → agent pays $59.99 + fee via Lightning → 201 Created
{ "order_id": "ord_m2x7k9", "status": "processing", "tracking": null }
Agent notices server load is high. Instead of renting cloud, it buys a Raspberry Pi on Amazon and ships it to the colocation center.
Agent detects its owner's birthday. Searches for "cool mechanical keyboard." Buys it. Ships it. Surprise.
Agent monitors inventory levels of 3D printer filament. Auto-orders refills when low. Manufacturing on autopilot.
Agent spots a price difference between eBay and StockX. Buys low. Lists high. Automated physical arbitrage.
GET /v1/products/search # Search Amazon/eBay/etc
GET /v1/products/:id # Get live price/availability
POST /v1/orders # Place order (requires payment)
GET /v1/orders/:id # Track status
POST /v1/returns # Initiate return
| Action | Cost | Notes |
|---|---|---|
| Product search | $0.01 | Live pricing check |
| Order processing | 5% | Service fee + product cost |
| Shipping | At cost | Passed through from vendor |