# Crush Pricing Intelligence API

Real-time competitive pricing data across US and Canadian e-commerce retailers (Amazon, Walmart, Best Buy, Target, etc.). Serves price comparisons, deal alerts, brand tracking, promotional intelligence, and market analytics to AI agents via x402 and MPP micropayments.

## What You Get

Real-time and historical pricing data scraped from major North American retailers. Every query returns structured data at the SKU level: product name, price, retailer, category, availability, ratings, review counts, and timestamps. No API keys — payment is the auth.

## Tools & Pricing

### Shopper — $0.01/query

| Tool | Description |
|------|-------------|
| best_price | Compare live prices for a product across Amazon, Walmart, Costco & more in the US and Canada |
| price_history | Daily price history for any SKU — spot trends, seasonal lows, and the right time to buy |
| deal_finder | Surface today's best deals in a product category across major North American retailers |
| price_drop_alert | Detect price drops across retailers in the last N days — catch markdowns as they happen |

### Marketing — $0.01/query

| Tool | Description |
|------|-------------|
| competitive_landscape | Map who's cheapest, priciest, and most aggressive in a category across US & Canadian retailers |
| brand_tracker | Track how a brand is priced and positioned vs competitors across Amazon, Walmart, and more |
| promo_intelligence | See which retailers are running promos, what's discounted, and how deep the cuts are |
| share_of_shelf | Measure a brand's share of listings in a category — across retailers and regions |
| price_positioning | See where a brand sits in the price ladder vs every competitor in the category |

### Analyst — $0.02/query

| Tool | Description |
|------|-------------|
| inflation_tracker | Track real price inflation in any product category across US & Canadian e-commerce |
| price_dispersion | Measure how much the same products vary in price across Amazon, Walmart, Costco & others |
| retailer_index | Benchmark a retailer's pricing against the market — above or below average |
| category_summary | Full category snapshot: price ranges, top brands, retailer coverage, and competitive dynamics |

All tools accept optional `country` (us/ca), `retailer` (amazon, walmart, costco...), and `days` parameters.

## Payment Networks

| Network | Token | Wallet Type |
|---------|-------|-------------|
| Solana | USDC | Solana (base58) |
| Base | USDC | EVM (0x...) |
| Tempo | USDC.e | EVM (0x...) |

The client tries Solana first (lowest fees), then Base, then Tempo. Even $1 gets you 50–200 queries.

## Direct API Access

https://api.crushrewards.dev/openapi.json

Accepts x402 (USDC on Base/Solana) and MPP (USDC.e on Tempo).

## Links

- npm: https://www.npmjs.com/package/@crush-rewards/mcp-server
- GitHub: https://github.com/Crush-Rewards/crush-mcp-server
- Setup Guide: /skill.md
- App: https://crushrewards.app