Infrastucture v1.0

Programmable
Finance Engine.

EscrowX exposes its autonomous milestone-based escrow engine as a standard REST API. Build your own marketplace, freelance platform, or gig economy app with secure, automated fund auditing.

Product to Infrastructure

We provide the plumbing for trust. You focus on building the best user experience for your workers and clients.

Global Adaptability

Support for on-chain crypto payments and fiat bridges means you can operate across borders without friction.

Authentication

Every request to the EscroX API must include your secret API Key in the x-api-key header. Keep this key secure and never expose it in client-side code.

Security Warning

If your API key is compromised, rotate it immediately from this portal to invalidate all current permissions.

// Standard Authentication Header
const headers = {
  'Content-Type': 'application/json',
  'x-api-key': 'YOUR_API_KEY'
};

Marketplace Integration Blueprint

Learn how to integrate EscroX to power your own Fiverr, Upwork, or freelance platform. By offloading the financial logic to our programmable engine, you eliminate the risk of payment fraud and complex smart contract management.

Full Lifecycle Integration Flow

Initialize Escrow

POST /v1/escrow/create

When a buyer purchases a service on your platform, call /create to lock funds with a specific freelancer.

Direct to Vault

/contract/{id}

Redirect the buyer to the verified EscroX Vault URL returned by the API to fund the contract securely.

Receive Updates

GET /v1/escrow/status/{id}

Listen for webhooks or poll the /status endpoint to know when funds are locked and work can begin.

Automated Disbursement

POST /v1/escrow/approve

Once work is approved on your platform, trigger /approve to release funds to the freelancer's wallet.

Why power your Gig Economy app with EscroX?

Legal Safety

We handle the financial custody, reducing your regulatory overhead.

Global Payouts

Direct support for crypto & fiat means you can pay devs anywhere.

Verified Proof

Our Al-verification and audit logs provide immutable proof of work.

Create Escrow

Initialize a new escrow contract programmatically. This generates a unique Escrow Vault with its own milestone tracking and audit trail.

Endpoint Specification

Field	Type	Description
clientData	Object	Contains `name` and `email` of the payer.
contractData	Object	Title, value, currency, and milestone array.

const response = await fetch('/api/v1/escrow/create', {
  method: 'POST',
  headers: { 'x-api-key': 'KEY' },
  body: JSON.stringify({
    clientData: { name: 'Acme Corp', email: 'billing@acme.com' },
    freelancerData: { name: 'Bob Dev', email: 'bob@dev.sh' },
    contractData: {
      title: 'Backend API Design',
      totalValue: 1200,
      currency: 'USD',
      milestones: [
        { title: 'Draft', amount: 400, order: 0 },
        { title: 'Release', amount: 800, order: 1 }
      ]
    }
  })
});

Approve Milestone

Programmatically release funds for a specific milestone. This should be called once work is verified either by your own internal logic or manual client intervention.

Endpoint URL

POST /api/v1/escrow/approve

// Approve Milestone ID 'm_123'
await fetch('/api/v1/escrow/approve', {
  method: 'POST',
  headers: { 'x-api-key': 'KEY' },
  body: JSON.stringify({
    contractId: 'escrow_abc',
    milestoneId: 'm_123',
    approverName: 'Admin Panel'
  })
});

Get Status

Fetch the real-time status of any escrow contract, including the full audit log and milestone completion status.

Use this to sync your own database with EscroX internal state.

Ready to scale trust?

Join 500+ developers building secure marketplaces with the EscroX programmable escrow engine.