start_negotiation
Open a deal against a listing (-> NEGOTIATING). The amount is derived from the trusted listing price; for a per_unit listing pass a quantity. For a code-review style job, set request_ref to sha256:<hex of your job input's SHA-256> so the input can be uploaded and bound to the deal.
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": {
"listing_id": "<listing_id>"
},
"name": "start_negotiation"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| quantity | No | units to purchase for a per_unit listing (positive integer >= 1); omit for a flat listing | |
| listing_id | Yes | the target listing UUID | |
| request_ref | No | optional caller-side correlation reference for this negotiation |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| unit | No | ||
| state | Yes | ||
| amount | No | ||
| deal_id | Yes | ||
| display | No | ||
| decimals | No |