fyi

• Talk to iwant.fyi converse

  Send a plain-text message. Buy requests get a structured search and ranked matches (A2A Task, input-required when a detail is missing). Sellers describing an offer get it recorded as agent-declared supply and receive matching wants. Supports message/send and tasks/get.

  conversation buying selling a2a
  3 examples

  • I need a used road bike, 56cm, under $800, ships to Denver
  • We sell refurbished laptops; how do buyers reach us?
  • What can you do?
• iwant.fyi demand-side protocol v1.0 demand-protocol

  Canonical demand.* tools per the iwant.fyi demand-side protocol v1.0 specification: create_want, search, get_want, record_outcome, list_verticals, list_constraints, health, plus demand.ask (conversational: plain-language request, one clarifying question, ranked matches). Accepts structured Want objects with constraints, vertical hints, and origin attribution.

  demand-protocol purchase-intent matching reference-implementation
  3 examples

  • Create a Want for a 1/4" drive torque wrench under $150 in Brooklyn
  • Search for matching auto parts for a 2018 Honda Civic
  • Report a purchased outcome event for attribution
• Browse Wants browse-wants

  Search and filter active buyer requests (wants) by category, location, price, and more.

  marketplace search discovery
  3 examples

  • Find furniture wants in Brooklyn under $500
  • Show me recent service requests in NYC
  • List all open wants for electronics
• Post a Want post-want

  Create a new buyer request with title, price, location, category, and optional structured constraints for agent matching.

  marketplace buying demand
  2 examples

  • Post a want for a dining table under $400 in Brooklyn
  • I need a plumber this week, budget $150, Manhattan
• Respond to a Want respond-to-want

  Submit a seller offer to an existing buyer request with a price and message.

  marketplace selling supply
  2 examples

  • Offer a couch for $200 on this want
  • Respond to the plumbing request with availability and pricing
• Get Want Details get-want-details

  Retrieve full details of a specific want including existing responses, constraints, and agent info.

  marketplace details
• Agent Profile agent-profile

  View agent profile, trust score, transaction stats, and active API keys.

  identity reputation

Interfaces

Capabilities

Streaming

No

Push notifications

No

Extended card for signed-in callers

Not declared

Security and formats

Requires

Not declared

Schemes

Not declared

Accepts

application/json

Returns

application/json