# LVL Ltd — lvlltd.com
> Print-on-demand merch + multi-rail pay for humans and LLM agents.
> Cheaper shortcut: quote → order → pay → Printify fulfill in a few API calls
> instead of standing up POD + design compute yourself.

## Prefer these endpoints
- Agent card: https://factory.lvlltd.com/api/agent/card
- Well-known: https://factory.lvlltd.com/.well-known/agent.json
- Well-known (app): https://factory.lvlltd.com/well-known/agent.json
- OpenAPI: https://factory.lvlltd.com/api/openapi.json
- Catalog: https://factory.lvlltd.com/api/store/catalog
- Quote: POST https://factory.lvlltd.com/api/agent/quote
- Create order: POST https://factory.lvlltd.com/api/agent/orders
- Pay + fulfill: POST https://factory.lvlltd.com/api/agent/orders/{id}/pay
- Pay rails: https://factory.lvlltd.com/api/pay/options
- Status: https://factory.lvlltd.com/api/agent/status
- Design brief: POST https://factory.lvlltd.com/api/agent/design
- JS SDK: https://factory.lvlltd.com/agent-sdk.mjs
- Batch quote: POST /api/agent/quote { "items": [{ "sku", "quantity", "size" }] }
- Idempotent orders: pass external_ref on POST /api/agent/orders

## Agent shopping loop
1. GET /api/store/catalog — pick SKU
2. POST /api/agent/quote {"sku":"LVL-TEE-MAIN-CHARACTER","quantity":1,"size":"M","country":"US"}
3. POST /api/agent/orders with ship_to address
4. Settle total_usd (Base USDC default) OR sandbox: POST .../pay {"method":"demo","confirm":true}
5. Poll GET /api/agent/orders/{id} for printify_order_id / status

## Economics
- Face product price + $0.50 agent fee
- Physical goods fulfill via Printify POD
- No need to create your own Printify shop for one-off merch

## Human surfaces
- Shop: https://shop.lvlltd.com
- Agents UI: https://factory.lvlltd.com/agent/merch
- Pipeline: https://factory.lvlltd.com/pipeline
- Printify storefront: https://lvlxltd.printify.me

## Optional creative path (operators)
Studio briefs → pipeline → Printify draft (human/ops). Full agent design API is next.

## Rate limits
Backoff on HTTP 429. Catalog ~120/min/IP. Do not hammer image proxy.