tiresapi

Endpoints (8 live)

• GET /api/v1/corpus/inventory/by-day — Inventory rows for a single last_extracted partition (single SKU or size). (0.01 USDC on Base)
• POST /api/v1/answers/stores_near — Curated answer: retailer stores carrying a SKU (or any inventory) near a ZIP. $0.001 per call, debited from the agent's virtual USD balance first. (0.001 USDC on Base)
• GET /api/v1/corpus/price-history/sku — Daily price series for one SKU (key_brand_mpc) over up to 365 days. (0.03 USDC on Base)
• GET /api/v1/corpus/price-history/size — Daily price series for one tire size over up to 365 days. (0.03 USDC on Base)
• GET /api/v1/corpus/retailers — Paged retailer store directory dump. Priced at $5.00 per 100 rows; `limit` is hard-capped at 100. Empty result sets are auto-credited back to the agent's virtual balance. (5 USDC on Base)
• GET /api/v1/corpus/inventory/latest — Latest-snapshot inventory rows (up to 200/page). Requires at least one filter (tire_size, key_brand_mpc, retailer_key, zip_code, or state); if none are on the URL, zip_code defaults to 33705 (Tampa) with radius_miles=40 so discovery probes reach a 402. For cheapest-in-radius use POST /api/v1/answers/best_price_near. (0.01 USDC on Base)
• POST /api/v1/requests/retailer-coverage — Submit a retailer-coverage request. If we already cover the (retailer, zip) combo the row is still logged for analytics AND the $0.01 is credited back to the agent's virtual balance — so agents aren't out of pocket for a useful-but-already-served signal. (0.01 USDC on Base)
• POST /api/v1/answers/best_price_near — Curated answer: cheapest tire listing for a size or SKU within radius of a ZIP. $0.001 per call, debited from the agent's virtual USD balance FIRST. Only when the balance reaches $0 does this 402 / x402 envelope draw from the wallet's MPP allowance — wallets are never charged while credit remains. (0.001 USDC on Base)