{"title":"Suplementor x402 Discovery","version":"1.0.0","x402Version":2,"payTo":null,"payToMode":"dynamic-per-request","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","credits":{"note":"Wallets with read-credits settle $0 for reads — a credited call returns no PAYMENT-RESPONSE header. Read-credits are earned on accepted submissions; the 402 challenge is anonymous, so check your balance at the usage endpoint.","usageEndpoint":"/api/v1/x402/usage"},"routes":[{"id":"search-products","method":"GET","path":"/api/v1/x402/products","resource":"/api/v1/x402/products","accepts":[{"scheme":"exact","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount":"5000","maxTimeoutSeconds":300,"extra":{"assetTransferMethod":"eip3009"}}],"bazaar":{"info":{"input":{"type":"http","method":"GET","queryParams":{"q":"vitamin","page":1,"limit":20,"showOffMarket":false}},"inputSchema":{"type":"object","properties":{"q":{"type":"string","description":"Free-text product search query."},"page":{"type":"integer","minimum":1,"description":"Page number (1-based)."},"limit":{"type":"integer","minimum":1,"maximum":100,"description":"Page size (max 100)."},"showOffMarket":{"type":"boolean","description":"Include off-market products when true."}},"required":["q"]},"output":{"type":"json","example":{"data":[{"id":123,"name":"Vitamin C 1000","brand_name":"Example Labs"}],"page":1,"limit":20,"total":1,"totalPages":1}},"routeTemplate":"/api/v1/x402/products"}}},{"id":"product-detail","method":"GET","path":"/api/v1/x402/products/:id","resource":"/api/v1/x402/products/{id}","accepts":[{"scheme":"exact","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount":"10000","maxTimeoutSeconds":300,"extra":{"assetTransferMethod":"eip3009"}}],"bazaar":{"info":{"input":{"type":"http","method":"GET","pathParams":{"id":"123"}},"inputSchema":{"type":"object","properties":{"id":{"type":"string","description":"Product ID in the Suplementor catalog."}},"required":["id"]},"output":{"type":"json","example":{"data":{"id":123,"name":"Vitamin D3 1000 IU","brand_name":"Example Labs","ingredients":[{"raw_name":"Vitamin D3","quantity":25,"unit":"mcg","raw_quantity":1000,"raw_unit":"IU"}]}}},"routeTemplate":"/api/v1/x402/products/:id"}}},{"id":"submission","method":"POST","path":"/api/v1/x402/submissions","resource":"/api/v1/x402/submissions","accepts":[{"scheme":"exact","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount":"10000","maxTimeoutSeconds":300,"extra":{"assetTransferMethod":"eip3009"}}],"bazaar":{"info":{"input":{"type":"http","method":"POST","body":{"name":"Vitamin C 1000","official_product_url":"https://example.com/products/vitamin-c-1000","brand_name":"Example Labs","ingredients":[{"raw_name":"Vitamin C","raw_quantity":1000,"raw_unit":"mg"}]}},"inputSchema":{"type":"object","description":"The submitting wallet is the x402 payer (from the X-PAYMENT authorization), so no wallet_address/signature fields are required in the body.","properties":{"name":{"type":"string","description":"Product name."},"official_product_url":{"type":"string","description":"Official product page URL."},"brand_name":{"type":"string","description":"Brand name (optional)."},"ingredients":{"type":"array","minItems":1,"description":"Required ingredient list as seen on label.","items":{"type":"object","properties":{"raw_name":{"type":"string"},"raw_quantity":{"type":"number","exclusiveMinimum":0},"raw_unit":{"type":"string","enum":["mcg","mg","g","kg","ml","l","IU"]},"substance_id":{"type":["integer","null"]},"order":{"type":"integer","minimum":0}},"required":["raw_name","raw_quantity","raw_unit"]}}},"required":["name","official_product_url","ingredients"]},"output":{"type":"json","example":{"data":{"id":321,"name":"Vitamin C 1000","approval_status":"pending","submitted_by_wallet_address":"0xabc123..."}}},"routeTemplate":"/api/v1/x402/submissions"}}},{"id":"usage-summary","method":"POST","path":"/api/v1/x402/usage","resource":"/api/v1/x402/usage","accepts":[],"bazaar":{"info":{"input":{"type":"http","method":"POST","body":{"wallet_address":"0xabc123...","signature":"0xsignature...","nonce_timestamp":"2026-06-17T20:06:02.844Z"}},"inputSchema":{"type":"object","properties":{"wallet_address":{"type":"string","description":"Agent EVM wallet address to inspect."},"signature":{"type":"string","description":"EIP-191 signature over canonical usage payload (wallet + nonce timestamp)."},"nonce_timestamp":{"type":"string","description":"ISO timestamp signed with payload (anti-replay)."}},"required":["wallet_address","signature","nonce_timestamp"]},"output":{"type":"json","example":{"data":{"wallet_address":"0xabc123...","searches_count":42,"products_fetched_count":18,"outstanding_credits":0,"submitted_products":[{"id":321,"name":"Vitamin C 1000","status":"pending","official_product_url":"https://example.com/products/vitamin-c-1000","approved_product_id":null,"created_at":"2026-01-01T00:00:00.000Z"}]}}},"routeTemplate":"/api/v1/x402/usage"}}}],"links":{"openapi":"/api/v1/openapi.json","llms":"/llms.txt","wellKnown":"/.well-known/x402.json"}}