DocumentationLedger WalletExchange providerSwap Integration

☞ The renaming of “Ledger Live” to “Ledger Wallet” and
”wallet” (in the hardware sense) to “signer” is still in progress.
This page may contain legacy references that will be updated.

Swap integration overview

The Swap integration lets users exchange one crypto asset for another directly inside Ledger Wallet. As a Swap provider, you handle the quoting, route finding, and order execution; Ledger handles the device-verified transaction signing and the embedded exchange experience.

Non-KYC exchanges that do not need a custom UI can use a pure API integration and skip the LiveApp step entirely. If this applies to you, sections 1 (Backend) and 3 (Test & Submit) are what you need.

To become a native Swap provider, you need to deliver up to three things:

  1. Backend API: adapt your API to the Ledger Swap specification. Each swap is secured with a cryptographic payload and signature: your backend generates a structured binary payload, signs it with your private key, and sends both to Ledger. You must also share your public key with Ledger so signatures can be verified.
  2. LiveApp (optional for non-KYC pure-API providers): a web application that loads inside Ledger Wallet. It uses the Ledger Exchange Services Kit alongside the Wallet API to display your swap UI and initiate transactions. The LiveApp receives the quote the user entered in the wallet as query parameters. You also need to write or update your manifest and follow Ledger’s UX requirements.
  3. Testing and submission: test the full integration end-to-end using Developer Mode in Ledger Wallet, then submit your API, manifest (if applicable), and public key for Ledger review.
  • Backend — the API endpoints, payload format, signature scheme, and key-pair requirements
  • LiveApp — LiveApp URL format, manifest requirements, Exchange Services Kit usage, and UX guidelines
  • Test & Submit — how to test end-to-end with Developer Mode and submit for review
  • Flow breakdown — UX flows, advanced scenarios, and architecture diagrams
  • Supported currencies — the list of currencies available for swapping
Ledger
Copyright © Ledger SAS. All rights reserved. Ledger, Ledger Stax, Ledger Flex, Ledger Nano, Ledger Nano S, Ledger OS, Ledger Wallet, [LEDGER] (logo), [L] (logo) are trademarks owned by Ledger SAS.