Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.li.fi/llms.txt

Use this file to discover all available pages before exploring further.

The Intents API is the integrator-facing interface for requesting quotes, submitting orders, and tracking status. All endpoints are open and require no API key.
For solver-facing endpoints (quote submission, account management), see the Solver API Overview. For authentication details, see Authentication.

Base URLs

EnvironmentURLUse
Productionhttps://order.li.fiLive orders with real assets
Developmenthttps://order-dev.li.fiTestnet orders (Sepolia, Base Sepolia, etc.)
Interactive API documentation is available at /docs on both environments.

Endpoints

MethodPathDescription
POST/quote/requestRequest a quote for an intent (exact-input or exact-output)
GET/api/v1/integrator/quote/requestV1 quote endpoint for integrator-friendly quote parameters
POST/orders/submitSubmit an order (intent) to the solver network
GET/ordersList orders with optional filters
GET/orders/statusGet order status by onChainOrderId or catalystOrderId
GET/chains/supportedGet the list of supported chains
GET/routesGet supported routes (chain/asset pairs)

Order Lifecycle

Orders can include transitional states depending on submission path and indexing timing. In most integrations, the primary execution progression is:
Signed → Delivered → Settled
StatusWhat happened
SignedOrder signed and broadcast to the solver network
DeliveredSolver has delivered assets on the destination chain
SettledOracle verified delivery, locked funds released to solver
If the order is not filled before fillDeadline, it can be refunded after expires.

Interoperable Addresses

The Intents API uses EIP-7930 interoperable addresses, which encode both the chain and address in a single bytes field. This applies to user, asset, and receiver fields in quote requests. Example encoding of 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base (chain ID 8453):
0x0001|0000|02|2105|14|833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
  ^^^^  Version: 1
       ^^^^  ChainType: EVM
            ^^  Chain Reference length: 2 bytes
               ^^^^  Chain Reference: 8453 (hex 2105)
                    ^^  Address length: 20 bytes
                       ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^  Address

Amounts

All amounts are in the token’s smallest unit (wei-equivalent), with no decimals. For example, 1.5 USDC (6 decimals) is "1500000".

Next Steps

Request a Quote

Fetch solver pricing for your intent

Create and Submit Orders

Construct and submit an order to the solver network

Track Order Status

Monitor orders via the API or on-chain events

Solver API

Solver endpoints, quoting, and filling orders