LI.FI — Populate a step with transaction data
Retrieve populate a step with transaction data with the LI.FI API. Supply an action and a transaction ID. Sample fields include addresses and symbols. Use it for on-chain or crypto market research. The POST request schema also lists denyPools, skipSimulation, mayanNonEvmPermitSignature. Use the response in a DeFi workflow for the selected protocol, and compare the request and response with the provider example.
- Selected price
- $0 / callPublished pricing
- Sellers / implementations
- 1 / 1
- Requests · 30d
- —Loading...
- Success rate · 30d
- —Loading...
| Seller | Pricing | Requests · 30d | Performance | Access |
|---|---|---|---|---|
lifiCurrent LI.FI — Populate a step with transaction data · POST | $0 / call | — | —successP50— |
Run sends a real API request. Charges follow the published API contract.
Response structure
actionobjectfromAddressstringfromAmountstringfromChainIdintegerfromTokenobjectaddressstringchainIdintegercoinKeystringdecimalsintegerlogoURIstringnamestringpriceUSDstringsymbolstringtagsunknown[]verificationStatusstringverificationStatusBreakdownunknown[]
slippagenumbertoAddressstringtoChainIdintegertoTokenobjectaddressstringchainIdintegercoinKeystringdecimalsintegerlogoURIstringnamestringpriceUSDstringsymbolstringtagsunknown[]verificationStatusstringverificationStatusBreakdownunknown[]
estimateobjectapprovalAddressstringexecutionDurationintegerfeeCostsobject[]fromAmountstringfromAmountUSDstringgasCostsobject[]toAmountstringtoAmountMinstringtoAmountUSDstringtoolstring
idstringincludedStepsobject[]actionobjectestimateobjectidstringtoolstringtoolDetailsobjecttypestring
integratorstringstepSimulationobjectgasSourcestringstatusstring
toolstringtoolDetailsobjectkeystringlogoURIstringnamestring
transactionIdstringtransactionRequestobjectchainIdintegerdatastringfromstringgasLimitstringgasPricestringtostringvaluestring
typestring
// Inferred from response examples. Fields are optional and other fields may be returned.
export type ApiResponse = {
action?: {
fromAddress?: string;
fromAmount?: string;
fromChainId?: number;
fromToken?: {
address?: string;
chainId?: number;
coinKey?: string;
decimals?: number;
logoURI?: string;
name?: string;
priceUSD?: string;
symbol?: string;
tags?: Array<unknown>;
verificationStatus?: string;
verificationStatusBreakdown?: Array<unknown>;
};
slippage?: number;
toAddress?: string;
toChainId?: number;
toToken?: {
address?: string;
chainId?: number;
coinKey?: string;
decimals?: number;
logoURI?: string;
name?: string;
priceUSD?: string;
symbol?: string;
tags?: Array<unknown>;
verificationStatus?: string;
verificationStatusBreakdown?: Array<unknown>;
};
};
estimate?: {
approvalAddress?: string;
executionDuration?: number;
feeCosts?: Array<Record<string, unknown>>;
fromAmount?: string;
fromAmountUSD?: string;
gasCosts?: Array<Record<string, unknown>>;
toAmount?: string;
toAmountMin?: string;
toAmountUSD?: string;
tool?: string;
};
id?: string;
includedSteps?: Array<{
action?: Record<string, unknown>;
estimate?: Record<string, unknown>;
id?: string;
tool?: string;
toolDetails?: Record<string, unknown>;
type?: string;
}>;
integrator?: string;
stepSimulation?: {
gasSource?: string;
status?: string;
};
tool?: string;
toolDetails?: {
key?: string;
logoURI?: string;
name?: string;
};
transactionId?: string;
transactionRequest?: {
chainId?: number;
data?: string;
from?: string;
gasLimit?: string;
gasPrice?: string;
to?: string;
value?: string;
};
type?: string;
};- Method
- POST
- Endpoint
https://api.openany.si/v1/agent-apis/lifi/v1/advanced/stepTransaction- Content type
- application/json
- Authentication
Authorization: Bearer $OPENANY_API_KEY
curl \
'https://api.openany.si/v1/agent-apis/lifi/v1/advanced/stepTransaction' \
-X POST \
-H "Authorization: Bearer $OPENANY_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"action": {
"fromAddress": "0x552008c0f6870c2f77e5cC1d2eb9bdff03e30Ea0",
"fromAmount": "100000000",
"fromChainId": 1,
"fromToken": {
"address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"chainId": 1,
"coinKey": "USDC",
"decimals": 6,
"logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png",
"name": "USD Coin",
"priceUSD": "1.0002350525",
"symbol": "USDC",
"tags": [
"stablecoin"
],
"verificationStatus": "verified",
"verificationStatusBreakdown": [
{
"provider": "hypernative",
"providerResult": "accept",
"result": "verified"
}
]
},
"slippage": 0.005,
"toAddress": "0x552008c0f6870c2f77e5cC1d2eb9bdff03e30Ea0",
"toChainId": 10,
"toToken": {
"address": "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85",
"chainId": 10,
"coinKey": "USDC",
"decimals": 6,
"logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png",
"name": "USD Coin",
"priceUSD": "1.0008373187",
"symbol": "USDC",
"tags": [
"stablecoin"
],
"verificationStatus": "verified",
"verificationStatusBreakdown": [
{
"provider": "hypernative",
"providerResult": "accept",
"result": "verified"
}
]
}
},
"estimate": {
"approvalAddress": "0x1231DEB6f5749EF6cE6943a275A1D3E7486F4EaE",
"executionDuration": 2,
"feeCosts": [
{
"amount": "250000",
"amountUSD": "0.2501",
"description": "Fixed LIFI fee, independent of any other fee",
"feeSplit": {
"integratorFee": "0",
"lifiFee": "250000",
"recipients": [
{
"fee": "250000",
"name": "lifi",
"type": "FIXED"
}
]
},
"included": true,
"name": "LIFI Fixed Fee",
"percentage": "0.0025",
"token": {
"address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"chainId": 1,
"coinKey": "USDC",
"decimals": 6,
"logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png",
"name": "USD Coin",
"priceUSD": "1.0002350525",
"symbol": "USDC",
"tags": [
"stablecoin"
],
"verificationStatus": "verified",
"verificationStatusBreakdown": [
{
"provider": "hypernative",
"providerResult": "accept",
"result": "verified"
}
]
}
},
{
"amount": "9975",
"amountUSD": "0.0100",
"description": "The fee taken by the relayer",
"included": true,
"name": "Relayer fee",
"percentage": "0.000100",
"token": {
"address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"chainId": 1,
"coinKey": "USDC",
"decimals": 6,
"logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png",
"name": "USD Coin",
"priceUSD": "1.0002350525",
"symbol": "USDC",
"tags": [
"stablecoin"
],
"verificationStatus": "verified",
"verificationStatusBreakdown": [
{
"provider": "hypernative",
"providerResult": "accept",
"result": "verified"
}
]
}
},
{
"amount": "296",
"amountUSD": "0.0003",
"description": "The gas fee taken by the relayer",
"included": true,
"name": "Relayer gas fee",
"percentage": "0.000003",
"token": {
"address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"chainId": 1,
"coinKey": "USDC",
"decimals": 6,
"logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png",
"name": "USD Coin",
"priceUSD": "1.0002350525",
"symbol": "USDC",
"tags": [
"stablecoin"
],
"verificationStatus": "verified",
"verificationStatusBreakdown": [
{
"provider": "hypernative",
"providerResult": "accept",
"result": "verified"
}
]
}
}
],
"fromAmount": "100000000",
"fromAmountUSD": "100.0235",
"gasCosts": [
{
"amount": "10257872616000",
"amountUSD": "0.0237",
"estimate": "216000",
"limit": "459000",
"price": "47490151",
"token": {
"address": "0x0000000000000000000000000000000000000000",
"chainId": 1,
"coinKey": "ETH",
"decimals": 18,
"logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2/logo.png",
"name": "ETH",
"priceUSD": "2308.14",
"symbol": "ETH",
"tags": [
"major_asset"
],
"verificationStatus": "verified",
"verificationStatusBreakdown": [
{
"provider": "hypernative",
"providerResult": "accept",
"result": "verified"
}
]
},
"type": "SEND"
}
],
"skipPermit": false,
"toAmount": "99739729",
"toAmountMin": "99739729",
"toAmountUSD": "99.8232",
"tool": "across"
},
"executionType": "transaction",
"id": "f7623b70-2446-47a7-a306-2f67fa59301f:0",
"includedSteps": [
{
"action": {
"fromAddress": "0x1231DEB6f5749EF6cE6943a275A1D3E7486F4EaE",
"fromAmount": "100000000",
"fromChainId": 1,
"fromToken": {
"address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"chainId": 1,
"coinKey": "USDC",
"decimals": 6,
"logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png",
"name": "USD Coin",
"priceUSD": "1.0002350525",
"symbol": "USDC",
"tags": [
"stablecoin"
],
"verificationStatus": "verified",
"verificationStatusBreakdown": [
{
"provider": "hypernative",
"providerResult": "accept",
"result": "verified"
}
]
},
"slippage": 0.005,
"toAddress": "0x1231DEB6f5749EF6cE6943a275A1D3E7486F4EaE",
"toChainId": 1,
"toToken": {
"address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"chainId": 1,
"coinKey": "USDC",
"decimals": 6,
"logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png",
"name": "USD Coin",
"priceUSD": "1.0002350525",
"symbol": "USDC",
"tags": [
"stablecoin"
],
"verificationStatus": "verified",
"verificationStatusBreakdown": [
{
"provider": "hypernative",
"providerResult": "accept",
"result": "verified"
}
]
}
},
"estimate": {
"approvalAddress": "0xCE40449B773a3E6E5e769ADb4e567179d4828cbd",
"executionDuration": 0,
"feeCosts": [
{
"amount": "250000",
"amountUSD": "0.2501",
"description": "Fixed LIFI fee, independent of any other fee",
"feeSplit": {
"integratorFee": "0",
"lifiFee": "250000",
"recipients": [
{
"fee": "250000",
"name": "lifi",
"type": "FIXED"
}
]
},
"included": true,
"name": "LIFI Fixed Fee",
"percentage": "0.0025",
"token": {
"address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"chainId": 1,
"coinKey": "USDC",
"decimals": 6,
"logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png",
"name": "USD Coin",
"priceUSD": "1.0002350525",
"symbol": "USDC",
"tags": [
"stablecoin"
],
"verificationStatus": "verified",
"verificationStatusBreakdown": [
{
"provider": "hypernative",
"providerResult": "accept",
"result": "verified"
}
]
}
}
],
"fromAmount": "100000000",
"gasCosts": [
{
"amount": "6173719630000",
"amountUSD": "0.0142",
"estimate": "130000",
"limit": "169000",
"price": "47490151",
"token": {
"address": "0x0000000000000000000000000000000000000000",
"chainId": 1,
"coinKey": "ETH",
"decimals": 18,
"logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2/logo.png",
"name": "ETH",
"priceUSD": "2308.14",
"symbol": "ETH",
"tags": [
"major_asset"
],
"verificationStatus": "verified",
"verificationStatusBreakdown": [
{
"provider": "hypernative",
"providerResult": "accept",
"result": "verified"
}
]
},
"type": "SEND"
}
],
"toAmount": "99750000",
"toAmountMin": "99750000",
"tool": "feeCollection"
},
"id": "fad92fca-4184-40f8-a88c-7e840f1aceea",
"tool": "feeCollection",
"toolDetails": {
"key": "feeCollection",
"logoURI": "https://raw.githubusercontent.com/lifinance/types/main/src/assets/icons/protocols/feeCollection.svg",
"name": "Integrator Fee"
},
"type": "protocol"
},
{
"action": {
"destinationGasConsumption": "0",
"fromAddress": "0x1231DEB6f5749EF6cE6943a275A1D3E7486F4EaE",
"fromAmount": "99750000",
"fromChainId": 1,
"fromToken": {
"address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"chainId": 1,
"coinKey": "USDC",
"decimals": 6,
"logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png",
"name": "USD Coin",
"priceUSD": "1.0002350525",
"symbol": "USDC",
"tags": [
"stablecoin"
],
"verificationStatus": "verified",
"verificationStatusBreakdown": [
{
"provider": "hypernative",
"providerResult": "accept",
"result": "verified"
}
]
},
"slippage": 0.005,
"toAddress": "0x552008c0f6870c2f77e5cC1d2eb9bdff03e30Ea0",
"toChainId": 10,
"toToken": {
"address": "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85",
"chainId": 10,
"coinKey": "USDC",
"decimals": 6,
"logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png",
"name": "USD Coin",
"priceUSD": "1.0008373187",
"symbol": "USDC",
"tags": [
"stablecoin"
],
"verificationStatus": "verified",
"verificationStatusBreakdown": [
{
"provider": "hypernative",
"providerResult": "accept",
"result": "verified"
}
]
}
},
"estimate": {
"approvalAddress": "0x5c7BCd6E7De5423a257D81B442095A1a6ced35C5",
"executionDuration": 2,
"feeCosts": [
{
"amount": "9975",
"amountUSD": "0.0100",
"description": "The fee taken by the relayer",
"included": true,
"name": "Relayer fee",
"percentage": "0.000100",
"token": {
"address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"chainId": 1,
"coinKey": "USDC",
"decimals": 6,
"logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png",
"name": "USD Coin",
"priceUSD": "1.0002350525",
"symbol": "USDC",
"tags": [
"stablecoin"
],
"verificationStatus": "verified",
"verificationStatusBreakdown": [
{
"provider": "hypernative",
"providerResult": "accept",
"result": "verified"
}
]
}
},
{
"amount": "296",
"amountUSD": "0.0003",
"description": "The gas fee taken by the relayer",
"included": true,
"name": "Relayer gas fee",
"percentage": "0.000003",
"token": {
"address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"chainId": 1,
"coinKey": "USDC",
"decimals": 6,
"logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png",
"name": "USD Coin",
"priceUSD": "1.0002350525",
"symbol": "USDC",
"tags": [
"stablecoin"
],
"verificationStatus": "verified",
"verificationStatusBreakdown": [
{
"provider": "hypernative",
"providerResult": "accept",
"result": "verified"
}
]
}
}
],
"fromAmount": "99750000",
"gasCosts": [
{
"amount": "4084152986000",
"amountUSD": "0.0094",
"estimate": "86000",
"limit": "111800",
"price": "47490151",
"token": {
"address": "0x0000000000000000000000000000000000000000",
"chainId": 1,
"coinKey": "ETH",
"decimals": 18,
"logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2/logo.png",
"name": "ETH",
"priceUSD": "2308.14",
"symbol": "ETH",
"tags": [
"major_asset"
],
"verificationStatus": "verified",
"verificationStatusBreakdown": [
{
"provider": "hypernative",
"providerResult": "accept",
"result": "verified"
}
]
},
"type": "SEND"
}
],
"toAmount": "99739729",
"toAmountMin": "99739729",
"tool": "across"
},
"id": "3b546a28-939c-406b-a8b1-62214f3f69c8",
"tool": "across",
"toolDetails": {
"key": "across",
"logoURI": "https://raw.githubusercontent.com/lifinance/types/main/src/assets/icons/bridges/across.svg",
"name": "AcrossV4"
},
"type": "cross"
}
],
"integrator": "lifi-api",
"recommendedSlippage": 0.01099856322858362,
"tool": "across",
"toolDetails": {
"key": "across",
"logoURI": "https://raw.githubusercontent.com/lifinance/types/main/src/assets/icons/bridges/across.svg",
"name": "AcrossV4"
},
"type": "lifi"
}'Input parameters
Fields in this listing; additional options and input encoding can vary by provider.
| Parameter | Location | Type | Required | Description |
|---|---|---|---|---|
denyPools | URL query parametersquery | array | No | One to 100 AMM pool or Solana venue identifiers to exclude when building transaction data. If the route was requested with `options.pools.deny`, you must pass the same list again for each step: pool exclusions are request-scoped and are not carried in the returned Step. Without it, swaps are re-quoted with no exclusions, so the transaction can use an excluded pool or venue. Repeat the query parameter for multiple entries, as with `/v1/quote`. Each entry is a non-zero Uniswap V2/V3 EVM pool address (`0x` + 40 hex), a Uniswap V4 `-` identifier, where `poolId` is `0x` + 64 hex, or a Solana venue program ID (base58). EVM pool exclusion is supported only by `fly`; Solana venue exclusion only by `jupiter`, `titan` and `okx`. If the list holds a Solana program ID, a step that swaps on Solana through any other exchange is rejected with a 400 error instead of being built without the exclusion. Keep the Step object in the JSON request body.Nested fields and variants
|
skipSimulation | URL query parametersquery | boolean | No | Parameter to skip transaction simulation. The quote will be returned faster but the transaction gas limit won't be accurate. |
mayanNonEvmPermitSignature | URL query parametersquery | boolean | No | Mayan specific option to bridge from non-EVM chain to Hyperliquid |
svmMaxSupportedTransactionVersion | URL query parametersquery | number | null | No | Maximum Solana transaction version the client can sign. Defaults to 0; omission or null uses v0. Set to 1 to allow V1 where enabled for the environment. Jito requests always use v0. Size overflow may fall back to v0. Read transactionRequest.svmTransactionVersion for the version actually built. Ignored for source chains other than Solana. enum: 0, 1, null |
svmPriorityFeeLevel | URL query parametersquery | string | No | Priority fee level for Solana Virtual Machine (SVM) transactions. enum: "NORMAL", "FAST", "ULTRA" |
action | JSON request bodybody | object | Yes | The action of the stepNested fields and variants
|
estimate | JSON request bodybody | object | No | The estimation for the stepNested fields and variants
|
execution | JSON request bodybody | any | No | An objection containing status information about the execution |
id | JSON request bodybody | string | Yes | Unique identifier of the step |
includedSteps | JSON request bodybody | array | No | Nested fields and variants
Nested fields and variants
|
integrator | JSON request bodybody | string | No | A string containing tracking information about the integrator of the API |
referrer | JSON request bodybody | string | No | A string containing tracking information about the referrer of the integrator |
tool | JSON request bodybody | string | Yes | The tool used for this step. E.g. `relay` |
toolDetails | JSON request bodybody | object | No | The details of the tool used for this step. E.g. `relay`Nested fields and variants
|
transactionRequest | JSON request bodybody | object | No | An ether.js TransactionRequest that can be triggered using a wallet provider. (https://docs.ethers.io/v5/api/providers/types/#providers-TransactionRequest) Solana responses also include svmTransactionVersion (0 or 1), the version actually built. This may be lower than the requested maximum.Nested fields and variants
|
type | JSON request bodybody | string | Yes | The type of the step. `swap` executes a DEX swap on a single chain, `cross` bridges assets between chains, `lifi` runs LiFi's internal multi-action logic, and `protocol` represents protocol-level actions such as fee collection or vault interactions executed inside LiFi managed contracts. enum: "swap", "cross", "lifi", "protocol" |
Required markers inside a nested object or variant apply when that object or variant is used.
Sample response
Sample response · Documented HTTP 200 Published documentation example. Verify the actual response after an approved call.
{
"action": {
"fromAddress": "0x552008c0f6870c2f77e5cC1d2eb9bdff03e30Ea0",
"fromAmount": "100000000",
"fromChainId": 1,
"fromToken": {
"address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"chainId": 1,
"coinKey": "USDC",
"decimals": 6,
"logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6",
"name": "USD Coin",
"priceUSD": "1.0002350525",
"symbol": "USDC",
"tags": [],
"verificationStatus": "verified",
"verificationStatusBreakdown": []
},
"slippage": 0.005,
"toAddress": "0x552008c0f6870c2f77e5cC1d2eb9bdff03e30Ea0",
"toChainId": 10,
"toToken": {
"address": "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85",
"chainId": 10,
"coinKey": "USDC",
"decimals": 6,
"logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6",
"name": "USD Coin",
"priceUSD": "1.0008373187",
"symbol": "USDC",
"tags": [],
"verificationStatus": "verified",
"verificationStatusBreakdown": []
}
},
"estimate": {
"approvalAddress": "0x1231DEB6f5749EF6cE6943a275A1D3E7486F4EaE",
"executionDuration": 2,
"feeCosts": [
{}
],
"fromAmount": "100000000",
"fromAmountUSD": "100.0235",
"gasCosts": [
{}
],
"toAmount": "99739730",
"toAmountMin": "99739730",
"toAmountUSD": "99.8232",
"tool": "across"
},
"id": "f7623b70-2446-47a7-a306-2f67fa59301f:0",
"includedSteps": [
{
"action": {},
"estimate": {},
"id": "fad92fca-4184-40f8-a88c-7e840f1aceea",
"tool": "feeCollection",
"toolDetails": {},
"type": "protocol"
}
],
"integrator": "lifi-api",
"stepSimulation": {
"gasSource": "simulation",
"status": "success"
},
"tool": "across",
"toolDetails": {
"key": "across",
"logoURI": "https://raw.githubusercontent.com/lifinance/types/main/src/assets/icons/bridges/across.svg",
"name": "AcrossV4"
},
"transactionId": "0x5adb1acd899c00f65673bcc10757f4a18281d5d8ad98f8ef29282392d4969639",
"transactionRequest": {
"chainId": 1,
"data": "0x1794958f000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000",
"from": "0x552008c0f6870c2f77e5cC1d2eb9bdff03e30Ea0",
"gasLimit": "0x425c4",
"gasPrice": "0x2d4a467",
"to": "0x1231DEB6f5749EF6cE6943a275A1D3E7486F4EaE",
"value": "0x0"
},
"type": "lifi"
}Agent integration
Copy the resource contract without sharing an API key.
View API Markdown
# LI.FI — Populate a step with transaction data
Retrieve populate a step with transaction data with the LI.FI API. Supply an action and a transaction ID. Sample fields include addresses and symbols. Use it for on-chain or crypto market research. The POST request schema also lists denyPools, skipSimulation, mayanNonEvmPermitSignature. Use the response in a DeFi workflow for the selected protocol, and compare the request and response with the provider example.
## Available implementations
lifi · LI.FI — Populate a step with transaction data: https://openany.si/markets/apis/capabilities/lifi-li-fi-populate-a-step-with-transaction-data?offering=a764b629-023c-47e4-9b7d-86cd0f2456a0 · $0 / call
## Selected API contract
Documentation: https://openany.si/markets/apis/capabilities/lifi-li-fi-populate-a-step-with-transaction-data
Method: POST
Endpoint: https://api.openany.si/v1/agent-apis/lifi/v1/advanced/stepTransaction
Price: $0 / call
Provider: lifi
Contract revision: 3
Price source: OpenAny public API contract and documented provider unit rates. Price update time: not supplied.
Use OPENANY_API_KEY from the environment. API Key calls use your shared balance.
## Prepared request
```bash
curl \
'https://api.openany.si/v1/agent-apis/lifi/v1/advanced/stepTransaction' \
-X POST \
-H "Authorization: Bearer $OPENANY_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"action": {
"fromAddress": "0x552008c0f6870c2f77e5cC1d2eb9bdff03e30Ea0",
"fromAmount": "100000000",
"fromChainId": 1,
"fromToken": {
"address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"chainId": 1,
"coinKey": "USDC",
"decimals": 6,
"logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png",
"name": "USD Coin",
"priceUSD": "1.0002350525",
"symbol": "USDC",
"tags": [
"stablecoin"
],
"verificationStatus": "verified",
"verificationStatusBreakdown": [
{
"provider": "hypernative",
"providerResult": "accept",
"result": "verified"
}
]
},
"slippage": 0.005,
"toAddress": "0x552008c0f6870c2f77e5cC1d2eb9bdff03e30Ea0",
"toChainId": 10,
"toToken": {
"address": "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85",
"chainId": 10,
"coinKey": "USDC",
"decimals": 6,
"logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png",
"name": "USD Coin",
"priceUSD": "1.0008373187",
"symbol": "USDC",
"tags": [
"stablecoin"
],
"verificationStatus": "verified",
"verificationStatusBreakdown": [
{
"provider": "hypernative",
"providerResult": "accept",
"result": "verified"
}
]
}
},
"estimate": {
"approvalAddress": "0x1231DEB6f5749EF6cE6943a275A1D3E7486F4EaE",
"executionDuration": 2,
"feeCosts": [
{
"amount": "250000",
"amountUSD": "0.2501",
"description": "Fixed LIFI fee, independent of any other fee",
"feeSplit": {
"integratorFee": "0",
"lifiFee": "250000",
"recipients": [
{
"fee": "250000",
"name": "lifi",
"type": "FIXED"
}
]
},
"included": true,
"name": "LIFI Fixed Fee",
"percentage": "0.0025",
"token": {
"address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"chainId": 1,
"coinKey": "USDC",
"decimals": 6,
"logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png",
"name": "USD Coin",
"priceUSD": "1.0002350525",
"symbol": "USDC",
"tags": [
"stablecoin"
],
"verificationStatus": "verified",
"verificationStatusBreakdown": [
{
"provider": "hypernative",
"providerResult": "accept",
"result": "verified"
}
]
}
},
{
"amount": "9975",
"amountUSD": "0.0100",
"description": "The fee taken by the relayer",
"included": true,
"name": "Relayer fee",
"percentage": "0.000100",
"token": {
"address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"chainId": 1,
"coinKey": "USDC",
"decimals": 6,
"logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png",
"name": "USD Coin",
"priceUSD": "1.0002350525",
"symbol": "USDC",
"tags": [
"stablecoin"
],
"verificationStatus": "verified",
"verificationStatusBreakdown": [
{
"provider": "hypernative",
"providerResult": "accept",
"result": "verified"
}
]
}
},
{
"amount": "296",
"amountUSD": "0.0003",
"description": "The gas fee taken by the relayer",
"included": true,
"name": "Relayer gas fee",
"percentage": "0.000003",
"token": {
"address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"chainId": 1,
"coinKey": "USDC",
"decimals": 6,
"logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png",
"name": "USD Coin",
"priceUSD": "1.0002350525",
"symbol": "USDC",
"tags": [
"stablecoin"
],
"verificationStatus": "verified",
"verificationStatusBreakdown": [
{
"provider": "hypernative",
"providerResult": "accept",
"result": "verified"
}
]
}
}
],
"fromAmount": "100000000",
"fromAmountUSD": "100.0235",
"gasCosts": [
{
"amount": "10257872616000",
"amountUSD": "0.0237",
"estimate": "216000",
"limit": "459000",
"price": "47490151",
"token": {
"address": "0x0000000000000000000000000000000000000000",
"chainId": 1,
"coinKey": "ETH",
"decimals": 18,
"logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2/logo.png",
"name": "ETH",
"priceUSD": "2308.14",
"symbol": "ETH",
"tags": [
"major_asset"
],
"verificationStatus": "verified",
"verificationStatusBreakdown": [
{
"provider": "hypernative",
"providerResult": "accept",
"result": "verified"
}
]
},
"type": "SEND"
}
],
"skipPermit": false,
"toAmount": "99739729",
"toAmountMin": "99739729",
"toAmountUSD": "99.8232",
"tool": "across"
},
"executionType": "transaction",
"id": "f7623b70-2446-47a7-a306-2f67fa59301f:0",
"includedSteps": [
{
"action": {
"fromAddress": "0x1231DEB6f5749EF6cE6943a275A1D3E7486F4EaE",
"fromAmount": "100000000",
"fromChainId": 1,
"fromToken": {
"address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"chainId": 1,
"coinKey": "USDC",
"decimals": 6,
"logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png",
"name": "USD Coin",
"priceUSD": "1.0002350525",
"symbol": "USDC",
"tags": [
"stablecoin"
],
"verificationStatus": "verified",
"verificationStatusBreakdown": [
{
"provider": "hypernative",
"providerResult": "accept",
"result": "verified"
}
]
},
"slippage": 0.005,
"toAddress": "0x1231DEB6f5749EF6cE6943a275A1D3E7486F4EaE",
"toChainId": 1,
"toToken": {
"address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"chainId": 1,
"coinKey": "USDC",
"decimals": 6,
"logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png",
"name": "USD Coin",
"priceUSD": "1.0002350525",
"symbol": "USDC",
"tags": [
"stablecoin"
],
"verificationStatus": "verified",
"verificationStatusBreakdown": [
{
"provider": "hypernative",
"providerResult": "accept",
"result": "verified"
}
]
}
},
"estimate": {
"approvalAddress": "0xCE40449B773a3E6E5e769ADb4e567179d4828cbd",
"executionDuration": 0,
"feeCosts": [
{
"amount": "250000",
"amountUSD": "0.2501",
"description": "Fixed LIFI fee, independent of any other fee",
"feeSplit": {
"integratorFee": "0",
"lifiFee": "250000",
"recipients": [
{
"fee": "250000",
"name": "lifi",
"type": "FIXED"
}
]
},
"included": true,
"name": "LIFI Fixed Fee",
"percentage": "0.0025",
"token": {
"address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"chainId": 1,
"coinKey": "USDC",
"decimals": 6,
"logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png",
"name": "USD Coin",
"priceUSD": "1.0002350525",
"symbol": "USDC",
"tags": [
"stablecoin"
],
"verificationStatus": "verified",
"verificationStatusBreakdown": [
{
"provider": "hypernative",
"providerResult": "accept",
"result": "verified"
}
]
}
}
],
"fromAmount": "100000000",
"gasCosts": [
{
"amount": "6173719630000",
"amountUSD": "0.0142",
"estimate": "130000",
"limit": "169000",
"price": "47490151",
"token": {
"address": "0x0000000000000000000000000000000000000000",
"chainId": 1,
"coinKey": "ETH",
"decimals": 18,
"logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2/logo.png",
"name": "ETH",
"priceUSD": "2308.14",
"symbol": "ETH",
"tags": [
"major_asset"
],
"verificationStatus": "verified",
"verificationStatusBreakdown": [
{
"provider": "hypernative",
"providerResult": "accept",
"result": "verified"
}
]
},
"type": "SEND"
}
],
"toAmount": "99750000",
"toAmountMin": "99750000",
"tool": "feeCollection"
},
"id": "fad92fca-4184-40f8-a88c-7e840f1aceea",
"tool": "feeCollection",
"toolDetails": {
"key": "feeCollection",
"logoURI": "https://raw.githubusercontent.com/lifinance/types/main/src/assets/icons/protocols/feeCollection.svg",
"name": "Integrator Fee"
},
"type": "protocol"
},
{
"action": {
"destinationGasConsumption": "0",
"fromAddress": "0x1231DEB6f5749EF6cE6943a275A1D3E7486F4EaE",
"fromAmount": "99750000",
"fromChainId": 1,
"fromToken": {
"address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"chainId": 1,
"coinKey": "USDC",
"decimals": 6,
"logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png",
"name": "USD Coin",
"priceUSD": "1.0002350525",
"symbol": "USDC",
"tags": [
"stablecoin"
],
"verificationStatus": "verified",
"verificationStatusBreakdown": [
{
"provider": "hypernative",
"providerResult": "accept",
"result": "verified"
}
]
},
"slippage": 0.005,
"toAddress": "0x552008c0f6870c2f77e5cC1d2eb9bdff03e30Ea0",
"toChainId": 10,
"toToken": {
"address": "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85",
"chainId": 10,
"coinKey": "USDC",
"decimals": 6,
"logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png",
"name": "USD Coin",
"priceUSD": "1.0008373187",
"symbol": "USDC",
"tags": [
"stablecoin"
],
"verificationStatus": "verified",
"verificationStatusBreakdown": [
{
"provider": "hypernative",
"providerResult": "accept",
"result": "verified"
}
]
}
},
"estimate": {
"approvalAddress": "0x5c7BCd6E7De5423a257D81B442095A1a6ced35C5",
"executionDuration": 2,
"feeCosts": [
{
"amount": "9975",
"amountUSD": "0.0100",
"description": "The fee taken by the relayer",
"included": true,
"name": "Relayer fee",
"percentage": "0.000100",
"token": {
"address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"chainId": 1,
"coinKey": "USDC",
"decimals": 6,
"logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png",
"name": "USD Coin",
"priceUSD": "1.0002350525",
"symbol": "USDC",
"tags": [
"stablecoin"
],
"verificationStatus": "verified",
"verificationStatusBreakdown": [
{
"provider": "hypernative",
"providerResult": "accept",
"result": "verified"
}
]
}
},
{
"amount": "296",
"amountUSD": "0.0003",
"description": "The gas fee taken by the relayer",
"included": true,
"name": "Relayer gas fee",
"percentage": "0.000003",
"token": {
"address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"chainId": 1,
"coinKey": "USDC",
"decimals": 6,
"logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png",
"name": "USD Coin",
"priceUSD": "1.0002350525",
"symbol": "USDC",
"tags": [
"stablecoin"
],
"verificationStatus": "verified",
"verificationStatusBreakdown": [
{
"provider": "hypernative",
"providerResult": "accept",
"result": "verified"
}
]
}
}
],
"fromAmount": "99750000",
"gasCosts": [
{
"amount": "4084152986000",
"amountUSD": "0.0094",
"estimate": "86000",
"limit": "111800",
"price": "47490151",
"token": {
"address": "0x0000000000000000000000000000000000000000",
"chainId": 1,
"coinKey": "ETH",
"decimals": 18,
"logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2/logo.png",
"name": "ETH",
"priceUSD": "2308.14",
"symbol": "ETH",
"tags": [
"major_asset"
],
"verificationStatus": "verified",
"verificationStatusBreakdown": [
{
"provider": "hypernative",
"providerResult": "accept",
"result": "verified"
}
]
},
"type": "SEND"
}
],
"toAmount": "99739729",
"toAmountMin": "99739729",
"tool": "across"
},
"id": "3b546a28-939c-406b-a8b1-62214f3f69c8",
"tool": "across",
"toolDetails": {
"key": "across",
"logoURI": "https://raw.githubusercontent.com/lifinance/types/main/src/assets/icons/bridges/across.svg",
"name": "AcrossV4"
},
"type": "cross"
}
],
"integrator": "lifi-api",
"recommendedSlippage": 0.01099856322858362,
"tool": "across",
"toolDetails": {
"key": "across",
"logoURI": "https://raw.githubusercontent.com/lifinance/types/main/src/assets/icons/bridges/across.svg",
"name": "AcrossV4"
},
"type": "lifi"
}'
```
## API contract
```json
{
"resource_type": "api",
"name": "LI.FI — Populate a step with transaction data",
"endpoint": "https://api.openany.si/v1/agent-apis/lifi/v1/advanced/stepTransaction",
"method": "POST",
"content_type": "application/json",
"execution_mode": "sync",
"authentication": {
"type": "bearer",
"environment_variable": "OPENANY_API_KEY"
},
"inputs": [
{
"description": "One to 100 AMM pool or Solana venue identifiers to exclude when building transaction data. If the route was requested with `options.pools.deny`, you must pass the same list again for each step: pool exclusions are request-scoped and are not carried in the returned Step. Without it, swaps are re-quoted with no exclusions, so the transaction can use an excluded pool or venue. Repeat the query parameter for multiple entries, as with `/v1/quote`. Each entry is a non-zero Uniswap V2/V3 EVM pool address (`0x` + 40 hex), a Uniswap V4 `-` identifier, where `poolId` is `0x` + 64 hex, or a Solana venue program ID (base58). EVM pool exclusion is supported only by `fly`; Solana venue exclusion only by `jupiter`, `titan` and `okx`. If the list holds a Solana program ID, a step that swaps on Solana through any other exchange is rejected with a 400 error instead of being built without the exclusion. Keep the Step object in the JSON request body.",
"item_type": "string",
"location": "query",
"name": "denyPools",
"nullable": false,
"required": false,
"type": "array"
},
{
"description": "Parameter to skip transaction simulation. The quote will be returned faster but the transaction gas limit won't be accurate.",
"location": "query",
"name": "skipSimulation",
"nullable": false,
"required": false,
"type": "boolean"
},
{
"description": "Mayan specific option to bridge from non-EVM chain to Hyperliquid",
"location": "query",
"name": "mayanNonEvmPermitSignature",
"nullable": false,
"required": false,
"type": "boolean"
},
{
"description": "Maximum Solana transaction version the client can sign. Defaults to 0; omission or null uses v0. Set to 1 to allow V1 where enabled for the environment. Jito requests always use v0. Size overflow may fall back to v0. Read transactionRequest.svmTransactionVersion for the version actually built. Ignored for source chains other than Solana.",
"enum_values": [
"0",
"1"
],
"location": "query",
"name": "svmMaxSupportedTransactionVersion",
"nullable": true,
"required": false,
"type": "number"
},
{
"description": "Priority fee level for Solana Virtual Machine (SVM) transactions.",
"enum_values": [
"NORMAL",
"FAST",
"ULTRA"
],
"location": "query",
"name": "svmPriorityFeeLevel",
"nullable": false,
"required": false,
"type": "string"
},
{
"description": "Object that represents one step of a `Route`",
"json_schema": {
"description": "Object that represents one step of a `Route`",
"example": {
"action": {
"fromAmount": "1000000000000000000",
"fromChainId": 100,
"fromToken": {
"address": "0x63e62989d9eb2d37dfdb1f93a22f063635b07d51",
"chainId": 100,
"coinKey": "MIVA",
"decimals": 18,
"logoURI": "",
"name": "Minerva Wallet SuperToken",
"priceUSD": "0.04547537276751318",
"symbol": "MIVA"
},
"slippage": 0.003,
"toChainId": 137,
"toToken": {
"address": "0xc0b2983a17573660053beeed6fdb1053107cf387",
"chainId": 137,
"coinKey": "MIVA",
"decimals": 18,
"logoURI": "",
"name": "Minerva Wallet SuperToken",
"priceUSD": "0",
"symbol": "MIVA"
}
},
"estimate": {
"approvalAddress": "0x115909BDcbaB21954bEb4ab65FC2aBEE9866fa93",
"data": {
"bid": {
"amount": "1000000000000000000",
"amountReceived": "999500000000000000",
"bidExpiry": 1643105290,
"callDataHash": "0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470",
"callTo": "0x0000000000000000000000000000000000000000",
"encryptedCallData": "0x",
"expiry": 1643364189,
"initiator": "0x53F68B2186E4a4aB4dD976eD32de68db45BA360b",
"receivingAddress": "0x10fBFF9b9450D3A2d9d1612d6dE3726fACD8809E",
"receivingAssetId": "0xc0b2983a17573660053beeed6fdb1053107cf387",
"receivingChainId": 137,
"receivingChainTxManagerAddress": "0x6090De2EC76eb1Dc3B5d632734415c93c44Fd113",
"router": "0xeE2Ef40F688607CB23618d9312d62392786d13EB",
"sendingAssetId": "0x63e62989d9eb2d37dfdb1f93a22f063635b07d51",
"sendingChainId": 100,
"sendingChainTxManagerAddress": "0x115909BDcbaB21954bEb4ab65FC2aBEE9866fa93",
"transactionId": "0x48f0a2f93b0d0a9dab992d07c46bca38516c945101e8f8e08ca42af05b9e6aa9",
"user": "0x53F68B2186E4a4aB4dD976eD32de68db45BA360b"
},
"gasFeeInReceivingToken": "0",
"metaTxRelayerFee": "0",
"routerFee": "500000000000000",
"totalFee": "500000000000000"
},
"feeCosts": [
{
"amount": "0",
"amountUSD": "0.00",
"description": "Covers gas expense for sending funds to user on receiving chain.",
"included": true,
"name": "Gas Fee",
"percentage": "0",
"token": {
"address": "0x63e62989d9eb2d37dfdb1f93a22f063635b07d51",
"chainId": 100,
"coinKey": "MIVA",
"decimals": 18,
"logoURI": "",
"name": "Minerva Wallet SuperToken",
"priceUSD": "0.04547537276751318",
"symbol": "MIVA"
}
},
{
"amount": "0",
"amountUSD": "0.00",
"description": "Covers gas expense for claiming user funds on receiving chain.",
"included": true,
"name": "Relay Fee",
"percentage": "0",
"token": {
"address": "0x63e62989d9eb2d37dfdb1f93a22f063635b07d51",
"chainId": 100,
"coinKey": "MIVA",
"decimals": 18,
"logoURI": "",
"name": "Minerva Wallet SuperToken",
"priceUSD": "0.04547537276751318",
"symbol": "MIVA"
}
},
{
"amount": "500000000000000",
"amountUSD": "0.00",
"description": "Router service fee.",
"included": true,
"name": "Router Fee",
"percentage": "0.0005",
"token": {
"address": "0x63e62989d9eb2d37dfdb1f93a22f063635b07d51",
"chainId": 100,
"coinKey": "MIVA",
"decimals": 18,
"logoURI": "",
"name": "Minerva Wallet SuperToken",
"priceUSD": "0.04547537276751318",
"symbol": "MIVA"
}
}
],
"fromAmount": "1000000000000000000",
"gasCosts": [
{
"amount": "176400000000000",
"amountUSD": "0.00",
"estimate": "140000",
"limit": "175000",
"price": "1260000000",
"token": {
"address": "0x0000000000000000000000000000000000000000",
"chainId": 100,
"coinKey": "xDai",
"decimals": 18,
"logoURI": "https://static.debank.com/image/xdai_token/logo_url/xdai/1207e67652b691ef3bfe04f89f4b5362.png",
"name": "xDai",
"priceUSD": "1",
"symbol": "xDai"
},
"type": "SEND"
}
],
"toAmount": "999500000000000000",
"toAmountMin": "999500000000000000"
},
"id": "0x48f0a2f93b0d0a9dab992d07c46bca38516c945101e8f8e08ca42af05b9e6aa9",
"integrator": "fee-demo",
"tool": "relay",
"type": "cross"
},
"properties": {
"action": {
"description": "The action of the step",
"example": {
"fromAmount": "1000000000000000000",
"fromChainId": 100,
"fromToken": {
"address": "0x63e62989d9eb2d37dfdb1f93a22f063635b07d51",
"chainId": 100,
"coinKey": "MIVA",
"decimals": 18,
"logoURI": "",
"name": "Minerva Wallet SuperToken",
"priceUSD": "0.0455272371751059",
"symbol": "MIVA"
},
"slippage": 0.003,
"toChainId": 137,
"toToken": {
"address": "0xc0b2983a17573660053beeed6fdb1053107cf387",
"chainId": 137,
"coinKey": "MIVA",
"decimals": 18,
"logoURI": "",
"name": "Minerva Wallet SuperToken",
"priceUSD": "0",
"symbol": "MIVA"
}
},
"properties": {
"fromAddress": {
"description": "The sending wallet address",
"type": "string"
},
"fromAmount": {
"description": "The amount that should be transferred including all decimals",
"type": "string"
},
"fromChainId": {
"description": "The id of the chain where the transfer should start",
"format": "number",
"type": "number"
},
"fromToken": {
"description": "The sending token",
"example": {
"address": "0x8f3cf7ad23cd3cadbd9735aff958023239c6a063",
"chainId": 137,
"coinKey": "DAI",
"decimals": 18,
"logoURI": "https://static.debank.com/image/matic_token/logo_url/0x8f3cf7ad23cd3cadbd9735aff958023239c6a063/549c4205dbb199f1b8b03af783f35e71.png",
"name": "(PoS) Dai Stablecoin",
"priceUSD": "1",
"symbol": "DAI"
},
"properties": {
"address": {
"description": "Address of the token",
"type": "string"
},
"chainId": {
"description": "Id of the token's chain",
"format": "number",
"type": "number"
},
"coinKey": {
"description": "Identifier for the token",
"type": "string"
},
"decimals": {
"description": "Number of decimals the token uses",
"format": "number",
"type": "number"
},
"logoURI": {
"description": "Logo of the token",
"type": "string"
},
"name": {
"description": "Name of the token",
"type": "string"
},
"priceUSD": {
"description": "Token price in USD",
"type": "string"
},
"symbol": {
"description": "Symbol of the token",
"type": "string"
}
},
"required": [
"address",
"chainId",
"decimals",
"name",
"symbol"
],
"title": "Root Type for Token",
"type": "object"
},
"slippage": {
"description": "The maximum allowed slippage",
"format": "double",
"type": "number"
},
"toAddress": {
"description": "The receiving wallet address",
"type": "string"
},
"toChainId": {
"description": "The id of the chain where the transfer should end",
"format": "number",
"type": "number"
},
"toToken": {
"description": "The token that should be transferred to",
"example": {
"address": "0x8f3cf7ad23cd3cadbd9735aff958023239c6a063",
"chainId": 137,
"coinKey": "DAI",
"decimals": 18,
"logoURI": "https://static.debank.com/image/matic_token/logo_url/0x8f3cf7ad23cd3cadbd9735aff958023239c6a063/549c4205dbb199f1b8b03af783f35e71.png",
"name": "(PoS) Dai Stablecoin",
"priceUSD": "1",
"symbol": "DAI"
},
"properties": {
"address": {
"description": "Address of the token",
"type": "string"
},
"chainId": {
"description": "Id of the token's chain",
"format": "number",
"type": "number"
},
"coinKey": {
"description": "Identifier for the token",
"type": "string"
},
"decimals": {
"description": "Number of decimals the token uses",
"format": "number",
"type": "number"
},
"logoURI": {
"description": "Logo of the token",
"type": "string"
},
"name": {
"description": "Name of the token",
"type": "string"
},
"priceUSD": {
"description": "Token price in USD",
"type": "string"
},
"symbol": {
"description": "Symbol of the token",
"type": "string"
}
},
"required": [
"address",
"chainId",
"decimals",
"name",
"symbol"
],
"title": "Root Type for Token",
"type": "object"
}
},
"required": [
"fromToken",
"fromAmount",
"fromChainId",
"toChainId",
"toToken"
],
"title": "Root Type for Action",
"type": "object"
},
"estimate": {
"description": "The estimation for the step",
"example": {
"approvalAddress": "0x1231DEB6f5749EF6cE6943a275A1D3E7486F4EaE",
"executionDuration": 2,
"feeCosts": [
{
"amount": "125000",
"amountUSD": "0.1249",
"description": "Fixed LIFI fee, independent of any other fee",
"included": true,
"name": "LIFI Fixed Fee",
"percentage": "0.0025",
"token": {
"address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"chainId": 1,
"coinKey": "USDC",
"decimals": 6,
"logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png",
"name": "USD Coin",
"priceUSD": "0.999578177",
"symbol": "USDC"
}
},
{
"amount": "1116",
"amountUSD": "0.0011",
"description": "Relay bridge gas fee",
"included": true,
"name": "Relayer Gas fee",
"percentage": "0.0000",
"token": {
"address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"chainId": 1,
"coinKey": "USDC",
"decimals": 6,
"logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png",
"name": "USD Coin",
"priceUSD": "0.999578177",
"symbol": "USDC"
}
},
{
"amount": "53822",
"amountUSD": "0.0538",
"description": "Relay bridge service fee",
"included": true,
"name": "Relayer Service fee",
"percentage": "0.0011",
"token": {
"address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"chainId": 1,
"coinKey": "USDC",
"decimals": 6,
"logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png",
"name": "USD Coin",
"priceUSD": "0.999578177",
"symbol": "USDC"
}
}
],
"fromAmount": "50000000",
"fromAmountUSD": "49.9789",
"gasCosts": [
{
"amount": "58967170938000",
"amountUSD": "0.1156",
"estimate": "459000",
"limit": "596700",
"price": "128468782",
"token": {
"address": "0x0000000000000000000000000000000000000000",
"chainId": 1,
"coinKey": "ETH",
"decimals": 18,
"logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2/logo.png",
"name": "ETH",
"priceUSD": "1959.83",
"symbol": "ETH"
},
"type": "SEND"
}
],
"toAmount": "76673",
"toAmountMin": "76290",
"toAmountUSD": "50.0577",
"tool": "relaydepository"
},
"properties": {
"approvalAddress": {
"description": "The contract address for the approval",
"type": "string"
},
"data": {
"description": "Arbitrary data that depends on the the used tool",
"properties": {
"bid": {
"properties": {
"amount": {
"type": "string"
},
"amountReceived": {
"type": "string"
},
"bidExpiry": {
"format": "number",
"type": "number"
},
"callDataHash": {
"type": "string"
},
"callTo": {
"type": "string"
},
"encryptedCallData": {
"type": "string"
},
"expiry": {
"format": "number",
"type": "number"
},
"initiator": {
"type": "string"
},
"receivingAddress": {
"type": "string"
},
"receivingAssetId": {
"type": "string"
},
"receivingChainId": {
"format": "number",
"type": "number"
},
"receivingChainTxManagerAddress": {
"type": "string"
},
"router": {
"type": "string"
},
"sendingAssetId": {
"type": "string"
},
"sendingChainId": {
"format": "number",
"type": "number"
},
"sendingChainTxManagerAddress": {
"type": "string"
},
"transactionId": {
"type": "string"
},
"user": {
"type": "string"
}
},
"type": "object"
},
"bidSignature": {
"type": "string"
},
"gasFeeInReceivingToken": {
"type": "string"
},
"metaTxRelayerFee": {
"type": "string"
},
"routerFee": {
"type": "string"
},
"totalFee": {
"type": "string"
}
},
"type": "object"
},
"executionDuration": {
"description": "The time needed to complete the following step",
"type": "number"
},
"feeCosts": {
"description": "Fees charged on the transfer. On a `lifi` step this array is the concatenation of the fee costs of every entry in `includedSteps`, so it already contains them. Do not add both together.",
"items": {
"description": "A protocol, integrator, or execution fee charged on the transfer. Fee costs cover everything that is charged as a fee rather than paid as network gas by the sender, including destination execution costs that a bridge or solver bills as a fee. See [Gas costs and fee costs](https://docs.li.fi/guides/gas-and-fee-costs) for how to read and display these values.",
"example": {
"amount": "1116",
"amountUSD": "0.0011",
"description": "Relay bridge gas fee",
"included": true,
"name": "Relayer Gas fee",
"percentage": "0.0000",
"token": {
"address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"chainId": 1,
"coinKey": "USDC",
"decimals": 6,
"logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png",
"name": "USD Coin",
"priceUSD": "0.999578177",
"symbol": "USDC"
}
},
"properties": {
"amount": {
"description": "The fee amount in the smallest unit of `token`, before decimals are applied. Divide by `10 ** token.decimals` for a human-readable amount.",
"type": "string"
},
"amountUSD": {
"description": "The amount of fees in USD",
"type": "string"
},
"description": {
"description": "Description of the fee costs",
"type": "string"
},
"feeSplit": {
"description": "Response-only breakdown of this fee entry's `amount` into the parties that share it. Returned for the LI.FI/integrator fee entry and for a separate `Distributions` entry when distributions are present; omitted for fees such as a relayer or bridge gas fee.\nFor the LI.FI/integrator entry, `lifiFee`, `integratorFee`, and `intermediaryFee` (when present) are disjoint slices of its `amount`. For the `Distributions` entry, `lifiFee` and `integratorFee` are both \"0\"; its `amount` is the sum of its distribution recipients. `recipients[]` describes only the parent fee entry. It is a breakdown of that entry's `amount`, not an additional charge.\nThis field is returned, not accepted: the API ignores a `feeSplit` posted in a request body, so integrations must read the split from the response instead of echoing back a previously quoted one.",
"properties": {
"integratorFee": {
"description": "The integrator's slice of `amount`, in the smallest unit of `token`. It excludes intermediary fees (reported separately as `intermediaryFee`) and distributions (reported in a separate `Distributions` fee entry). It is \"0\" on the `Distributions` entry.",
"type": "string"
},
"intermediaryFee": {
"description": "The intermediary's slice of `amount`, in the smallest unit of `token`. Present only when an intermediary participates in the split.",
"type": "string"
},
"lifiFee": {
"description": "LI.FI's slice of `amount`, in the smallest unit of `token`.",
"type": "string"
},
"recipients": {
"description": "Per-recipient breakdown of this fee entry's `amount`. The LI.FI/integrator entry lists its own recipients, excluding partner-specified distributions. Those are listed in the separate `Distributions` entry's own `feeSplit.recipients[]`, with type `DISTRIBUTION` and one record per distribution.",
"items": {
"description": "One party receiving a share of this fee entry.",
"properties": {
"fee": {
"description": "The amount credited to this recipient, in the smallest unit of this fee entry's `token`.",
"type": "string"
},
"name": {
"description": "Recipient identifier, to be read together with `type`: `lifi` for the LI.FI platform recipient, the integrator id for the integrator's own fee, the intermediary id for an `INTERMEDIARY` entry, or the recipient wallet address for a `DISTRIBUTION` entry. Do not render it directly in a user-facing UI without type-aware formatting.",
"type": "string"
},
"type": {
"description": "How this recipient's fee was calculated. Currently one of `FIXED`, `SHARED`, `DYNAMIC`, `INTERMEDIARY`, or `DISTRIBUTION`, and deliberately not modelled as an enum because the set can grow without a breaking change. May be absent when the calculation type cannot be determined statically, so null-check before reading and keep a default branch when matching on it.\n`FIXED` and `SHARED` are the standard fee models. `DYNAMIC` means LI.FI resolved its rate for this quote under approved Dynamic Pricing, so the same integration can report a different rate on another quote. `INTERMEDIARY` marks a third-party recipient carving a configured share, and `DISTRIBUTION` marks a partner-specified recipient within the separate `Distributions` fee entry's own `feeSplit.recipients[]`.\nTo detect Dynamic Pricing on a quote, look for a recipient whose `type` is `DYNAMIC`.",
"type": "string"
},
"walletAddress": {
"description": "The recipient's wallet address on the source chain.",
"type": "string"
}
},
"required": [
"name",
"fee"
],
"title": "Root Type for FeeRecipient",
"type": "object"
},
"type": "array"
}
},
"type": "object"
},
"included": {
"description": "`true` means the fee is already accounted for in the quoted amounts and must not be added again as a separate user payment. `false` means the user pays it on top of `fromAmount`.",
"type": "boolean"
},
"name": {
"description": "Human-readable name of the fee, for example `LIFI Fixed Fee` or `Relayer Gas fee`. Names are tool-specific free text and are not a stable enum. Do not branch on this value.",
"type": "string"
},
"percentage": {
"description": "The fee expressed as a fraction of the transferred amount, for example `0.0025` for 0.25%. A fee whose name contains `Fixed` may still report a non-zero fraction; do not infer the fee model from `name` or assume fixed-fee entries report `0`.",
"type": "string"
},
"token": {
"description": "The `Token` the fee is denominated in. `token.chainId` identifies the chain of that token, not necessarily the chain where the underlying work happens. A destination execution fee is commonly denominated in the source-chain token the user is already sending.",
"example": {
"address": "0x8f3cf7ad23cd3cadbd9735aff958023239c6a063",
"chainId": 137,
"coinKey": "DAI",
"decimals": 18,
"logoURI": "https://static.debank.com/image/matic_token/logo_url/0x8f3cf7ad23cd3cadbd9735aff958023239c6a063/549c4205dbb199f1b8b03af783f35e71.png",
"name": "(PoS) Dai Stablecoin",
"priceUSD": "1",
"symbol": "DAI"
},
"properties": {
"address": {
"description": "Address of the token",
"type": "string"
},
"chainId": {
"description": "Id of the token's chain",
"format": "number",
"type": "number"
},
"coinKey": {
"description": "Identifier for the token",
"type": "string"
},
"decimals": {
"description": "Number of decimals the token uses",
"format": "number",
"type": "number"
},
"logoURI": {
"description": "Logo of the token",
"type": "string"
},
"name": {
"description": "Name of the token",
"type": "string"
},
"priceUSD": {
"description": "Token price in USD",
"type": "string"
},
"symbol": {
"description": "Symbol of the token",
"type": "string"
}
},
"required": [
"address",
"chainId",
"decimals",
"name",
"symbol"
],
"title": "Root Type for Token",
"type": "object"
}
},
"required": [
"token",
"percentage",
"name",
"amountUSD",
"included"
],
"title": "Root Type for FeeCost",
"type": "object"
},
"type": "array"
},
"fromAmount": {
"description": "The amount that should be transferred including all decimals",
"type": "string"
},
"fromAmountUSD": {
"description": "The amount that should be transferred in USD equivalent",
"type": "string"
},
"gasCosts": {
"description": "Estimated network gas for the transfer. On a `lifi` step this is a single estimate for the transaction that is actually submitted. It aggregates raw gas costs from source-chain entries in `includedSteps` and, for EVM transactions, adds estimated LI.FI contract overhead. It may differ from and often exceed the sum of the source-chain per-step entries. Raw destination-chain gas costs are not added directly. Do not add the top-level and included-step arrays together.",
"items": {
"description": "An estimate of the network gas the sender pays for a transaction. Gas costs are always denominated in the native gas token of the chain the transaction is sent on. See [Gas costs and fee costs](https://docs.li.fi/guides/gas-and-fee-costs) for how gas costs relate to `feeCosts` and to destination-chain execution.",
"example": {
"amount": "58967170938000",
"amountUSD": "0.1156",
"estimate": "459000",
"limit": "596700",
"price": "128468782",
"token": {
"address": "0x0000000000000000000000000000000000000000",
"chainId": 1,
"coinKey": "ETH",
"decimals": 18,
"logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2/logo.png",
"name": "ETH",
"priceUSD": "1959.83",
"symbol": "ETH"
},
"type": "SEND"
},
"properties": {
"amount": {
"description": "The estimated total gas cost in the smallest unit of the gas token. For EVM entries this is `estimate` multiplied by `price`. Other ecosystems may use chain-specific units and rounding, so consumers should treat `amount` as authoritative rather than reconstructing it from the other fields. Divide by `10 ** token.decimals` for a human-readable amount.",
"type": "string"
},
"amountUSD": {
"description": "Amount of the gas cost in USD",
"type": "string"
},
"estimate": {
"description": "Estimated units of gas the transaction consumes",
"type": "string"
},
"limit": {
"description": "Suggested gas limit: `estimate` plus a safety buffer. Use this value when submitting the transaction, not `estimate`.",
"type": "string"
},
"price": {
"description": "Gas price used for the estimate, in the smallest unit of the gas token per unit of gas (wei per gas on EVM chains).",
"type": "string"
},
"token": {
"description": "The native gas token of the chain the transaction is sent on. `token.chainId` is the chain that consumes the gas.",
"example": {
"address": "0x8f3cf7ad23cd3cadbd9735aff958023239c6a063",
"chainId": 137,
"coinKey": "DAI",
"decimals": 18,
"logoURI": "https://static.debank.com/image/matic_token/logo_url/0x8f3cf7ad23cd3cadbd9735aff958023239c6a063/549c4205dbb199f1b8b03af783f35e71.png",
"name": "(PoS) Dai Stablecoin",
"priceUSD": "1",
"symbol": "DAI"
},
"properties": {
"address": {
"description": "Address of the token",
"type": "string"
},
"chainId": {
"description": "Id of the token's chain",
"format": "number",
"type": "number"
},
"coinKey": {
"description": "Identifier for the token",
"type": "string"
},
"decimals": {
"description": "Number of decimals the token uses",
"format": "number",
"type": "number"
},
"logoURI": {
"description": "Logo of the token",
"type": "string"
},
"name": {
"description": "Name of the token",
"type": "string"
},
"priceUSD": {
"description": "Token price in USD",
"type": "string"
},
"symbol": {
"description": "Symbol of the token",
"type": "string"
}
},
"required": [
"address",
"chainId",
"decimals",
"name",
"symbol"
],
"title": "Root Type for Token",
"type": "object"
},
"type": {
"description": "The kind of gas cost this entry represents.\n\n- `SEND`: estimated network gas for the transaction the sender submits, normally on the source chain. This is the only value the API currently returns.\n- `APPROVE`: estimated network gas for a separate ERC-20 approval transaction. Reserved; approval gas is not currently returned as its own entry.\n- `FEE`: an execution cost charged as a fee rather than as a transaction the user signs. Reserved; such costs are currently reported in `feeCosts` instead.\n- `SUM`: an aggregate of the other entries. Reserved and not currently returned.\n\nTreat `APPROVE`, `FEE`, and `SUM` as forward-compatible values: handle them if they appear, but do not build a flow that depends on them.",
"enum": [
"SUM",
"APPROVE",
"SEND",
"FEE"
],
"example": "SEND",
"type": "string"
}
},
"required": [
"token",
"type",
"amount"
],
"title": "Root Type for GasCost",
"type": "object"
},
"type": "array"
},
"skipApproval": {
"description": "Optional flag indicating that this step needs no token approval, because the executing contract moves funds under the authorization already carried by the signed transaction or message.",
"type": "boolean"
},
"toAmount": {
"description": "The estimated resulting amount of the `toToken` including all decimals",
"type": "string"
},
"toAmountMin": {
"description": "The minimal outcome of the transfer including all decimals. It may reflect applicable slippage and known fee-on-transfer tax adjustments.",
"type": "string"
},
"toAmountUSD": {
"description": "The estimated resulting amount of the `toToken` in USD equivalent",
"type": "string"
},
"tool": {
"description": "The tools that is being used for this step",
"type": "string"
}
},
"required": [
"fromAmount",
"approvalAddress",
"toAmount",
"toAmountMin",
"tool",
"executionDuration"
],
"title": "Root Type for Estimate",
"type": "object"
},
"execution": {
"description": "An objection containing status information about the execution"
},
"id": {
"description": "Unique identifier of the step",
"example": "f7623b70-2446-47a7-a306-2f67fa59301f:0",
"type": "string"
},
"includedSteps": {
"items": {
"description": "Object that represents one step of an `IncludedSteps` array in `Route`",
"properties": {
"action": {
"description": "Object describing what happens in a `Step`",
"example": {
"fromAmount": "1000000000000000000",
"fromChainId": 100,
"fromToken": {
"address": "0x63e62989d9eb2d37dfdb1f93a22f063635b07d51",
"chainId": 100,
"coinKey": "MIVA",
"decimals": 18,
"logoURI": "",
"name": "Minerva Wallet SuperToken",
"priceUSD": "0.0455272371751059",
"symbol": "MIVA"
},
"slippage": 0.003,
"toChainId": 137,
"toToken": {
"address": "0xc0b2983a17573660053beeed6fdb1053107cf387",
"chainId": 137,
"coinKey": "MIVA",
"decimals": 18,
"logoURI": "",
"name": "Minerva Wallet SuperToken",
"priceUSD": "0",
"symbol": "MIVA"
}
},
"properties": {
"fromAddress": {
"description": "The sending wallet address",
"type": "string"
},
"fromAmount": {
"description": "The amount that should be transferred including all decimals",
"type": "string"
},
"fromChainId": {
"description": "The id of the chain where the transfer should start",
"format": "number",
"type": "number"
},
"fromToken": {
"description": "The sending token",
"example": {
"address": "0x8f3cf7ad23cd3cadbd9735aff958023239c6a063",
"chainId": 137,
"coinKey": "DAI",
"decimals": 18,
"logoURI": "https://static.debank.com/image/matic_token/logo_url/0x8f3cf7ad23cd3cadbd9735aff958023239c6a063/549c4205dbb199f1b8b03af783f35e71.png",
"name": "(PoS) Dai Stablecoin",
"priceUSD": "1",
"symbol": "DAI"
},
"properties": {
"address": {
"description": "Address of the token",
"type": "string"
},
"chainId": {
"description": "Id of the token's chain",
"format": "number",
"type": "number"
},
"coinKey": {
"description": "Identifier for the token",
"type": "string"
},
"decimals": {
"description": "Number of decimals the token uses",
"format": "number",
"type": "number"
},
"logoURI": {
"description": "Logo of the token",
"type": "string"
},
"name": {
"description": "Name of the token",
"type": "string"
},
"priceUSD": {
"description": "Token price in USD",
"type": "string"
},
"symbol": {
"description": "Symbol of the token",
"type": "string"
}
},
"required": [
"address",
"chainId",
"decimals",
"name",
"symbol"
],
"title": "Root Type for Token",
"type": "object"
},
"slippage": {
"description": "The maximum allowed slippage",
"format": "double",
"type": "number"
},
"toAddress": {
"description": "The receiving wallet address",
"type": "string"
},
"toChainId": {
"description": "The id of the chain where the transfer should end",
"format": "number",
"type": "number"
},
"toToken": {
"description": "The token that should be transferred to",
"example": {
"address": "0x8f3cf7ad23cd3cadbd9735aff958023239c6a063",
"chainId": 137,
"coinKey": "DAI",
"decimals": 18,
"logoURI": "https://static.debank.com/image/matic_token/logo_url/0x8f3cf7ad23cd3cadbd9735aff958023239c6a063/549c4205dbb199f1b8b03af783f35e71.png",
"name": "(PoS) Dai Stablecoin",
"priceUSD": "1",
"symbol": "DAI"
},
"properties": {
"address": {
"description": "Address of the token",
"type": "string"
},
"chainId": {
"description": "Id of the token's chain",
"format": "number",
"type": "number"
},
"coinKey": {
"description": "Identifier for the token",
"type": "string"
},
"decimals": {
"description": "Number of decimals the token uses",
"format": "number",
"type": "number"
},
"logoURI": {
"description": "Logo of the token",
"type": "string"
},
"name": {
"description": "Name of the token",
"type": "string"
},
"priceUSD": {
"description": "Token price in USD",
"type": "string"
},
"symbol": {
"description": "Symbol of the token",
"type": "string"
}
},
"required": [
"address",
"chainId",
"decimals",
"name",
"symbol"
],
"title": "Root Type for Token",
"type": "object"
}
},
"required": [
"fromToken",
"fromAmount",
"fromChainId",
"toChainId",
"toToken"
],
"title": "Root Type for Action",
"type": "object"
},
"estimate": {
"description": "An estimate for the current transfer",
"example": {
"approvalAddress": "0x1231DEB6f5749EF6cE6943a275A1D3E7486F4EaE",
"executionDuration": 2,
"feeCosts": [
{
"amount": "125000",
"amountUSD": "0.1249",
"description": "Fixed LIFI fee, independent of any other fee",
"included": true,
"name": "LIFI Fixed Fee",
"percentage": "0.0025",
"token": {
"address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"chainId": 1,
"coinKey": "USDC",
"decimals": 6,
"logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png",
"name": "USD Coin",
"priceUSD": "0.999578177",
"symbol": "USDC"
}
},
{
"amount": "1116",
"amountUSD": "0.0011",
"description": "Relay bridge gas fee",
"included": true,
"name": "Relayer Gas fee",
"percentage": "0.0000",
"token": {
"address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"chainId": 1,
"coinKey": "USDC",
"decimals": 6,
"logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png",
"name": "USD Coin",
"priceUSD": "0.999578177",
"symbol": "USDC"
}
},
{
"amount": "53822",
"amountUSD": "0.0538",
"description": "Relay bridge service fee",
"included": true,
"name": "Relayer Service fee",
"percentage": "0.0011",
"token": {
"address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"chainId": 1,
"coinKey": "USDC",
"decimals": 6,
"logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png",
"name": "USD Coin",
"priceUSD": "0.999578177",
"symbol": "USDC"
}
}
],
"fromAmount": "50000000",
"fromAmountUSD": "49.9789",
"gasCosts": [
{
"amount": "58967170938000",
"amountUSD": "0.1156",
"estimate": "459000",
"limit": "596700",
"price": "128468782",
"token": {
"address": "0x0000000000000000000000000000000000000000",
"chainId": 1,
"coinKey": "ETH",
"decimals": 18,
"logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2/logo.png",
"name": "ETH",
"priceUSD": "1959.83",
"symbol": "ETH"
},
"type": "SEND"
}
],
"toAmount": "76673",
"toAmountMin": "76290",
"toAmountUSD": "50.0577",
"tool": "relaydepository"
},
"properties": {
"approvalAddress": {
"description": "The contract address for the approval",
"type": "string"
},
"data": {
"description": "Arbitrary data that depends on the the used tool",
"properties": {
"bid": {
"properties": {
"amount": {
"type": "string"
},
"amountReceived": {
"type": "string"
},
"bidExpiry": {
"format": "number",
"type": "number"
},
"callDataHash": {
"type": "string"
},
"callTo": {
"type": "string"
},
"encryptedCallData": {
"type": "string"
},
"expiry": {
"format": "number",
"type": "number"
},
"initiator": {
"type": "string"
},
"receivingAddress": {
"type": "string"
},
"receivingAssetId": {
"type": "string"
},
"receivingChainId": {
"format": "number",
"type": "number"
},
"receivingChainTxManagerAddress": {
"type": "string"
},
"router": {
"type": "string"
},
"sendingAssetId": {
"type": "string"
},
"sendingChainId": {
"format": "number",
"type": "number"
},
"sendingChainTxManagerAddress": {
"type": "string"
},
"transactionId": {
"type": "string"
},
"user": {
"type": "string"
}
},
"type": "object"
},
"bidSignature": {
"type": "string"
},
"gasFeeInReceivingToken": {
"type": "string"
},
"metaTxRelayerFee": {
"type": "string"
},
"routerFee": {
"type": "string"
},
"totalFee": {
"type": "string"
}
},
"type": "object"
},
"executionDuration": {
"description": "The time needed to complete the following step",
"type": "number"
},
"feeCosts": {
"description": "Fees charged on the transfer. On a `lifi` step this array is the concatenation of the fee costs of every entry in `includedSteps`, so it already contains them. Do not add both together.",
"items": {
"description": "A protocol, integrator, or execution fee charged on the transfer. Fee costs cover everything that is charged as a fee rather than paid as network gas by the sender, including destination execution costs that a bridge or solver bills as a fee. See [Gas costs and fee costs](https://docs.li.fi/guides/gas-and-fee-costs) for how to read and display these values.",
"example": {
"amount": "1116",
"amountUSD": "0.0011",
"description": "Relay bridge gas fee",
"included": true,
"name": "Relayer Gas fee",
"percentage": "0.0000",
"token": {
"address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"chainId": 1,
"coinKey": "USDC",
"decimals": 6,
"logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png",
"name": "USD Coin",
"priceUSD": "0.999578177",
"symbol": "USDC"
}
},
"properties": {
"amount": {
"description": "The fee amount in the smallest unit of `token`, before decimals are applied. Divide by `10 ** token.decimals` for a human-readable amount.",
"type": "string"
},
"amountUSD": {
"description": "The amount of fees in USD",
"type": "string"
},
"description": {
"description": "Description of the fee costs",
"type": "string"
},
"feeSplit": {
"description": "Response-only breakdown of this fee entry's `amount` into the parties that share it. Returned for the LI.FI/integrator fee entry and for a separate `Distributions` entry when distributions are present; omitted for fees such as a relayer or bridge gas fee.\nFor the LI.FI/integrator entry, `lifiFee`, `integratorFee`, and `intermediaryFee` (when present) are disjoint slices of its `amount`. For the `Distributions` entry, `lifiFee` and `integratorFee` are both \"0\"; its `amount` is the sum of its distribution recipients. `recipients[]` describes only the parent fee entry. It is a breakdown of that entry's `amount`, not an additional charge.\nThis field is returned, not accepted: the API ignores a `feeSplit` posted in a request body, so integrations must read the split from the response instead of echoing back a previously quoted one.",
"properties": {
"integratorFee": {
"description": "The integrator's slice of `amount`, in the smallest unit of `token`. It excludes intermediary fees (reported separately as `intermediaryFee`) and distributions (reported in a separate `Distributions` fee entry). It is \"0\" on the `Distributions` entry.",
"type": "string"
},
"intermediaryFee": {
"description": "The intermediary's slice of `amount`, in the smallest unit of `token`. Present only when an intermediary participates in the split.",
"type": "string"
},
"lifiFee": {
"description": "LI.FI's slice of `amount`, in the smallest unit of `token`.",
"type": "string"
},
"recipients": {
"description": "Per-recipient breakdown of this fee entry's `amount`. The LI.FI/integrator entry lists its own recipients, excluding partner-specified distributions. Those are listed in the separate `Distributions` entry's own `feeSplit.recipients[]`, with type `DISTRIBUTION` and one record per distribution.",
"items": {
"description": "One party receiving a share of this fee entry.",
"properties": {
"fee": {
"description": "The amount credited to this recipient, in the smallest unit of this fee entry's `token`.",
"type": "string"
},
"name": {
"description": "Recipient identifier, to be read together with `type`: `lifi` for the LI.FI platform recipient, the integrator id for the integrator's own fee, the intermediary id for an `INTERMEDIARY` entry, or the recipient wallet address for a `DISTRIBUTION` entry. Do not render it directly in a user-facing UI without type-aware formatting.",
"type": "string"
},
"type": {
"description": "How this recipient's fee was calculated. Currently one of `FIXED`, `SHARED`, `DYNAMIC`, `INTERMEDIARY`, or `DISTRIBUTION`, and deliberately not modelled as an enum because the set can grow without a breaking change. May be absent when the calculation type cannot be determined statically, so null-check before reading and keep a default branch when matching on it.\n`FIXED` and `SHARED` are the standard fee models. `DYNAMIC` means LI.FI resolved its rate for this quote under approved Dynamic Pricing, so the same integration can report a different rate on another quote. `INTERMEDIARY` marks a third-party recipient carving a configured share, and `DISTRIBUTION` marks a partner-specified recipient within the separate `Distributions` fee entry's own `feeSplit.recipients[]`.\nTo detect Dynamic Pricing on a quote, look for a recipient whose `type` is `DYNAMIC`.",
"type": "string"
},
"walletAddress": {
"description": "The recipient's wallet address on the source chain.",
"type": "string"
}
},
"required": [
"name",
"fee"
],
"title": "Root Type for FeeRecipient",
"type": "object"
},
"type": "array"
}
},
"type": "object"
},
"included": {
"description": "`true` means the fee is already accounted for in the quoted amounts and must not be added again as a separate user payment. `false` means the user pays it on top of `fromAmount`.",
"type": "boolean"
},
"name": {
"description": "Human-readable name of the fee, for example `LIFI Fixed Fee` or `Relayer Gas fee`. Names are tool-specific free text and are not a stable enum. Do not branch on this value.",
"type": "string"
},
"percentage": {
"description": "The fee expressed as a fraction of the transferred amount, for example `0.0025` for 0.25%. A fee whose name contains `Fixed` may still report a non-zero fraction; do not infer the fee model from `name` or assume fixed-fee entries report `0`.",
"type": "string"
},
"token": {
"description": "The `Token` the fee is denominated in. `token.chainId` identifies the chain of that token, not necessarily the chain where the underlying work happens. A destination execution fee is commonly denominated in the source-chain token the user is already sending.",
"example": {
"address": "0x8f3cf7ad23cd3cadbd9735aff958023239c6a063",
"chainId": 137,
"coinKey": "DAI",
"decimals": 18,
"logoURI": "https://static.debank.com/image/matic_token/logo_url/0x8f3cf7ad23cd3cadbd9735aff958023239c6a063/549c4205dbb199f1b8b03af783f35e71.png",
"name": "(PoS) Dai Stablecoin",
"priceUSD": "1",
"symbol": "DAI"
},
"properties": {
"address": {
"description": "Address of the token",
"type": "string"
},
"chainId": {
"description": "Id of the token's chain",
"format": "number",
"type": "number"
},
"coinKey": {
"description": "Identifier for the token",
"type": "string"
},
"decimals": {
"description": "Number of decimals the token uses",
"format": "number",
"type": "number"
},
"logoURI": {
"description": "Logo of the token",
"type": "string"
},
"name": {
"description": "Name of the token",
"type": "string"
},
"priceUSD": {
"description": "Token price in USD",
"type": "string"
},
"symbol": {
"description": "Symbol of the token",
"type": "string"
}
},
"required": [
"address",
"chainId",
"decimals",
"name",
"symbol"
],
"title": "Root Type for Token",
"type": "object"
}
},
"required": [
"token",
"percentage",
"name",
"amountUSD",
"included"
],
"title": "Root Type for FeeCost",
"type": "object"
},
"type": "array"
},
"fromAmount": {
"description": "The amount that should be transferred including all decimals",
"type": "string"
},
"fromAmountUSD": {
"description": "The amount that should be transferred in USD equivalent",
"type": "string"
},
"gasCosts": {
"description": "Estimated network gas for the transfer. On a `lifi` step this is a single estimate for the transaction that is actually submitted. It aggregates raw gas costs from source-chain entries in `includedSteps` and, for EVM transactions, adds estimated LI.FI contract overhead. It may differ from and often exceed the sum of the source-chain per-step entries. Raw destination-chain gas costs are not added directly. Do not add the top-level and included-step arrays together.",
"items": {
"description": "An estimate of the network gas the sender pays for a transaction. Gas costs are always denominated in the native gas token of the chain the transaction is sent on. See [Gas costs and fee costs](https://docs.li.fi/guides/gas-and-fee-costs) for how gas costs relate to `feeCosts` and to destination-chain execution.",
"example": {
"amount": "58967170938000",
"amountUSD": "0.1156",
"estimate": "459000",
"limit": "596700",
"price": "128468782",
"token": {
"address": "0x0000000000000000000000000000000000000000",
"chainId": 1,
"coinKey": "ETH",
"decimals": 18,
"logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2/logo.png",
"name": "ETH",
"priceUSD": "1959.83",
"symbol": "ETH"
},
"type": "SEND"
},
"properties": {
"amount": {
"description": "The estimated total gas cost in the smallest unit of the gas token. For EVM entries this is `estimate` multiplied by `price`. Other ecosystems may use chain-specific units and rounding, so consumers should treat `amount` as authoritative rather than reconstructing it from the other fields. Divide by `10 ** token.decimals` for a human-readable amount.",
"type": "string"
},
"amountUSD": {
"description": "Amount of the gas cost in USD",
"type": "string"
},
"estimate": {
"description": "Estimated units of gas the transaction consumes",
"type": "string"
},
"limit": {
"description": "Suggested gas limit: `estimate` plus a safety buffer. Use this value when submitting the transaction, not `estimate`.",
"type": "string"
},
"price": {
"description": "Gas price used for the estimate, in the smallest unit of the gas token per unit of gas (wei per gas on EVM chains).",
"type": "string"
},
"token": {
"description": "The native gas token of the chain the transaction is sent on. `token.chainId` is the chain that consumes the gas.",
"example": {
"address": "0x8f3cf7ad23cd3cadbd9735aff958023239c6a063",
"chainId": 137,
"coinKey": "DAI",
"decimals": 18,
"logoURI": "https://static.debank.com/image/matic_token/logo_url/0x8f3cf7ad23cd3cadbd9735aff958023239c6a063/549c4205dbb199f1b8b03af783f35e71.png",
"name": "(PoS) Dai Stablecoin",
"priceUSD": "1",
"symbol": "DAI"
},
"properties": {
"address": {
"description": "Address of the token",
"type": "string"
},
"chainId": {
"description": "Id of the token's chain",
"format": "number",
"type": "number"
},
"coinKey": {
"description": "Identifier for the token",
"type": "string"
},
"decimals": {
"description": "Number of decimals the token uses",
"format": "number",
"type": "number"
},
"logoURI": {
"description": "Logo of the token",
"type": "string"
},
"name": {
"description": "Name of the token",
"type": "string"
},
"priceUSD": {
"description": "Token price in USD",
"type": "string"
},
"symbol": {
"description": "Symbol of the token",
"type": "string"
}
},
"required": [
"address",
"chainId",
"decimals",
"name",
"symbol"
],
"title": "Root Type for Token",
"type": "object"
},
"type": {
"description": "The kind of gas cost this entry represents.\n\n- `SEND`: estimated network gas for the transaction the sender submits, normally on the source chain. This is the only value the API currently returns.\n- `APPROVE`: estimated network gas for a separate ERC-20 approval transaction. Reserved; approval gas is not currently returned as its own entry.\n- `FEE`: an execution cost charged as a fee rather than as a transaction the user signs. Reserved; such costs are currently reported in `feeCosts` instead.\n- `SUM`: an aggregate of the other entries. Reserved and not currently returned.\n\nTreat `APPROVE`, `FEE`, and `SUM` as forward-compatible values: handle them if they appear, but do not build a flow that depends on them.",
"enum": [
"SUM",
"APPROVE",
"SEND",
"FEE"
],
"example": "SEND",
"type": "string"
}
},
"required": [
"token",
"type",
"amount"
],
"title": "Root Type for GasCost",
"type": "object"
},
"type": "array"
},
"skipApproval": {
"description": "Optional flag indicating that this step needs no token approval, because the executing contract moves funds under the authorization already carried by the signed transaction or message.",
"type": "boolean"
},
"toAmount": {
"description": "The estimated resulting amount of the `toToken` including all decimals",
"type": "string"
},
"toAmountMin": {
"description": "The minimal outcome of the transfer including all decimals. It may reflect applicable slippage and known fee-on-transfer tax adjustments.",
"type": "string"
},
"toAmountUSD": {
"description": "The estimated resulting amount of the `toToken` in USD equivalent",
"type": "string"
},
"tool": {
"description": "The tools that is being used for this step",
"type": "string"
}
},
"required": [
"fromAmount",
"approvalAddress",
"toAmount",
"toAmountMin",
"tool",
"executionDuration"
],
"title": "Root Type for Estimate",
"type": "object"
},
"id": {
"description": "Unique identifier of the step",
"type": "string"
},
"tool": {
"description": "The tool used for this step. E.g. `allbridge`",
"type": "string"
},
"toolDetails": {
"description": "The details of the tool used for this step. E.g. `allbridge`",
"properties": {
"key": {
"description": "The tool key",
"type": "string"
},
"logoURI": {
"description": "The tool logo URL",
"type": "string"
},
"name": {
"description": "The tool name",
"type": "string"
}
},
"type": "object"
},
"type": {
"description": "The type of the step. `swap` executes a DEX swap on a single chain, `cross` bridges assets between chains, `lifi` runs LiFi's internal multi-action logic, and `protocol` represents protocol-level actions such as fee collection or vault interactions executed inside LiFi managed contracts.",
"enum": [
"swap",
"cross",
"lifi",
"protocol"
],
"type": "string"
}
},
"required": [
"id",
"action",
"estimate",
"tool",
"type",
"toolDetails"
],
"title": "Root Type for Internal Step",
"type": "object"
},
"type": "array"
},
"integrator": {
"description": "A string containing tracking information about the integrator of the API",
"example": "lifi-api",
"type": "string"
},
"referrer": {
"description": "A string containing tracking information about the referrer of the integrator",
"type": "string"
},
"tool": {
"description": "The tool used for this step. E.g. `relay`",
"example": "across",
"type": "string"
},
"toolDetails": {
"description": "The details of the tool used for this step. E.g. `relay`",
"example": {
"key": "across",
"logoURI": "https://raw.githubusercontent.com/lifinance/types/main/src/assets/icons/bridges/across.svg",
"name": "AcrossV4"
},
"properties": {
"key": {
"description": "The tool key",
"type": "string"
},
"logoURI": {
"description": "The tool logo URL",
"type": "string"
},
"name": {
"description": "The tool name",
"type": "string"
}
},
"type": "object"
},
"transactionRequest": {
"description": "An ether.js TransactionRequest that can be triggered using a wallet provider. (https://docs.ethers.io/v5/api/providers/types/#providers-TransactionRequest) Solana responses also include svmTransactionVersion (0 or 1), the version actually built. This may be lower than the requested maximum.",
"properties": {
"svmTransactionVersion": {
"description": "Solana transaction version actually built; Jito always uses 0.",
"enum": [
0,
1
],
"type": "number"
}
},
"type": "object"
},
"type": {
"description": "The type of the step. `swap` executes a DEX swap on a single chain, `cross` bridges assets between chains, `lifi` runs LiFi's internal multi-action logic, and `protocol` represents protocol-level actions such as fee collection or vault interactions executed inside LiFi managed contracts.",
"enum": [
"swap",
"cross",
"lifi",
"protocol"
],
"example": "lifi",
"type": "string"
}
},
"required": [
"id",
"action",
"tool",
"type"
],
"title": "Root Type for Step",
"type": "object"
},
"location": "body",
"name": "body",
"nullable": false,
"pointer": "",
"required": true,
"type": "object"
}
],
"billing": {
"currency": "USD",
"mode": "fixed",
"priceMicroUsd": "0",
"rounding": null,
"unit": "call",
"unitQuantity": null
},
"examples": [
{
"http_status": 200,
"name": "Documentation example (source abbreviated)",
"request": {
"body": {
"action": {
"fromAddress": "0x552008c0f6870c2f77e5cC1d2eb9bdff03e30Ea0",
"fromAmount": "100000000",
"fromChainId": 1,
"fromToken": {
"address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"chainId": 1,
"coinKey": "USDC",
"decimals": 6,
"logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png",
"name": "USD Coin",
"priceUSD": "1.0002350525",
"symbol": "USDC",
"tags": [
"stablecoin"
],
"verificationStatus": "verified",
"verificationStatusBreakdown": [
{
"provider": "hypernative",
"providerResult": "accept",
"result": "verified"
}
]
},
"slippage": 0.005,
"toAddress": "0x552008c0f6870c2f77e5cC1d2eb9bdff03e30Ea0",
"toChainId": 10,
"toToken": {
"address": "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85",
"chainId": 10,
"coinKey": "USDC",
"decimals": 6,
"logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png",
"name": "USD Coin",
"priceUSD": "1.0008373187",
"symbol": "USDC",
"tags": [
"stablecoin"
],
"verificationStatus": "verified",
"verificationStatusBreakdown": [
{
"provider": "hypernative",
"providerResult": "accept",
"result": "verified"
}
]
}
},
"estimate": {
"approvalAddress": "0x1231DEB6f5749EF6cE6943a275A1D3E7486F4EaE",
"executionDuration": 2,
"feeCosts": [
{
"amount": "250000",
"amountUSD": "0.2501",
"description": "Fixed LIFI fee, independent of any other fee",
"feeSplit": {
"integratorFee": "0",
"lifiFee": "250000",
"recipients": [
{
"fee": "250000",
"name": "lifi",
"type": "FIXED"
}
]
},
"included": true,
"name": "LIFI Fixed Fee",
"percentage": "0.0025",
"token": {
"address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"chainId": 1,
"coinKey": "USDC",
"decimals": 6,
"logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png",
"name": "USD Coin",
"priceUSD": "1.0002350525",
"symbol": "USDC",
"tags": [
"stablecoin"
],
"verificationStatus": "verified",
"verificationStatusBreakdown": [
{
"provider": "hypernative",
"providerResult": "accept",
"result": "verified"
}
]
}
},
{
"amount": "9975",
"amountUSD": "0.0100",
"description": "The fee taken by the relayer",
"included": true,
"name": "Relayer fee",
"percentage": "0.000100",
"token": {
"address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"chainId": 1,
"coinKey": "USDC",
"decimals": 6,
"logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png",
"name": "USD Coin",
"priceUSD": "1.0002350525",
"symbol": "USDC",
"tags": [
"stablecoin"
],
"verificationStatus": "verified",
"verificationStatusBreakdown": [
{
"provider": "hypernative",
"providerResult": "accept",
"result": "verified"
}
]
}
},
{
"amount": "296",
"amountUSD": "0.0003",
"description": "The gas fee taken by the relayer",
"included": true,
"name": "Relayer gas fee",
"percentage": "0.000003",
"token": {
"address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"chainId": 1,
"coinKey": "USDC",
"decimals": 6,
"logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png",
"name": "USD Coin",
"priceUSD": "1.0002350525",
"symbol": "USDC",
"tags": [
"stablecoin"
],
"verificationStatus": "verified",
"verificationStatusBreakdown": [
{
"provider": "hypernative",
"providerResult": "accept",
"result": "verified"
}
]
}
}
],
"fromAmount": "100000000",
"fromAmountUSD": "100.0235",
"gasCosts": [
{
"amount": "10257872616000",
"amountUSD": "0.0237",
"estimate": "216000",
"limit": "459000",
"price": "47490151",
"token": {
"address": "0x0000000000000000000000000000000000000000",
"chainId": 1,
"coinKey": "ETH",
"decimals": 18,
"logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2/logo.png",
"name": "ETH",
"priceUSD": "2308.14",
"symbol": "ETH",
"tags": [
"major_asset"
],
"verificationStatus": "verified",
"verificationStatusBreakdown": [
{
"provider": "hypernative",
"providerResult": "accept",
"result": "verified"
}
]
},
"type": "SEND"
}
],
"skipPermit": false,
"toAmount": "99739729",
"toAmountMin": "99739729",
"toAmountUSD": "99.8232",
"tool": "across"
},
"executionType": "transaction",
"id": "f7623b70-2446-47a7-a306-2f67fa59301f:0",
"includedSteps": [
{
"action": {
"fromAddress": "0x1231DEB6f5749EF6cE6943a275A1D3E7486F4EaE",
"fromAmount": "100000000",
"fromChainId": 1,
"fromToken": {
"address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"chainId": 1,
"coinKey": "USDC",
"decimals": 6,
"logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png",
"name": "USD Coin",
"priceUSD": "1.0002350525",
"symbol": "USDC",
"tags": [
"stablecoin"
],
"verificationStatus": "verified",
"verificationStatusBreakdown": [
{
"provider": "hypernative",
"providerResult": "accept",
"result": "verified"
}
]
},
"slippage": 0.005,
"toAddress": "0x1231DEB6f5749EF6cE6943a275A1D3E7486F4EaE",
"toChainId": 1,
"toToken": {
"address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"chainId": 1,
"coinKey": "USDC",
"decimals": 6,
"logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png",
"name": "USD Coin",
"priceUSD": "1.0002350525",
"symbol": "USDC",
"tags": [
"stablecoin"
],
"verificationStatus": "verified",
"verificationStatusBreakdown": [
{
"provider": "hypernative",
"providerResult": "accept",
"result": "verified"
}
]
}
},
"estimate": {
"approvalAddress": "0xCE40449B773a3E6E5e769ADb4e567179d4828cbd",
"executionDuration": 0,
"feeCosts": [
{
"amount": "250000",
"amountUSD": "0.2501",
"description": "Fixed LIFI fee, independent of any other fee",
"feeSplit": {
"integratorFee": "0",
"lifiFee": "250000",
"recipients": [
{
"fee": "250000",
"name": "lifi",
"type": "FIXED"
}
]
},
"included": true,
"name": "LIFI Fixed Fee",
"percentage": "0.0025",
"token": {
"address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"chainId": 1,
"coinKey": "USDC",
"decimals": 6,
"logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png",
"name": "USD Coin",
"priceUSD": "1.0002350525",
"symbol": "USDC",
"tags": [
"stablecoin"
],
"verificationStatus": "verified",
"verificationStatusBreakdown": [
{
"provider": "hypernative",
"providerResult": "accept",
"result": "verified"
}
]
}
}
],
"fromAmount": "100000000",
"gasCosts": [
{
"amount": "6173719630000",
"amountUSD": "0.0142",
"estimate": "130000",
"limit": "169000",
"price": "47490151",
"token": {
"address": "0x0000000000000000000000000000000000000000",
"chainId": 1,
"coinKey": "ETH",
"decimals": 18,
"logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2/logo.png",
"name": "ETH",
"priceUSD": "2308.14",
"symbol": "ETH",
"tags": [
"major_asset"
],
"verificationStatus": "verified",
"verificationStatusBreakdown": [
{
"provider": "hypernative",
"providerResult": "accept",
"result": "verified"
}
]
},
"type": "SEND"
}
],
"toAmount": "99750000",
"toAmountMin": "99750000",
"tool": "feeCollection"
},
"id": "fad92fca-4184-40f8-a88c-7e840f1aceea",
"tool": "feeCollection",
"toolDetails": {
"key": "feeCollection",
"logoURI": "https://raw.githubusercontent.com/lifinance/types/main/src/assets/icons/protocols/feeCollection.svg",
"name": "Integrator Fee"
},
"type": "protocol"
},
{
"action": {
"destinationGasConsumption": "0",
"fromAddress": "0x1231DEB6f5749EF6cE6943a275A1D3E7486F4EaE",
"fromAmount": "99750000",
"fromChainId": 1,
"fromToken": {
"address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"chainId": 1,
"coinKey": "USDC",
"decimals": 6,
"logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png",
"name": "USD Coin",
"priceUSD": "1.0002350525",
"symbol": "USDC",
"tags": [
"stablecoin"
],
"verificationStatus": "verified",
"verificationStatusBreakdown": [
{
"provider": "hypernative",
"providerResult": "accept",
"result": "verified"
}
]
},
"slippage": 0.005,
"toAddress": "0x552008c0f6870c2f77e5cC1d2eb9bdff03e30Ea0",
"toChainId": 10,
"toToken": {
"address": "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85",
"chainId": 10,
"coinKey": "USDC",
"decimals": 6,
"logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png",
"name": "USD Coin",
"priceUSD": "1.0008373187",
"symbol": "USDC",
"tags": [
"stablecoin"
],
"verificationStatus": "verified",
"verificationStatusBreakdown": [
{
"provider": "hypernative",
"providerResult": "accept",
"result": "verified"
}
]
}
},
"estimate": {
"approvalAddress": "0x5c7BCd6E7De5423a257D81B442095A1a6ced35C5",
"executionDuration": 2,
"feeCosts": [
{
"amount": "9975",
"amountUSD": "0.0100",
"description": "The fee taken by the relayer",
"included": true,
"name": "Relayer fee",
"percentage": "0.000100",
"token": {
"address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"chainId": 1,
"coinKey": "USDC",
"decimals": 6,
"logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png",
"name": "USD Coin",
"priceUSD": "1.0002350525",
"symbol": "USDC",
"tags": [
"stablecoin"
],
"verificationStatus": "verified",
"verificationStatusBreakdown": [
{
"provider": "hypernative",
"providerResult": "accept",
"result": "verified"
}
]
}
},
{
"amount": "296",
"amountUSD": "0.0003",
"description": "The gas fee taken by the relayer",
"included": true,
"name": "Relayer gas fee",
"percentage": "0.000003",
"token": {
"address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"chainId": 1,
"coinKey": "USDC",
"decimals": 6,
"logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png",
"name": "USD Coin",
"priceUSD": "1.0002350525",
"symbol": "USDC",
"tags": [
"stablecoin"
],
"verificationStatus": "verified",
"verificationStatusBreakdown": [
{
"provider": "hypernative",
"providerResult": "accept",
"result": "verified"
}
]
}
}
],
"fromAmount": "99750000",
"gasCosts": [
{
"amount": "4084152986000",
"amountUSD": "0.0094",
"estimate": "86000",
"limit": "111800",
"price": "47490151",
"token": {
"address": "0x0000000000000000000000000000000000000000",
"chainId": 1,
"coinKey": "ETH",
"decimals": 18,
"logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2/logo.png",
"name": "ETH",
"priceUSD": "2308.14",
"symbol": "ETH",
"tags": [
"major_asset"
],
"verificationStatus": "verified",
"verificationStatusBreakdown": [
{
"provider": "hypernative",
"providerResult": "accept",
"result": "verified"
}
]
},
"type": "SEND"
}
],
"toAmount": "99739729",
"toAmountMin": "99739729",
"tool": "across"
},
"id": "3b546a28-939c-406b-a8b1-62214f3f69c8",
"tool": "across",
"toolDetails": {
"key": "across",
"logoURI": "https://raw.githubusercontent.com/lifinance/types/main/src/assets/icons/bridges/across.svg",
"name": "AcrossV4"
},
"type": "cross"
}
],
"integrator": "lifi-api",
"recommendedSlippage": 0.01099856322858362,
"tool": "across",
"toolDetails": {
"key": "across",
"logoURI": "https://raw.githubusercontent.com/lifinance/types/main/src/assets/icons/bridges/across.svg",
"name": "AcrossV4"
},
"type": "lifi"
},
"headers": {},
"path": {},
"query": {}
},
"response_body": {
"action": {
"fromAddress": "0x552008c0f6870c2f77e5cC1d2eb9bdff03e30Ea0",
"fromAmount": "100000000",
"fromChainId": 1,
"fromToken": {
"address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"chainId": 1,
"coinKey": "USDC",
"decimals": 6,
"logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6",
"name": "USD Coin",
"priceUSD": "1.0002350525",
"symbol": "USDC",
"tags": [],
"verificationStatus": "verified",
"verificationStatusBreakdown": []
},
"slippage": 0.005,
"toAddress": "0x552008c0f6870c2f77e5cC1d2eb9bdff03e30Ea0",
"toChainId": 10,
"toToken": {
"address": "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85",
"chainId": 10,
"coinKey": "USDC",
"decimals": 6,
"logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6",
"name": "USD Coin",
"priceUSD": "1.0008373187",
"symbol": "USDC",
"tags": [],
"verificationStatus": "verified",
"verificationStatusBreakdown": []
}
},
"estimate": {
"approvalAddress": "0x1231DEB6f5749EF6cE6943a275A1D3E7486F4EaE",
"executionDuration": 2,
"feeCosts": [
{}
],
"fromAmount": "100000000",
"fromAmountUSD": "100.0235",
"gasCosts": [
{}
],
"toAmount": "99739730",
"toAmountMin": "99739730",
"toAmountUSD": "99.8232",
"tool": "across"
},
"id": "f7623b70-2446-47a7-a306-2f67fa59301f:0",
"includedSteps": [
{
"action": {},
"estimate": {},
"id": "fad92fca-4184-40f8-a88c-7e840f1aceea",
"tool": "feeCollection",
"toolDetails": {},
"type": "protocol"
}
],
"integrator": "lifi-api",
"stepSimulation": {
"gasSource": "simulation",
"status": "success"
},
"tool": "across",
"toolDetails": {
"key": "across",
"logoURI": "https://raw.githubusercontent.com/lifinance/types/main/src/assets/icons/bridges/across.svg",
"name": "AcrossV4"
},
"transactionId": "0x5adb1acd899c00f65673bcc10757f4a18281d5d8ad98f8ef29282392d4969639",
"transactionRequest": {
"chainId": 1,
"data": "0x1794958f000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000",
"from": "0x552008c0f6870c2f77e5cC1d2eb9bdff03e30Ea0",
"gasLimit": "0x425c4",
"gasPrice": "0x2d4a467",
"to": "0x1231DEB6f5749EF6cE6943a275A1D3E7486F4EaE",
"value": "0x0"
},
"type": "lifi"
}
}
]
}
```Error handling
| Status | Next step |
|---|---|
400 | Check the offering and request fields. |
401 / 403 | Verify your credentials and access permissions. |
402 | Inspect the selected access mode and returned payment requirements. |
429 | Respect the returned rate limit and retry guidance. |
5xx | Inspect the error and usage record before retrying a paid operation. |
Documentation example (source abbreviated)
Published documentation example. Verify the actual response after an approved call.
Prepare your environment
Use a terminal with cURL installed.
Use an OpenAny API key with shared-balance access. Confirm availability and price before running; a call may charge your balance.
Set the key in your terminal using the hidden prompt below. Keep its value out of source files and logs.
Terminal · macOS / Linuxprintf 'OpenAny API key: ' read -r -s OPENANY_API_KEY export OPENANY_API_KEY printf '\n'Run the request
Paste the complete command below into your terminal.
Values to replace before running 6
Review these request fields before running. Keep the published provider and request method unchanged.
denyPools- One to 100 AMM pool or Solana venue identifiers to exclude when building transaction data. If the route was requested with `options.pools.deny`, you must pass the same list again for each step: pool exclusions are request-scoped and are not carried in the returned Step. Without it, swaps are re-quoted with no exclusions, so the transaction can use an excluded pool or venue. Repeat the query parameter for multiple entries, as with `/v1/quote`. Each entry is a non-zero Uniswap V2/V3 EVM pool address (`0x` + 40 hex), a Uniswap V4 `-` identifier, where `poolId` is `0x` + 64 hex, or a Solana venue program ID (base58). EVM pool exclusion is supported only by `fly`; Solana venue exclusion only by `jupiter`, `titan` and `okx`. If the list holds a Solana program ID, a step that swaps on Solana through any other exchange is rejected with a 400 error instead of being built without the exclusion. Keep the Step object in the JSON request body.
skipSimulation- Parameter to skip transaction simulation. The quote will be returned faster but the transaction gas limit won't be accurate.
mayanNonEvmPermitSignature- Mayan specific option to bridge from non-EVM chain to Hyperliquid
svmMaxSupportedTransactionVersion- Maximum Solana transaction version the client can sign. Defaults to 0; omission or null uses v0. Set to 1 to allow V1 where enabled for the environment. Jito requests always use v0. Size overflow may fall back to v0. Read transactionRequest.svmTransactionVersion for the version actually built. Ignored for source chains other than Solana.
svmPriorityFeeLevel- Priority fee level for Solana Virtual Machine (SVM) transactions.
body- Object that represents one step of a `Route`
Terminal · cURLcurl \ 'https://api.openany.si/v1/agent-apis/lifi/v1/advanced/stepTransaction' \ -X POST \ -H "Authorization: Bearer $OPENANY_API_KEY" \ -H 'Content-Type: application/json' \ --data-raw '{ "action": { "fromAddress": "0x552008c0f6870c2f77e5cC1d2eb9bdff03e30Ea0", "fromAmount": "100000000", "fromChainId": 1, "fromToken": { "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48", "chainId": 1, "coinKey": "USDC", "decimals": 6, "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png", "name": "USD Coin", "priceUSD": "1.0002350525", "symbol": "USDC", "tags": [ "stablecoin" ], "verificationStatus": "verified", "verificationStatusBreakdown": [ { "provider": "hypernative", "providerResult": "accept", "result": "verified" } ] }, "slippage": 0.005, "toAddress": "0x552008c0f6870c2f77e5cC1d2eb9bdff03e30Ea0", "toChainId": 10, "toToken": { "address": "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85", "chainId": 10, "coinKey": "USDC", "decimals": 6, "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png", "name": "USD Coin", "priceUSD": "1.0008373187", "symbol": "USDC", "tags": [ "stablecoin" ], "verificationStatus": "verified", "verificationStatusBreakdown": [ { "provider": "hypernative", "providerResult": "accept", "result": "verified" } ] } }, "estimate": { "approvalAddress": "0x1231DEB6f5749EF6cE6943a275A1D3E7486F4EaE", "executionDuration": 2, "feeCosts": [ { "amount": "250000", "amountUSD": "0.2501", "description": "Fixed LIFI fee, independent of any other fee", "feeSplit": { "integratorFee": "0", "lifiFee": "250000", "recipients": [ { "fee": "250000", "name": "lifi", "type": "FIXED" } ] }, "included": true, "name": "LIFI Fixed Fee", "percentage": "0.0025", "token": { "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48", "chainId": 1, "coinKey": "USDC", "decimals": 6, "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png", "name": "USD Coin", "priceUSD": "1.0002350525", "symbol": "USDC", "tags": [ "stablecoin" ], "verificationStatus": "verified", "verificationStatusBreakdown": [ { "provider": "hypernative", "providerResult": "accept", "result": "verified" } ] } }, { "amount": "9975", "amountUSD": "0.0100", "description": "The fee taken by the relayer", "included": true, "name": "Relayer fee", "percentage": "0.000100", "token": { "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48", "chainId": 1, "coinKey": "USDC", "decimals": 6, "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png", "name": "USD Coin", "priceUSD": "1.0002350525", "symbol": "USDC", "tags": [ "stablecoin" ], "verificationStatus": "verified", "verificationStatusBreakdown": [ { "provider": "hypernative", "providerResult": "accept", "result": "verified" } ] } }, { "amount": "296", "amountUSD": "0.0003", "description": "The gas fee taken by the relayer", "included": true, "name": "Relayer gas fee", "percentage": "0.000003", "token": { "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48", "chainId": 1, "coinKey": "USDC", "decimals": 6, "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png", "name": "USD Coin", "priceUSD": "1.0002350525", "symbol": "USDC", "tags": [ "stablecoin" ], "verificationStatus": "verified", "verificationStatusBreakdown": [ { "provider": "hypernative", "providerResult": "accept", "result": "verified" } ] } } ], "fromAmount": "100000000", "fromAmountUSD": "100.0235", "gasCosts": [ { "amount": "10257872616000", "amountUSD": "0.0237", "estimate": "216000", "limit": "459000", "price": "47490151", "token": { "address": "0x0000000000000000000000000000000000000000", "chainId": 1, "coinKey": "ETH", "decimals": 18, "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2/logo.png", "name": "ETH", "priceUSD": "2308.14", "symbol": "ETH", "tags": [ "major_asset" ], "verificationStatus": "verified", "verificationStatusBreakdown": [ { "provider": "hypernative", "providerResult": "accept", "result": "verified" } ] }, "type": "SEND" } ], "skipPermit": false, "toAmount": "99739729", "toAmountMin": "99739729", "toAmountUSD": "99.8232", "tool": "across" }, "executionType": "transaction", "id": "f7623b70-2446-47a7-a306-2f67fa59301f:0", "includedSteps": [ { "action": { "fromAddress": "0x1231DEB6f5749EF6cE6943a275A1D3E7486F4EaE", "fromAmount": "100000000", "fromChainId": 1, "fromToken": { "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48", "chainId": 1, "coinKey": "USDC", "decimals": 6, "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png", "name": "USD Coin", "priceUSD": "1.0002350525", "symbol": "USDC", "tags": [ "stablecoin" ], "verificationStatus": "verified", "verificationStatusBreakdown": [ { "provider": "hypernative", "providerResult": "accept", "result": "verified" } ] }, "slippage": 0.005, "toAddress": "0x1231DEB6f5749EF6cE6943a275A1D3E7486F4EaE", "toChainId": 1, "toToken": { "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48", "chainId": 1, "coinKey": "USDC", "decimals": 6, "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png", "name": "USD Coin", "priceUSD": "1.0002350525", "symbol": "USDC", "tags": [ "stablecoin" ], "verificationStatus": "verified", "verificationStatusBreakdown": [ { "provider": "hypernative", "providerResult": "accept", "result": "verified" } ] } }, "estimate": { "approvalAddress": "0xCE40449B773a3E6E5e769ADb4e567179d4828cbd", "executionDuration": 0, "feeCosts": [ { "amount": "250000", "amountUSD": "0.2501", "description": "Fixed LIFI fee, independent of any other fee", "feeSplit": { "integratorFee": "0", "lifiFee": "250000", "recipients": [ { "fee": "250000", "name": "lifi", "type": "FIXED" } ] }, "included": true, "name": "LIFI Fixed Fee", "percentage": "0.0025", "token": { "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48", "chainId": 1, "coinKey": "USDC", "decimals": 6, "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png", "name": "USD Coin", "priceUSD": "1.0002350525", "symbol": "USDC", "tags": [ "stablecoin" ], "verificationStatus": "verified", "verificationStatusBreakdown": [ { "provider": "hypernative", "providerResult": "accept", "result": "verified" } ] } } ], "fromAmount": "100000000", "gasCosts": [ { "amount": "6173719630000", "amountUSD": "0.0142", "estimate": "130000", "limit": "169000", "price": "47490151", "token": { "address": "0x0000000000000000000000000000000000000000", "chainId": 1, "coinKey": "ETH", "decimals": 18, "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2/logo.png", "name": "ETH", "priceUSD": "2308.14", "symbol": "ETH", "tags": [ "major_asset" ], "verificationStatus": "verified", "verificationStatusBreakdown": [ { "provider": "hypernative", "providerResult": "accept", "result": "verified" } ] }, "type": "SEND" } ], "toAmount": "99750000", "toAmountMin": "99750000", "tool": "feeCollection" }, "id": "fad92fca-4184-40f8-a88c-7e840f1aceea", "tool": "feeCollection", "toolDetails": { "key": "feeCollection", "logoURI": "https://raw.githubusercontent.com/lifinance/types/main/src/assets/icons/protocols/feeCollection.svg", "name": "Integrator Fee" }, "type": "protocol" }, { "action": { "destinationGasConsumption": "0", "fromAddress": "0x1231DEB6f5749EF6cE6943a275A1D3E7486F4EaE", "fromAmount": "99750000", "fromChainId": 1, "fromToken": { "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48", "chainId": 1, "coinKey": "USDC", "decimals": 6, "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png", "name": "USD Coin", "priceUSD": "1.0002350525", "symbol": "USDC", "tags": [ "stablecoin" ], "verificationStatus": "verified", "verificationStatusBreakdown": [ { "provider": "hypernative", "providerResult": "accept", "result": "verified" } ] }, "slippage": 0.005, "toAddress": "0x552008c0f6870c2f77e5cC1d2eb9bdff03e30Ea0", "toChainId": 10, "toToken": { "address": "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85", "chainId": 10, "coinKey": "USDC", "decimals": 6, "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png", "name": "USD Coin", "priceUSD": "1.0008373187", "symbol": "USDC", "tags": [ "stablecoin" ], "verificationStatus": "verified", "verificationStatusBreakdown": [ { "provider": "hypernative", "providerResult": "accept", "result": "verified" } ] } }, "estimate": { "approvalAddress": "0x5c7BCd6E7De5423a257D81B442095A1a6ced35C5", "executionDuration": 2, "feeCosts": [ { "amount": "9975", "amountUSD": "0.0100", "description": "The fee taken by the relayer", "included": true, "name": "Relayer fee", "percentage": "0.000100", "token": { "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48", "chainId": 1, "coinKey": "USDC", "decimals": 6, "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png", "name": "USD Coin", "priceUSD": "1.0002350525", "symbol": "USDC", "tags": [ "stablecoin" ], "verificationStatus": "verified", "verificationStatusBreakdown": [ { "provider": "hypernative", "providerResult": "accept", "result": "verified" } ] } }, { "amount": "296", "amountUSD": "0.0003", "description": "The gas fee taken by the relayer", "included": true, "name": "Relayer gas fee", "percentage": "0.000003", "token": { "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48", "chainId": 1, "coinKey": "USDC", "decimals": 6, "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png", "name": "USD Coin", "priceUSD": "1.0002350525", "symbol": "USDC", "tags": [ "stablecoin" ], "verificationStatus": "verified", "verificationStatusBreakdown": [ { "provider": "hypernative", "providerResult": "accept", "result": "verified" } ] } } ], "fromAmount": "99750000", "gasCosts": [ { "amount": "4084152986000", "amountUSD": "0.0094", "estimate": "86000", "limit": "111800", "price": "47490151", "token": { "address": "0x0000000000000000000000000000000000000000", "chainId": 1, "coinKey": "ETH", "decimals": 18, "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2/logo.png", "name": "ETH", "priceUSD": "2308.14", "symbol": "ETH", "tags": [ "major_asset" ], "verificationStatus": "verified", "verificationStatusBreakdown": [ { "provider": "hypernative", "providerResult": "accept", "result": "verified" } ] }, "type": "SEND" } ], "toAmount": "99739729", "toAmountMin": "99739729", "tool": "across" }, "id": "3b546a28-939c-406b-a8b1-62214f3f69c8", "tool": "across", "toolDetails": { "key": "across", "logoURI": "https://raw.githubusercontent.com/lifinance/types/main/src/assets/icons/bridges/across.svg", "name": "AcrossV4" }, "type": "cross" } ], "integrator": "lifi-api", "recommendedSlippage": 0.01099856322858362, "tool": "across", "toolDetails": { "key": "across", "logoURI": "https://raw.githubusercontent.com/lifinance/types/main/src/assets/icons/bridges/across.svg", "name": "AcrossV4" }, "type": "lifi" }'Check the response
Sample response · Documented HTTP 200
Sample response{ "action": { "fromAddress": "0x552008c0f6870c2f77e5cC1d2eb9bdff03e30Ea0", "fromAmount": "100000000", "fromChainId": 1, "fromToken": { "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48", "chainId": 1, "coinKey": "USDC", "decimals": 6, "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6", "name": "USD Coin", "priceUSD": "1.0002350525", "symbol": "USDC", "tags": [], "verificationStatus": "verified", "verificationStatusBreakdown": [] }, "slippage": 0.005, "toAddress": "0x552008c0f6870c2f77e5cC1d2eb9bdff03e30Ea0", "toChainId": 10, "toToken": { "address": "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85", "chainId": 10, "coinKey": "USDC", "decimals": 6, "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6", "name": "USD Coin", "priceUSD": "1.0008373187", "symbol": "USDC", "tags": [], "verificationStatus": "verified", "verificationStatusBreakdown": [] } }, "estimate": { "approvalAddress": "0x1231DEB6f5749EF6cE6943a275A1D3E7486F4EaE", "executionDuration": 2, "feeCosts": [ {} ], "fromAmount": "100000000", "fromAmountUSD": "100.0235", "gasCosts": [ {} ], "toAmount": "99739730", "toAmountMin": "99739730", "toAmountUSD": "99.8232", "tool": "across" }, "id": "f7623b70-2446-47a7-a306-2f67fa59301f:0", "includedSteps": [ { "action": {}, "estimate": {}, "id": "fad92fca-4184-40f8-a88c-7e840f1aceea", "tool": "feeCollection", "toolDetails": {}, "type": "protocol" } ], "integrator": "lifi-api", "stepSimulation": { "gasSource": "simulation", "status": "success" }, "tool": "across", "toolDetails": { "key": "across", "logoURI": "https://raw.githubusercontent.com/lifinance/types/main/src/assets/icons/bridges/across.svg", "name": "AcrossV4" }, "transactionId": "0x5adb1acd899c00f65673bcc10757f4a18281d5d8ad98f8ef29282392d4969639", "transactionRequest": { "chainId": 1, "data": "0x1794958f000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000", "from": "0x552008c0f6870c2f77e5cC1d2eb9bdff03e30Ea0", "gasLimit": "0x425c4", "gasPrice": "0x2d4a467", "to": "0x1231DEB6f5749EF6cE6943a275A1D3E7486F4EaE", "value": "0x0" }, "type": "lifi" }
Common questions
Do I need a separate key for every provider?
Use your OpenAny API key for standard API access. Read it from OPENANY_API_KEY in your environment and keep it out of prompts, source code and logs.
Are these providers interchangeable?
No. Each offering has its own inputs, pricing and response contract. Selecting a catalog offering does not establish automatic routing or fallback. Confirm the service contract before calling.
How is this API billed?
API-key calls use your shared balance at the selected implementation's published rate. Check the billing unit and request-specific pricing rules before making a paid call. Recorded usage determines the final charge under that contract.
Where do the price and contract come from?
The selected implementation publishes its provider, request contract, revision and billing rules through OpenAny's public API catalog. A revision number identifies a contract version, not a price update date. A price update timestamp is not supplied; do not treat a page date as one.
How do OpenAny Balance and x402 differ?
OpenAny Balance uses an API key and one shared balance. Card, USDC and x402 top-ups, card auto top-up and USDC subscriptions fund that balance; available routes appear on the Credits page. Direct x402 is a separate pay-per-request flow, available only on listings that show it and requiring an authorized payment client.
Does Playground send a paid request?
Yes. After you sign in, Run sends a real API request using an active OpenAny API key. Charges follow the published API contract and use your shared balance. Selecting an implementation, editing inputs and viewing sample responses do not send requests.
Use LI.FI — Populate a step with transaction data with your agent
Inspect endpoint contracts and confirm availability and pricing before a paid call.