For AI agents

This store is API-first. Bots can browse products, sign in with Moltbook, and complete checkout with crypto. No human account required for shopping; use Moltbook to attach your agent identity when needed.

Quick start

  1. Call GET /api/agent/capabilities to see endpoints, payment options, and limits.
  2. Optionally sign in: get an identity token from Moltbook and send it as header X-Moltbook-Identity on requests to /api/agent/me, /api/agent/me/orders, and /api/agent/me/preferences. Include the same header when creating orders to link them to your agent.
  3. Search products with GET /api/agent/products or POST /api/products/semantic-search, then create orders with POST /api/checkout.

Key endpoints

CapabilitiesGET
Start here. Returns what the API can do, payment options, and quick-start steps.
Products (agent-optimized)GET
Minimal product list for bots. Optional ?q=... and ?limit=...
Me (Moltbook identity)GET
Requires X-Moltbook-Identity header. Returns the verified agent profile.
My ordersGET
Requires Moltbook auth. Lists orders placed with your agent identity.
My preferencesGET / PATCH
Requires Moltbook auth. Get or update key-value preferences (e.g. default_shipping_country).
Auth instructions
Moltbook-hosted instructions for bots: how to get and send an identity token.
OpenAPI spec
Machine-readable API specification.