verify_price
Ask whether a price makes sense for its context, rather than what the price should be. Returns a verdict (within_band, too_high, too_low, or unknown), the band it was judged against, a signed deviation from the reference, a confidence, and the evidence behind it. A verdict of "unknown" means the price could not be judged, which is not the same as within_band. Act on next_step: buy (within band on confident, independent evidence), negotiate (too high), walk_away (far too high, confidently) or check_more (unknown, too low, or weak evidence); next_step_reason says why. Pass quote_valid_until from the compute_price result the price came from, and where quote expiry is switched on the answer says quote_expired when that quote is stale. Where paid verdicts are switched on, a caller with no key can pay for one verdict with x402: pass payment, a signed payment for the price and terms listed under payments.x402.verify_price in /.well-known/agents.json; a verdict of unknown is not charged. Where buyers' spend limits are switched on and metadata.category names a category, the evidence includes buyer_budget: what buyers' own spend checks allowed for it (buyer_envelope), reported and never counted in the verdict. price_statement says what the answer is: a third party's estimate whose band is an acceptance range around the reference, not an interval of value.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"proposed_price": "<proposed_price>"
},
"name": "verify_price"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| geo | No | Optional geography hint, e.g. US. | |
| channel | No | Optional. The sales channel, e.g. an agent marketplace. With a rate saved by set_channel_rates, the price covers the channel's cut. | |
| payment | No | Optional. The signed x402 payment, base64, as sent in an X-PAYMENT or PAYMENT-SIGNATURE header; or, where the answer offers MPP tempo, the whole Payment-Authorization value ("Payment " and the credential). Omit it to read what the call costs and how to pay; nothing is charged until you send it. | |
| currency | No | Three-letter ISO currency code, e.g. USD. Defaults to USD. | |
| metadata | No | Optional free-form context. | |
| max_price | No | Optional hard ceiling. Binding: a verdict will never relax it. | |
| min_price | No | Optional hard floor. Binding: a verdict will never relax it. | |
| buyer_type | No | Optional. Who the price is for: an AI agent or a person. Recorded with the quote only. | |
| product_id | No | Optional identifier of what is being priced. | |
| buyer_agent | No | Optional. The buying agent, e.g. chatgpt. A label recorded with the quote only. | |
| product_type | No | Optional category of what is being priced. | |
| current_price | No | Optional incumbent price. Not required: asking whether a price is sensible does not presuppose an existing one. | |
| outcome_terms | No | Optional, for a price charged per outcome: when the outcome counts as failed and what is owed then. The result echoes the terms normalised, with complete false until success_definition, resolve_by and on_timeout are all set. | |
| proposed_price | Yes | The price to judge. This is the subject of the call. | |
| customer_segment | No | Optional segment, e.g. enterprise. | |
| quote_valid_until | No | Optional. The valid_until of the compute_price result this price came from (RFC 3339). Where quote expiry is switched on, a time already past is answered with quote_expired: true. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| band | No | The range the price was judged against; a null bound is open on that side. Term: lp:band.verification. | |
| message | No | A short sentence about the result that an agent can show its person. | |
| verdict | No | unknown means nothing could judge the price, which is not within_band. Term: lp:verdict. | |
| currency | No | ISO 4217 code of proposed_price and the band. | |
| evidence | No | Each source's reference, band and weight. Term: lp:evidence. | |
| next_step | No | What a buyer should do with this price. Term: lp:next-step. | |
| confidence | No | The lowest evidence weight, halved when sources disagree. Term: lp:confidence.verdict. | |
| valid_until | No | RFC 3339; the verdict holds only until then. | |
| deviation_pct | No | Percent from the reference price; positive is above it. Term: lp:deviation. | |
| proposed_price | No | The price that was judged. Term: lp:proposed-price. | |
| price_statement | No | What this answer is: a third party's estimate whose band is an acceptance range around the reference (interval_meaning acceptance_range), not an interval of value. Term: lp:price-statement. | |
| reference_price | No | The price the evidence points at. Term: lp:reference-price. | |
| next_step_reason | No | Why next_step was chosen, in one sentence. | |
| independent_evidence | No | False means the verdict partly reasoned from the price itself. Term: lp:independent-evidence. |