Layerswap Docs

Create a key

Register in the Partner Dashboard.
Create an organization, then create an app inside it.
Open the app and copy its mainnet or testnet API key.

Select an environment

Layerswap uses the same API base URL for both environments:

https://api.layerswap.io/api/v2

The API key selects the environment. A testnet key returns testnet networks and routes; a mainnet key returns mainnet data. In the Widget, the config.version value must match the key’s environment.

Authenticate an API request

Send the key in the X-LS-APIKEY header:

curl 'https://api.layerswap.io/api/v2/limits?source_network=ETHEREUM_MAINNET&source_token=USDC&destination_network=ARBITRUM_MAINNET&destination_token=USDC' \
  --header 'accept: application/json' \
  --header 'X-LS-APIKEY: YOUR_API_KEY'

const config = {
  apiKey: "YOUR_API_KEY",
  version: "mainnet",
}

Pass the object to LayerswapWidget or LayerswapDepositWidget. See the Swap Widget quickstart for a complete example.

Choose your integration — compare the Widget, Hosted Page, and API.
Swap Widget quickstart — add the swap flow to your app.
Build your first API swap — quote, create, fund, and track a swap.
Partner Dashboard reference — manage apps, API keys, and webhooks.