Vol. 01 · No. 01 May 23, 2026

PRICE·PILOT

Your agent's shopping receipt — the cheapest price, verified

  ┌─────────────────────────────┐
  │  ASK · RESOLVE · VERIFY · PAY │
  └─────────────────────────────┘

Pay-per-call price agent — just a nickel to never overpay $0.05 / check

Product summary [at a glance]

Hermes agent plugin

Cheapest-product checks for agent commerce.

PricePilot is the paid shopping tool Hermes calls when a shopper asks for the best buy. It turns one structured request into a verified retailer result with a buy link and receipt JSON.

Telegram-ready Amazon + Walmart live Shoes + general products x402 / MPP
Telegram shopper asks
Hermes reasons + structures
PricePilot verifies market
Receipt best offer + proof
Under the hood — PricePilot resolves in parallel
PricePilot
Amazon live
Walmart live
Verified cheapest
Buyer input Brand, model, category, color, condition, and optional size.
Retail coverage Amazon and Walmart live; Target, eBay, and Facebook queued.
Agent output Best offer, all offers, missing sources, product_id, and observation IDs.
Built with
Nimble
ClickHouse
Senso

Paid service endpoint [powered by x402 / MPP]

Live now — checking Amazon & Walmart every request
POST /find_cheapest $0.05

Pass an explicit product spec — brand, model, variant attributes (color, size, storage). PricePilot returns the cheapest verified buyable offer plus a stable product_id your agent can reuse.

Amazon — live Walmart — live Target — next eBay — next Facebook — next

Things your agent can ask [4]

Hermes turns each ask into a structured call. Shoes can include size; generic products do not need one.
  • ? Cheapest Nike Killshot 2 Sail/Lucid Green men's size 11.5
  • ? Cheapest Sony WH-1000XM5 headphones in black
  • ? Cheapest Hoka Clifton 9 women's size 8
  • ? Cheapest LEGO 10497 Galaxy Explorer set

Tools under the hood [verify, store, report]

After PricePilot is paid, four things happen before Hermes hears back: Nimble pulls live SERP + PDP variant data, Verify rejects near-miss variants, ClickHouse logs the observation, and Senso writes a cited report. The receipt that lands in Telegram is the cheapest verified buyable offer plus the IDs to look it up later.

Verify, store, and report
Nimble SERP + PDP variant data
Verify + Rank reject near-miss variants
ClickHouse price_events memory
Senso cited reports + history
Back to Hermes: best offer, all offers, missing sources, product_id, and observation IDs flow back to Telegram as the receipt.
psst—Every price you get was checked just for you. No stale SERP guesses. Just the real buyable price, fresh off the shelf.

How Hermes uses it [agent flow]

Here's the step-by-step from a shopper's first text to the final verified receipt.

01
User texts Hermes in Telegram
"Find the cheapest Sony WH-1000XM5 in black" or "Nike Killshot 2 men's size 11.5."
02
Hermes structures the request
Brand, model, category, color, optional size, condition, and source scope become one tool call.
03
PricePilot verifies the market
Amazon and Walmart are resolved live today. Target, eBay, and Facebook Marketplace are queued as the next retailer connectors.
04
Hermes completes the job
The cheapest verified offer comes back with seller, stock, URL, observation IDs, and missing-source reasons.

What happens on a call [4 steps]

Why this matters: Most price APIs return stale SERP estimates. PricePilot walks the full product tree to find the actual buyable offer — the one your agent can send someone to purchase.
  • 01. You send a product spec. Brand, model, variant fields. No URLs to guess, no SKUs to look up.
  • 02. We resolve the exact variant on Amazon and Walmart. SERP → parent PDP → child PDP on each, in parallel, so the offers match your spec — not a near-miss.
  • 03. We pull the live offer. Real price, real stock, real seller from the PDP at request time. Not a cached SERP estimate.
  • 04. You get one JSON response. The cheapest verified offer plus a stable product_id.

Live retailer comparison [Nike Killshot 2 — verified offers]

This is what your buyer sees — not abstract JSON, but real retailer cards with live prices, stock status, and the winner highlighted.

Checked 2026-05-23
Nike Killshot 2 Sail / Lucid Green
Nike Killshot 2 — Sail/Lucid Green
Men's · US 11.5
In stock
$94.99
View on Amazon
★ CHEAPEST
Nike Killshot 2 Sail / Lucid Green
Nike Killshot 2 — Sail/Lucid Green
Men's · US 11.5
In stock
$89.97
View on Walmart
$94.99 $89.97 You save $5.02 by going with Walmart

Powered by PricePilot · Checked 2026-05-23 15:42 UTC

Sample receipt [POST /find_cheapest]

— Request —

POST /find_cheapest
{
  "brand": "Nike",
  "model": "Killshot 2",
  "color": "Sail/Lucid Green",
  "size": { "system": "US", "gender": "men", "value": 11.5 },
  "condition": "new",
  "postal_code": "10001"
}

— Response —

PRODUCT Nike Killshot 2
VARIANT Sail/Lucid · M 11.5
AMAZON $94.99
WALMART $89.97 ★
STOCK In stock
CHEAPEST $89.97
YOU SAVED: $119.00 → $29.03
Verified · 2026-05-23
★★★★★ real price

— Raw JSON —

{
  "product_id": "nike-killshot-2",
  "best": {
    "source": "walmart",
    "price": 89.97,
    "currency": "USD",
    "in_stock": true,
    "seller": "Walmart",
    "url": "https://www.walmart.com/ip/XXXXXXXX",
    "variant": { "color": "Sail/Lucid Green", "size": "11.5" }
  },
  "all_offers": [
    { "source": "walmart", "price": 89.97, "in_stock": true },
    { "source": "amazon",  "price": 94.99, "in_stock": true }
  ],
  "missing_sources": ["target"],
  "checked_at": "2026-05-23T15:42:11Z"
}

Make your first call [3 steps]

  • 01. Pick a wallet your agent can pay from. AgentCash is fastest — ships USDC and signs payments. Or use Base / Tempo directly.
  • 02. POST a product spec to /find_cheapest. First request gets a 402 with the price ($0.05). Re-send with the payment header to receive the offer.
  • 03. Read the cheapest offer. The best field is the verified buyable result. Hand it to your shopper, log it, or check again tomorrow.
$ curl -X POST https://pricepilot-sepia.vercel.app/find_cheapest \
    -H "Content-Type: application/json" \
    -d '{"brand":"Nike","model":"Killshot 2",
        "size":{"system":"US","gender":"men","value":11.5}}'

How to pay [3 options]

Onboard once — wallet, USDC, payment signing all handled. Then try a real paid call.

$ npx agentcash onboard
$ npx agentcash try https://pricepilot-sepia.vercel.app/find_cheapest

Wrap fetch with x402-fetch. Any Base wallet your agent can sign with works.

import { withPaymentInterceptor } from 'x402-fetch'
const fetchWithPay = withPaymentInterceptor(fetch, account)
await fetchWithPay('https://pricepilot-sepia.vercel.app/find_cheapest', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify(spec),
})

Configure mppx with a Tempo wallet — Privy server wallets work fine.

import { Mppx, tempo } from 'mppx/client'
Mppx.create({ methods: [tempo({ account: tempoWallet })] })
await fetch('https://pricepilot-sepia.vercel.app/find_cheapest', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify(spec),
})

Resources

"Best price. Real stock. No guessing."
— your agent, probably