file_agent_want
File what you want to buy from an agent-facing API and cannot buy today. Optional kind is typically one of coin, country, vies_country, monitor_host, sms_service — free-form values possible. The $0.01 fee is there to keep intents honest, not to sell you anything: it is not a purchase of the capability and no promise that it gets built. Optionally add the price per call you would pay and your expected monthly volume. Free alternative: POST /agent/request.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | No | Optional coverage kind, typically one of 'coin', 'country', 'vies_country', 'monitor_host', 'sms_service' — free-form values possible. Sending it makes your intent countable in the aggregate | |
| want | Yes | What you want to buy and cannot buy today, in your own words | |
| value | No | Optional coverage value, e.g. 'PT'. Same character rules as request_capability | |
| max_price_usd | No | Optional: USD per call you would actually pay. Budget-backed intents outrank anonymous wishes | |
| expected_calls_per_month | No | Optional: calls per month you expect to make |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | Yes | Verbatim boundary of this endpoint: the fee keeps intents honest, it is not a purchase of the capability and no promise that it gets built; your intent is counted aggregated and anonymised in x402_demand_report, and your wallet and text are never resold. | |
| query | Yes | The validated input echoed back, so the record can never contradict what you sent. | |
| recorded | Yes | Always true on a 200: the intent is stored. A failure to store is a 503 and is not charged. | |
| intent_id | Yes | Opaque reference for this intent, e.g. 'want_a1b2c3d4e5f6'. Quote it if you follow up; it is random rather than sequential, and there is no lookup endpoint. | |
| checked_at | Yes | When we produced this answer (ISO 8601, UTC). The only ISO timestamp in the payload; every other timestamp is unix seconds. |