This endpoint expects a full Step object which usually is retrieved by calling the /advanced/routes endpoint and selecting the most suitable Route. Afterwards the transaction for every required Step can be retrieved using this endpoint.
Attention: This request is more complex and intended to be used via our JavaScript SDK.
If you requested the route with options.pools.deny, you must pass the same list again as the denyPools query parameter on every /v1/advanced/stepTransaction request. The list is request-scoped and is not carried in the returned step. Without it, swaps are re-quoted with no exclusions, so the transaction can use a pool or venue you excluded.
Provide 1–100 identifiers using the same formats as /v1/quote: non-zero Uniswap V2/V3 EVM pool addresses, Uniswap V4 <poolManagerAddress>-<poolId> identifiers or Solana venue program IDs. Repeat denyPools for multiple entries. Keep the Step object in the JSON request body.EVM pool exclusion is supported only by fly, and Solana venue exclusion only by jupiter, titan and okx. Passing the list again preserves the exclusions when swaps are re-quoted to build transaction data. 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.
For a route requested with slippageScope=route, post the step exactly as it was returned, including its routeSlippage commitment. The transaction is built to deliver at least the committed floor (routeSlippage.minimumToAmount), and toAmountMin stays that floor.
If the fresh quotes can no longer deliver the floor, the request fails with 409 and ROUTE_SLIPPAGE_FLOOR_UNREACHABLE. The floor is never lowered; request a new quote instead.
A commitment that was changed or doesn’t match the step fails with 400 and ROUTE_SLIPPAGE_COMMITMENT_INVALID.
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 <poolManagerAddress>-<poolId> 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.
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.
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.
Present only when the route was requested with slippageScope=route. The route-wide slippage commitment: post it back unchanged with the step to /v1/advanced/stepTransaction.
Metadata about step-level transaction simulation during stepTransaction. Present on EVM and Solana stepTransaction responses when the simulation runs (on EVM, when gas limits are resolved).
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.
Present only when the route was requested with slippageScope=route. The route-wide slippage commitment: post it back unchanged with the step to /v1/advanced/stepTransaction.
Metadata about step-level transaction simulation during stepTransaction. Present on EVM and Solana stepTransaction responses when the simulation runs (on EVM, when gas limits are resolved).
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"LI.FI","description":"Get the best price execution for any swaps and bridging across EVM chains, Solana, Bitcoin and alt-VMs. Enable trading across all DEX aggregators, bridges, and intent-systems and save hundreds of developer hours.","colors":{"primary":"#5C67FF","light":"#fab6f4","dark":"#5C67FF"},"logo":{"light":"https://mintcdn.com/lifi/EmProAEgMrruLUbI/logo/light.png?fit=max\u0026auto=format\u0026n=EmProAEgMrruLUbI\u0026q=85\u0026s=f435348680e682acea6e3b9af339ed7a","dark":"https://mintcdn.com/lifi/EmProAEgMrruLUbI/logo/dark.png?fit=max\u0026auto=format\u0026n=EmProAEgMrruLUbI\u0026q=85\u0026s=d02539147db168291d7c711beb45d10b"},"favicon":"https://mintcdn.com/lifi/jEGN0oG6bNsdv0a3/logo/favicon.svg?fit=max\u0026auto=format\u0026n=jEGN0oG6bNsdv0a3\u0026q=85\u0026s=35fb6353ca8815e24daf1025135fef38","api":{"openapi":"openapi.yaml"},"appearance":{"default":"dark"},"background":{"color":{"light":"#FAFAFF","dark":"#000B29"}},"navbar":{"links":[{"href":"https://lifihelp.zendesk.com/hc/en-us","label":"Support"}],"primary":{"type":"button","label":"Get Started","href":"https://portal.li.fi/signup"}},"footer":{"socials":{"x":"https://x.com/lifiprotocol","github":"https://github.com/lifinance","website":"https://li.fi/"},"links":[{"header":"Company","items":[{"label":"Careers","href":"https://li.fi/careers"},{"label":"Brand Assets","href":"https://li.fi/brand-assets"},{"label":"About","href":"https://li.fi/"}]},{"header":"Tools","items":[{"label":"LI.FI Explorer","href":"https://explorer.li.fi/?utm_source=lifi\u0026utm_medium=footer_link_tools\u0026utm_campaign=lifi_to_explorer"}]},{"header":"Legal","items":[{"label":"Privacy Policy","href":"https://li.fi/legal/privacy-policy"},{"label":"Terms of Service","href":"https://li.fi/legal/terms-and-conditions"},{"label":"Imprint","href":"https://li.fi/legal/imprint"}]}]},"styling":{"eyebrows":"section","codeblocks":"system","latex":false},"integrations":{"ga4":{"measurementId":"G-NTE1P73M4Q"}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"navigation":{"languages":[{"language":"en","href":"introduction/introduction"},{"language":"zh-Hans","href":"zh-Hans/introduction/introduction"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"lifi","hasAudioNarration":false,"actualSubdomain":"lifi","customDomains":["docs.li.fi"],"gitSource":{"type":"github","owner":"lifinance","repo":"public-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af46ec9ec28eb92a90adcf0","clientVersion":"0.0.4111","searchFilterCounts":[{"language":"en","tag":"Composer","count":56},{"language":"en","tag":"Overview","count":48},{"language":"zh-Hans","tag":"Composer","count":46},{"language":"zh-Hans","tag":"概述","count":44},{"language":"en","tag":"Integrate via Composer API","count":40},{"language":"en","tag":"API Reference","count":34},{"language":"en","tag":"Intents \u0026 Solvers","count":32},{"language":"zh-Hans","tag":"意图与求解器","count":32},{"language":"zh-Hans","tag":"通过 Composer API 集成","count":30},{"language":"zh-Hans","tag":"API 参考","count":29},{"language":"en","tag":"Reference","count":28},{"language":"en","tag":"For Agents","count":21},{"language":"en","tag":"Widget","count":20},{"language":"zh-Hans","tag":"Widget","count":20},{"language":"zh-Hans","tag":"参考文档","count":19},{"language":"en","tag":"Getting Started","count":16},{"language":"en","tag":"General API","count":16},{"language":"zh-Hans","tag":"通用 API","count":16},{"language":"zh-Hans","tag":"企业级功能","count":15},{"language":"zh-Hans","tag":"入门","count":14}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/advanced/populate-a-step-with-transaction-data","slug":"/api-reference/advanced/populate-a-step-with-transaction-data","pageMetadata":{"openapi":"post /v1/advanced/stepTransaction","title":"Populate a step with transaction data","description":"This endpoint expects a full `Step` object which usually is retrieved by calling the `/advanced/routes` endpoint and selecting the most suitable `Route`. Afterwards the transaction for every required `Step` can be retrieved using this endpoint.\n**Attention**: This request is more complex and intended to be used via our [JavaScript SDK](https://docs.li.fi/integrate-li.fi-js-sdk/install-li.fi-sdk).","href":"/api-reference/advanced/populate-a-step-with-transaction-data"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n a: \"a\",\n code: \"code\",\n p: \"p\",\n strong: \"strong\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"This endpoint expects a full \", _jsx(_components.code, {\n children: \"Step\"\n }), \" object which usually is retrieved by calling the \", _jsx(_components.code, {\n children: \"/advanced/routes\"\n }), \" endpoint and selecting the most suitable \", _jsx(_components.code, {\n children: \"Route\"\n }), \". Afterwards the transaction for every required \", _jsx(_components.code, {\n children: \"Step\"\n }), \" can be retrieved using this endpoint.\\n\", _jsx(_components.strong, {\n children: \"Attention\"\n }), \": This request is more complex and intended to be used via our \", _jsx(_components.a, {\n href: \"https://docs.li.fi/integrate-li.fi-js-sdk/install-li.fi-sdk\",\n children: \"JavaScript SDK\"\n }), \".\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,ul:`ul`,..._provideComponents(),...props.components},{Info,Warning}=_components;if(!Info)_missingMdxReference(`Info`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Warning,{children:_jsxs(_components.p,{children:[`If you requested the route with `,_jsx(_components.code,{children:`options.pools.deny`}),`, you must pass the same list again as the `,_jsx(_components.code,{children:`denyPools`}),` query parameter on every `,_jsx(_components.code,{children:`/v1/advanced/stepTransaction`}),` request. The list is request-scoped and is not carried in the returned step. Without it, swaps are re-quoted with no exclusions, so the transaction can use a pool or venue you excluded.`]})}),`\n`,_jsxs(Info,{children:[_jsxs(_components.p,{children:[`Provide 1–100 identifiers using the same formats as `,_jsx(_components.a,{href:`/api-reference/get-a-quote-for-a-token-transfer`,children:_jsx(_components.code,{children:`/v1/quote`})}),`: non-zero Uniswap V2/V3 EVM pool addresses, Uniswap V4 `,_jsx(_components.code,{children:`\u003cpoolManagerAddress>-\u003cpoolId>`}),` identifiers or Solana venue program IDs. Repeat `,_jsx(_components.code,{children:`denyPools`}),` for multiple entries. Keep the `,_jsx(_components.code,{children:`Step`}),` object in the JSON request body.`]}),_jsxs(_components.p,{children:[`EVM pool exclusion is supported only by `,_jsx(_components.code,{children:`fly`}),`, and Solana venue exclusion only by `,_jsx(_components.code,{children:`jupiter`}),`, `,_jsx(_components.code,{children:`titan`}),` and `,_jsx(_components.code,{children:`okx`}),`. Passing the list again preserves the exclusions when swaps are re-quoted to build transaction data. 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.`]})]}),`\n`,_jsxs(Info,{children:[_jsxs(_components.p,{children:[`For a route requested with `,_jsx(_components.code,{children:`slippageScope=route`}),`, post the step exactly as it was returned, including its `,_jsx(_components.code,{children:`routeSlippage`}),` commitment. The transaction is built to deliver at least the committed floor (`,_jsx(_components.code,{children:`routeSlippage.minimumToAmount`}),`), and `,_jsx(_components.code,{children:`toAmountMin`}),` stays that floor.`]}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`If the fresh quotes can no longer deliver the floor, the request fails with `,_jsx(_components.code,{children:`409`}),` and `,_jsx(_components.code,{children:`ROUTE_SLIPPAGE_FLOOR_UNREACHABLE`}),`. The floor is never lowered; request a new quote instead.`]}),`\n`,_jsxs(_components.li,{children:[`A commitment that was changed or doesn’t match the step fails with `,_jsx(_components.code,{children:`400`}),` and `,_jsx(_components.code,{children:`ROUTE_SLIPPAGE_COMMITMENT_INVALID`}),`.`]}),`\n`]}),_jsxs(_components.p,{children:[`See `,_jsx(_components.a,{href:`/guides/route-wide-slippage`,children:`Route-wide Slippage`}),`.`]})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"codeStyling":"system","config":{},"pageMetadata":{"openapi":"post /v1/advanced/stepTransaction","title":"Populate a step with transaction data","description":"This endpoint expects a full `Step` object which usually is retrieved by calling the `/advanced/routes` endpoint and selecting the most suitable `Route`. Afterwards the transaction for every required `Step` can be retrieved using this endpoint.\n**Attention**: This request is more complex and intended to be used via our [JavaScript SDK](https://docs.li.fi/integrate-li.fi-js-sdk/install-li.fi-sdk).","href":"/api-reference/advanced/populate-a-step-with-transaction-data"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/lifi/951d8dd0c2dbce84/plausible.js","/_mintlify/custom/lifi/8e3c41579c236ea7/scripts/translate-docs.js","/_mintlify/custom/lifi/b34903975490ec23/scripts/generate-md-redirects.js","/_mintlify/custom/lifi/516472b23ab068ad/scripts/check-links.js","/_mintlify/custom/lifi/70364f7a7384bb43/scripts/markdown-chunker.js","/_mintlify/custom/lifi/6c99617851837b30/scripts/translation-config.js","/_mintlify/custom/lifi/8f88293865b45873/scripts/verify-translation-coverage.js"],"openApiReferenceData":{"operation":{"requestBody":"eafa0cc9-dd60-4377-8545-15df4aa04a55","tags":["advanced"],"parameters":["a3de6355-53a5-45de-9820-56e135e23875","532b2c83-5a99-4c6d-b44c-3e66206cc97b","285d8454-8072-43e7-94e5-fe5090429f45","fccf0498-74b6-403a-b5a3-870d531370b7","848788d9-0b5d-4f9b-8641-b6fa96dd4d06","d63b6103-0f0c-491f-b6f8-09334781d7a0"],"responses":{"200":"9ed6baf3-48cb-433d-b721-24f23adce41a","400":"f9b920fc-7a03-45a7-a6e9-a1dfa611a6e0"},"summary":"Populate a step with transaction data","description":"This endpoint expects a full `Step` object which usually is retrieved by calling the `/advanced/routes` endpoint and selecting the most suitable `Route`. Afterwards the transaction for every required `Step` can be retrieved using this endpoint.\n**Attention**: This request is more complex and intended to be used via our [JavaScript SDK](https://docs.li.fi/integrate-li.fi-js-sdk/install-li.fi-sdk).","method":"post","type":"path","servers":["b0730262-4388-4811-ad69-ca25fee73841","99a2e2ba-7b12-4205-b954-204c6fd2ee53"],"security":[],"path":"/v1/advanced/stepTransaction","baseUrlOptions":["https://li.quest","https://staging.li.quest"],"title":"Populate a step with transaction data","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"a3de6355-53a5-45de-9820-56e135e23875":{"name":"denyPools","in":"query","required":false,"style":"form","explode":true,"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 `\u003cpoolManagerAddress>-\u003cpoolId>` 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.","schema":{"type":"array","minItems":1,"maxItems":100,"items":{"type":"string","uniqueKey":"items.[INDEX]","typeLabel":"string"},"isRequired":false,"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 `\u003cpoolManagerAddress>-\u003cpoolId>` 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.","uniqueKey":"","typeLabel":"string[]"},"example":["0xd0b53D9277642d899DF5C87A3966A349A798F224"]},"532b2c83-5a99-4c6d-b44c-3e66206cc97b":{"name":"x-lifi-api-key","description":"Authentication header, register in the LI.FI Partner Portal (https://portal.li.fi/ ) to get your API Key.","schema":{"type":"string","description":"Authentication header, register in the LI.FI Partner Portal (https://portal.li.fi/ ) to get your API Key.","uniqueKey":"","typeLabel":"string"},"in":"header"},"285d8454-8072-43e7-94e5-fe5090429f45":{"name":"skipSimulation","description":"Parameter to skip transaction simulation. The quote will be returned faster but the transaction gas limit won't be accurate.","schema":{"type":"boolean","isRequired":false,"description":"Parameter to skip transaction simulation. The quote will be returned faster but the transaction gas limit won't be accurate.","uniqueKey":"","typeLabel":"boolean"},"in":"query","required":false},"fccf0498-74b6-403a-b5a3-870d531370b7":{"name":"mayanNonEvmPermitSignature","description":"Mayan specific option to bridge from non-EVM chain to Hyperliquid","schema":{"type":"boolean","isRequired":false,"description":"Mayan specific option to bridge from non-EVM chain to Hyperliquid","uniqueKey":"","typeLabel":"boolean"},"in":"query","required":false},"848788d9-0b5d-4f9b-8641-b6fa96dd4d06":{"name":"svmMaxSupportedTransactionVersion","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.","schema":{"oneOf":[{"type":"number","enum":[0,1],"default":0,"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.","uniqueKey":"oneOf.0","typeLabel":"enum\u003cnumber>"},{"type":"null","enum":[0,1],"default":0,"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.","uniqueKey":"oneOf.1","typeLabel":"null"}],"isRequired":false,"uniqueKey":"","typeLabel":"enum\u003cnumber> | null"},"in":"query","required":false},"d63b6103-0f0c-491f-b6f8-09334781d7a0":{"name":"svmPriorityFeeLevel","description":"Priority fee level for Solana Virtual Machine (SVM) transactions.","schema":{"enum":["NORMAL","FAST","ULTRA"],"type":"string","isRequired":false,"description":"Priority fee level for Solana Virtual Machine (SVM) transactions.","uniqueKey":"","typeLabel":"enum\u003cstring>"},"in":"query","required":false}},"requestBody":{"description":"The step object","content":{"application/json":{"schema":{"title":"Root Type for Step","description":"Object that represents one step of a `Route`","required":["id","action","tool","type"],"type":"object","properties":{"id":{"description":"Unique identifier of the step","type":"string","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"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","isRequired":true,"uniqueKey":"type","typeLabel":"enum\u003cstring>"},"tool":{"description":"The tool used for this step. E.g. `relay`","type":"string","isRequired":true,"uniqueKey":"tool","typeLabel":"string"},"action":{"title":"Root Type for Action","description":"The action of the step","required":["fromToken","fromAmount","fromChainId","toChainId","toToken"],"type":"object","properties":{"fromChainId":{"format":"number","description":"The id of the chain where the transfer should start","type":"number","isRequired":true,"uniqueKey":"action.fromChainId","typeLabel":"number\u003cnumber>"},"fromAmount":{"description":"The amount that should be transferred including all decimals","type":"string","isRequired":true,"uniqueKey":"action.fromAmount","typeLabel":"string"},"fromToken":{"title":"Root Type for Token","description":"The sending token","required":["address","chainId","decimals","name","symbol"],"type":"object","properties":{"address":{"description":"Address of the token","type":"string","isRequired":true,"uniqueKey":"action.fromToken.address","typeLabel":"string"},"decimals":{"format":"number","description":"Number of decimals the token uses","type":"number","isRequired":true,"uniqueKey":"action.fromToken.decimals","typeLabel":"number\u003cnumber>"},"symbol":{"description":"Symbol of the token","type":"string","isRequired":true,"uniqueKey":"action.fromToken.symbol","typeLabel":"string"},"chainId":{"format":"number","description":"Id of the token's chain","type":"number","isRequired":true,"uniqueKey":"action.fromToken.chainId","typeLabel":"number\u003cnumber>"},"name":{"description":"Name of the token","type":"string","isRequired":true,"uniqueKey":"action.fromToken.name","typeLabel":"string"},"coinKey":{"description":"Identifier for the token","type":"string","uniqueKey":"action.fromToken.coinKey","typeLabel":"string"},"logoURI":{"description":"Logo of the token","type":"string","uniqueKey":"action.fromToken.logoURI","typeLabel":"string"},"priceUSD":{"description":"Token price in USD","type":"string","uniqueKey":"action.fromToken.priceUSD","typeLabel":"string"}},"example":{"address":"0x8f3cf7ad23cd3cadbd9735aff958023239c6a063","symbol":"DAI","decimals":18,"chainId":137,"name":"(PoS) Dai Stablecoin","coinKey":"DAI","priceUSD":"1","logoURI":"https://static.debank.com/image/matic_token/logo_url/0x8f3cf7ad23cd3cadbd9735aff958023239c6a063/549c4205dbb199f1b8b03af783f35e71.png"},"isRequired":true,"uniqueKey":"action.fromToken","typeLabel":"Root Type for Token · object"},"toChainId":{"format":"number","description":"The id of the chain where the transfer should end","type":"number","isRequired":true,"uniqueKey":"action.toChainId","typeLabel":"number\u003cnumber>"},"toToken":{"title":"Root Type for Token","description":"The token that should be transferred to","required":["address","chainId","decimals","name","symbol"],"type":"object","properties":{"address":{"description":"Address of the token","type":"string","isRequired":true,"uniqueKey":"action.toToken.address","typeLabel":"string"},"decimals":{"format":"number","description":"Number of decimals the token uses","type":"number","isRequired":true,"uniqueKey":"action.toToken.decimals","typeLabel":"number\u003cnumber>"},"symbol":{"description":"Symbol of the token","type":"string","isRequired":true,"uniqueKey":"action.toToken.symbol","typeLabel":"string"},"chainId":{"format":"number","description":"Id of the token's chain","type":"number","isRequired":true,"uniqueKey":"action.toToken.chainId","typeLabel":"number\u003cnumber>"},"name":{"description":"Name of the token","type":"string","isRequired":true,"uniqueKey":"action.toToken.name","typeLabel":"string"},"coinKey":{"description":"Identifier for the token","type":"string","uniqueKey":"action.toToken.coinKey","typeLabel":"string"},"logoURI":{"description":"Logo of the token","type":"string","uniqueKey":"action.toToken.logoURI","typeLabel":"string"},"priceUSD":{"description":"Token price in USD","type":"string","uniqueKey":"action.toToken.priceUSD","typeLabel":"string"}},"example":{"address":"0x8f3cf7ad23cd3cadbd9735aff958023239c6a063","symbol":"DAI","decimals":18,"chainId":137,"name":"(PoS) Dai Stablecoin","coinKey":"DAI","priceUSD":"1","logoURI":"https://static.debank.com/image/matic_token/logo_url/0x8f3cf7ad23cd3cadbd9735aff958023239c6a063/549c4205dbb199f1b8b03af783f35e71.png"},"isRequired":true,"uniqueKey":"action.toToken","typeLabel":"Root Type for Token · object"},"slippage":{"format":"double","description":"The maximum allowed slippage","type":"number","uniqueKey":"action.slippage","typeLabel":"number\u003cdouble>"},"fromAddress":{"description":"The sending wallet address","type":"string","uniqueKey":"action.fromAddress","typeLabel":"string"},"toAddress":{"description":"The receiving wallet address","type":"string","uniqueKey":"action.toAddress","typeLabel":"string"}},"example":{"fromChainId":100,"fromAmount":"1000000000000000000","fromToken":{"address":"0x63e62989d9eb2d37dfdb1f93a22f063635b07d51","symbol":"MIVA","decimals":18,"chainId":100,"name":"Minerva Wallet SuperToken","coinKey":"MIVA","priceUSD":"0.0455272371751059","logoURI":""},"toChainId":137,"toToken":{"address":"0xc0b2983a17573660053beeed6fdb1053107cf387","symbol":"MIVA","decimals":18,"chainId":137,"name":"Minerva Wallet SuperToken","coinKey":"MIVA","priceUSD":"0","logoURI":""},"slippage":0.003},"isRequired":true,"uniqueKey":"action","typeLabel":"Root Type for Action · object"},"toolDetails":{"description":"The details of the tool used for this step. E.g. `relay`","type":"object","properties":{"key":{"description":"The tool key","type":"string","uniqueKey":"toolDetails.key","typeLabel":"string"},"name":{"description":"The tool name","type":"string","uniqueKey":"toolDetails.name","typeLabel":"string"},"logoURI":{"description":"The tool logo URL","type":"string","uniqueKey":"toolDetails.logoURI","typeLabel":"string"}},"uniqueKey":"toolDetails","typeLabel":"object"},"estimate":{"title":"Root Type for Estimate","description":"The estimation for the step","required":["fromAmount","approvalAddress","toAmount","toAmountMin","tool","executionDuration"],"type":"object","properties":{"tool":{"description":"The tools that is being used for this step","type":"string","isRequired":true,"uniqueKey":"estimate.tool","typeLabel":"string"},"fromAmount":{"description":"The amount that should be transferred including all decimals","type":"string","isRequired":true,"uniqueKey":"estimate.fromAmount","typeLabel":"string"},"toAmount":{"description":"The estimated resulting amount of the `toToken` including all decimals","type":"string","isRequired":true,"uniqueKey":"estimate.toAmount","typeLabel":"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","isRequired":true,"uniqueKey":"estimate.toAmountMin","typeLabel":"string"},"approvalAddress":{"description":"The contract address for the approval","type":"string","isRequired":true,"uniqueKey":"estimate.approvalAddress","typeLabel":"string"},"executionDuration":{"description":"The time needed to complete the following step","type":"number","isRequired":true,"uniqueKey":"estimate.executionDuration","typeLabel":"number"},"fromAmountUSD":{"description":"The amount that should be transferred in USD equivalent","type":"string","uniqueKey":"estimate.fromAmountUSD","typeLabel":"string"},"toAmountUSD":{"description":"The estimated resulting amount of the `toToken` in USD equivalent","type":"string","uniqueKey":"estimate.toAmountUSD","typeLabel":"string"},"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","uniqueKey":"estimate.skipApproval","typeLabel":"boolean"},"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.","type":"array","items":{"title":"Root Type for FeeCost","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.","required":["token","percentage","name","amountUSD","included"],"type":"object","properties":{"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","isRequired":true,"uniqueKey":"estimate.feeCosts.items.[INDEX].name","typeLabel":"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","isRequired":true,"uniqueKey":"estimate.feeCosts.items.[INDEX].percentage","typeLabel":"string"},"token":{"title":"Root Type for 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.","required":["address","chainId","decimals","name","symbol"],"type":"object","properties":{"address":{"description":"Address of the token","type":"string","isRequired":true,"uniqueKey":"estimate.feeCosts.items.[INDEX].token.address","typeLabel":"string"},"decimals":{"format":"number","description":"Number of decimals the token uses","type":"number","isRequired":true,"uniqueKey":"estimate.feeCosts.items.[INDEX].token.decimals","typeLabel":"number\u003cnumber>"},"symbol":{"description":"Symbol of the token","type":"string","isRequired":true,"uniqueKey":"estimate.feeCosts.items.[INDEX].token.symbol","typeLabel":"string"},"chainId":{"format":"number","description":"Id of the token's chain","type":"number","isRequired":true,"uniqueKey":"estimate.feeCosts.items.[INDEX].token.chainId","typeLabel":"number\u003cnumber>"},"name":{"description":"Name of the token","type":"string","isRequired":true,"uniqueKey":"estimate.feeCosts.items.[INDEX].token.name","typeLabel":"string"},"coinKey":{"description":"Identifier for the token","type":"string","uniqueKey":"estimate.feeCosts.items.[INDEX].token.coinKey","typeLabel":"string"},"logoURI":{"description":"Logo of the token","type":"string","uniqueKey":"estimate.feeCosts.items.[INDEX].token.logoURI","typeLabel":"string"},"priceUSD":{"description":"Token price in USD","type":"string","uniqueKey":"estimate.feeCosts.items.[INDEX].token.priceUSD","typeLabel":"string"}},"example":{"address":"0x8f3cf7ad23cd3cadbd9735aff958023239c6a063","symbol":"DAI","decimals":18,"chainId":137,"name":"(PoS) Dai Stablecoin","coinKey":"DAI","priceUSD":"1","logoURI":"https://static.debank.com/image/matic_token/logo_url/0x8f3cf7ad23cd3cadbd9735aff958023239c6a063/549c4205dbb199f1b8b03af783f35e71.png"},"isRequired":true,"uniqueKey":"estimate.feeCosts.items.[INDEX].token","typeLabel":"Root Type for Token · object"},"amountUSD":{"description":"The amount of fees in USD","type":"string","isRequired":true,"uniqueKey":"estimate.feeCosts.items.[INDEX].amountUSD","typeLabel":"string"},"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","isRequired":true,"uniqueKey":"estimate.feeCosts.items.[INDEX].included","typeLabel":"boolean"},"description":{"description":"Description of the fee costs","type":"string","uniqueKey":"estimate.feeCosts.items.[INDEX].description","typeLabel":"string"},"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","uniqueKey":"estimate.feeCosts.items.[INDEX].amount","typeLabel":"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.","type":"object","properties":{"lifiFee":{"description":"LI.FI's slice of `amount`, in the smallest unit of `token`.","type":"string","uniqueKey":"estimate.feeCosts.items.[INDEX].feeSplit.lifiFee","typeLabel":"string"},"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","uniqueKey":"estimate.feeCosts.items.[INDEX].feeSplit.integratorFee","typeLabel":"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","uniqueKey":"estimate.feeCosts.items.[INDEX].feeSplit.intermediaryFee","typeLabel":"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.","type":"array","items":{"title":"Root Type for FeeRecipient","description":"One party receiving a share of this fee entry.","type":"object","required":["name","fee"],"properties":{"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","isRequired":true,"uniqueKey":"estimate.feeCosts.items.[INDEX].feeSplit.recipients.items.[INDEX].name","typeLabel":"string"},"fee":{"description":"The amount credited to this recipient, in the smallest unit of this fee entry's `token`.","type":"string","isRequired":true,"uniqueKey":"estimate.feeCosts.items.[INDEX].feeSplit.recipients.items.[INDEX].fee","typeLabel":"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","uniqueKey":"estimate.feeCosts.items.[INDEX].feeSplit.recipients.items.[INDEX].type","typeLabel":"string"},"walletAddress":{"description":"The recipient's wallet address on the source chain.","type":"string","uniqueKey":"estimate.feeCosts.items.[INDEX].feeSplit.recipients.items.[INDEX].walletAddress","typeLabel":"string"}},"uniqueKey":"estimate.feeCosts.items.[INDEX].feeSplit.recipients.items.[INDEX]","typeLabel":"Root Type for FeeRecipient · object"},"uniqueKey":"estimate.feeCosts.items.[INDEX].feeSplit.recipients","typeLabel":"Root Type for FeeRecipient · object[]"}},"uniqueKey":"estimate.feeCosts.items.[INDEX].feeSplit","typeLabel":"object"}},"example":{"name":"Relayer Gas fee","description":"Relay bridge gas fee","percentage":"0.0000","token":{"address":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48","symbol":"USDC","decimals":6,"chainId":1,"name":"USD Coin","coinKey":"USDC","priceUSD":"0.999578177","logoURI":"https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png"},"amount":"1116","amountUSD":"0.0011","included":true},"uniqueKey":"estimate.feeCosts.items.[INDEX]","typeLabel":"Root Type for FeeCost · object"},"uniqueKey":"estimate.feeCosts","typeLabel":"Root Type for FeeCost · object[]"},"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.","type":"array","items":{"title":"Root Type for GasCost","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.","required":["token","type","amount"],"type":"object","properties":{"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.","type":"string","enum":["SUM","APPROVE","SEND","FEE"],"example":"SEND","isRequired":true,"uniqueKey":"estimate.gasCosts.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"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","isRequired":true,"uniqueKey":"estimate.gasCosts.items.[INDEX].amount","typeLabel":"string"},"token":{"title":"Root Type for Token","description":"The native gas token of the chain the transaction is sent on. `token.chainId` is the chain that consumes the gas.","required":["address","chainId","decimals","name","symbol"],"type":"object","properties":{"address":{"description":"Address of the token","type":"string","isRequired":true,"uniqueKey":"estimate.gasCosts.items.[INDEX].token.address","typeLabel":"string"},"decimals":{"format":"number","description":"Number of decimals the token uses","type":"number","isRequired":true,"uniqueKey":"estimate.gasCosts.items.[INDEX].token.decimals","typeLabel":"number\u003cnumber>"},"symbol":{"description":"Symbol of the token","type":"string","isRequired":true,"uniqueKey":"estimate.gasCosts.items.[INDEX].token.symbol","typeLabel":"string"},"chainId":{"format":"number","description":"Id of the token's chain","type":"number","isRequired":true,"uniqueKey":"estimate.gasCosts.items.[INDEX].token.chainId","typeLabel":"number\u003cnumber>"},"name":{"description":"Name of the token","type":"string","isRequired":true,"uniqueKey":"estimate.gasCosts.items.[INDEX].token.name","typeLabel":"string"},"coinKey":{"description":"Identifier for the token","type":"string","uniqueKey":"estimate.gasCosts.items.[INDEX].token.coinKey","typeLabel":"string"},"logoURI":{"description":"Logo of the token","type":"string","uniqueKey":"estimate.gasCosts.items.[INDEX].token.logoURI","typeLabel":"string"},"priceUSD":{"description":"Token price in USD","type":"string","uniqueKey":"estimate.gasCosts.items.[INDEX].token.priceUSD","typeLabel":"string"}},"example":{"address":"0x8f3cf7ad23cd3cadbd9735aff958023239c6a063","symbol":"DAI","decimals":18,"chainId":137,"name":"(PoS) Dai Stablecoin","coinKey":"DAI","priceUSD":"1","logoURI":"https://static.debank.com/image/matic_token/logo_url/0x8f3cf7ad23cd3cadbd9735aff958023239c6a063/549c4205dbb199f1b8b03af783f35e71.png"},"isRequired":true,"uniqueKey":"estimate.gasCosts.items.[INDEX].token","typeLabel":"Root Type for Token · object"},"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","uniqueKey":"estimate.gasCosts.items.[INDEX].price","typeLabel":"string"},"estimate":{"description":"Estimated units of gas the transaction consumes","type":"string","uniqueKey":"estimate.gasCosts.items.[INDEX].estimate","typeLabel":"string"},"limit":{"description":"Suggested gas limit: `estimate` plus a safety buffer. Use this value when submitting the transaction, not `estimate`.","type":"string","uniqueKey":"estimate.gasCosts.items.[INDEX].limit","typeLabel":"string"},"amountUSD":{"description":"Amount of the gas cost in USD","type":"string","uniqueKey":"estimate.gasCosts.items.[INDEX].amountUSD","typeLabel":"string"}},"example":{"type":"SEND","price":"128468782","estimate":"459000","limit":"596700","amount":"58967170938000","amountUSD":"0.1156","token":{"address":"0x0000000000000000000000000000000000000000","symbol":"ETH","decimals":18,"chainId":1,"name":"ETH","coinKey":"ETH","priceUSD":"1959.83","logoURI":"https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2/logo.png"}},"uniqueKey":"estimate.gasCosts.items.[INDEX]","typeLabel":"Root Type for GasCost · object"},"uniqueKey":"estimate.gasCosts","typeLabel":"Root Type for GasCost · object[]"},"data":{"description":"Arbitrary data that depends on the the used tool","type":"object","properties":{"bid":{"type":"object","properties":{"user":{"type":"string","uniqueKey":"estimate.data.bid.user","typeLabel":"string"},"router":{"type":"string","uniqueKey":"estimate.data.bid.router","typeLabel":"string"},"initiator":{"type":"string","uniqueKey":"estimate.data.bid.initiator","typeLabel":"string"},"sendingChainId":{"format":"number","type":"number","uniqueKey":"estimate.data.bid.sendingChainId","typeLabel":"number\u003cnumber>"},"sendingAssetId":{"type":"string","uniqueKey":"estimate.data.bid.sendingAssetId","typeLabel":"string"},"amount":{"type":"string","uniqueKey":"estimate.data.bid.amount","typeLabel":"string"},"receivingChainId":{"format":"number","type":"number","uniqueKey":"estimate.data.bid.receivingChainId","typeLabel":"number\u003cnumber>"},"receivingAssetId":{"type":"string","uniqueKey":"estimate.data.bid.receivingAssetId","typeLabel":"string"},"amountReceived":{"type":"string","uniqueKey":"estimate.data.bid.amountReceived","typeLabel":"string"},"receivingAddress":{"type":"string","uniqueKey":"estimate.data.bid.receivingAddress","typeLabel":"string"},"transactionId":{"type":"string","uniqueKey":"estimate.data.bid.transactionId","typeLabel":"string"},"expiry":{"format":"number","type":"number","uniqueKey":"estimate.data.bid.expiry","typeLabel":"number\u003cnumber>"},"callDataHash":{"type":"string","uniqueKey":"estimate.data.bid.callDataHash","typeLabel":"string"},"callTo":{"type":"string","uniqueKey":"estimate.data.bid.callTo","typeLabel":"string"},"encryptedCallData":{"type":"string","uniqueKey":"estimate.data.bid.encryptedCallData","typeLabel":"string"},"sendingChainTxManagerAddress":{"type":"string","uniqueKey":"estimate.data.bid.sendingChainTxManagerAddress","typeLabel":"string"},"receivingChainTxManagerAddress":{"type":"string","uniqueKey":"estimate.data.bid.receivingChainTxManagerAddress","typeLabel":"string"},"bidExpiry":{"format":"number","type":"number","uniqueKey":"estimate.data.bid.bidExpiry","typeLabel":"number\u003cnumber>"}},"uniqueKey":"estimate.data.bid","typeLabel":"object"},"bidSignature":{"type":"string","uniqueKey":"estimate.data.bidSignature","typeLabel":"string"},"gasFeeInReceivingToken":{"type":"string","uniqueKey":"estimate.data.gasFeeInReceivingToken","typeLabel":"string"},"totalFee":{"type":"string","uniqueKey":"estimate.data.totalFee","typeLabel":"string"},"metaTxRelayerFee":{"type":"string","uniqueKey":"estimate.data.metaTxRelayerFee","typeLabel":"string"},"routerFee":{"type":"string","uniqueKey":"estimate.data.routerFee","typeLabel":"string"}},"uniqueKey":"estimate.data","typeLabel":"object"}},"example":{"tool":"relaydepository","fromAmount":"50000000","fromAmountUSD":"49.9789","toAmount":"76673","toAmountMin":"76290","toAmountUSD":"50.0577","executionDuration":2,"approvalAddress":"0x1231DEB6f5749EF6cE6943a275A1D3E7486F4EaE","feeCosts":[{"name":"LIFI Fixed Fee","description":"Fixed LIFI fee, independent of any other fee","percentage":"0.0025","token":{"address":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48","symbol":"USDC","decimals":6,"chainId":1,"name":"USD Coin","coinKey":"USDC","priceUSD":"0.999578177","logoURI":"https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png"},"amount":"125000","amountUSD":"0.1249","included":true},{"name":"Relayer Gas fee","description":"Relay bridge gas fee","percentage":"0.0000","token":{"address":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48","symbol":"USDC","decimals":6,"chainId":1,"name":"USD Coin","coinKey":"USDC","priceUSD":"0.999578177","logoURI":"https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png"},"amount":"1116","amountUSD":"0.0011","included":true},{"name":"Relayer Service fee","description":"Relay bridge service fee","percentage":"0.0011","token":{"address":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48","symbol":"USDC","decimals":6,"chainId":1,"name":"USD Coin","coinKey":"USDC","priceUSD":"0.999578177","logoURI":"https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png"},"amount":"53822","amountUSD":"0.0538","included":true}],"gasCosts":[{"type":"SEND","price":"128468782","estimate":"459000","limit":"596700","amount":"58967170938000","amountUSD":"0.1156","token":{"address":"0x0000000000000000000000000000000000000000","symbol":"ETH","decimals":18,"chainId":1,"name":"ETH","coinKey":"ETH","priceUSD":"1959.83","logoURI":"https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2/logo.png"}}]},"uniqueKey":"estimate","typeLabel":"Root Type for Estimate · object"},"routeSlippage":{"title":"Root Type for RouteSlippageCommitment","description":"Present only when the route was requested with `slippageScope=route`. The route-wide slippage commitment: post it back unchanged with the step to `/v1/advanced/stepTransaction`.","required":["scope","slippage","referenceToAmount","minimumToAmount","toChainId","toTokenAddress","settlement","checkpoints"],"type":"object","properties":{"scope":{"enum":["route"],"type":"string","isRequired":true,"uniqueKey":"routeSlippage.scope","typeLabel":"enum\u003cstring>"},"slippage":{"description":"The budget for the whole route, as a decimal string, for example `0.01`","type":"string","isRequired":true,"uniqueKey":"routeSlippage.slippage","typeLabel":"string"},"referenceToAmount":{"description":"The expected output the floor was computed from, in base units of the destination token","type":"string","isRequired":true,"uniqueKey":"routeSlippage.referenceToAmount","typeLabel":"string"},"minimumToAmount":{"description":"The floor, in base units of the destination token. Also returned as `toAmountMin`.","type":"string","isRequired":true,"uniqueKey":"routeSlippage.minimumToAmount","typeLabel":"string"},"toChainId":{"description":"The chain the floor applies to","type":"integer","isRequired":true,"uniqueKey":"routeSlippage.toChainId","typeLabel":"integer"},"toTokenAddress":{"description":"The token the floor applies to","type":"string","isRequired":true,"uniqueKey":"routeSlippage.toTokenAddress","typeLabel":"string"},"settlement":{"description":"`atomic`: a single transaction; a delivery below the floor reverts it. `conditional`: a cross-chain transfer. The source transaction enforces the source checkpoint, and the bridge holds the floor from there: Mayan, Across and Stargate V2 carry it in their own order, and other bridges are built only when their own minimum reaches it. A bridge that can't deliver its minimum refunds or recovers instead, which `/v1/status` reports as `NOT_FULFILLED`.","enum":["atomic","conditional"],"type":"string","isRequired":true,"uniqueKey":"routeSlippage.settlement","typeLabel":"enum\u003cstring>"},"checkpoints":{"description":"Amounts enforced along the way. `atomic`: one entry, the floor. `conditional`: the source checkpoint (the minimum the source transaction must hand to the bridge, in the bridged token) followed by the floor.","type":"array","items":{"type":"object","required":["stepId","chainId","tokenAddress","minimumAmount"],"properties":{"stepId":{"type":"string","isRequired":true,"uniqueKey":"routeSlippage.checkpoints.items.[INDEX].stepId","typeLabel":"string"},"chainId":{"type":"integer","isRequired":true,"uniqueKey":"routeSlippage.checkpoints.items.[INDEX].chainId","typeLabel":"integer"},"tokenAddress":{"type":"string","isRequired":true,"uniqueKey":"routeSlippage.checkpoints.items.[INDEX].tokenAddress","typeLabel":"string"},"minimumAmount":{"type":"string","isRequired":true,"uniqueKey":"routeSlippage.checkpoints.items.[INDEX].minimumAmount","typeLabel":"string"}},"uniqueKey":"routeSlippage.checkpoints.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"routeSlippage.checkpoints","typeLabel":"object[]"},"toAddress":{"description":"The recipient the delivery is measured at","type":"string","uniqueKey":"routeSlippage.toAddress","typeLabel":"string"}},"example":{"scope":"route","slippage":"0.01","referenceToAmount":"400000000000000000","minimumToAmount":"396000000000000000","toChainId":42161,"toTokenAddress":"0x82aF49447D8a07e3bd95BD0d56f35241523fBab1","toAddress":"0x552008c0f6870c2f77e5cC1d2eb9bdff03e30Ea0","settlement":"atomic","checkpoints":[{"stepId":"0x48f0a2f93b0d0a9dab992d07c46bca38516c945101e8f8e08ca42af05b9e6aa9","chainId":42161,"tokenAddress":"0x82aF49447D8a07e3bd95BD0d56f35241523fBab1","minimumAmount":"396000000000000000"}]},"uniqueKey":"routeSlippage","typeLabel":"Root Type for RouteSlippageCommitment · object"},"integrator":{"description":"A string containing tracking information about the integrator of the API","type":"string","uniqueKey":"integrator","typeLabel":"string"},"includedSteps":{"type":"array","items":{"title":"Root Type for Internal Step","description":"Object that represents one step of an `IncludedSteps` array in `Route`","required":["id","action","estimate","tool","type","toolDetails"],"type":"object","properties":{"id":{"description":"Unique identifier of the step","type":"string","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].id","typeLabel":"string"},"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","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"tool":{"description":"The tool used for this step. E.g. `allbridge`","type":"string","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].tool","typeLabel":"string"},"toolDetails":{"description":"The details of the tool used for this step. E.g. `allbridge`","type":"object","properties":{"key":{"description":"The tool key","type":"string","uniqueKey":"includedSteps.items.[INDEX].toolDetails.key","typeLabel":"string"},"name":{"description":"The tool name","type":"string","uniqueKey":"includedSteps.items.[INDEX].toolDetails.name","typeLabel":"string"},"logoURI":{"description":"The tool logo URL","type":"string","uniqueKey":"includedSteps.items.[INDEX].toolDetails.logoURI","typeLabel":"string"}},"isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].toolDetails","typeLabel":"object"},"action":{"title":"Root Type for Action","description":"Object describing what happens in a `Step`","required":["fromToken","fromAmount","fromChainId","toChainId","toToken"],"type":"object","properties":{"fromChainId":{"format":"number","description":"The id of the chain where the transfer should start","type":"number","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].action.fromChainId","typeLabel":"number\u003cnumber>"},"fromAmount":{"description":"The amount that should be transferred including all decimals","type":"string","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].action.fromAmount","typeLabel":"string"},"fromToken":{"title":"Root Type for Token","description":"The sending token","required":["address","chainId","decimals","name","symbol"],"type":"object","properties":{"address":{"description":"Address of the token","type":"string","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].action.fromToken.address","typeLabel":"string"},"decimals":{"format":"number","description":"Number of decimals the token uses","type":"number","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].action.fromToken.decimals","typeLabel":"number\u003cnumber>"},"symbol":{"description":"Symbol of the token","type":"string","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].action.fromToken.symbol","typeLabel":"string"},"chainId":{"format":"number","description":"Id of the token's chain","type":"number","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].action.fromToken.chainId","typeLabel":"number\u003cnumber>"},"name":{"description":"Name of the token","type":"string","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].action.fromToken.name","typeLabel":"string"},"coinKey":{"description":"Identifier for the token","type":"string","uniqueKey":"includedSteps.items.[INDEX].action.fromToken.coinKey","typeLabel":"string"},"logoURI":{"description":"Logo of the token","type":"string","uniqueKey":"includedSteps.items.[INDEX].action.fromToken.logoURI","typeLabel":"string"},"priceUSD":{"description":"Token price in USD","type":"string","uniqueKey":"includedSteps.items.[INDEX].action.fromToken.priceUSD","typeLabel":"string"}},"example":{"address":"0x8f3cf7ad23cd3cadbd9735aff958023239c6a063","symbol":"DAI","decimals":18,"chainId":137,"name":"(PoS) Dai Stablecoin","coinKey":"DAI","priceUSD":"1","logoURI":"https://static.debank.com/image/matic_token/logo_url/0x8f3cf7ad23cd3cadbd9735aff958023239c6a063/549c4205dbb199f1b8b03af783f35e71.png"},"isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].action.fromToken","typeLabel":"Root Type for Token · object"},"toChainId":{"format":"number","description":"The id of the chain where the transfer should end","type":"number","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].action.toChainId","typeLabel":"number\u003cnumber>"},"toToken":{"title":"Root Type for Token","description":"The token that should be transferred to","required":["address","chainId","decimals","name","symbol"],"type":"object","properties":{"address":{"description":"Address of the token","type":"string","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].action.toToken.address","typeLabel":"string"},"decimals":{"format":"number","description":"Number of decimals the token uses","type":"number","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].action.toToken.decimals","typeLabel":"number\u003cnumber>"},"symbol":{"description":"Symbol of the token","type":"string","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].action.toToken.symbol","typeLabel":"string"},"chainId":{"format":"number","description":"Id of the token's chain","type":"number","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].action.toToken.chainId","typeLabel":"number\u003cnumber>"},"name":{"description":"Name of the token","type":"string","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].action.toToken.name","typeLabel":"string"},"coinKey":{"description":"Identifier for the token","type":"string","uniqueKey":"includedSteps.items.[INDEX].action.toToken.coinKey","typeLabel":"string"},"logoURI":{"description":"Logo of the token","type":"string","uniqueKey":"includedSteps.items.[INDEX].action.toToken.logoURI","typeLabel":"string"},"priceUSD":{"description":"Token price in USD","type":"string","uniqueKey":"includedSteps.items.[INDEX].action.toToken.priceUSD","typeLabel":"string"}},"example":{"address":"0x8f3cf7ad23cd3cadbd9735aff958023239c6a063","symbol":"DAI","decimals":18,"chainId":137,"name":"(PoS) Dai Stablecoin","coinKey":"DAI","priceUSD":"1","logoURI":"https://static.debank.com/image/matic_token/logo_url/0x8f3cf7ad23cd3cadbd9735aff958023239c6a063/549c4205dbb199f1b8b03af783f35e71.png"},"isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].action.toToken","typeLabel":"Root Type for Token · object"},"slippage":{"format":"double","description":"The maximum allowed slippage","type":"number","uniqueKey":"includedSteps.items.[INDEX].action.slippage","typeLabel":"number\u003cdouble>"},"fromAddress":{"description":"The sending wallet address","type":"string","uniqueKey":"includedSteps.items.[INDEX].action.fromAddress","typeLabel":"string"},"toAddress":{"description":"The receiving wallet address","type":"string","uniqueKey":"includedSteps.items.[INDEX].action.toAddress","typeLabel":"string"}},"example":{"fromChainId":100,"fromAmount":"1000000000000000000","fromToken":{"address":"0x63e62989d9eb2d37dfdb1f93a22f063635b07d51","symbol":"MIVA","decimals":18,"chainId":100,"name":"Minerva Wallet SuperToken","coinKey":"MIVA","priceUSD":"0.0455272371751059","logoURI":""},"toChainId":137,"toToken":{"address":"0xc0b2983a17573660053beeed6fdb1053107cf387","symbol":"MIVA","decimals":18,"chainId":137,"name":"Minerva Wallet SuperToken","coinKey":"MIVA","priceUSD":"0","logoURI":""},"slippage":0.003},"isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].action","typeLabel":"Root Type for Action · object"},"estimate":{"title":"Root Type for Estimate","description":"An estimate for the current transfer","required":["fromAmount","approvalAddress","toAmount","toAmountMin","tool","executionDuration"],"type":"object","properties":{"tool":{"description":"The tools that is being used for this step","type":"string","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].estimate.tool","typeLabel":"string"},"fromAmount":{"description":"The amount that should be transferred including all decimals","type":"string","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].estimate.fromAmount","typeLabel":"string"},"toAmount":{"description":"The estimated resulting amount of the `toToken` including all decimals","type":"string","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].estimate.toAmount","typeLabel":"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","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].estimate.toAmountMin","typeLabel":"string"},"approvalAddress":{"description":"The contract address for the approval","type":"string","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].estimate.approvalAddress","typeLabel":"string"},"executionDuration":{"description":"The time needed to complete the following step","type":"number","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].estimate.executionDuration","typeLabel":"number"},"fromAmountUSD":{"description":"The amount that should be transferred in USD equivalent","type":"string","uniqueKey":"includedSteps.items.[INDEX].estimate.fromAmountUSD","typeLabel":"string"},"toAmountUSD":{"description":"The estimated resulting amount of the `toToken` in USD equivalent","type":"string","uniqueKey":"includedSteps.items.[INDEX].estimate.toAmountUSD","typeLabel":"string"},"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","uniqueKey":"includedSteps.items.[INDEX].estimate.skipApproval","typeLabel":"boolean"},"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.","type":"array","items":{"title":"Root Type for FeeCost","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.","required":["token","percentage","name","amountUSD","included"],"type":"object","properties":{"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","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].estimate.feeCosts.items.[INDEX].name","typeLabel":"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","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].estimate.feeCosts.items.[INDEX].percentage","typeLabel":"string"},"token":{"title":"Root Type for 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.","required":["address","chainId","decimals","name","symbol"],"type":"object","properties":{"address":{"description":"Address of the token","type":"string","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].estimate.feeCosts.items.[INDEX].token.address","typeLabel":"string"},"decimals":{"format":"number","description":"Number of decimals the token uses","type":"number","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].estimate.feeCosts.items.[INDEX].token.decimals","typeLabel":"number\u003cnumber>"},"symbol":{"description":"Symbol of the token","type":"string","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].estimate.feeCosts.items.[INDEX].token.symbol","typeLabel":"string"},"chainId":{"format":"number","description":"Id of the token's chain","type":"number","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].estimate.feeCosts.items.[INDEX].token.chainId","typeLabel":"number\u003cnumber>"},"name":{"description":"Name of the token","type":"string","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].estimate.feeCosts.items.[INDEX].token.name","typeLabel":"string"},"coinKey":{"description":"Identifier for the token","type":"string","uniqueKey":"includedSteps.items.[INDEX].estimate.feeCosts.items.[INDEX].token.coinKey","typeLabel":"string"},"logoURI":{"description":"Logo of the token","type":"string","uniqueKey":"includedSteps.items.[INDEX].estimate.feeCosts.items.[INDEX].token.logoURI","typeLabel":"string"},"priceUSD":{"description":"Token price in USD","type":"string","uniqueKey":"includedSteps.items.[INDEX].estimate.feeCosts.items.[INDEX].token.priceUSD","typeLabel":"string"}},"example":{"address":"0x8f3cf7ad23cd3cadbd9735aff958023239c6a063","symbol":"DAI","decimals":18,"chainId":137,"name":"(PoS) Dai Stablecoin","coinKey":"DAI","priceUSD":"1","logoURI":"https://static.debank.com/image/matic_token/logo_url/0x8f3cf7ad23cd3cadbd9735aff958023239c6a063/549c4205dbb199f1b8b03af783f35e71.png"},"isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].estimate.feeCosts.items.[INDEX].token","typeLabel":"Root Type for Token · object"},"amountUSD":{"description":"The amount of fees in USD","type":"string","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].estimate.feeCosts.items.[INDEX].amountUSD","typeLabel":"string"},"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","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].estimate.feeCosts.items.[INDEX].included","typeLabel":"boolean"},"description":{"description":"Description of the fee costs","type":"string","uniqueKey":"includedSteps.items.[INDEX].estimate.feeCosts.items.[INDEX].description","typeLabel":"string"},"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","uniqueKey":"includedSteps.items.[INDEX].estimate.feeCosts.items.[INDEX].amount","typeLabel":"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.","type":"object","properties":{"lifiFee":{"description":"LI.FI's slice of `amount`, in the smallest unit of `token`.","type":"string","uniqueKey":"includedSteps.items.[INDEX].estimate.feeCosts.items.[INDEX].feeSplit.lifiFee","typeLabel":"string"},"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","uniqueKey":"includedSteps.items.[INDEX].estimate.feeCosts.items.[INDEX].feeSplit.integratorFee","typeLabel":"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","uniqueKey":"includedSteps.items.[INDEX].estimate.feeCosts.items.[INDEX].feeSplit.intermediaryFee","typeLabel":"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.","type":"array","items":{"title":"Root Type for FeeRecipient","description":"One party receiving a share of this fee entry.","type":"object","required":["name","fee"],"properties":{"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","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].estimate.feeCosts.items.[INDEX].feeSplit.recipients.items.[INDEX].name","typeLabel":"string"},"fee":{"description":"The amount credited to this recipient, in the smallest unit of this fee entry's `token`.","type":"string","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].estimate.feeCosts.items.[INDEX].feeSplit.recipients.items.[INDEX].fee","typeLabel":"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","uniqueKey":"includedSteps.items.[INDEX].estimate.feeCosts.items.[INDEX].feeSplit.recipients.items.[INDEX].type","typeLabel":"string"},"walletAddress":{"description":"The recipient's wallet address on the source chain.","type":"string","uniqueKey":"includedSteps.items.[INDEX].estimate.feeCosts.items.[INDEX].feeSplit.recipients.items.[INDEX].walletAddress","typeLabel":"string"}},"uniqueKey":"includedSteps.items.[INDEX].estimate.feeCosts.items.[INDEX].feeSplit.recipients.items.[INDEX]","typeLabel":"Root Type for FeeRecipient · object"},"uniqueKey":"includedSteps.items.[INDEX].estimate.feeCosts.items.[INDEX].feeSplit.recipients","typeLabel":"Root Type for FeeRecipient · object[]"}},"uniqueKey":"includedSteps.items.[INDEX].estimate.feeCosts.items.[INDEX].feeSplit","typeLabel":"object"}},"example":{"name":"Relayer Gas fee","description":"Relay bridge gas fee","percentage":"0.0000","token":{"address":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48","symbol":"USDC","decimals":6,"chainId":1,"name":"USD Coin","coinKey":"USDC","priceUSD":"0.999578177","logoURI":"https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png"},"amount":"1116","amountUSD":"0.0011","included":true},"uniqueKey":"includedSteps.items.[INDEX].estimate.feeCosts.items.[INDEX]","typeLabel":"Root Type for FeeCost · object"},"uniqueKey":"includedSteps.items.[INDEX].estimate.feeCosts","typeLabel":"Root Type for FeeCost · object[]"},"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.","type":"array","items":{"title":"Root Type for GasCost","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.","required":["token","type","amount"],"type":"object","properties":{"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.","type":"string","enum":["SUM","APPROVE","SEND","FEE"],"example":"SEND","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].estimate.gasCosts.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"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","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].estimate.gasCosts.items.[INDEX].amount","typeLabel":"string"},"token":{"title":"Root Type for Token","description":"The native gas token of the chain the transaction is sent on. `token.chainId` is the chain that consumes the gas.","required":["address","chainId","decimals","name","symbol"],"type":"object","properties":{"address":{"description":"Address of the token","type":"string","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].estimate.gasCosts.items.[INDEX].token.address","typeLabel":"string"},"decimals":{"format":"number","description":"Number of decimals the token uses","type":"number","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].estimate.gasCosts.items.[INDEX].token.decimals","typeLabel":"number\u003cnumber>"},"symbol":{"description":"Symbol of the token","type":"string","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].estimate.gasCosts.items.[INDEX].token.symbol","typeLabel":"string"},"chainId":{"format":"number","description":"Id of the token's chain","type":"number","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].estimate.gasCosts.items.[INDEX].token.chainId","typeLabel":"number\u003cnumber>"},"name":{"description":"Name of the token","type":"string","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].estimate.gasCosts.items.[INDEX].token.name","typeLabel":"string"},"coinKey":{"description":"Identifier for the token","type":"string","uniqueKey":"includedSteps.items.[INDEX].estimate.gasCosts.items.[INDEX].token.coinKey","typeLabel":"string"},"logoURI":{"description":"Logo of the token","type":"string","uniqueKey":"includedSteps.items.[INDEX].estimate.gasCosts.items.[INDEX].token.logoURI","typeLabel":"string"},"priceUSD":{"description":"Token price in USD","type":"string","uniqueKey":"includedSteps.items.[INDEX].estimate.gasCosts.items.[INDEX].token.priceUSD","typeLabel":"string"}},"example":{"address":"0x8f3cf7ad23cd3cadbd9735aff958023239c6a063","symbol":"DAI","decimals":18,"chainId":137,"name":"(PoS) Dai Stablecoin","coinKey":"DAI","priceUSD":"1","logoURI":"https://static.debank.com/image/matic_token/logo_url/0x8f3cf7ad23cd3cadbd9735aff958023239c6a063/549c4205dbb199f1b8b03af783f35e71.png"},"isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].estimate.gasCosts.items.[INDEX].token","typeLabel":"Root Type for Token · object"},"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","uniqueKey":"includedSteps.items.[INDEX].estimate.gasCosts.items.[INDEX].price","typeLabel":"string"},"estimate":{"description":"Estimated units of gas the transaction consumes","type":"string","uniqueKey":"includedSteps.items.[INDEX].estimate.gasCosts.items.[INDEX].estimate","typeLabel":"string"},"limit":{"description":"Suggested gas limit: `estimate` plus a safety buffer. Use this value when submitting the transaction, not `estimate`.","type":"string","uniqueKey":"includedSteps.items.[INDEX].estimate.gasCosts.items.[INDEX].limit","typeLabel":"string"},"amountUSD":{"description":"Amount of the gas cost in USD","type":"string","uniqueKey":"includedSteps.items.[INDEX].estimate.gasCosts.items.[INDEX].amountUSD","typeLabel":"string"}},"example":{"type":"SEND","price":"128468782","estimate":"459000","limit":"596700","amount":"58967170938000","amountUSD":"0.1156","token":{"address":"0x0000000000000000000000000000000000000000","symbol":"ETH","decimals":18,"chainId":1,"name":"ETH","coinKey":"ETH","priceUSD":"1959.83","logoURI":"https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2/logo.png"}},"uniqueKey":"includedSteps.items.[INDEX].estimate.gasCosts.items.[INDEX]","typeLabel":"Root Type for GasCost · object"},"uniqueKey":"includedSteps.items.[INDEX].estimate.gasCosts","typeLabel":"Root Type for GasCost · object[]"},"data":{"description":"Arbitrary data that depends on the the used tool","type":"object","properties":{"bid":{"type":"object","properties":{"user":{"type":"string","uniqueKey":"includedSteps.items.[INDEX].estimate.data.bid.user","typeLabel":"string"},"router":{"type":"string","uniqueKey":"includedSteps.items.[INDEX].estimate.data.bid.router","typeLabel":"string"},"initiator":{"type":"string","uniqueKey":"includedSteps.items.[INDEX].estimate.data.bid.initiator","typeLabel":"string"},"sendingChainId":{"format":"number","type":"number","uniqueKey":"includedSteps.items.[INDEX].estimate.data.bid.sendingChainId","typeLabel":"number\u003cnumber>"},"sendingAssetId":{"type":"string","uniqueKey":"includedSteps.items.[INDEX].estimate.data.bid.sendingAssetId","typeLabel":"string"},"amount":{"type":"string","uniqueKey":"includedSteps.items.[INDEX].estimate.data.bid.amount","typeLabel":"string"},"receivingChainId":{"format":"number","type":"number","uniqueKey":"includedSteps.items.[INDEX].estimate.data.bid.receivingChainId","typeLabel":"number\u003cnumber>"},"receivingAssetId":{"type":"string","uniqueKey":"includedSteps.items.[INDEX].estimate.data.bid.receivingAssetId","typeLabel":"string"},"amountReceived":{"type":"string","uniqueKey":"includedSteps.items.[INDEX].estimate.data.bid.amountReceived","typeLabel":"string"},"receivingAddress":{"type":"string","uniqueKey":"includedSteps.items.[INDEX].estimate.data.bid.receivingAddress","typeLabel":"string"},"transactionId":{"type":"string","uniqueKey":"includedSteps.items.[INDEX].estimate.data.bid.transactionId","typeLabel":"string"},"expiry":{"format":"number","type":"number","uniqueKey":"includedSteps.items.[INDEX].estimate.data.bid.expiry","typeLabel":"number\u003cnumber>"},"callDataHash":{"type":"string","uniqueKey":"includedSteps.items.[INDEX].estimate.data.bid.callDataHash","typeLabel":"string"},"callTo":{"type":"string","uniqueKey":"includedSteps.items.[INDEX].estimate.data.bid.callTo","typeLabel":"string"},"encryptedCallData":{"type":"string","uniqueKey":"includedSteps.items.[INDEX].estimate.data.bid.encryptedCallData","typeLabel":"string"},"sendingChainTxManagerAddress":{"type":"string","uniqueKey":"includedSteps.items.[INDEX].estimate.data.bid.sendingChainTxManagerAddress","typeLabel":"string"},"receivingChainTxManagerAddress":{"type":"string","uniqueKey":"includedSteps.items.[INDEX].estimate.data.bid.receivingChainTxManagerAddress","typeLabel":"string"},"bidExpiry":{"format":"number","type":"number","uniqueKey":"includedSteps.items.[INDEX].estimate.data.bid.bidExpiry","typeLabel":"number\u003cnumber>"}},"uniqueKey":"includedSteps.items.[INDEX].estimate.data.bid","typeLabel":"object"},"bidSignature":{"type":"string","uniqueKey":"includedSteps.items.[INDEX].estimate.data.bidSignature","typeLabel":"string"},"gasFeeInReceivingToken":{"type":"string","uniqueKey":"includedSteps.items.[INDEX].estimate.data.gasFeeInReceivingToken","typeLabel":"string"},"totalFee":{"type":"string","uniqueKey":"includedSteps.items.[INDEX].estimate.data.totalFee","typeLabel":"string"},"metaTxRelayerFee":{"type":"string","uniqueKey":"includedSteps.items.[INDEX].estimate.data.metaTxRelayerFee","typeLabel":"string"},"routerFee":{"type":"string","uniqueKey":"includedSteps.items.[INDEX].estimate.data.routerFee","typeLabel":"string"}},"uniqueKey":"includedSteps.items.[INDEX].estimate.data","typeLabel":"object"}},"example":{"tool":"relaydepository","fromAmount":"50000000","fromAmountUSD":"49.9789","toAmount":"76673","toAmountMin":"76290","toAmountUSD":"50.0577","executionDuration":2,"approvalAddress":"0x1231DEB6f5749EF6cE6943a275A1D3E7486F4EaE","feeCosts":[{"name":"LIFI Fixed Fee","description":"Fixed LIFI fee, independent of any other fee","percentage":"0.0025","token":{"address":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48","symbol":"USDC","decimals":6,"chainId":1,"name":"USD Coin","coinKey":"USDC","priceUSD":"0.999578177","logoURI":"https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png"},"amount":"125000","amountUSD":"0.1249","included":true},{"name":"Relayer Gas fee","description":"Relay bridge gas fee","percentage":"0.0000","token":{"address":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48","symbol":"USDC","decimals":6,"chainId":1,"name":"USD Coin","coinKey":"USDC","priceUSD":"0.999578177","logoURI":"https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png"},"amount":"1116","amountUSD":"0.0011","included":true},{"name":"Relayer Service fee","description":"Relay bridge service fee","percentage":"0.0011","token":{"address":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48","symbol":"USDC","decimals":6,"chainId":1,"name":"USD Coin","coinKey":"USDC","priceUSD":"0.999578177","logoURI":"https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png"},"amount":"53822","amountUSD":"0.0538","included":true}],"gasCosts":[{"type":"SEND","price":"128468782","estimate":"459000","limit":"596700","amount":"58967170938000","amountUSD":"0.1156","token":{"address":"0x0000000000000000000000000000000000000000","symbol":"ETH","decimals":18,"chainId":1,"name":"ETH","coinKey":"ETH","priceUSD":"1959.83","logoURI":"https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2/logo.png"}}]},"isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].estimate","typeLabel":"Root Type for Estimate · object"}},"uniqueKey":"includedSteps.items.[INDEX]","typeLabel":"Root Type for Internal Step · object"},"uniqueKey":"includedSteps","typeLabel":"Root Type for Internal Step · object[]"},"referrer":{"description":"A string containing tracking information about the referrer of the integrator","type":"string","uniqueKey":"referrer","typeLabel":"string"},"execution":{"description":"An objection containing status information about the execution","uniqueKey":"execution","typeLabel":"any"},"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.","type":"object","properties":{"svmTransactionVersion":{"description":"Solana transaction version actually built; Jito always uses 0.","type":"number","enum":[0,1],"uniqueKey":"transactionRequest.svmTransactionVersion","typeLabel":"enum\u003cnumber>"}},"uniqueKey":"transactionRequest","typeLabel":"object"},"stepSimulation":{"title":"Step simulation metadata","description":"Metadata about step-level transaction simulation during stepTransaction. Present on EVM and Solana stepTransaction responses when the simulation runs (on EVM, when gas limits are resolved).","required":["status","gasSource"],"type":"object","properties":{"status":{"description":"Whether and how step simulation was attempted","type":"string","enum":["success","skipped","not-attempted","failure"],"isRequired":true,"uniqueKey":"stepSimulation.status","typeLabel":"enum\u003cstring>"},"gasSource":{"description":"Source used for the SEND gas limit on the returned transaction","type":"string","enum":["simulation","tool"],"isRequired":true,"uniqueKey":"stepSimulation.gasSource","typeLabel":"enum\u003cstring>"},"disabledReason":{"description":"Present when status is not-attempted","type":"string","enum":["globally_disabled","simulation_unavailable","chain_not_supported"],"uniqueKey":"stepSimulation.disabledReason","typeLabel":"enum\u003cstring>"},"skipReason":{"description":"Present when status is skipped","type":"string","uniqueKey":"stepSimulation.skipReason","typeLabel":"string"},"revertReason":{"description":"Present when status is failure and dry-run mode is enabled","type":"string","uniqueKey":"stepSimulation.revertReason","typeLabel":"string"}},"uniqueKey":"stepSimulation","typeLabel":"Step simulation metadata · object"}},"example":{"id":"0x48f0a2f93b0d0a9dab992d07c46bca38516c945101e8f8e08ca42af05b9e6aa9","type":"cross","tool":"relay","action":{"fromChainId":100,"toChainId":137,"fromToken":{"address":"0x63e62989d9eb2d37dfdb1f93a22f063635b07d51","symbol":"MIVA","decimals":18,"chainId":100,"name":"Minerva Wallet SuperToken","coinKey":"MIVA","priceUSD":"0.04547537276751318","logoURI":""},"toToken":{"address":"0xc0b2983a17573660053beeed6fdb1053107cf387","symbol":"MIVA","decimals":18,"chainId":137,"name":"Minerva Wallet SuperToken","coinKey":"MIVA","priceUSD":"0","logoURI":""},"fromAmount":"1000000000000000000","slippage":0.003},"estimate":{"fromAmount":"1000000000000000000","toAmount":"999500000000000000","toAmountMin":"999500000000000000","approvalAddress":"0x115909BDcbaB21954bEb4ab65FC2aBEE9866fa93","feeCosts":[{"name":"Gas Fee","description":"Covers gas expense for sending funds to user on receiving chain.","percentage":"0","token":{"address":"0x63e62989d9eb2d37dfdb1f93a22f063635b07d51","symbol":"MIVA","decimals":18,"chainId":100,"name":"Minerva Wallet SuperToken","coinKey":"MIVA","priceUSD":"0.04547537276751318","logoURI":""},"amount":"0","amountUSD":"0.00","included":true},{"name":"Relay Fee","description":"Covers gas expense for claiming user funds on receiving chain.","percentage":"0","token":{"address":"0x63e62989d9eb2d37dfdb1f93a22f063635b07d51","symbol":"MIVA","decimals":18,"chainId":100,"name":"Minerva Wallet SuperToken","coinKey":"MIVA","priceUSD":"0.04547537276751318","logoURI":""},"amount":"0","amountUSD":"0.00","included":true},{"name":"Router Fee","description":"Router service fee.","percentage":"0.0005","token":{"address":"0x63e62989d9eb2d37dfdb1f93a22f063635b07d51","symbol":"MIVA","decimals":18,"chainId":100,"name":"Minerva Wallet SuperToken","coinKey":"MIVA","priceUSD":"0.04547537276751318","logoURI":""},"amount":"500000000000000","amountUSD":"0.00","included":true}],"gasCosts":[{"type":"SEND","price":"1260000000","estimate":"140000","limit":"175000","amount":"176400000000000","amountUSD":"0.00","token":{"address":"0x0000000000000000000000000000000000000000","symbol":"xDai","decimals":18,"chainId":100,"name":"xDai","coinKey":"xDai","priceUSD":"1","logoURI":"https://static.debank.com/image/xdai_token/logo_url/xdai/1207e67652b691ef3bfe04f89f4b5362.png"}}],"data":{"bid":{"user":"0x53F68B2186E4a4aB4dD976eD32de68db45BA360b","router":"0xeE2Ef40F688607CB23618d9312d62392786d13EB","initiator":"0x53F68B2186E4a4aB4dD976eD32de68db45BA360b","sendingChainId":100,"sendingAssetId":"0x63e62989d9eb2d37dfdb1f93a22f063635b07d51","amount":"1000000000000000000","receivingChainId":137,"receivingAssetId":"0xc0b2983a17573660053beeed6fdb1053107cf387","amountReceived":"999500000000000000","receivingAddress":"0x10fBFF9b9450D3A2d9d1612d6dE3726fACD8809E","transactionId":"0x48f0a2f93b0d0a9dab992d07c46bca38516c945101e8f8e08ca42af05b9e6aa9","expiry":1643364189,"callDataHash":"0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470","callTo":"0x0000000000000000000000000000000000000000","encryptedCallData":"0x","sendingChainTxManagerAddress":"0x115909BDcbaB21954bEb4ab65FC2aBEE9866fa93","receivingChainTxManagerAddress":"0x6090De2EC76eb1Dc3B5d632734415c93c44Fd113","bidExpiry":1643105290},"gasFeeInReceivingToken":"0","totalFee":"500000000000000","metaTxRelayerFee":"0","routerFee":"500000000000000"}},"integrator":"fee-demo"},"uniqueKey":"","typeLabel":"Root Type for Step · object"},"examples":{"StepRequestExample":{"title":"StepRequestExample","value":{"id":"a8dc011a-f52d-4492-9e99-21de64b5453a","type":"lifi","tool":"1inch","toolDetails":{"key":"1inch","logoURI":"https://raw.githubusercontent.com/lifinance/types/main/src/assets/icons/exchanges/oneinch.svg","name":"1inch"},"action":{"fromChainId":100,"toChainId":100,"fromToken":{"address":"0x0000000000000000000000000000000000000000","symbol":"xDai","decimals":18,"chainId":100,"name":"xDai","coinKey":"xDai","priceUSD":"1","logoURI":"https://static.debank.com/image/xdai_token/logo_url/xdai/1207e67652b691ef3bfe04f89f4b5362.png"},"toToken":{"name":"Minerva Wallet SuperToken","symbol":"MIVA","coinKey":"MIVA","decimals":18,"chainId":100,"priceUSD":"1","logoURI":"https://minerva.digital/i/MIVA-Token_200x200.png","address":"0x63e62989d9eb2d37dfdb1f93a22f063635b07d51"},"fromAmount":"1000000000000000000","slippage":0.003,"fromAddress":"0x552008c0f6870c2f77e5cC1d2eb9bdff03e30Ea0","toAddress":"0x552008c0f6870c2f77e5cC1d2eb9bdff03e30Ea0"},"estimate":{"fromAmount":"1000000000000000000","toAmount":"21922914496086353975","toAmountMin":"21265227061203763356","tool":"1inch","executionDuration":30,"approvalAddress":"0x1111111254fb6c44bac0bed2854e76f90643097d","feeCosts":[],"gasCosts":[{"type":"SEND","price":"1000000000","estimate":"252364","limit":"315455","amount":"252364000000000","amountUSD":"0.00","token":{"address":"0x0000000000000000000000000000000000000000","symbol":"xDai","decimals":18,"chainId":100,"name":"xDai","coinKey":"xDai","priceUSD":"1","logoURI":"https://static.debank.com/image/xdai_token/logo_url/xdai/1207e67652b691ef3bfe04f89f4b5362.png"}}]},"integrator":"fee-demo","includedSteps":[{"id":"a8dc011a-f52d-4492-9e99-21de64b5453a","type":"swap","tool":"1inch","toolDetails":{"key":"1inch","logoURI":"https://raw.githubusercontent.com/lifinance/types/main/src/assets/icons/exchanges/oneinch.svg","name":"1inch"},"action":{"fromChainId":100,"toChainId":100,"fromToken":{"address":"0x0000000000000000000000000000000000000000","symbol":"xDai","decimals":18,"chainId":100,"name":"xDai","coinKey":"xDai","priceUSD":"1","logoURI":"https://static.debank.com/image/xdai_token/logo_url/xdai/1207e67652b691ef3bfe04f89f4b5362.png"},"toToken":{"name":"Minerva Wallet SuperToken","symbol":"MIVA","coinKey":"MIVA","decimals":18,"chainId":100,"priceUSD":"1","logoURI":"https://minerva.digital/i/MIVA-Token_200x200.png","address":"0x63e62989d9eb2d37dfdb1f93a22f063635b07d51"},"fromAmount":"1000000000000000000","slippage":0.003,"fromAddress":"0x552008c0f6870c2f77e5cC1d2eb9bdff03e30Ea0","toAddress":"0x552008c0f6870c2f77e5cC1d2eb9bdff03e30Ea0"},"estimate":{"fromAmount":"1000000000000000000","toAmount":"21922914496086353975","toAmountMin":"21265227061203763356","tool":"1inch","executionDuration":30,"approvalAddress":"0x1111111254fb6c44bac0bed2854e76f90643097d","feeCosts":[],"gasCosts":[{"type":"SEND","price":"1000000000","estimate":"252364","limit":"315455","amount":"252364000000000","amountUSD":"0.00","token":{"address":"0x0000000000000000000000000000000000000000","symbol":"xDai","decimals":18,"chainId":100,"name":"xDai","coinKey":"xDai","priceUSD":"1","logoURI":"https://static.debank.com/image/xdai_token/logo_url/xdai/1207e67652b691ef3bfe04f89f4b5362.png"}}]}}]}}},"exampleType":"examples"}},"required":true,"exampleType":"examples"},"responses":{"9ed6baf3-48cb-433d-b721-24f23adce41a":{"content":{"application/json":{"schema":{"title":"Root Type for Step","description":"Object that represents one step of a `Route`","required":["id","action","tool","type"],"type":"object","properties":{"id":{"description":"Unique identifier of the step","type":"string","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"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","isRequired":true,"uniqueKey":"type","typeLabel":"enum\u003cstring>"},"tool":{"description":"The tool used for this step. E.g. `relay`","type":"string","isRequired":true,"uniqueKey":"tool","typeLabel":"string"},"action":{"title":"Root Type for Action","description":"The action of the step","required":["fromToken","fromAmount","fromChainId","toChainId","toToken"],"type":"object","properties":{"fromChainId":{"format":"number","description":"The id of the chain where the transfer should start","type":"number","isRequired":true,"uniqueKey":"action.fromChainId","typeLabel":"number\u003cnumber>"},"fromAmount":{"description":"The amount that should be transferred including all decimals","type":"string","isRequired":true,"uniqueKey":"action.fromAmount","typeLabel":"string"},"fromToken":{"title":"Root Type for Token","description":"The sending token","required":["address","chainId","decimals","name","symbol"],"type":"object","properties":{"address":{"description":"Address of the token","type":"string","isRequired":true,"uniqueKey":"action.fromToken.address","typeLabel":"string"},"decimals":{"format":"number","description":"Number of decimals the token uses","type":"number","isRequired":true,"uniqueKey":"action.fromToken.decimals","typeLabel":"number\u003cnumber>"},"symbol":{"description":"Symbol of the token","type":"string","isRequired":true,"uniqueKey":"action.fromToken.symbol","typeLabel":"string"},"chainId":{"format":"number","description":"Id of the token's chain","type":"number","isRequired":true,"uniqueKey":"action.fromToken.chainId","typeLabel":"number\u003cnumber>"},"name":{"description":"Name of the token","type":"string","isRequired":true,"uniqueKey":"action.fromToken.name","typeLabel":"string"},"coinKey":{"description":"Identifier for the token","type":"string","uniqueKey":"action.fromToken.coinKey","typeLabel":"string"},"logoURI":{"description":"Logo of the token","type":"string","uniqueKey":"action.fromToken.logoURI","typeLabel":"string"},"priceUSD":{"description":"Token price in USD","type":"string","uniqueKey":"action.fromToken.priceUSD","typeLabel":"string"}},"example":{"address":"0x8f3cf7ad23cd3cadbd9735aff958023239c6a063","symbol":"DAI","decimals":18,"chainId":137,"name":"(PoS) Dai Stablecoin","coinKey":"DAI","priceUSD":"1","logoURI":"https://static.debank.com/image/matic_token/logo_url/0x8f3cf7ad23cd3cadbd9735aff958023239c6a063/549c4205dbb199f1b8b03af783f35e71.png"},"isRequired":true,"uniqueKey":"action.fromToken","typeLabel":"Root Type for Token · object"},"toChainId":{"format":"number","description":"The id of the chain where the transfer should end","type":"number","isRequired":true,"uniqueKey":"action.toChainId","typeLabel":"number\u003cnumber>"},"toToken":{"title":"Root Type for Token","description":"The token that should be transferred to","required":["address","chainId","decimals","name","symbol"],"type":"object","properties":{"address":{"description":"Address of the token","type":"string","isRequired":true,"uniqueKey":"action.toToken.address","typeLabel":"string"},"decimals":{"format":"number","description":"Number of decimals the token uses","type":"number","isRequired":true,"uniqueKey":"action.toToken.decimals","typeLabel":"number\u003cnumber>"},"symbol":{"description":"Symbol of the token","type":"string","isRequired":true,"uniqueKey":"action.toToken.symbol","typeLabel":"string"},"chainId":{"format":"number","description":"Id of the token's chain","type":"number","isRequired":true,"uniqueKey":"action.toToken.chainId","typeLabel":"number\u003cnumber>"},"name":{"description":"Name of the token","type":"string","isRequired":true,"uniqueKey":"action.toToken.name","typeLabel":"string"},"coinKey":{"description":"Identifier for the token","type":"string","uniqueKey":"action.toToken.coinKey","typeLabel":"string"},"logoURI":{"description":"Logo of the token","type":"string","uniqueKey":"action.toToken.logoURI","typeLabel":"string"},"priceUSD":{"description":"Token price in USD","type":"string","uniqueKey":"action.toToken.priceUSD","typeLabel":"string"}},"example":{"address":"0x8f3cf7ad23cd3cadbd9735aff958023239c6a063","symbol":"DAI","decimals":18,"chainId":137,"name":"(PoS) Dai Stablecoin","coinKey":"DAI","priceUSD":"1","logoURI":"https://static.debank.com/image/matic_token/logo_url/0x8f3cf7ad23cd3cadbd9735aff958023239c6a063/549c4205dbb199f1b8b03af783f35e71.png"},"isRequired":true,"uniqueKey":"action.toToken","typeLabel":"Root Type for Token · object"},"slippage":{"format":"double","description":"The maximum allowed slippage","type":"number","uniqueKey":"action.slippage","typeLabel":"number\u003cdouble>"},"fromAddress":{"description":"The sending wallet address","type":"string","uniqueKey":"action.fromAddress","typeLabel":"string"},"toAddress":{"description":"The receiving wallet address","type":"string","uniqueKey":"action.toAddress","typeLabel":"string"}},"example":{"fromChainId":100,"fromAmount":"1000000000000000000","fromToken":{"address":"0x63e62989d9eb2d37dfdb1f93a22f063635b07d51","symbol":"MIVA","decimals":18,"chainId":100,"name":"Minerva Wallet SuperToken","coinKey":"MIVA","priceUSD":"0.0455272371751059","logoURI":""},"toChainId":137,"toToken":{"address":"0xc0b2983a17573660053beeed6fdb1053107cf387","symbol":"MIVA","decimals":18,"chainId":137,"name":"Minerva Wallet SuperToken","coinKey":"MIVA","priceUSD":"0","logoURI":""},"slippage":0.003},"isRequired":true,"uniqueKey":"action","typeLabel":"Root Type for Action · object"},"toolDetails":{"description":"The details of the tool used for this step. E.g. `relay`","type":"object","properties":{"key":{"description":"The tool key","type":"string","uniqueKey":"toolDetails.key","typeLabel":"string"},"name":{"description":"The tool name","type":"string","uniqueKey":"toolDetails.name","typeLabel":"string"},"logoURI":{"description":"The tool logo URL","type":"string","uniqueKey":"toolDetails.logoURI","typeLabel":"string"}},"uniqueKey":"toolDetails","typeLabel":"object"},"estimate":{"title":"Root Type for Estimate","description":"The estimation for the step","required":["fromAmount","approvalAddress","toAmount","toAmountMin","tool","executionDuration"],"type":"object","properties":{"tool":{"description":"The tools that is being used for this step","type":"string","isRequired":true,"uniqueKey":"estimate.tool","typeLabel":"string"},"fromAmount":{"description":"The amount that should be transferred including all decimals","type":"string","isRequired":true,"uniqueKey":"estimate.fromAmount","typeLabel":"string"},"toAmount":{"description":"The estimated resulting amount of the `toToken` including all decimals","type":"string","isRequired":true,"uniqueKey":"estimate.toAmount","typeLabel":"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","isRequired":true,"uniqueKey":"estimate.toAmountMin","typeLabel":"string"},"approvalAddress":{"description":"The contract address for the approval","type":"string","isRequired":true,"uniqueKey":"estimate.approvalAddress","typeLabel":"string"},"executionDuration":{"description":"The time needed to complete the following step","type":"number","isRequired":true,"uniqueKey":"estimate.executionDuration","typeLabel":"number"},"fromAmountUSD":{"description":"The amount that should be transferred in USD equivalent","type":"string","uniqueKey":"estimate.fromAmountUSD","typeLabel":"string"},"toAmountUSD":{"description":"The estimated resulting amount of the `toToken` in USD equivalent","type":"string","uniqueKey":"estimate.toAmountUSD","typeLabel":"string"},"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","uniqueKey":"estimate.skipApproval","typeLabel":"boolean"},"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.","type":"array","items":{"title":"Root Type for FeeCost","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.","required":["token","percentage","name","amountUSD","included"],"type":"object","properties":{"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","isRequired":true,"uniqueKey":"estimate.feeCosts.items.[INDEX].name","typeLabel":"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","isRequired":true,"uniqueKey":"estimate.feeCosts.items.[INDEX].percentage","typeLabel":"string"},"token":{"title":"Root Type for 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.","required":["address","chainId","decimals","name","symbol"],"type":"object","properties":{"address":{"description":"Address of the token","type":"string","isRequired":true,"uniqueKey":"estimate.feeCosts.items.[INDEX].token.address","typeLabel":"string"},"decimals":{"format":"number","description":"Number of decimals the token uses","type":"number","isRequired":true,"uniqueKey":"estimate.feeCosts.items.[INDEX].token.decimals","typeLabel":"number\u003cnumber>"},"symbol":{"description":"Symbol of the token","type":"string","isRequired":true,"uniqueKey":"estimate.feeCosts.items.[INDEX].token.symbol","typeLabel":"string"},"chainId":{"format":"number","description":"Id of the token's chain","type":"number","isRequired":true,"uniqueKey":"estimate.feeCosts.items.[INDEX].token.chainId","typeLabel":"number\u003cnumber>"},"name":{"description":"Name of the token","type":"string","isRequired":true,"uniqueKey":"estimate.feeCosts.items.[INDEX].token.name","typeLabel":"string"},"coinKey":{"description":"Identifier for the token","type":"string","uniqueKey":"estimate.feeCosts.items.[INDEX].token.coinKey","typeLabel":"string"},"logoURI":{"description":"Logo of the token","type":"string","uniqueKey":"estimate.feeCosts.items.[INDEX].token.logoURI","typeLabel":"string"},"priceUSD":{"description":"Token price in USD","type":"string","uniqueKey":"estimate.feeCosts.items.[INDEX].token.priceUSD","typeLabel":"string"}},"example":{"address":"0x8f3cf7ad23cd3cadbd9735aff958023239c6a063","symbol":"DAI","decimals":18,"chainId":137,"name":"(PoS) Dai Stablecoin","coinKey":"DAI","priceUSD":"1","logoURI":"https://static.debank.com/image/matic_token/logo_url/0x8f3cf7ad23cd3cadbd9735aff958023239c6a063/549c4205dbb199f1b8b03af783f35e71.png"},"isRequired":true,"uniqueKey":"estimate.feeCosts.items.[INDEX].token","typeLabel":"Root Type for Token · object"},"amountUSD":{"description":"The amount of fees in USD","type":"string","isRequired":true,"uniqueKey":"estimate.feeCosts.items.[INDEX].amountUSD","typeLabel":"string"},"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","isRequired":true,"uniqueKey":"estimate.feeCosts.items.[INDEX].included","typeLabel":"boolean"},"description":{"description":"Description of the fee costs","type":"string","uniqueKey":"estimate.feeCosts.items.[INDEX].description","typeLabel":"string"},"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","uniqueKey":"estimate.feeCosts.items.[INDEX].amount","typeLabel":"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.","type":"object","properties":{"lifiFee":{"description":"LI.FI's slice of `amount`, in the smallest unit of `token`.","type":"string","uniqueKey":"estimate.feeCosts.items.[INDEX].feeSplit.lifiFee","typeLabel":"string"},"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","uniqueKey":"estimate.feeCosts.items.[INDEX].feeSplit.integratorFee","typeLabel":"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","uniqueKey":"estimate.feeCosts.items.[INDEX].feeSplit.intermediaryFee","typeLabel":"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.","type":"array","items":{"title":"Root Type for FeeRecipient","description":"One party receiving a share of this fee entry.","type":"object","required":["name","fee"],"properties":{"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","isRequired":true,"uniqueKey":"estimate.feeCosts.items.[INDEX].feeSplit.recipients.items.[INDEX].name","typeLabel":"string"},"fee":{"description":"The amount credited to this recipient, in the smallest unit of this fee entry's `token`.","type":"string","isRequired":true,"uniqueKey":"estimate.feeCosts.items.[INDEX].feeSplit.recipients.items.[INDEX].fee","typeLabel":"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","uniqueKey":"estimate.feeCosts.items.[INDEX].feeSplit.recipients.items.[INDEX].type","typeLabel":"string"},"walletAddress":{"description":"The recipient's wallet address on the source chain.","type":"string","uniqueKey":"estimate.feeCosts.items.[INDEX].feeSplit.recipients.items.[INDEX].walletAddress","typeLabel":"string"}},"uniqueKey":"estimate.feeCosts.items.[INDEX].feeSplit.recipients.items.[INDEX]","typeLabel":"Root Type for FeeRecipient · object"},"uniqueKey":"estimate.feeCosts.items.[INDEX].feeSplit.recipients","typeLabel":"Root Type for FeeRecipient · object[]"}},"uniqueKey":"estimate.feeCosts.items.[INDEX].feeSplit","typeLabel":"object"}},"example":{"name":"Relayer Gas fee","description":"Relay bridge gas fee","percentage":"0.0000","token":{"address":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48","symbol":"USDC","decimals":6,"chainId":1,"name":"USD Coin","coinKey":"USDC","priceUSD":"0.999578177","logoURI":"https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png"},"amount":"1116","amountUSD":"0.0011","included":true},"uniqueKey":"estimate.feeCosts.items.[INDEX]","typeLabel":"Root Type for FeeCost · object"},"uniqueKey":"estimate.feeCosts","typeLabel":"Root Type for FeeCost · object[]"},"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.","type":"array","items":{"title":"Root Type for GasCost","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.","required":["token","type","amount"],"type":"object","properties":{"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.","type":"string","enum":["SUM","APPROVE","SEND","FEE"],"example":"SEND","isRequired":true,"uniqueKey":"estimate.gasCosts.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"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","isRequired":true,"uniqueKey":"estimate.gasCosts.items.[INDEX].amount","typeLabel":"string"},"token":{"title":"Root Type for Token","description":"The native gas token of the chain the transaction is sent on. `token.chainId` is the chain that consumes the gas.","required":["address","chainId","decimals","name","symbol"],"type":"object","properties":{"address":{"description":"Address of the token","type":"string","isRequired":true,"uniqueKey":"estimate.gasCosts.items.[INDEX].token.address","typeLabel":"string"},"decimals":{"format":"number","description":"Number of decimals the token uses","type":"number","isRequired":true,"uniqueKey":"estimate.gasCosts.items.[INDEX].token.decimals","typeLabel":"number\u003cnumber>"},"symbol":{"description":"Symbol of the token","type":"string","isRequired":true,"uniqueKey":"estimate.gasCosts.items.[INDEX].token.symbol","typeLabel":"string"},"chainId":{"format":"number","description":"Id of the token's chain","type":"number","isRequired":true,"uniqueKey":"estimate.gasCosts.items.[INDEX].token.chainId","typeLabel":"number\u003cnumber>"},"name":{"description":"Name of the token","type":"string","isRequired":true,"uniqueKey":"estimate.gasCosts.items.[INDEX].token.name","typeLabel":"string"},"coinKey":{"description":"Identifier for the token","type":"string","uniqueKey":"estimate.gasCosts.items.[INDEX].token.coinKey","typeLabel":"string"},"logoURI":{"description":"Logo of the token","type":"string","uniqueKey":"estimate.gasCosts.items.[INDEX].token.logoURI","typeLabel":"string"},"priceUSD":{"description":"Token price in USD","type":"string","uniqueKey":"estimate.gasCosts.items.[INDEX].token.priceUSD","typeLabel":"string"}},"example":{"address":"0x8f3cf7ad23cd3cadbd9735aff958023239c6a063","symbol":"DAI","decimals":18,"chainId":137,"name":"(PoS) Dai Stablecoin","coinKey":"DAI","priceUSD":"1","logoURI":"https://static.debank.com/image/matic_token/logo_url/0x8f3cf7ad23cd3cadbd9735aff958023239c6a063/549c4205dbb199f1b8b03af783f35e71.png"},"isRequired":true,"uniqueKey":"estimate.gasCosts.items.[INDEX].token","typeLabel":"Root Type for Token · object"},"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","uniqueKey":"estimate.gasCosts.items.[INDEX].price","typeLabel":"string"},"estimate":{"description":"Estimated units of gas the transaction consumes","type":"string","uniqueKey":"estimate.gasCosts.items.[INDEX].estimate","typeLabel":"string"},"limit":{"description":"Suggested gas limit: `estimate` plus a safety buffer. Use this value when submitting the transaction, not `estimate`.","type":"string","uniqueKey":"estimate.gasCosts.items.[INDEX].limit","typeLabel":"string"},"amountUSD":{"description":"Amount of the gas cost in USD","type":"string","uniqueKey":"estimate.gasCosts.items.[INDEX].amountUSD","typeLabel":"string"}},"example":{"type":"SEND","price":"128468782","estimate":"459000","limit":"596700","amount":"58967170938000","amountUSD":"0.1156","token":{"address":"0x0000000000000000000000000000000000000000","symbol":"ETH","decimals":18,"chainId":1,"name":"ETH","coinKey":"ETH","priceUSD":"1959.83","logoURI":"https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2/logo.png"}},"uniqueKey":"estimate.gasCosts.items.[INDEX]","typeLabel":"Root Type for GasCost · object"},"uniqueKey":"estimate.gasCosts","typeLabel":"Root Type for GasCost · object[]"},"data":{"description":"Arbitrary data that depends on the the used tool","type":"object","properties":{"bid":{"type":"object","properties":{"user":{"type":"string","uniqueKey":"estimate.data.bid.user","typeLabel":"string"},"router":{"type":"string","uniqueKey":"estimate.data.bid.router","typeLabel":"string"},"initiator":{"type":"string","uniqueKey":"estimate.data.bid.initiator","typeLabel":"string"},"sendingChainId":{"format":"number","type":"number","uniqueKey":"estimate.data.bid.sendingChainId","typeLabel":"number\u003cnumber>"},"sendingAssetId":{"type":"string","uniqueKey":"estimate.data.bid.sendingAssetId","typeLabel":"string"},"amount":{"type":"string","uniqueKey":"estimate.data.bid.amount","typeLabel":"string"},"receivingChainId":{"format":"number","type":"number","uniqueKey":"estimate.data.bid.receivingChainId","typeLabel":"number\u003cnumber>"},"receivingAssetId":{"type":"string","uniqueKey":"estimate.data.bid.receivingAssetId","typeLabel":"string"},"amountReceived":{"type":"string","uniqueKey":"estimate.data.bid.amountReceived","typeLabel":"string"},"receivingAddress":{"type":"string","uniqueKey":"estimate.data.bid.receivingAddress","typeLabel":"string"},"transactionId":{"type":"string","uniqueKey":"estimate.data.bid.transactionId","typeLabel":"string"},"expiry":{"format":"number","type":"number","uniqueKey":"estimate.data.bid.expiry","typeLabel":"number\u003cnumber>"},"callDataHash":{"type":"string","uniqueKey":"estimate.data.bid.callDataHash","typeLabel":"string"},"callTo":{"type":"string","uniqueKey":"estimate.data.bid.callTo","typeLabel":"string"},"encryptedCallData":{"type":"string","uniqueKey":"estimate.data.bid.encryptedCallData","typeLabel":"string"},"sendingChainTxManagerAddress":{"type":"string","uniqueKey":"estimate.data.bid.sendingChainTxManagerAddress","typeLabel":"string"},"receivingChainTxManagerAddress":{"type":"string","uniqueKey":"estimate.data.bid.receivingChainTxManagerAddress","typeLabel":"string"},"bidExpiry":{"format":"number","type":"number","uniqueKey":"estimate.data.bid.bidExpiry","typeLabel":"number\u003cnumber>"}},"uniqueKey":"estimate.data.bid","typeLabel":"object"},"bidSignature":{"type":"string","uniqueKey":"estimate.data.bidSignature","typeLabel":"string"},"gasFeeInReceivingToken":{"type":"string","uniqueKey":"estimate.data.gasFeeInReceivingToken","typeLabel":"string"},"totalFee":{"type":"string","uniqueKey":"estimate.data.totalFee","typeLabel":"string"},"metaTxRelayerFee":{"type":"string","uniqueKey":"estimate.data.metaTxRelayerFee","typeLabel":"string"},"routerFee":{"type":"string","uniqueKey":"estimate.data.routerFee","typeLabel":"string"}},"uniqueKey":"estimate.data","typeLabel":"object"}},"example":{"tool":"relaydepository","fromAmount":"50000000","fromAmountUSD":"49.9789","toAmount":"76673","toAmountMin":"76290","toAmountUSD":"50.0577","executionDuration":2,"approvalAddress":"0x1231DEB6f5749EF6cE6943a275A1D3E7486F4EaE","feeCosts":[{"name":"LIFI Fixed Fee","description":"Fixed LIFI fee, independent of any other fee","percentage":"0.0025","token":{"address":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48","symbol":"USDC","decimals":6,"chainId":1,"name":"USD Coin","coinKey":"USDC","priceUSD":"0.999578177","logoURI":"https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png"},"amount":"125000","amountUSD":"0.1249","included":true},{"name":"Relayer Gas fee","description":"Relay bridge gas fee","percentage":"0.0000","token":{"address":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48","symbol":"USDC","decimals":6,"chainId":1,"name":"USD Coin","coinKey":"USDC","priceUSD":"0.999578177","logoURI":"https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png"},"amount":"1116","amountUSD":"0.0011","included":true},{"name":"Relayer Service fee","description":"Relay bridge service fee","percentage":"0.0011","token":{"address":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48","symbol":"USDC","decimals":6,"chainId":1,"name":"USD Coin","coinKey":"USDC","priceUSD":"0.999578177","logoURI":"https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png"},"amount":"53822","amountUSD":"0.0538","included":true}],"gasCosts":[{"type":"SEND","price":"128468782","estimate":"459000","limit":"596700","amount":"58967170938000","amountUSD":"0.1156","token":{"address":"0x0000000000000000000000000000000000000000","symbol":"ETH","decimals":18,"chainId":1,"name":"ETH","coinKey":"ETH","priceUSD":"1959.83","logoURI":"https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2/logo.png"}}]},"uniqueKey":"estimate","typeLabel":"Root Type for Estimate · object"},"routeSlippage":{"title":"Root Type for RouteSlippageCommitment","description":"Present only when the route was requested with `slippageScope=route`. The route-wide slippage commitment: post it back unchanged with the step to `/v1/advanced/stepTransaction`.","required":["scope","slippage","referenceToAmount","minimumToAmount","toChainId","toTokenAddress","settlement","checkpoints"],"type":"object","properties":{"scope":{"enum":["route"],"type":"string","isRequired":true,"uniqueKey":"routeSlippage.scope","typeLabel":"enum\u003cstring>"},"slippage":{"description":"The budget for the whole route, as a decimal string, for example `0.01`","type":"string","isRequired":true,"uniqueKey":"routeSlippage.slippage","typeLabel":"string"},"referenceToAmount":{"description":"The expected output the floor was computed from, in base units of the destination token","type":"string","isRequired":true,"uniqueKey":"routeSlippage.referenceToAmount","typeLabel":"string"},"minimumToAmount":{"description":"The floor, in base units of the destination token. Also returned as `toAmountMin`.","type":"string","isRequired":true,"uniqueKey":"routeSlippage.minimumToAmount","typeLabel":"string"},"toChainId":{"description":"The chain the floor applies to","type":"integer","isRequired":true,"uniqueKey":"routeSlippage.toChainId","typeLabel":"integer"},"toTokenAddress":{"description":"The token the floor applies to","type":"string","isRequired":true,"uniqueKey":"routeSlippage.toTokenAddress","typeLabel":"string"},"settlement":{"description":"`atomic`: a single transaction; a delivery below the floor reverts it. `conditional`: a cross-chain transfer. The source transaction enforces the source checkpoint, and the bridge holds the floor from there: Mayan, Across and Stargate V2 carry it in their own order, and other bridges are built only when their own minimum reaches it. A bridge that can't deliver its minimum refunds or recovers instead, which `/v1/status` reports as `NOT_FULFILLED`.","enum":["atomic","conditional"],"type":"string","isRequired":true,"uniqueKey":"routeSlippage.settlement","typeLabel":"enum\u003cstring>"},"checkpoints":{"description":"Amounts enforced along the way. `atomic`: one entry, the floor. `conditional`: the source checkpoint (the minimum the source transaction must hand to the bridge, in the bridged token) followed by the floor.","type":"array","items":{"type":"object","required":["stepId","chainId","tokenAddress","minimumAmount"],"properties":{"stepId":{"type":"string","isRequired":true,"uniqueKey":"routeSlippage.checkpoints.items.[INDEX].stepId","typeLabel":"string"},"chainId":{"type":"integer","isRequired":true,"uniqueKey":"routeSlippage.checkpoints.items.[INDEX].chainId","typeLabel":"integer"},"tokenAddress":{"type":"string","isRequired":true,"uniqueKey":"routeSlippage.checkpoints.items.[INDEX].tokenAddress","typeLabel":"string"},"minimumAmount":{"type":"string","isRequired":true,"uniqueKey":"routeSlippage.checkpoints.items.[INDEX].minimumAmount","typeLabel":"string"}},"uniqueKey":"routeSlippage.checkpoints.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"routeSlippage.checkpoints","typeLabel":"object[]"},"toAddress":{"description":"The recipient the delivery is measured at","type":"string","uniqueKey":"routeSlippage.toAddress","typeLabel":"string"}},"example":{"scope":"route","slippage":"0.01","referenceToAmount":"400000000000000000","minimumToAmount":"396000000000000000","toChainId":42161,"toTokenAddress":"0x82aF49447D8a07e3bd95BD0d56f35241523fBab1","toAddress":"0x552008c0f6870c2f77e5cC1d2eb9bdff03e30Ea0","settlement":"atomic","checkpoints":[{"stepId":"0x48f0a2f93b0d0a9dab992d07c46bca38516c945101e8f8e08ca42af05b9e6aa9","chainId":42161,"tokenAddress":"0x82aF49447D8a07e3bd95BD0d56f35241523fBab1","minimumAmount":"396000000000000000"}]},"uniqueKey":"routeSlippage","typeLabel":"Root Type for RouteSlippageCommitment · object"},"integrator":{"description":"A string containing tracking information about the integrator of the API","type":"string","uniqueKey":"integrator","typeLabel":"string"},"includedSteps":{"type":"array","items":{"title":"Root Type for Internal Step","description":"Object that represents one step of an `IncludedSteps` array in `Route`","required":["id","action","estimate","tool","type","toolDetails"],"type":"object","properties":{"id":{"description":"Unique identifier of the step","type":"string","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].id","typeLabel":"string"},"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","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"tool":{"description":"The tool used for this step. E.g. `allbridge`","type":"string","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].tool","typeLabel":"string"},"toolDetails":{"description":"The details of the tool used for this step. E.g. `allbridge`","type":"object","properties":{"key":{"description":"The tool key","type":"string","uniqueKey":"includedSteps.items.[INDEX].toolDetails.key","typeLabel":"string"},"name":{"description":"The tool name","type":"string","uniqueKey":"includedSteps.items.[INDEX].toolDetails.name","typeLabel":"string"},"logoURI":{"description":"The tool logo URL","type":"string","uniqueKey":"includedSteps.items.[INDEX].toolDetails.logoURI","typeLabel":"string"}},"isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].toolDetails","typeLabel":"object"},"action":{"title":"Root Type for Action","description":"Object describing what happens in a `Step`","required":["fromToken","fromAmount","fromChainId","toChainId","toToken"],"type":"object","properties":{"fromChainId":{"format":"number","description":"The id of the chain where the transfer should start","type":"number","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].action.fromChainId","typeLabel":"number\u003cnumber>"},"fromAmount":{"description":"The amount that should be transferred including all decimals","type":"string","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].action.fromAmount","typeLabel":"string"},"fromToken":{"title":"Root Type for Token","description":"The sending token","required":["address","chainId","decimals","name","symbol"],"type":"object","properties":{"address":{"description":"Address of the token","type":"string","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].action.fromToken.address","typeLabel":"string"},"decimals":{"format":"number","description":"Number of decimals the token uses","type":"number","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].action.fromToken.decimals","typeLabel":"number\u003cnumber>"},"symbol":{"description":"Symbol of the token","type":"string","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].action.fromToken.symbol","typeLabel":"string"},"chainId":{"format":"number","description":"Id of the token's chain","type":"number","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].action.fromToken.chainId","typeLabel":"number\u003cnumber>"},"name":{"description":"Name of the token","type":"string","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].action.fromToken.name","typeLabel":"string"},"coinKey":{"description":"Identifier for the token","type":"string","uniqueKey":"includedSteps.items.[INDEX].action.fromToken.coinKey","typeLabel":"string"},"logoURI":{"description":"Logo of the token","type":"string","uniqueKey":"includedSteps.items.[INDEX].action.fromToken.logoURI","typeLabel":"string"},"priceUSD":{"description":"Token price in USD","type":"string","uniqueKey":"includedSteps.items.[INDEX].action.fromToken.priceUSD","typeLabel":"string"}},"example":{"address":"0x8f3cf7ad23cd3cadbd9735aff958023239c6a063","symbol":"DAI","decimals":18,"chainId":137,"name":"(PoS) Dai Stablecoin","coinKey":"DAI","priceUSD":"1","logoURI":"https://static.debank.com/image/matic_token/logo_url/0x8f3cf7ad23cd3cadbd9735aff958023239c6a063/549c4205dbb199f1b8b03af783f35e71.png"},"isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].action.fromToken","typeLabel":"Root Type for Token · object"},"toChainId":{"format":"number","description":"The id of the chain where the transfer should end","type":"number","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].action.toChainId","typeLabel":"number\u003cnumber>"},"toToken":{"title":"Root Type for Token","description":"The token that should be transferred to","required":["address","chainId","decimals","name","symbol"],"type":"object","properties":{"address":{"description":"Address of the token","type":"string","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].action.toToken.address","typeLabel":"string"},"decimals":{"format":"number","description":"Number of decimals the token uses","type":"number","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].action.toToken.decimals","typeLabel":"number\u003cnumber>"},"symbol":{"description":"Symbol of the token","type":"string","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].action.toToken.symbol","typeLabel":"string"},"chainId":{"format":"number","description":"Id of the token's chain","type":"number","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].action.toToken.chainId","typeLabel":"number\u003cnumber>"},"name":{"description":"Name of the token","type":"string","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].action.toToken.name","typeLabel":"string"},"coinKey":{"description":"Identifier for the token","type":"string","uniqueKey":"includedSteps.items.[INDEX].action.toToken.coinKey","typeLabel":"string"},"logoURI":{"description":"Logo of the token","type":"string","uniqueKey":"includedSteps.items.[INDEX].action.toToken.logoURI","typeLabel":"string"},"priceUSD":{"description":"Token price in USD","type":"string","uniqueKey":"includedSteps.items.[INDEX].action.toToken.priceUSD","typeLabel":"string"}},"example":{"address":"0x8f3cf7ad23cd3cadbd9735aff958023239c6a063","symbol":"DAI","decimals":18,"chainId":137,"name":"(PoS) Dai Stablecoin","coinKey":"DAI","priceUSD":"1","logoURI":"https://static.debank.com/image/matic_token/logo_url/0x8f3cf7ad23cd3cadbd9735aff958023239c6a063/549c4205dbb199f1b8b03af783f35e71.png"},"isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].action.toToken","typeLabel":"Root Type for Token · object"},"slippage":{"format":"double","description":"The maximum allowed slippage","type":"number","uniqueKey":"includedSteps.items.[INDEX].action.slippage","typeLabel":"number\u003cdouble>"},"fromAddress":{"description":"The sending wallet address","type":"string","uniqueKey":"includedSteps.items.[INDEX].action.fromAddress","typeLabel":"string"},"toAddress":{"description":"The receiving wallet address","type":"string","uniqueKey":"includedSteps.items.[INDEX].action.toAddress","typeLabel":"string"}},"example":{"fromChainId":100,"fromAmount":"1000000000000000000","fromToken":{"address":"0x63e62989d9eb2d37dfdb1f93a22f063635b07d51","symbol":"MIVA","decimals":18,"chainId":100,"name":"Minerva Wallet SuperToken","coinKey":"MIVA","priceUSD":"0.0455272371751059","logoURI":""},"toChainId":137,"toToken":{"address":"0xc0b2983a17573660053beeed6fdb1053107cf387","symbol":"MIVA","decimals":18,"chainId":137,"name":"Minerva Wallet SuperToken","coinKey":"MIVA","priceUSD":"0","logoURI":""},"slippage":0.003},"isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].action","typeLabel":"Root Type for Action · object"},"estimate":{"title":"Root Type for Estimate","description":"An estimate for the current transfer","required":["fromAmount","approvalAddress","toAmount","toAmountMin","tool","executionDuration"],"type":"object","properties":{"tool":{"description":"The tools that is being used for this step","type":"string","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].estimate.tool","typeLabel":"string"},"fromAmount":{"description":"The amount that should be transferred including all decimals","type":"string","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].estimate.fromAmount","typeLabel":"string"},"toAmount":{"description":"The estimated resulting amount of the `toToken` including all decimals","type":"string","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].estimate.toAmount","typeLabel":"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","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].estimate.toAmountMin","typeLabel":"string"},"approvalAddress":{"description":"The contract address for the approval","type":"string","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].estimate.approvalAddress","typeLabel":"string"},"executionDuration":{"description":"The time needed to complete the following step","type":"number","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].estimate.executionDuration","typeLabel":"number"},"fromAmountUSD":{"description":"The amount that should be transferred in USD equivalent","type":"string","uniqueKey":"includedSteps.items.[INDEX].estimate.fromAmountUSD","typeLabel":"string"},"toAmountUSD":{"description":"The estimated resulting amount of the `toToken` in USD equivalent","type":"string","uniqueKey":"includedSteps.items.[INDEX].estimate.toAmountUSD","typeLabel":"string"},"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","uniqueKey":"includedSteps.items.[INDEX].estimate.skipApproval","typeLabel":"boolean"},"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.","type":"array","items":{"title":"Root Type for FeeCost","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.","required":["token","percentage","name","amountUSD","included"],"type":"object","properties":{"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","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].estimate.feeCosts.items.[INDEX].name","typeLabel":"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","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].estimate.feeCosts.items.[INDEX].percentage","typeLabel":"string"},"token":{"title":"Root Type for 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.","required":["address","chainId","decimals","name","symbol"],"type":"object","properties":{"address":{"description":"Address of the token","type":"string","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].estimate.feeCosts.items.[INDEX].token.address","typeLabel":"string"},"decimals":{"format":"number","description":"Number of decimals the token uses","type":"number","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].estimate.feeCosts.items.[INDEX].token.decimals","typeLabel":"number\u003cnumber>"},"symbol":{"description":"Symbol of the token","type":"string","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].estimate.feeCosts.items.[INDEX].token.symbol","typeLabel":"string"},"chainId":{"format":"number","description":"Id of the token's chain","type":"number","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].estimate.feeCosts.items.[INDEX].token.chainId","typeLabel":"number\u003cnumber>"},"name":{"description":"Name of the token","type":"string","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].estimate.feeCosts.items.[INDEX].token.name","typeLabel":"string"},"coinKey":{"description":"Identifier for the token","type":"string","uniqueKey":"includedSteps.items.[INDEX].estimate.feeCosts.items.[INDEX].token.coinKey","typeLabel":"string"},"logoURI":{"description":"Logo of the token","type":"string","uniqueKey":"includedSteps.items.[INDEX].estimate.feeCosts.items.[INDEX].token.logoURI","typeLabel":"string"},"priceUSD":{"description":"Token price in USD","type":"string","uniqueKey":"includedSteps.items.[INDEX].estimate.feeCosts.items.[INDEX].token.priceUSD","typeLabel":"string"}},"example":{"address":"0x8f3cf7ad23cd3cadbd9735aff958023239c6a063","symbol":"DAI","decimals":18,"chainId":137,"name":"(PoS) Dai Stablecoin","coinKey":"DAI","priceUSD":"1","logoURI":"https://static.debank.com/image/matic_token/logo_url/0x8f3cf7ad23cd3cadbd9735aff958023239c6a063/549c4205dbb199f1b8b03af783f35e71.png"},"isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].estimate.feeCosts.items.[INDEX].token","typeLabel":"Root Type for Token · object"},"amountUSD":{"description":"The amount of fees in USD","type":"string","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].estimate.feeCosts.items.[INDEX].amountUSD","typeLabel":"string"},"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","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].estimate.feeCosts.items.[INDEX].included","typeLabel":"boolean"},"description":{"description":"Description of the fee costs","type":"string","uniqueKey":"includedSteps.items.[INDEX].estimate.feeCosts.items.[INDEX].description","typeLabel":"string"},"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","uniqueKey":"includedSteps.items.[INDEX].estimate.feeCosts.items.[INDEX].amount","typeLabel":"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.","type":"object","properties":{"lifiFee":{"description":"LI.FI's slice of `amount`, in the smallest unit of `token`.","type":"string","uniqueKey":"includedSteps.items.[INDEX].estimate.feeCosts.items.[INDEX].feeSplit.lifiFee","typeLabel":"string"},"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","uniqueKey":"includedSteps.items.[INDEX].estimate.feeCosts.items.[INDEX].feeSplit.integratorFee","typeLabel":"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","uniqueKey":"includedSteps.items.[INDEX].estimate.feeCosts.items.[INDEX].feeSplit.intermediaryFee","typeLabel":"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.","type":"array","items":{"title":"Root Type for FeeRecipient","description":"One party receiving a share of this fee entry.","type":"object","required":["name","fee"],"properties":{"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","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].estimate.feeCosts.items.[INDEX].feeSplit.recipients.items.[INDEX].name","typeLabel":"string"},"fee":{"description":"The amount credited to this recipient, in the smallest unit of this fee entry's `token`.","type":"string","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].estimate.feeCosts.items.[INDEX].feeSplit.recipients.items.[INDEX].fee","typeLabel":"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","uniqueKey":"includedSteps.items.[INDEX].estimate.feeCosts.items.[INDEX].feeSplit.recipients.items.[INDEX].type","typeLabel":"string"},"walletAddress":{"description":"The recipient's wallet address on the source chain.","type":"string","uniqueKey":"includedSteps.items.[INDEX].estimate.feeCosts.items.[INDEX].feeSplit.recipients.items.[INDEX].walletAddress","typeLabel":"string"}},"uniqueKey":"includedSteps.items.[INDEX].estimate.feeCosts.items.[INDEX].feeSplit.recipients.items.[INDEX]","typeLabel":"Root Type for FeeRecipient · object"},"uniqueKey":"includedSteps.items.[INDEX].estimate.feeCosts.items.[INDEX].feeSplit.recipients","typeLabel":"Root Type for FeeRecipient · object[]"}},"uniqueKey":"includedSteps.items.[INDEX].estimate.feeCosts.items.[INDEX].feeSplit","typeLabel":"object"}},"example":{"name":"Relayer Gas fee","description":"Relay bridge gas fee","percentage":"0.0000","token":{"address":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48","symbol":"USDC","decimals":6,"chainId":1,"name":"USD Coin","coinKey":"USDC","priceUSD":"0.999578177","logoURI":"https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png"},"amount":"1116","amountUSD":"0.0011","included":true},"uniqueKey":"includedSteps.items.[INDEX].estimate.feeCosts.items.[INDEX]","typeLabel":"Root Type for FeeCost · object"},"uniqueKey":"includedSteps.items.[INDEX].estimate.feeCosts","typeLabel":"Root Type for FeeCost · object[]"},"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.","type":"array","items":{"title":"Root Type for GasCost","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.","required":["token","type","amount"],"type":"object","properties":{"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.","type":"string","enum":["SUM","APPROVE","SEND","FEE"],"example":"SEND","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].estimate.gasCosts.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"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","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].estimate.gasCosts.items.[INDEX].amount","typeLabel":"string"},"token":{"title":"Root Type for Token","description":"The native gas token of the chain the transaction is sent on. `token.chainId` is the chain that consumes the gas.","required":["address","chainId","decimals","name","symbol"],"type":"object","properties":{"address":{"description":"Address of the token","type":"string","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].estimate.gasCosts.items.[INDEX].token.address","typeLabel":"string"},"decimals":{"format":"number","description":"Number of decimals the token uses","type":"number","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].estimate.gasCosts.items.[INDEX].token.decimals","typeLabel":"number\u003cnumber>"},"symbol":{"description":"Symbol of the token","type":"string","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].estimate.gasCosts.items.[INDEX].token.symbol","typeLabel":"string"},"chainId":{"format":"number","description":"Id of the token's chain","type":"number","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].estimate.gasCosts.items.[INDEX].token.chainId","typeLabel":"number\u003cnumber>"},"name":{"description":"Name of the token","type":"string","isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].estimate.gasCosts.items.[INDEX].token.name","typeLabel":"string"},"coinKey":{"description":"Identifier for the token","type":"string","uniqueKey":"includedSteps.items.[INDEX].estimate.gasCosts.items.[INDEX].token.coinKey","typeLabel":"string"},"logoURI":{"description":"Logo of the token","type":"string","uniqueKey":"includedSteps.items.[INDEX].estimate.gasCosts.items.[INDEX].token.logoURI","typeLabel":"string"},"priceUSD":{"description":"Token price in USD","type":"string","uniqueKey":"includedSteps.items.[INDEX].estimate.gasCosts.items.[INDEX].token.priceUSD","typeLabel":"string"}},"example":{"address":"0x8f3cf7ad23cd3cadbd9735aff958023239c6a063","symbol":"DAI","decimals":18,"chainId":137,"name":"(PoS) Dai Stablecoin","coinKey":"DAI","priceUSD":"1","logoURI":"https://static.debank.com/image/matic_token/logo_url/0x8f3cf7ad23cd3cadbd9735aff958023239c6a063/549c4205dbb199f1b8b03af783f35e71.png"},"isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].estimate.gasCosts.items.[INDEX].token","typeLabel":"Root Type for Token · object"},"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","uniqueKey":"includedSteps.items.[INDEX].estimate.gasCosts.items.[INDEX].price","typeLabel":"string"},"estimate":{"description":"Estimated units of gas the transaction consumes","type":"string","uniqueKey":"includedSteps.items.[INDEX].estimate.gasCosts.items.[INDEX].estimate","typeLabel":"string"},"limit":{"description":"Suggested gas limit: `estimate` plus a safety buffer. Use this value when submitting the transaction, not `estimate`.","type":"string","uniqueKey":"includedSteps.items.[INDEX].estimate.gasCosts.items.[INDEX].limit","typeLabel":"string"},"amountUSD":{"description":"Amount of the gas cost in USD","type":"string","uniqueKey":"includedSteps.items.[INDEX].estimate.gasCosts.items.[INDEX].amountUSD","typeLabel":"string"}},"example":{"type":"SEND","price":"128468782","estimate":"459000","limit":"596700","amount":"58967170938000","amountUSD":"0.1156","token":{"address":"0x0000000000000000000000000000000000000000","symbol":"ETH","decimals":18,"chainId":1,"name":"ETH","coinKey":"ETH","priceUSD":"1959.83","logoURI":"https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2/logo.png"}},"uniqueKey":"includedSteps.items.[INDEX].estimate.gasCosts.items.[INDEX]","typeLabel":"Root Type for GasCost · object"},"uniqueKey":"includedSteps.items.[INDEX].estimate.gasCosts","typeLabel":"Root Type for GasCost · object[]"},"data":{"description":"Arbitrary data that depends on the the used tool","type":"object","properties":{"bid":{"type":"object","properties":{"user":{"type":"string","uniqueKey":"includedSteps.items.[INDEX].estimate.data.bid.user","typeLabel":"string"},"router":{"type":"string","uniqueKey":"includedSteps.items.[INDEX].estimate.data.bid.router","typeLabel":"string"},"initiator":{"type":"string","uniqueKey":"includedSteps.items.[INDEX].estimate.data.bid.initiator","typeLabel":"string"},"sendingChainId":{"format":"number","type":"number","uniqueKey":"includedSteps.items.[INDEX].estimate.data.bid.sendingChainId","typeLabel":"number\u003cnumber>"},"sendingAssetId":{"type":"string","uniqueKey":"includedSteps.items.[INDEX].estimate.data.bid.sendingAssetId","typeLabel":"string"},"amount":{"type":"string","uniqueKey":"includedSteps.items.[INDEX].estimate.data.bid.amount","typeLabel":"string"},"receivingChainId":{"format":"number","type":"number","uniqueKey":"includedSteps.items.[INDEX].estimate.data.bid.receivingChainId","typeLabel":"number\u003cnumber>"},"receivingAssetId":{"type":"string","uniqueKey":"includedSteps.items.[INDEX].estimate.data.bid.receivingAssetId","typeLabel":"string"},"amountReceived":{"type":"string","uniqueKey":"includedSteps.items.[INDEX].estimate.data.bid.amountReceived","typeLabel":"string"},"receivingAddress":{"type":"string","uniqueKey":"includedSteps.items.[INDEX].estimate.data.bid.receivingAddress","typeLabel":"string"},"transactionId":{"type":"string","uniqueKey":"includedSteps.items.[INDEX].estimate.data.bid.transactionId","typeLabel":"string"},"expiry":{"format":"number","type":"number","uniqueKey":"includedSteps.items.[INDEX].estimate.data.bid.expiry","typeLabel":"number\u003cnumber>"},"callDataHash":{"type":"string","uniqueKey":"includedSteps.items.[INDEX].estimate.data.bid.callDataHash","typeLabel":"string"},"callTo":{"type":"string","uniqueKey":"includedSteps.items.[INDEX].estimate.data.bid.callTo","typeLabel":"string"},"encryptedCallData":{"type":"string","uniqueKey":"includedSteps.items.[INDEX].estimate.data.bid.encryptedCallData","typeLabel":"string"},"sendingChainTxManagerAddress":{"type":"string","uniqueKey":"includedSteps.items.[INDEX].estimate.data.bid.sendingChainTxManagerAddress","typeLabel":"string"},"receivingChainTxManagerAddress":{"type":"string","uniqueKey":"includedSteps.items.[INDEX].estimate.data.bid.receivingChainTxManagerAddress","typeLabel":"string"},"bidExpiry":{"format":"number","type":"number","uniqueKey":"includedSteps.items.[INDEX].estimate.data.bid.bidExpiry","typeLabel":"number\u003cnumber>"}},"uniqueKey":"includedSteps.items.[INDEX].estimate.data.bid","typeLabel":"object"},"bidSignature":{"type":"string","uniqueKey":"includedSteps.items.[INDEX].estimate.data.bidSignature","typeLabel":"string"},"gasFeeInReceivingToken":{"type":"string","uniqueKey":"includedSteps.items.[INDEX].estimate.data.gasFeeInReceivingToken","typeLabel":"string"},"totalFee":{"type":"string","uniqueKey":"includedSteps.items.[INDEX].estimate.data.totalFee","typeLabel":"string"},"metaTxRelayerFee":{"type":"string","uniqueKey":"includedSteps.items.[INDEX].estimate.data.metaTxRelayerFee","typeLabel":"string"},"routerFee":{"type":"string","uniqueKey":"includedSteps.items.[INDEX].estimate.data.routerFee","typeLabel":"string"}},"uniqueKey":"includedSteps.items.[INDEX].estimate.data","typeLabel":"object"}},"example":{"tool":"relaydepository","fromAmount":"50000000","fromAmountUSD":"49.9789","toAmount":"76673","toAmountMin":"76290","toAmountUSD":"50.0577","executionDuration":2,"approvalAddress":"0x1231DEB6f5749EF6cE6943a275A1D3E7486F4EaE","feeCosts":[{"name":"LIFI Fixed Fee","description":"Fixed LIFI fee, independent of any other fee","percentage":"0.0025","token":{"address":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48","symbol":"USDC","decimals":6,"chainId":1,"name":"USD Coin","coinKey":"USDC","priceUSD":"0.999578177","logoURI":"https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png"},"amount":"125000","amountUSD":"0.1249","included":true},{"name":"Relayer Gas fee","description":"Relay bridge gas fee","percentage":"0.0000","token":{"address":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48","symbol":"USDC","decimals":6,"chainId":1,"name":"USD Coin","coinKey":"USDC","priceUSD":"0.999578177","logoURI":"https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png"},"amount":"1116","amountUSD":"0.0011","included":true},{"name":"Relayer Service fee","description":"Relay bridge service fee","percentage":"0.0011","token":{"address":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48","symbol":"USDC","decimals":6,"chainId":1,"name":"USD Coin","coinKey":"USDC","priceUSD":"0.999578177","logoURI":"https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png"},"amount":"53822","amountUSD":"0.0538","included":true}],"gasCosts":[{"type":"SEND","price":"128468782","estimate":"459000","limit":"596700","amount":"58967170938000","amountUSD":"0.1156","token":{"address":"0x0000000000000000000000000000000000000000","symbol":"ETH","decimals":18,"chainId":1,"name":"ETH","coinKey":"ETH","priceUSD":"1959.83","logoURI":"https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2/logo.png"}}]},"isRequired":true,"uniqueKey":"includedSteps.items.[INDEX].estimate","typeLabel":"Root Type for Estimate · object"}},"uniqueKey":"includedSteps.items.[INDEX]","typeLabel":"Root Type for Internal Step · object"},"uniqueKey":"includedSteps","typeLabel":"Root Type for Internal Step · object[]"},"referrer":{"description":"A string containing tracking information about the referrer of the integrator","type":"string","uniqueKey":"referrer","typeLabel":"string"},"execution":{"description":"An objection containing status information about the execution","uniqueKey":"execution","typeLabel":"any"},"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.","type":"object","properties":{"svmTransactionVersion":{"description":"Solana transaction version actually built; Jito always uses 0.","type":"number","enum":[0,1],"uniqueKey":"transactionRequest.svmTransactionVersion","typeLabel":"enum\u003cnumber>"}},"uniqueKey":"transactionRequest","typeLabel":"object"},"stepSimulation":{"title":"Step simulation metadata","description":"Metadata about step-level transaction simulation during stepTransaction. Present on EVM and Solana stepTransaction responses when the simulation runs (on EVM, when gas limits are resolved).","required":["status","gasSource"],"type":"object","properties":{"status":{"description":"Whether and how step simulation was attempted","type":"string","enum":["success","skipped","not-attempted","failure"],"isRequired":true,"uniqueKey":"stepSimulation.status","typeLabel":"enum\u003cstring>"},"gasSource":{"description":"Source used for the SEND gas limit on the returned transaction","type":"string","enum":["simulation","tool"],"isRequired":true,"uniqueKey":"stepSimulation.gasSource","typeLabel":"enum\u003cstring>"},"disabledReason":{"description":"Present when status is not-attempted","type":"string","enum":["globally_disabled","simulation_unavailable","chain_not_supported"],"uniqueKey":"stepSimulation.disabledReason","typeLabel":"enum\u003cstring>"},"skipReason":{"description":"Present when status is skipped","type":"string","uniqueKey":"stepSimulation.skipReason","typeLabel":"string"},"revertReason":{"description":"Present when status is failure and dry-run mode is enabled","type":"string","uniqueKey":"stepSimulation.revertReason","typeLabel":"string"}},"uniqueKey":"stepSimulation","typeLabel":"Step simulation metadata · object"}},"example":{"id":"0x48f0a2f93b0d0a9dab992d07c46bca38516c945101e8f8e08ca42af05b9e6aa9","type":"cross","tool":"relay","action":{"fromChainId":100,"toChainId":137,"fromToken":{"address":"0x63e62989d9eb2d37dfdb1f93a22f063635b07d51","symbol":"MIVA","decimals":18,"chainId":100,"name":"Minerva Wallet SuperToken","coinKey":"MIVA","priceUSD":"0.04547537276751318","logoURI":""},"toToken":{"address":"0xc0b2983a17573660053beeed6fdb1053107cf387","symbol":"MIVA","decimals":18,"chainId":137,"name":"Minerva Wallet SuperToken","coinKey":"MIVA","priceUSD":"0","logoURI":""},"fromAmount":"1000000000000000000","slippage":0.003},"estimate":{"fromAmount":"1000000000000000000","toAmount":"999500000000000000","toAmountMin":"999500000000000000","approvalAddress":"0x115909BDcbaB21954bEb4ab65FC2aBEE9866fa93","feeCosts":[{"name":"Gas Fee","description":"Covers gas expense for sending funds to user on receiving chain.","percentage":"0","token":{"address":"0x63e62989d9eb2d37dfdb1f93a22f063635b07d51","symbol":"MIVA","decimals":18,"chainId":100,"name":"Minerva Wallet SuperToken","coinKey":"MIVA","priceUSD":"0.04547537276751318","logoURI":""},"amount":"0","amountUSD":"0.00","included":true},{"name":"Relay Fee","description":"Covers gas expense for claiming user funds on receiving chain.","percentage":"0","token":{"address":"0x63e62989d9eb2d37dfdb1f93a22f063635b07d51","symbol":"MIVA","decimals":18,"chainId":100,"name":"Minerva Wallet SuperToken","coinKey":"MIVA","priceUSD":"0.04547537276751318","logoURI":""},"amount":"0","amountUSD":"0.00","included":true},{"name":"Router Fee","description":"Router service fee.","percentage":"0.0005","token":{"address":"0x63e62989d9eb2d37dfdb1f93a22f063635b07d51","symbol":"MIVA","decimals":18,"chainId":100,"name":"Minerva Wallet SuperToken","coinKey":"MIVA","priceUSD":"0.04547537276751318","logoURI":""},"amount":"500000000000000","amountUSD":"0.00","included":true}],"gasCosts":[{"type":"SEND","price":"1260000000","estimate":"140000","limit":"175000","amount":"176400000000000","amountUSD":"0.00","token":{"address":"0x0000000000000000000000000000000000000000","symbol":"xDai","decimals":18,"chainId":100,"name":"xDai","coinKey":"xDai","priceUSD":"1","logoURI":"https://static.debank.com/image/xdai_token/logo_url/xdai/1207e67652b691ef3bfe04f89f4b5362.png"}}],"data":{"bid":{"user":"0x53F68B2186E4a4aB4dD976eD32de68db45BA360b","router":"0xeE2Ef40F688607CB23618d9312d62392786d13EB","initiator":"0x53F68B2186E4a4aB4dD976eD32de68db45BA360b","sendingChainId":100,"sendingAssetId":"0x63e62989d9eb2d37dfdb1f93a22f063635b07d51","amount":"1000000000000000000","receivingChainId":137,"receivingAssetId":"0xc0b2983a17573660053beeed6fdb1053107cf387","amountReceived":"999500000000000000","receivingAddress":"0x10fBFF9b9450D3A2d9d1612d6dE3726fACD8809E","transactionId":"0x48f0a2f93b0d0a9dab992d07c46bca38516c945101e8f8e08ca42af05b9e6aa9","expiry":1643364189,"callDataHash":"0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470","callTo":"0x0000000000000000000000000000000000000000","encryptedCallData":"0x","sendingChainTxManagerAddress":"0x115909BDcbaB21954bEb4ab65FC2aBEE9866fa93","receivingChainTxManagerAddress":"0x6090De2EC76eb1Dc3B5d632734415c93c44Fd113","bidExpiry":1643105290},"gasFeeInReceivingToken":"0","totalFee":"500000000000000","metaTxRelayerFee":"0","routerFee":"500000000000000"}},"integrator":"fee-demo"},"uniqueKey":"","typeLabel":"Root Type for Step · object"},"examples":{"StepResponseExample":{"title":"StepResponseExample","value":{"id":"a8dc011a-f52d-4492-9e99-21de64b5453a","type":"lifi","tool":"1inch","toolDetails":{"key":"1inch","logoURI":"https://raw.githubusercontent.com/lifinance/types/main/src/assets/icons/exchanges/oneinch.svg","name":"1inch"},"action":{"fromChainId":100,"toChainId":100,"fromToken":{"address":"0x0000000000000000000000000000000000000000","symbol":"xDai","decimals":18,"chainId":100,"name":"xDai","coinKey":"xDai","priceUSD":"1","logoURI":"https://static.debank.com/image/xdai_token/logo_url/xdai/1207e67652b691ef3bfe04f89f4b5362.png"},"toToken":{"name":"Minerva Wallet SuperToken","symbol":"MIVA","coinKey":"MIVA","decimals":18,"chainId":100,"logoURI":"https://minerva.digital/i/MIVA-Token_200x200.png","address":"0x63e62989d9eb2d37dfdb1f93a22f063635b07d51"},"fromAmount":"1000000000000000000","slippage":0.003,"fromAddress":"0x552008c0f6870c2f77e5cC1d2eb9bdff03e30Ea0","toAddress":"0x552008c0f6870c2f77e5cC1d2eb9bdff03e30Ea0"},"estimate":{"fromAmount":"1000000000000000000","toAmount":"21922914496086353975","toAmountMin":"21265227061203763356","approvalAddress":"0x1111111254fb6c44bac0bed2854e76f90643097d","feeCosts":[],"gasCosts":[{"type":"SEND","price":"1000000000","estimate":"252364","limit":"315455","amount":"252364000000000","amountUSD":"0.00","token":{"address":"0x0000000000000000000000000000000000000000","symbol":"xDai","decimals":18,"chainId":100,"name":"xDai","coinKey":"xDai","priceUSD":"1","logoURI":"https://static.debank.com/image/xdai_token/logo_url/xdai/1207e67652b691ef3bfe04f89f4b5362.png"}}],"data":{"fromToken":{"name":"xDAI","address":"0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee","symbol":"xDAI","decimals":18,"logoURI":"https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0x6B175474E89094C44Da98b954EedeAC495271d0F/logo.png"},"toToken":{"name":"Minerva Wallet SuperToken","address":"0x63e62989d9eb2d37dfdb1f93a22f063635b07d51","symbol":"MIVA","decimals":18,"logoURI":"https://minerva.digital/i/MIVA-Token_200x200.png"},"toTokenAmount":"21922914496086353975","fromTokenAmount":"1000000000000000000","protocols":[{"name":"GNOSIS_HONEYSWAP","part":100,"fromTokenAddress":"0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee","toTokenAddress":"0x63e62989d9eb2d37dfdb1f93a22f063635b07d51"}],"estimatedGas":252364}},"integrator":"fee-demo","transactionRequest":{"from":"0x552008c0f6870c2f77e5cC1d2eb9bdff03e30Ea0","to":"0x1111111254fb6c44bac0bed2854e76f90643097d","chainId":100,"data":"0x...","value":"0x0de0b6b3a7640000","gasPrice":"0xb2d05e00","gasLimit":"0x0e9cb2"},"includedSteps":[{"id":"a8dc011a-f52d-4492-9e99-21de64b5453a","type":"swap","tool":"1inch","toolDetails":{"key":"1inch","logoURI":"https://raw.githubusercontent.com/lifinance/types/main/src/assets/icons/exchanges/oneinch.svg","name":"1inch"},"action":{"fromChainId":100,"toChainId":100,"fromToken":{"address":"0x0000000000000000000000000000000000000000","symbol":"xDai","decimals":18,"chainId":100,"name":"xDai","coinKey":"xDai","priceUSD":"1","logoURI":"https://static.debank.com/image/xdai_token/logo_url/xdai/1207e67652b691ef3bfe04f89f4b5362.png"},"toToken":{"name":"Minerva Wallet SuperToken","symbol":"MIVA","coinKey":"MIVA","decimals":18,"chainId":100,"logoURI":"https://minerva.digital/i/MIVA-Token_200x200.png","address":"0x63e62989d9eb2d37dfdb1f93a22f063635b07d51"},"fromAmount":"1000000000000000000","slippage":0.003,"fromAddress":"0x552008c0f6870c2f77e5cC1d2eb9bdff03e30Ea0","toAddress":"0x552008c0f6870c2f77e5cC1d2eb9bdff03e30Ea0"},"estimate":{"fromAmount":"1000000000000000000","toAmount":"21922914496086353975","toAmountMin":"21265227061203763356","approvalAddress":"0x1111111254fb6c44bac0bed2854e76f90643097d","feeCosts":[],"gasCosts":[{"type":"SEND","price":"1000000000","estimate":"252364","limit":"315455","amount":"252364000000000","amountUSD":"0.00","token":{"address":"0x0000000000000000000000000000000000000000","symbol":"xDai","decimals":18,"chainId":100,"name":"xDai","coinKey":"xDai","priceUSD":"1","logoURI":"https://static.debank.com/image/xdai_token/logo_url/xdai/1207e67652b691ef3bfe04f89f4b5362.png"}}],"data":{"fromToken":{"name":"xDAI","address":"0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee","symbol":"xDAI","decimals":18,"logoURI":"https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0x6B175474E89094C44Da98b954EedeAC495271d0F/logo.png"},"toToken":{"name":"Minerva Wallet SuperToken","address":"0x63e62989d9eb2d37dfdb1f93a22f063635b07d51","symbol":"MIVA","decimals":18,"logoURI":"https://minerva.digital/i/MIVA-Token_200x200.png"},"toTokenAmount":"21922914496086353975","fromTokenAmount":"1000000000000000000","protocols":[{"name":"GNOSIS_HONEYSWAP","part":100,"fromTokenAddress":"0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee","toTokenAddress":"0x63e62989d9eb2d37dfdb1f93a22f063635b07d51"}],"estimatedGas":252364}}}]}}},"exampleType":"examples"}},"description":"The step populated with the transaction data","exampleType":"examples"},"f9b920fc-7a03-45a7-a6e9-a1dfa611a6e0":{"description":"Invalid Step Request","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{},"servers":{"b0730262-4388-4811-ad69-ca25fee73841":{"url":"https://li.quest","description":"LI.FI Production Environment"},"99a2e2ba-7b12-4205-b954-204c6fd2ee53":{"url":"https://staging.li.quest","description":"LI.FI Staging Environment"}}},"originalFileLocation":"openapi.yaml"},"subdomain":"lifi","siteName":"LI.FI","title":"Populate a step with transaction data - LI.FI","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/api-reference/advanced/populate-a-step-with-transaction-data","matchLevel":0},"zh-Hans":{"href":"/zh-Hans/introduction/introduction","matchLevel":4}}},"lastModified":"2026-10-29T06:58:53.291Z","originalFileLocation":"api-reference/advanced/populate-a-step-with-transaction-data.mdx","locale":"en"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"This endpoint expects a full Step object which usually is retrieved by calling the /advanced/routes endpoint and selecting the most suitable Route. Afterwards the transaction for every required Step can be retrieved using this endpoint. Attention: This request is more complex and intended to be used via our JavaScript SDK.\">\u003cmeta data-mint-head name=\"application-name\" content=\"LI.FI\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/lifi/uhSlA1vHRUBoEVMw/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/lifi/uhSlA1vHRUBoEVMw/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/lifi/uhSlA1vHRUBoEVMw/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/lifi/uhSlA1vHRUBoEVMw/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/lifi/uhSlA1vHRUBoEVMw/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/lifi/uhSlA1vHRUBoEVMw/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/lifi/uhSlA1vHRUBoEVMw/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/lifi/uhSlA1vHRUBoEVMw/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/lifi/uhSlA1vHRUBoEVMw/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Populate a step with transaction data - LI.FI\">\u003cmeta data-mint-head property=\"og:description\" content=\"This endpoint expects a full Step object which usually is retrieved by calling the /advanced/routes endpoint and selecting the most suitable Route. Afterwards the transaction for every required Step can be retrieved using this endpoint. Attention: This request is more complex and intended to be used via our JavaScript SDK.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"LI.FI\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.li.fi/api-reference/advanced/populate-a-step-with-transaction-data\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://lifi.mintlify.site/_mintlify/api/og/v2?division=Advanced+routes\u0026amp;title=Populate+a+step+with+transaction+data\u0026amp;description=This+endpoint+expects+a+full+%60Step%60+object+which+usually+is+retrieved+by+calling+the+%60%2Fadvanced%2Froutes%60+endpoint+and+selecting+the+most+suitable+%60Route%60.+Afterw\u0026amp;theme=d2a96653fbdd3b58627ba1f7\u0026amp;signature=5617ab8f347382b86bc8bb8d431423fe8fdf1e3af6706fb8e52424235f6666eb\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Populate a step with transaction data - LI.FI\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"This endpoint expects a full Step object which usually is retrieved by calling the /advanced/routes endpoint and selecting the most suitable Route. Afterwards the transaction for every required Step can be retrieved using this endpoint. Attention: This request is more complex and intended to be used via our JavaScript SDK.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://lifi.mintlify.site/_mintlify/api/og/v2?division=Advanced+routes\u0026amp;title=Populate+a+step+with+transaction+data\u0026amp;description=This+endpoint+expects+a+full+%60Step%60+object+which+usually+is+retrieved+by+calling+the+%60%2Fadvanced%2Froutes%60+endpoint+and+selecting+the+most+suitable+%60Route%60.+Afterw\u0026amp;theme=d2a96653fbdd3b58627ba1f7\u0026amp;signature=5617ab8f347382b86bc8bb8d431423fe8fdf1e3af6706fb8e52424235f6666eb\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/lifi/uhSlA1vHRUBoEVMw/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"LI.FI\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#5C67FF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.li.fi/api-reference/advanced/populate-a-step-with-transaction-data\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/advanced/populate-a-step-with-transaction-data.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.li.fi/#organization\",\"name\":\"LI.FI\",\"url\":\"https://docs.li.fi\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/lifi/EmProAEgMrruLUbI/logo/light.png?fit=max\u0026auto=format\u0026n=EmProAEgMrruLUbI\u0026q=85\u0026s=f435348680e682acea6e3b9af339ed7a\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.li.fi#website\",\"name\":\"LI.FI\",\"url\":\"https://docs.li.fi\",\"publisher\":{\"@id\":\"https://docs.li.fi/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.li.fi/api-reference/advanced/populate-a-step-with-transaction-data#webpage\",\"url\":\"https://docs.li.fi/api-reference/advanced/populate-a-step-with-transaction-data\",\"name\":\"Populate a step with transaction data\",\"description\":\"This endpoint expects a full Step object which usually is retrieved by calling the /advanced/routes endpoint and selecting the most suitable Route. Afterwards the transaction for every required Step can be retrieved using this endpoint. Attention: This request is more complex and intended to be used via our JavaScript SDK.\",\"dateModified\":\"2026-10-29T06:58:53.291Z\",\"isPartOf\":{\"@id\":\"https://docs.li.fi#website\"},\"breadcrumb\":{\"@id\":\"https://docs.li.fi/api-reference/advanced/populate-a-step-with-transaction-data#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.li.fi/api-reference/advanced/populate-a-step-with-transaction-data#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Requesting a quote\",\"item\":\"https://docs.li.fi/api-reference/presets/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Advanced routes\",\"item\":\"https://docs.li.fi/api-reference/advanced/get-a-set-of-routes-for-a-request-that-describes-a-transfer-of-tokens\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Populate a step with transaction data\",\"item\":\"https://docs.li.fi/api-reference/advanced/populate-a-step-with-transaction-data\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.li.fi/api-reference/advanced/populate-a-step-with-transaction-data#apireference\",\"headline\":\"Populate a step with transaction data\",\"name\":\"Populate a step with transaction data\",\"description\":\"This endpoint expects a full Step object which usually is retrieved by calling the /advanced/routes endpoint and selecting the most suitable Route. Afterwards the transaction for every required Step can be retrieved using this endpoint. Attention: This request is more complex and intended to be used via our JavaScript SDK.\",\"url\":\"https://docs.li.fi/api-reference/advanced/populate-a-step-with-transaction-data\",\"mainEntityOfPage\":{\"@id\":\"https://docs.li.fi/api-reference/advanced/populate-a-step-with-transaction-data#webpage\"},\"dateModified\":\"2026-10-29T06:58:53.291Z\",\"publisher\":{\"@id\":\"https://docs.li.fi/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.li.fi#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"LI.FI\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"LI.FI\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/advanced/populate-a-step-with-transaction-data.md","siteName":"LI.FI","nav":{"global":null,"languages":[{"language":"en","tabs":[{"tab":"Overview","pages":[{"title":"Overview","href":"/introduction/introduction"}]},{"tab":"Enterprise (New)","pages":[{"title":"Enterprise (New)","href":"/enterprise/overview"}]},{"tab":"API Reference","groups":[{"group":"About APIs","pages":[{"title":"Overview","href":"/api-reference/introduction"},{"title":"OpenAPI Specification","href":"/api-reference/openapi-spec"},{"title":"Rate Limits and API Authentication","href":"/api-reference/rate-limits"},{"title":"API Key Security","href":"/api-reference/api-key-security"},{"title":"Error Codes","href":"/api-reference/error-codes"}]},{"group":"General API","pages":[{"group":"Chains","pages":[{"openapi":"openapi.yaml GET /v1/chains","title":"Get information about all currently supported chains","href":"/api-reference/get-information-about-all-currently-supported-chains"}]},{"group":"Tokens","pages":[{"title":"Fetch all known tokens","openapi":"get /v1/tokens","href":"/api-reference/fetch-all-known-tokens"},{"openapi":"get /v1/token","title":"Fetch information about a Token","href":"/api-reference/fetch-information-about-a-token"}]},{"group":"Tools","pages":[{"openapi":"get /v1/tools","title":"Get available bridges and exchanges","href":"/api-reference/get-available-bridges-and-exchanges"}]},{"group":"Connections","pages":[{"openapi":"get /v1/connections","title":"Returns all possible connections between two chains.","href":"/api-reference/returns-all-possible-connections-based-on-a-from-or-tochain"}]},{"group":"Gas endpoints","pages":[{"openapi":"get /v1/gas/prices/{chainId}","title":"Get gas price for the specified chainId","href":"/api-reference/gas/get-gas-price-for-the-specified-chainid"},{"openapi":"get /v1/gas/prices","title":"Get gas prices for enabled chains","href":"/api-reference/gas/get-gas-prices-for-enabled-chains"},{"openapi":"get /v1/gas/suggestion/{chain}","title":"Get a gas suggestion for the specified chain","href":"/api-reference/get-a-gas-suggestion-for-the-specified-chain"},{"openapi":"get /v1/gas/status","title":"Get status information about a lifuel transaction","href":"/api-reference/get-status-information-about-a-lifuel-transaction"},{"openapi":"get /v1/gas/refetch","title":"In case a transaction was missed by a relayer, this endpoint can be used to force a tx to be re-fetched.","href":"/api-reference/in-case-a-transaction-was-missed-by-a-relayer-this-endpoint-can-be-used-to-force-a-tx-to-be-re-fetched"}]},{"group":"Transaction status","pages":[{"openapi":"get /v1/status","title":"Check the status of a cross chain transfer","href":"/api-reference/check-the-status-of-a-cross-chain-transfer"}]},{"group":"Integrator fee information","pages":[{"openapi":"get /v1/integrators/{integratorId}/withdraw/{chainId}","title":"Get transaction request for withdrawing collected integrator's fees by chain","href":"/api-reference/get-transaction-request-for-withdrawing-collected-integrators-fees-by-chain"},{"openapi":"get /v1/integrators/{integratorId}","title":"Get integrator's collected fees data for all supported chains","href":"/api-reference/get-integrators-collected-fees-data-for-all-supported-chains"}]},{"group":"Analytics","pages":[{"openapi":"get /v1/analytics/transfers/summary","title":"Get the total amount of a token received on a specific chain, for cross-chain transfers.","href":"/api-reference/get-the-total-amount-of-a-token-received-on-a-specific-chain-for-cross-chain-transfers"},{"openapi":"get /v1/analytics/transfers","title":"Get a list of filtered transfers","href":"/api-reference/get-a-list-of-filtered-transfers"},{"openapi":"get /v2/analytics/transfers","title":"Get a paginated list of filtered transfers","href":"/api-reference/get-a-paginated-list-of-filtered-transfers"}]}]},{"group":"Requesting a quote","pages":[{"group":"API presets","pages":[{"title":"API Presets","href":"/api-reference/presets/overview"},{"title":"Stablecoin preset","href":"/api-reference/presets/stablecoin"}]},{"group":"Single-step quote","pages":[{"openapi":"get /v1/quote","title":"Get a quote for a token transfer","href":"/api-reference/get-a-quote-for-a-token-transfer"},{"openapi":"get /v1/quote/toAmount","title":"Get a quote for a token transfer","href":"/api-reference/get-a-quote-for-a-token-transfer-1"},{"openapi":"post /v1/quote/contractCalls","title":"Perform multiple contract calls across blockchains (BETA)","href":"/api-reference/perform-multiple-contract-calls-across-blockchains-beta"}]},{"group":"Advanced routes","pages":[{"openapi":"post /v1/advanced/routes","title":"Get a set of routes for a request that describes a transfer of tokens","description":"In order to execute any transfer, you must first request possible `Routes`. From the result set a `Route` can be selected and executed by retrieving the transaction for every included `Step` using the `/steps/transaction` endpoint.\n**Attention**: This request is more complex and intended to be used via our [JavaScript SDK](https://docs.li.fi/integrate-li.fi-js-sdk/install-li.fi-sdk).","href":"/api-reference/advanced/get-a-set-of-routes-for-a-request-that-describes-a-transfer-of-tokens"},{"openapi":"post /v1/advanced/stepTransaction","title":"Populate a step with transaction data","href":"/api-reference/advanced/populate-a-step-with-transaction-data"}]},{"group":"Parse transaction call data","pages":[{"openapi":"get /v1/calldata/parse","title":"Parse transaction call data (BETA)","description":"This endpoint allows to pass transaction call data. It will then parse the call data based on known and on-chain ABIs to provide a JSON overview of the internal transaction information.","href":"/api-reference/parse-transaction-call-data-beta"}]}]}]},{"tab":"SDK","pages":[{"title":"SDK","href":"/sdk/overview"}]},{"tab":"Widget","pages":[{"title":"Widget","href":"/widget/overview"}]},{"tab":"Composer","pages":[{"title":"Composer","href":"/composer/overview"}]},{"tab":"Earn","pages":[{"title":"Earn","href":"/earn/overview"}]},{"tab":"Perps","pages":[{"title":"Perps","href":"/perps/overview"}]},{"tab":"Intents \u0026 Solvers","pages":[{"title":"Intents \u0026 Solvers","href":"/lifi-intents/introduction"}]},{"tab":"For Agents","pages":[{"title":"For Agents","href":"/agents/overview"}]},{"tab":"Widget Playground","href":"https://playground.li.fi/"},{"tab":"Bigmi","pages":[{"title":"Bigmi","href":"/bigmi/overview"}]},{"tab":"Guides","pages":[{"title":"Guides","href":"/guides/gas-options"}]},{"tab":"FAQs","pages":[{"title":"FAQs","href":"/faqs/fees-monetization"}]}]},{"language":"zh-Hans","pages":[{"title":"zh-Hans","href":"/zh-Hans/introduction/introduction"}]}]},"basePath":"","title":"Populate a step with transaction data - LI.FI","buildId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","deploymentId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CybtLBIt.js","utils-BMLj2fvV.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-B6In562Y.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Dr8Mfhp9.js","snippetPresets-2rmQvMVl.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-WMqJYdZj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CJ-MlPHu.js","shallow-dY3TMRCk.js","getApiPlaygroundDisplay-v-1B2bKm.js","CodeSnippet-BDhiTB7U.js","CodeSnippets-D9hnzQcS.js","Page-C4GwDT3_.js","getPastedJson-Th2V45jI.js","icon-BQXch1W9.js","MethodPill-BCqUneP3.js","DuplicateIcon-Q_-bhurZ.js","createIcon-DUjLHRqp.js","DynamicMarkdown-B-f2cqXQ.js","SectionHeading-Da5NsV4v.js","axios-vUo_bRtp.js","Markdown-D13FWkIM.js","clsx-D3Isdib3.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-C-XZBk9h.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink--qIqmmVG.js"]}