For AI Agents

The definitive agentic commerce API. Multi-chain payments, autonomous checkout via x402, and a curated catalog — all without an API key.

You can use either this site's API (https://forthecult.store/api) or the agent subdomain (https://ai.forthecult.store/api); same endpoints.

Quick Start

  1. Call GET /api/agent/capabilities to see endpoints, payment options, and limits.
  2. Use POST /api/agent/shop with natural language — get AI-curated product recommendations.
  3. Create orders with POST /api/checkout. For autonomous payments, use x402 protocol with USDC on Solana or Base.
  4. Optionally: include X-Moltbook-Identity header to link orders to your agent profile via Moltbook.

Key Endpoints

CapabilitiesGET
Start here. Returns what the API can do, payment options, and quick-start steps.
Shop (AI assistant)POST
Natural language shopping. Send a message, get AI reply + structured products.
Products (agent-optimized)GET
Minimal product list for bots. Optional ?q=... and ?limit=...
CheckoutPOST
Create an order with card or crypto. Supports x402 autonomous payment.
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.

SHOP API

For agents that prefer code over conversation. One endpoint, natural language in, structured products out.

POSThttps://forthecult.store/api/agent/shop
REQUEST
{
  "message": "wireless noise-canceling headphones under $200",
  "context": {
    "priceRange": { "max": 200 },
    "preferences": ["good battery life", "comfortable"]
  }
}
RESPONSE
{
  "reply": "I found some great wireless noise-canceling headphones under $200...",
  "products": [
    {
      "id": "prod_sony_wh1000xm4",
      "title": "Sony WH-1000XM4 Wireless Headphones",
      "price": 198.00,
      "currency": "USD",
      "rating": 4.7,
      "reviewCount": 42531,
      "imageUrl": "https://...",
      "source": "store",
      "inStock": true,
      "badge": "bestseller"
    }
  ]
}

What Agents Can Build

From gift-finding to home automation — our API powers autonomous commerce for any use case.

Gift Agents
"Find a birthday gift for a 30-year-old who loves hiking" → curated options, ready to ship.
Home Automation
Smart home agents that reorder supplies when inventory runs low or trigger purchases based on events.
Personal Stylists
Fashion agents that source outfits based on style preferences, events, and weather.
Research Agents
Compare products, aggregate reviews, and surface the best options for any category.
Autonomous Assistants
AI assistants that handle shopping end-to-end — from discovery to payment to delivery tracking.
Wellness Concierge
Health-focused agents that curate supplements, longevity products, and wellness essentials.