SmartEscrow API


 

SmartEscrow API

Secure, Automated, Multi-Chain Stablecoin Escrow

 

Supported Stablecoins

3+

USDC, USDT, uUSD & more soon

On-Chain Automation

100%

Funding verification and release

Developer Focused

RESTful

Simple integration with webhooks

The Escrow Lifecycle

Our API manages the entire escrow process, from creation to final disbursement, with automated on-chain verification at its core. This flow ensures a trustless and efficient transfer of value.

1.

Create

Define parties, asset, and amount via `POST /v1/escrows`.

2.

Fund

Buyer sends stablecoins to the escrow address.

3.

Verify

System verifies the transaction hash on-chain via `POST /…/fund`.

4.

Release

Funds are sent to the seller via `POST /…/release`.

✅

Complete

All parties are notified of the successful transaction via webhook.

Platform Growth

Our infrastructure is built to scale. We’ve seen consistent growth in monthly transaction volume, demonstrating robust demand for secure, programmatic escrow services.

Stablecoin Distribution

While we support multiple stablecoins, USDC currently leads in adoption on our platform, valued for its transparency and strong backing. This diversification ensures flexibility for our users.

Core Data Models

Our API operates on two primary objects: the `Escrow` object, which defines the agreement, and the `Transaction` object, which tracks on-chain events. Understanding these structures is key to a successful integration.

Escrow Object

{
“id”: “esc_1a2b3c4d5e6f”,
“status”: “pending_funding”,
“parties”: {
“buyer”: { “wallet_address”: “…” },
“seller”: { “wallet_address”: “…” }
},
“asset”: {
“type”: “real_estate_nft”,
“identifier”: “0xabc…”
},
“amount”: “500000.00”,
“stablecoin”: “USDC”,
“blockchain”: “ethereum”,
“created_at”: “2025-09-15T…”
}

Transaction Object

{
“id”: “txn_fedcba9876”,
“escrow_id”: “esc_1a2b3c4d5e6f”,
“type”: “funding”,
“amount”: “500000.00”,
“stablecoin”: “USDC”,
“status”: “completed”,
“blockchain”: “ethereum”,
“transaction_hash”: “0x…txhash…”,
“created_at”: “2025-09-16T…”
}

Quick API Reference

These are the primary endpoints you’ll use to interact with the SmartEscrow system. Each is designed for a specific, intuitive action within the escrow lifecycle.

  • POST
    /v1/escrows

    Create a new escrow agreement.

  • GET
    /v1/escrows/{id}

    Retrieve escrow details.

  • POST
    /v1/escrows/{id}/fund

    Submit a transaction hash for funding.

  • POST
    /v1/escrows/{id}/release

    Authorize release of funds to the seller.

Developer Best Practices

To ensure a robust and reliable integration, we strongly recommend implementing these two key features of our API.

🔑

Idempotency Keys

Safely retry `POST` requests without the risk of creating duplicate entries. Include a unique `Idempotency-Key` header to ensure an operation is only performed once, protecting against network errors.

🔔

Asynchronous Webhooks

Don’t poll for status updates. Provide a `webhook_url` to receive real-time notifications for critical on-chain events like `escrow.funded` and `escrow.released`, creating a more efficient and responsive application.