Build a URL
Start withhttps://layerswap.io/app and add only the parameters you need:
URLSearchParams so values are encoded and the URL stays copy-pasteable:
URL parameters
All values are strings in the URL.Route and amount
Lock or hide fields
Flow and display
Correlation
Use a unique, non-secret
externalId for each user flow. Store it with the corresponding user action so your backend can find the matching swap. See Reference IDs and repeated requests for reuse behavior.
Named themes
The Hosted Page accepts five preset values throughtheme:
lightdefaulttonimmutableimmutablePlay
ThemeData object instead.
Older aliases
Older URLs are normalized, but use the canonical parameters above in new links:
If both source-exchange aliases appear,
sourceExchangeName takes precedence over fromExchange. Do not depend on that rule in new URLs.
Destination-address confirmation
The Hosted Page can ask the user to confirm a prefilled destination address. If your product requires a destination that the user cannot change or confirm, use the Deposit Widget, which accepts a fixeddestinationAddress prop.
Embed in an iframe
Build the URL with the same parameters, then use it assrc:
Track the result
Track completion through your backend using the Layerswap API. See Track completion for correlation byexternalId or funding transaction hash.