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.
| Method | Path | Description |
|---|---|---|
| POST | /api/swaps/execute | Quote 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 withamount_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