{"uid":"cap_9ea7OlRU2tf0wUT9Uwfc4","slug":"api-crushrewards-dev-e139c1da","name":"CrushRewards Price Dispersion Analyzer","description":"Real-time pricing, promotions, and competitive intelligence across US and Canadian retailers — exposed as paid API endpoints and MCP tools that AI agents can call directly, with x402 and MPP micropayments per query.","url":"https://api.crushrewards.dev/v1/analyst/price-dispersion","method":"GET","headers":{},"bodySchema":null,"responseSchema":{"type":"json"},"example":{"request":{"country":"us","category":"electronics","retailer":"amazon"},"response":{"meta":{"computed_at":"2026-06-16T01:26:53.877Z","served_from":"live","schema_version":"v3","freshness_seconds":69089},"country":"us","std_dev":83.36,"category":"electronics","currency":"USD","excluded":{"below_floor":0,"price_outliers":30,"accessory_or_parts":5,"refurbished_or_used":28},"resolved":{"alternates":[],"category_id":null,"match_source":"slug","category_path":"electronics","match_confidence":1},"avg_price":87.1,"max_price":409,"min_price":5.99,"department":null,"percentiles":{"p10":19.7,"p25":28.24,"p50":49.99,"p75":119.45,"p90":199.99},"product_count":179,"outliers_excluded":30,"coeff_of_variation":0.957,"representative_floor":5}},"exampleRequest":{"country":"us","category":"electronics","retailer":"amazon"},"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_nTkqTZYaIKLKrI64L_Tip","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Analyzes price spread within a product category, returning mean, standard deviation, coefficient of variation, and p10–p90 percentiles with IQR-based outlier exclusion.","exampleAgentPrompt":"Can you pull the price dispersion stats for the electronics category on Amazon in the US — I want to see mean, standard deviation, and the p10 through p90 percentiles?","exampleUseCases":[{"title":"Compare pricing strategies across competitors","prompt":"I need to understand how much prices vary within the office supplies category across all Canadian retailers. Can you get me the standard deviation and percentile breakdown — specifically p25 and p75 — so I can see where most competitors are pricing?"},{"title":"Identify high-volatility product categories","prompt":"Which grocery product categories have the most price spread right now? Pull the coefficient of variation for the top 5 grocery subcategories so I can flag which ones are most volatile for our pricing team."},{"title":"Detect pricing anomalies and outliers","prompt":"Can you analyze the home appliances category in the US and show me how many products got flagged as outliers? I want to see the mean price and IQR details so we can decide if those outliers are legit or data errors."}],"resultDescription":"Returns a JSON object containing the product category, country, currency, product count, number of outliers excluded via IQR, average price, min/max prices, standard deviation, coefficient of variation, and a full set of percentile breakpoints (p10, p25, p50, p75, p90).","failureModes":["Missing required 'category' parameter returns a validation error","Unknown or unsupported category string may return empty/null statistical fields with zero product count","Unsupported retailer enum value returns a 400 or validation error","No products found for the specified category/retailer/country combination results in null stats fields","Network or upstream data source unavailability may return 5xx errors"],"whenToPreferThis":"Use this endpoint when you need statistical distribution metrics for prices within a product category — specifically when you need percentiles, standard deviation, or coefficient of variation rather than just a simple average. Prefer this over the category overview endpoint when the goal is to understand price spread and variability, not just central tendency. Ideal for competitive pricing analysis, identifying price clustering, or flagging categories with high price volatility.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:40:09.609Z","isFirstParty":false}