Integrate Liquid Network

This guide walks you through adding Liquid Network support to your exchange, broker, or fintech platform. By the end, you'll know how to create wallets, generate deposit addresses, track balances, send and receive LBTC and Liquid assets, query blockchain data, and optionally support AMP2 managed assets like regulated securities and stablecoins.

No prior Liquid experience required. We'll start from zero.

Who this is for

  • Exchanges adding Liquid deposits and withdrawals
  • Brokers settling trades on Liquid
  • Fintech platforms integrating LBTC or Liquid issued assets (USDt, securities, etc.)
  • Custodians managing Liquid wallets on behalf of clients

What you'll build

flowchart LR
  subgraph yourInfra["Your Infrastructure"]
    backend["Your Backend"]
    lwk["LWK (Wallet Kit)"]
    backend --> lwk
  end

  subgraph liquidInfra["Liquid Infrastructure"]
    esplora["Esplora / Waterfalls"]
    liquid["Liquid Network"]
  end

  subgraph optional["Optional: AMP2"]
    proxy["AMP2 Proxy"]
    amp["AMP2 Server"]
    proxy --> amp
  end

  lwk -->|"sync & broadcast"| esplora
  esplora --> liquid
  lwk -.->|"register & cosign"| proxy

Core path (most integrations): Your backend uses LWK to manage wallets and talks to Esplora or Waterfalls for blockchain data. That's it.

AMP2 path (optional): If you want to support issuer controlled assets (regulated tokens, securities), you additionally register as a venue with AMP2 and handle cosigned transactions through their proxy.

What you'll need

ComponentPurposeRequired?
LWK (Liquid Wallet Kit)Wallet creation, address derivation, tx building, signingYes
Esplora APIBlockchain queries, tx broadcast, fee estimatesYes (public or self hosted)
WaterfallsFast wallet sync (single request full scan)Recommended
AMP2 ProxyRegister wallets and cosign for AMP2 managed assetsOnly for AMP2 assets

Guide structure

Work through these sections in order:

  1. Understanding Liquid: What Liquid is, why it matters for your business, and how it works under the hood.
  2. Use LWK: Install LWK, create wallets, derive addresses, sync balances, send and receive transactions.
  3. Blockchain Data: Query the chain, look up transactions, estimate fees, broadcast transactions.
  4. Supported Assets: Integrate issued Liquid assets, AMP0 assets, and AMP2 assets.
  5. Advanced: Run your own Elements node and handle peg-in/peg-out flows.

The Liquid Network is a Bitcoin layer-2 enabling the issuance of security tokens and other digital assets.

© 2023 Liquid Network
All rights reserved.

Feedback and Content Requests

We'd be happy to hear your suggestions on how we can improve this site.

BuildOnL2 Community

The official BuildOnL2 community lives
at community.liquid.net. Join us and build the future of Bitcoin on Liquid.

Telegram

Community-driven telegram group where
most of the Liquid developers hang out.
Go to t.me/liquid_devel to join.