LifiQuote

Documentation for eth_defi.lifi.quote.LifiQuote Python class.

class LifiQuote

Bases: object

LI.FI cross-chain quote response.

Contains all information needed to execute a cross-chain transfer, including the ready-to-sign transaction request.

Attributes summary

`source_chain_id`
`target_chain_id`
`from_token`
`to_token`
`from_amount`
`estimate_to_amount`
`estimate_to_amount_min`
`gas_cost_usd`
`execution_duration`
`fetched_at`
`data`

Methods summary

`__init__`(source_chain_id, target_chain_id, ...)
`get_age_seconds`()	Seconds elapsed since this quote was fetched.
`get_transaction_request`()	Get the transaction request from the quote.
`is_valid`([max_age_seconds])	Check if this quote is still fresh enough to execute.

__init__(source_chain_id, target_chain_id, from_token, to_token, from_amount, estimate_to_amount, estimate_to_amount_min, gas_cost_usd, execution_duration, fetched_at, data)

Parameters

source_chain_id (int) –
target_chain_id (int) –
from_token (str) –
to_token (str) –
from_amount (int) –
estimate_to_amount (int) –
estimate_to_amount_min (int) –
gas_cost_usd (Optional[decimal.Decimal]) –
execution_duration (Optional[int]) –
fetched_at (float) –
data (dict) –

Return type

None

get_age_seconds()

Seconds elapsed since this quote was fetched.

Returns: Age of the quote in seconds.
Return type: float

get_transaction_request()

Get the transaction request from the quote.

This is the ready-to-sign transaction with from, to, data, value, gasLimit, gasPrice, and chainId.

Returns: Transaction request dict from LI.FI API
Return type: dict

is_valid(max_age_seconds=120)

Check if this quote is still fresh enough to execute.

The LI.FI /v1/quote endpoint does not return an explicit expiry timestamp. This method uses a time-based heuristic: quotes older than max_age_seconds are considered stale because gas prices and bridge liquidity change rapidly.

Parameters: max_age_seconds (float) – Maximum acceptable age in seconds (default 120s)
Returns: True if the quote is younger than max_age_seconds.
Return type: bool