10FI Gasless API

The Gasless API is a separate product for sponsored approvals and swaps on routes where 10FI supports gasless execution. Users sign an off-chain intent; 10FI relays the order and resolvers settle on-chain. Wallets can show the network fee as free on supported routes.

Not every pair or chain supports gasless execution. If a route is not eligible, your integration should fall back to Swap API and normal network gas may apply.

Dedicated Gasless API endpoints (Phase 6 — shadow-only)

Auth required on all /v1/gasless/* routes (X-Client-Id + X-API-Key). Default: ENABLE_GASLESS_API=0, executable: false, no broadcast.

Method	Path	Purpose
POST	/v1/gasless/quote	Capability + shadow quote; includes swapApiFallback when unsupported
POST	/v1/gasless/prepare	Mock toSign payload — no relay
POST	/v1/gasless/submit	Shadow accept only — signature not stored
GET	/v1/gasless/status/:id	Neutral shadow order status

Legacy combined flow (still supported)

/v1/quote + /v1/swap + /v1/submit + /v1/status/:orderId when type: "gasless" wins on Swap API quote ranking.

Typical dedicated Gasless API flow

1. POST /v1/gasless/quote — inspect capability, unsupportedReason, swapApiFallback.
2. If unsupported, use Swap API; user may pay network gas.
3. POST /v1/gasless/prepare → user signs toSign.
4. POST /v1/gasless/submit → poll /v1/gasless/status/:id.

curl -X POST "https://api.10fi.org/v1/gasless/quote" -H "Content-Type: application/json" \
  -H "X-Client-Id: $TENFI_CLIENT_ID" -H "X-API-Key: $TENFI_API_KEY" \
  -d '{ "chain":"bsc", "from":"USDC", "to":"BNB", "amount":"50", "userAddress":"0xYourWallet" }'

curl -X POST "https://api.10fi.org/v1/gasless/prepare" -H "Content-Type: application/json" \
  -H "X-Client-Id: $TENFI_CLIENT_ID" -H "X-API-Key: $TENFI_API_KEY" \
  -d '{ "quoteId":"gl_...", "chain":"bsc", "from":"USDC", "to":"BNB", "userAddress":"0xYourWallet" }'

Capabilities

• permit — EIP-2612 where token supports it (e.g. USDC)
• permit2 — Permit2 signature flow
• relayer — sponsored meta-tx (mock in Phase 6)
• nativeGasless — intent/resolver for wrapped native
• unsupported — use Swap API; user pays network gas

Current support & roadmap

• Phase 6: dedicated /v1/gasless/* foundation is live in shadow mode (executable: false).
• Swap API fallback: returned in swapApiFallback on quote when gasless unavailable.
• Flags: check GET /v1/health → gaslessApi.

Fees

• Platform: flat 0.1% (net amounts).
• Network gas: sponsored by resolver on eligible Gasless API routes (recovered in the quoted rate).

Only the Gasless API product should use "gasless" or "zero gas" in user-facing copy. Full reference: /docs · Swap product: /docs/swap-api