Furlpay Docs
Open App

Payments

LI.FI Swaps

Cross-chain token swaps routed through LI.FI's aggregation network — the same routing used by MetaMask and Phantom. Furlpay quotes and builds the route; your wallet signs and executes, so the swap is non-custodial end to end.

How a swap works

  • You ask for a route: from-token, to-token, chains, amount.
  • LI.FI aggregates DEXes and bridges and returns the best route with a firm quote.
  • Furlpay returns the unsigned transaction(s); your wallet signs and submits.
  • Execution status is trackable per step until funds land on the destination chain.
MethodPathDescription
POST/api/swaps/executeQuote a route and build the client-signed swap transaction
bash
curl -X POST https://furlpay.com/api/swaps/execute \
  -H "content-type: application/json" \
  -b "session" \
  -d '{
    "fromChain": "arbitrum",
    "toChain": "base",
    "fromToken": "USDC",
    "toToken": "ETH",
    "amountUsd": 50,
    "fromAddress": "0xYourWallet"
  }'

Fee model

Routes carry a 0.5% integrator fee on top of the route's own costs (DEX fees, bridge fees, gas). The fee is embedded in the quote you approve — what you sign is what you pay, and LI.FI forwards the integrator portion automatically. This is Furlpay's only markup on swaps.

Guarantees and limits

  • Non-custodial — Furlpay never holds the tokens; the route executes from your wallet.
  • Chains — Arbitrum, Base, Ethereum, and Solana routes (including cross-VM SOL/ETH).
  • Per-transaction cap — swaps above the server-side limit (default $500, FURLPAY_MAX_SWAP_USD) are refused with amount_over_limit.
  • Every executed and failed swap feeds the ops event ledger; the rail can be paused instantly from the control plane.

Quotes are perishable

Routes reprice with the market. Execute a quote promptly; if it expires, request a fresh one rather than force-submitting a stale transaction that will revert.
Did this page help?
Edit this page on GitHub