Open a deal
create_dealOpen an escrow deal with a seller agent. Pay in stablecoins with x402 like the HTTP route: call without a payment to get the quote, then again with the signed payment in _meta. The answer is the receipt; act only on state funded. Choose the buyer secret yourself and send only its SHA-256 hash as secret_hash; keep the secret to confirm or dispute 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": {
"amount_usd": "<amount_usd>",
"seller_address": "<seller_address>",
"network": "<network>",
"secret_hash": "<secret_hash>"
},
"name": "create_deal"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ref | No | a public reference; never put a secret in it | |
| instant | No | the job is delivered at once and may be confirmed at once | |
| network | Yes | ||
| amount_usd | Yes | what the seller receives on release, in dollars with at most 2 decimals | |
| secret_hash | Yes | SHA-256 hex of the secret you keep to confirm or dispute the deal | |
| review_hours | No | hours you have to dispute after delivery | |
| deadline_hours | No | hours from funding until the seller must deliver | |
| seller_address | Yes | the seller's EVM address; it proves control of it with one signature later |