{"uid":"cap__f5k-0qAAGqjANia_h10e","slug":"escrow-milestone-payments-a72664d2","name":"Escrow / Milestone Payments","description":"Agent-to-agent escrow with milestone releases.","url":"https://escrow-api-production-014b.up.railway.app/create?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","required":["payee","payer","amount"],"properties":{"payee":{"type":"string"},"payer":{"type":"string"},"amount":{"type":"number"},"milestones":{"type":"array"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_BG2DkrnVahVr7FS2n2Jsp","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Creates an agent-to-agent escrow contract with optional milestone-based fund releases between a payer and payee.","exampleAgentPrompt":"Set up an escrow contract where payer 0xABC123 deposits 500 USDC for payee 0xDEF456, with three milestones: 150 USDC on design approval, 200 USDC on development completion, and 150 USDC on final delivery.","exampleUseCases":[{"title":"Freelance AI agent contracting","prompt":"I'm hiring an AI agent to build me a data pipeline — set up an escrow where I (0xPAYER99) lock 1000 USDC for the agent at 0xAGENT42, releasing 400 USDC after the schema is approved, 400 after the pipeline runs successfully, and 200 on final handoff."},{"title":"Agent-to-agent task delegation","prompt":"My orchestrator agent at 0xORCH01 needs to pay a sub-agent at 0xSUB77 a total of 250 USDC for a research task — can you create an escrow that holds the funds and releases them when the sub-agent marks the task complete?"},{"title":"Staged creative project payment","prompt":"Set up a milestone escrow between payer 0xCLIENT5 and payee 0xCREATOR8 for 800 USDC total — split it into two releases: 400 USDC on draft approval and 400 USDC on final delivery."}],"resultDescription":"Returns an escrow contract record including a contract ID, the locked amount, the payer and payee addresses, and the defined milestone schedule with release conditions and statuses.","failureModes":["Missing required fields (payee, payer, or amount) returns a 400 validation error","Invalid address format for payee or payer causes contract creation failure","Amount set to zero or negative value rejected by validation","Malformed milestones array (e.g. milestone amounts exceeding total) may cause rejection","Service unavailability on Railway infrastructure returns 5xx error","Duplicate contract creation not prevented — callers must manage idempotency externally"],"whenToPreferThis":"Choose this endpoint when you need to lock funds between two known parties (agents or humans) with conditional or staged release logic, especially in agent-to-agent commerce contexts where trustless payment holding is required. Prefer this over direct transfers when milestones or deliverable-gating are needed, or when neither party fully trusts the other to fulfill obligations upfront.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-20T06:31:48.317Z","isFirstParty":false,"canonicalSlug":"escrow-milestone-payments-a72664d2"}