Skip to main content
The API MVP is intentionally small. It covers backend quote-driven swap creation and status polling.

Current limits

AreaCurrent behavior
API keysBackend-only partner API keys.
Quote typeExact-input floating quotes only.
Quote lifetimeShort-lived quotes with an expiresAt timestamp.
CommissionConfigured during partner onboarding and partnership setup.
Status updatesPoll GET /swap/{id}.
Destination memoNot supported in the MVP.

Integration defaults

  • Poll active swaps every 30 seconds.
  • Store the LightSwap swap ID with your own order ID.
  • Treat all amounts as decimal strings.
  • Refresh supported assets regularly instead of hardcoding asset lists.

Fees and network costs

The API returns the route estimate and deposit instructions for the swap. Wallet, gas, and blockchain network costs are separate third-party costs and can change outside LightSwap.

Support handoff

When you contact support, include:
  • Your externalId, if you sent one.
  • LightSwap swap ID, if one exists.
  • Deposit transaction hash, if the user has already sent funds.
Do not include private keys, seed phrases, or full internal customer records.