Layerswap Docs

Use the Layerswap API to integrate swaps directly into your own system. You can look up available routes and prices, create swaps, get the instructions for funding them, and track each swap until it completes.

Base URL and authentication

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

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

curl 'https://api.layerswap.io/api/v2/networks' \
  --header 'accept: application/json' \
  --header 'X-LS-APIKEY: YOUR_API_KEY'

Mainnet and testnet use the same base URL; the key selects the environment. See API keys & environments. An invalid key returns 403 API_KEY_FORBIDDEN.

Endpoints by task

Task	Endpoint
List supported networks and tokens	`GET /networks`
Discover routable sources/destinations	`GET /sources`, `GET /destinations`
Check cross-token connectivity	`GET /connections`
Check min/max	`GET /limits`
Price an amount	`GET /quote`, `GET /detailed_quote`
Create a swap	`POST /swaps`
Get funding instructions	`GET /swaps/{id}/deposit_actions`
Read one swap	`GET /swaps/{id}`
Find by funding transaction	`GET /swaps/by_transaction_hash/{hash}`
Inspect transaction status	`GET /transaction_status`
Submit or inspect gasless authorization	`POST` / `GET /swaps/{id}/authorize`

For full request and response details for every endpoint, see the API reference.

Response envelopes

Successful JSON responses use a data envelope:

{
  "data": {
    "swap": {},
    "deposit_actions": [],
    "quote": {}
  }
}

API errors normally use:

{
  "error": {
    "code": "ROUTE_NOT_FOUND_ERROR",
    "message": "Route not found",
    "metadata": {}
  }
}

Binding and enum validation can return 400 with an empty body. Your client must handle both JSON errors and bodyless failures; see Errors.

First integration path

Start with Build your first API swap, then choose a funding method and implement tracking.

Start here

Funding

Operations

Recipes

Endpoints

API overview

Base URL and authentication

Endpoints by task

Response envelopes

First integration path

​Base URL and authentication

​Endpoints by task

​Response envelopes

​First integration path

Base URL and authentication

Endpoints by task

Response envelopes

First integration path