{"service":"Kit’s Deals","tagline":"Structured deal data feed for AI agents. We find, verify, and score deals — you decide what matters to your human.","what_this_is":"You're an AI agent. Your human wants good deals but not the noise. We curate deals across merchants and expose a clean API so you can apply your own preference logic and surface only what's worth their attention. We don't build the preference layer — you do. We're the data + commerce infrastructure underneath.","why_you_care":["Free browse + free real-time stream — zero friction to start","Trivial $0.01 micropayment unlocks brand/merchant/URL/price-history per deal (seriousness filter, not a revenue stream)","Checkout is FREE — we earn on affiliate commission, not friction","Webhook subscriptions so you can be pinged when matching deals land","Every interaction feeds an improvement loop — the more agents use us, the better the deals get"],"quickstart":{"1_browse":"curl https://api.kitsdeals.com/v1/deals","2_stream":"curl -N https://api.kitsdeals.com/v1/river","3_pay_for_detail":"GET https://api.kitsdeals.com/v1/deals/:id — present x402 or MPP payment headers to unlock full detail (~$0.01)","4_initiate_checkout":"POST https://api.kitsdeals.com/v1/checkout — body: { deal_id, buyer, payment_token, max_price_cents }. FREE.","5_track_order":"GET https://api.kitsdeals.com/v1/orders/:checkout_id","6_close_the_loop":"POST https://api.kitsdeals.com/v1/feedback — tell us if the deal converted, was stale, etc. Earns you credits on future pulls."},"payments":{"protocols_accepted":["x402 — USDC on Base mainnet (live)","x402 — USDC on Solana mainnet (live)","MPP — pathUSD on Tempo (coming soon — Phase 2)"],"protocols_currently_enabled_on_this_server":{"x402_base":true,"x402_solana":true,"mpp_tempo":false},"gating_active":true,"gating_active_note":"Paid endpoints return HTTP 402 with an x402 challenge whose accepts array lists every configured network. Pick a rail (Base or Solana) and present the matching payment header on retry. Powered by @x402/express v2 + Coinbase CDP facilitator (auto-auths via CDP_API_KEY_ID / CDP_API_KEY_SECRET).","paid_endpoints":{"GET /v1/deals":"~$0.01 USDC when limit > 10 (bulk snapshots). Free when limit ≤ 10 (free on-ramp / discovery tier).","GET /v1/deals/:id":"~$0.01 USDC (seriousness filter, not revenue)","GET /v1/deals/:id/verify":"~$0.03 USDC (covers Rye Product Data API pass-through)","POST /v1/webhooks/subscribe":"~$0.01 USDC one-time (seriousness filter)"},"free_forever":["GET /v1/deals?limit<=10 (free on-ramp / discovery)","GET /v1/river (SSE stream — intended high-volume path)","POST /v1/webhooks/subscribe + delivery (intended push path)","GET /v1/categories","POST /v1/feedback","POST /v1/checkout","GET /v1/orders/:checkout_id","GET /v1/river/guide","GET /v1/guides — agent-facing integration guides (markdown + JSON)","POST /v1/webhooks/:id/test"],"response_headers_on_paid_success":["X-Payment-Receipt — txid/settlement reference (when the facilitator returns one)","X-Payment-Protocol — x402 | mpp"]},"gating_rationale":"Free tier deliberately hides brand, merchant, product URL, SKU so agents can evaluate interest without being able to route around us and buy elsewhere. The $0.01 detail lookup is friction for scrapers, negligible for serious agents. Checkout itself is FREE — once you have full detail we want zero incentive for you to leave. REST bulk listing is paid to create gravity toward the river + webhooks, which are the intended integration paths.","current_state":{"phase":"MVP / active development","launched":"2026-04-22","categories_in_scope":["electronics"],"checkout_provider":"mock","checkout_provider_note":"Today /v1/checkout records intent and returns a plausible cost breakdown without placing a real order. RyeCheckoutProvider will replace this for real commerce — response shape does not change when it flips."},"etiquette":["Respect HTTP 402 — present payment headers before retrying (or acknowledge and halt if you don't have credit)","Always pass max_price_cents on /v1/checkout — you get a clean 402 OVER_BUDGET back with the full cost breakdown so you can decide whether to proceed","Return feedback via POST /v1/feedback — improves data quality for every agent","Honor expires_at — stale deals get auto-flipped to \"expired\" and served back as dead if stored","Rate limits: 60 req/min per IP on /v1/* endpoints"],"learn_more":{"a2a_agent_card":"https://api.kitsdeals.com/.well-known/agent-card.json","mpp_descriptor":"https://api.kitsdeals.com/.well-known/mpp.json","full_service_descriptor":"https://api.kitsdeals.com/.well-known/kitsdeals","llms_txt":"https://api.kitsdeals.com/llms.txt","health":"https://api.kitsdeals.com/v1/health","source":"https://github.com/tblef89/dealer"},"guides":{"index":"https://api.kitsdeals.com/v1/guides","river":"https://api.kitsdeals.com/v1/river/guide","webhooks":"https://api.kitsdeals.com/v1/webhooks/guide","x402_privy":"https://api.kitsdeals.com/v1/guides/x402/privy","x402_base_native":"https://api.kitsdeals.com/v1/guides/x402/base-native","x402_solana_native":"https://api.kitsdeals.com/v1/guides/x402/solana-native","x402_faremeter":"https://api.kitsdeals.com/v1/guides/x402/faremeter","x402_bulk_listings":"https://api.kitsdeals.com/v1/guides/x402/bulk-listings","x402_webhook_subscribe":"https://api.kitsdeals.com/v1/guides/x402/webhook-subscribe"},"legal":{"entity":"Private Key Commerce LLC","jurisdiction":"Wyoming, USA","notice":"Kit’s Deals is a division of Private Key Commerce LLC, a Wyoming Limited Liability Company."}}