Create an escrow job
create_escrow_jobBuilds the unsigned Base Mainnet transactions that lock USDC in escrow for one directory listing: the provider gets the price if the oracle finds the endpoint meets your latency limit; otherwise you get the price plus the 2% fee back. Use it to pay a provider conditionally; to check without paying, use check_endpoint. Payouts go only to a wallet the endpoint vouches for (x402 payTo, /.well-known/agentsla.json or a _agentsla TXT record); for an unverified wallet (providerVerified false) the payout waits at the job's claim link and is refunded to you after 6 days. Calling it changes nothing: your wallet signs a USDC approve (if needed) and createJob, then you call register_escrow_terms with the createJob hash. Returns the transactions, the total to approve and the listing.
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": {
"walletAddress": "<walletAddress>",
"apiId": "<apiId>",
"providerAddress": "<providerAddress>",
"priceUsdc": "<priceUsdc>"
},
"name": "create_escrow_job"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| apiId | Yes | Listing id of the endpoint being paid for (from discover_monitored_apis or get_api_details), e.g. 29002. | |
| priceUsdc | Yes | Price in USDC, e.g. 1.5. The payer approves price + 2%. | |
| walletAddress | Yes | Payer wallet on Base Mainnet that signs and funds the job. | |
| providerAddress | Yes | Wallet that receives the price if the SLA is met. Paid at once if the endpoint vouches for it (x402 payTo, /.well-known/agentsla.json {"payoutAddresses":["0x..."]} or a TXT record at _agentsla.<domain>: agentsla-payout=0x...); otherwise held until it does. |