{"uid":"cap_5r1CUZh9P89vHY8B8Xfrt","slug":"agentshare-commerce-quote-product-offer-search-4a9f5852","name":"AgentShare Commerce Quote — Product & Offer Search","description":"AgentShare — agent-paid API access for autonomous agents. Dual-auth (API key or x402 USDC), machine-readable discovery, MCP. Commerce and Solana/Meteora DeFi tools are secondary modules.","url":"https://agentshare.dev/api/v1/agent/commerce/quote","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"type":"object","properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["q"],"properties":{"q":{"type":"string","minLength":1,"description":"Product / offer query."},"mode":{"enum":["search","best_offer"],"type":"string","description":"Quote mode."},"query":{"type":"string","minLength":1,"description":"Alias for q."},"max_price_usd":{"type":"number","description":"Optional budget cap (USD)."}},"additionalProperties":true}}},"output":{"type":"object","properties":{"example":{"listings":[],"schema_version":"agentshare.price.v1"}}}}},"responseSchema":{"type":"json","example":{"listings":[],"schema_version":"agentshare.price.v1"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_7qMDmh0muai48r48qvo1o","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches for product and offer listings matching a query, returning priced results with optional budget filtering and best-offer mode.","exampleAgentPrompt":"Search AgentShare for the best offer on a Solana hardware wallet under $80 — use best_offer mode and show me all matching listings.","exampleUseCases":[{"title":"Budget-capped product price search","prompt":"Find me the best offer for a Ledger Nano X on AgentShare, keeping it under $100 — use best_offer mode so I get the single cheapest option."},{"title":"Open-ended product listing search","prompt":"Search AgentShare for all listings related to 'Solana validator node setup services' and show me everything available with their prices."},{"title":"Comparing offers before purchase","prompt":"I want to compare offers for a Solana DeFi analytics subscription on AgentShare — run a search and list all the results so I can pick the best one."}],"resultDescription":"Returns a JSON object containing a list of product/offer listings matching the query and a schema_version field (agentshare.price.v1). Each listing includes offer details and pricing. The listings array may be empty if no results match.","failureModes":["Empty listings array returned when no offers match the query","Missing required 'q' parameter causes 400 Bad Request","Invalid mode enum value rejected by schema validation","max_price_usd filter excludes all results, returning empty listings","Service unavailable or payment not processed results in 402 or 503 error"],"whenToPreferThis":"Use this endpoint when you need to search for product offers or pricing within the AgentShare marketplace, especially when operating in a Solana or x402 payment context. Prefer this over generic search APIs when you need structured commerce listings with price metadata and want to leverage the best_offer mode for single-result price optimization or budget-cap filtering via max_price_usd.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:38:37.338Z","isFirstParty":false}