Skip to main content
The LightSwap widget lets you add the hosted swap flow to your website with an iframe. Use the widget when you want users to complete the swap flow on your page without building a backend API integration first. The widget can run without a key. If you have a revenue-sharing agreement with LightSwap, add your public widget key so swaps can be attributed to your integration. All query parameters are optional. https://lightswap.me/widget is a valid widget URL and opens with LightSwap defaults.
Do not put an API key in the widget. API keys are secret backend credentials. Widget keys are public attribution identifiers.

​
Quick start

1

Choose optional defaults

Set the starting pair, amount, locale, theme, and accent color in the iframe URL.
2

Paste the iframe

Place the iframe where the widget should appear. No wrapper or custom parent component is required.
3

Add a public widget key if needed

Add key=YOUR_PUBLIC_WIDGET_KEY only when LightSwap has issued a key for attribution or revenue sharing.

​
Basic iframe

<iframe
  title="LightSwap widget"
  src="https://lightswap.me/widget?from=BTC&to=ETH&amount=10&theme=light&accent=18e299&locale=en"
  style="border:0;display:block;width:441px;max-width:100%;height:570px;background:transparent;"
  scrolling="no"
  allow="clipboard-write"
></iframe>

​
Example page

Open widget example

Preview the hosted widget in an iframe.

​
Add attribution

Use a public widget key only if LightSwap has issued one to you. Add it as the key query parameter. 
<iframe
  title="LightSwap widget"
  src="https://lightswap.me/widget?key=YOUR_PUBLIC_WIDGET_KEY&from=BTC&to=ETH&amount=10&theme=light&accent=18e299&locale=en"
  style="border:0;display:block;width:441px;max-width:100%;height:570px;background:transparent;"
  scrolling="no"
  allow="clipboard-write"
></iframe>
LightSwap stores revenue-sharing terms in its own systems. Do not add custom fee or commission parameters to the widget URL. You do not need to register a domain before embedding the widget. If you use a public widget key, only place it on pages where you want swaps attributed to your integration.

​
Settings

ParameterRequiredDescription
keyNoPublic widget key for attribution. Omit it for unattributed usage.
fromNoInitial source token symbol, for example BTC.
toNoInitial destination token symbol, for example ETH.
amountNoInitial send amount. Use a positive decimal value.
themeNolight, dark, or auto. Defaults to auto.
accentNoHex accent color without #, for example 18e299.
localeNoen, es, or ru. Defaults to en.
Keep the iframe itself unframed. The snippet above controls the widget width and height, so you can paste it directly into a page layout.

​
Need a public widget key?

Contact LightSwap if you want attributed widget usage or revenue sharing. Looking for a backend API integration instead of the iframe widget? Start with Direct API or go directly to the API Reference.