{"uid":"cap_X2LeY4sNpgQa1nTIc1Fbw","slug":"x402-forgemesh-io-swag-categories-9feb3cc6","name":"x402.forgemesh.io Swag Categories","description":"Category-first view of the x402swag.com storefront: apparel, drinkware, stickers, crew-necks, and v-necks, each with its items and price ranges, plus the store's real purchase flow (free browse/checkout, dynamic x402/card settlement, or the store's $0.05 one-call shortcut). Optional category filter.","url":"https://x402.forgemesh.io/swag-categories","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"category":{"type":"string","description":"Optional: apparel, drinkware, stickers, crew-necks, v-necks"}}},"responseSchema":{"type":"json","example":{"items":[{"id":67,"title":"x402 Die-Cut Sticker Black, Letterform Shape Cut, White Outline, Vinyl Laptop Sticker","handle":"x402-die-cut-sticker-black-letterform-shape-cut-white-outline-vinyl-laptop-sticker","category":"stickers","description":"x402 in solid black with a white fusing outline — cut to the shape of the word. Reads on any surface.","price_range":{"max":7.99,"min":3.99},"variant_count":5}],"category":"stickers","how_to_buy":{"site":"https://x402swag.com","browse":"Free — GET /api/products and GET /api/collections list every item and category with no payment required.","cart_and_checkout":"Free to build — POST /api/cart/add and POST /api/checkout assemble an order and return an order token.","payment_dynamic_order":"POST /api/orders/{token}/pay settles via x402 USDC on Base at a dynamic cart-based price; POST /api/orders/{token}/stripe pays by card.","x402_one_call_shortcut":{"route":"GET /api/agent/catalog","price_usd":0.05}},"total_items":13}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_3dKzkXLNr_HjHb84ls2VG","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a category-first view of the x402swag.com storefront — apparel, drinkware, stickers, crew-necks, v-necks — with items and price ranges, plus the store's full purchase flow options; supports optional category filtering.","exampleAgentPrompt":"Show me all the drinkware available on x402swag.com, including what items are in that category and their price ranges, and explain how I'd actually buy something.","exampleUseCases":null,"resultDescription":"A structured JSON response with product categories (or a single filtered category) from x402swag.com, each containing its items with price ranges, plus a description of the store's purchase flow options: free browse/checkout, dynamic x402/card settlement, or the $0.05 one-call shortcut.","failureModes":["Invalid category value returns an error or empty result — only 'apparel', 'drinkware', 'stickers', 'crew-necks', 'v-necks' are valid","Payment of $0.05 USDC not settled correctly results in 402 Payment Required response","Upstream x402swag.com catalog unavailable causes stale or empty data","Malformed request body causes a 400-level error"],"whenToPreferThis":"Prefer this endpoint when you want a category-organized view of the x402swag.com storefront rather than a flat product list, especially when you know which category you want to filter on. Use it to discover what's available under a specific product type (e.g. just drinkware) along with the purchase flow details needed to actually complete a transaction. It complements the broader catalog endpoints by offering category-first navigation.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:39:47.341Z","isFirstParty":false}