FurlPay Docs
Open App
  • Introduction
  • Quickstart
  • For AI Agents
  • Monorepo
  • API Routes
  • Authenticationnew
  • Webhook Eventsnew
  • Error Codesnew
  • Rate Limitsnew
  • Agentic Payments (x402)
  • Agent Trust & Mandates (TAP)
  • CCTP Cross-Chainnew
  • LI.FI Swapsnew
  • FurlPay Travels (Travel MCP)
  • Solana Actions & Blinks
  • Claude Connectornew
  • AI Assistants
  • Stripe Crypto
  • Persona KYC
  • MiCA Roadmap
  • Security Posturenew
  • MPC & WebAuthn
  • Help Centernew
  • Getting Started
  • KYC Verification
  • Passkeys & Biometrics
  • Privacy & Data Protection
  • Transaction Statuses
  • Gasless Transfers
  • Deposits & Withdrawals
  • Managing Virtual Cards
  • Freezing & Unfreezing Cards
  • Declined Transactions
  • SDK & API Support
  • x402 Monetization Basics
  • Booking Travel
  • Travel Refunds & Cancellations

Resources

  • Changelog
  • System Status
  • OpenAPI Spec
  • Community
  • GitHub
Docs/Payments/LI.FI Swaps

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

← Previous

CCTP Cross-Chain

Next →

FurlPay Travels (Travel MCP)