You are using the latest version. You can still access the
deprecated one
Ctrlk
BlocksBackOfficeDiscordWebsite
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Introduction

How to get started in Trustless Work API REST

What is the Trustless Work API?

The Trustless Work REST API lets you create and manage decentralized escrow contracts on Stellar using Soroban smart contracts.

Use it to deploy escrows, fund them, track milestones, and release funds.

Base URLs

Base URL (Mainnet)
https://api.trustlesswork.com

Core capabilities

  • Deploy escrows with roles, milestones, and conditions.

  • Fund escrows using Stellar assets (example: USDC).

  • Approve / update milestones to drive releases.

  • Dispute and resolution flows (escrow-level or milestone-level).

  • Release funds only when conditions are met.

  • Query status for escrows, milestones, and balances.

Escrow types

  1. Single-release escrow

    • One release action for the full amount.

  2. Multi-release escrow

    • Multiple milestone payouts.

    • Each milestone can be approved, disputed, and released independently.

Rate limits

Limit: 50 requests per 60 seconds per client.

Transactions, signing, and permissions

Most write endpoints return unsigned XDR. You must sign client-side with the correct role wallet.

Actions are role-gated (approve, dispute, resolve, release).

Endpoint map (high level)

Use Swagger for the full spec. These groups cover most integrations:

Deployment

  • POST /escrow/single-release/v2/deploy

  • POST /escrow/multi-release/v2/deploy

Funding

  • POST /escrow/single-release/v2/fund

  • POST /escrow/multi-release/v2/fund

Milestones

  • POST /escrow/{type}/{version}/approve-milestones

  • POST /escrow/{type}/{version}/change-milestone-status

  • POST /escrow/{type}/v2/manage-milestones (v2 only)

Release

  • POST /escrow/single-release/{version}/release-funds

  • POST /escrow/multi-release/v2/release-funds (batch indexes[])

Disputes

  • POST /escrow/{type}/{version}/dispute

  • POST /escrow/{type}/{version}/resolve-dispute

Updates & TTL

  • PUT /escrow/{type}/{version}/update

  • POST /escrow/{type}/{version}/extend-ttl

  • POST /escrow/{type}/v2/withdraw-remaining-funds

Query

  • GET /escrow/{type}/{version}/:contractId

  • GET /escrow/{type}/{version}/escrow-balances

Stellar / Transaction

  • POST /stellar/send-transaction

Fees

Mainnet charges a 0.3% protocol fee.

API docs (Swagger)

LogoTrustless Work API Documentationapi.trustlesswork.com

Dev resources

GitHub repository

LogoTrustless WorkGitHub

Last updated