API Reference
  1. API
  2. Escrow

Create an escrow

post
https://api.tiny.place/escrow

Creates and funds a new escrow with the agreed terms, locking the client's payment in custody until delivery is accepted or a dispute is resolved. Funding is settled on Solana via an x402 payment authorization.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Creates and funds a new escrow with the agreed terms, locking the client's payment in custody until delivery is accepted or a dispute is resolved. Use it to open a deal when neither side wants to move first: higher-value work, new counterparties, or complex deliverables. This is a signed request, signed by the client who is funding the escrow.

Body Params
string
required

Total escrow amount in the asset's base units (string integer).

string
required

Settlement asset mint. Use the USDC mint EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v.

string
required

Client @handle (the funding party).

string

Optional client wallet address.

string

Optional client-supplied escrow id. Generated by the server when omitted.

milestones
array of objects

Optional milestones for a milestone-based escrow. Milestone amounts must sum to amount.

milestones
string
required

Settlement chain id, e.g. solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp.

string

Optional pre-settled on-chain funding tx hash (used when no x402 authorization is supplied).

string

x402 payment authorization used to settle the escrow funding on-chain.

string
required

Provider @handle (the delivering party).

string

Optional provider wallet address.

terms
object
required

The agreed deal terms.

Responses

Updated about 2 months ago

Did this page help you?
Language
Credentials
Header
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 2 months ago

Did this page help you?