Skip to main content
API presets provide tuned routing defaults for the LI.FI API. When you pass a preset, LI.FI loads the preset’s defaults and merges any request-specific options on top. Your explicit values always win, so you can start with a preset and selectively override the pieces you care about.

​
Supported endpoints

​
How presets are applied

  1. LI.FI loads the preset defaults.
  2. LI.FI merges your request options on top of those defaults.
  3. Any conflicting keys fall back to the values you provided in the request body or query string.
This keeps requests concise while preserving full control.

​
Processing flow

  1. Validate that the requested preset name is present and active.
  2. Load the preset configuration (defaults, tool preferences, etc) or use the built-in default if it isn’t available.
  3. Merge preset defaults into the request payload or query parameters.
  4. Apply user-provided overrides so explicit values win.
  5. Log the resolved preset for observability and troubleshooting.
If validation fails, for example because the preset name does not match the required pattern, the API returns HTTP 400.

​
Preset names

Presets can be referenced by:
  • Generic names such as stablecoin
  • Specific names such as stablecoin-cheapest
See all available presets. A generic name can map to a specific preset. For example, stablecoin resolves to stablecoin-cheapest by default. LI.FI may promote other presets behind the same generic name when new configurations such as stablecoin-fastest or partner-specific variants stablecoin-partnerX become available.

​
Using the preset parameter

​
Advanced Routes

Provide the preset inside the options object. 
{
  "fromChainId": 1,
  "toChainId": 137,
  "fromAmount": "1000000000000000000",
  "fromTokenAddress": "0xA0b86a33E6441b8C4C8C0C4C0C4C0C4C0C4C0C4C",
  "toTokenAddress": "0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174",
  "options": {
    "preset": "stablecoin"
  }
}

​
Quote

Send the preset as a query parameter. 
GET /v1/quote?fromChain=1&toChain=137&fromToken=0xA0b86a33E6441b8C4C8C0C4C0C4C0C4C0C4C0C4C&toToken=0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174&fromAddress=0x123...&fromAmount=1000000000000000000&preset=stablecoin

​
Available presets

More presets will be documented as they are released.