Returns all possible connections between two chains.
This endpoint gives information about all possible transfers between chains.
fromChain and toChain are required. Additional filters such as token, bridge, and exchange can be used to narrow the result further.
Information about which chains and tokens are supported can be taken from the response of the /v1/chains endpoint.
Information about which bridges and exchanges are supported can be taken from the response of the /v1/tools endpoint.
GET
/
v1
/
connections
Returns all possible connections between two chains.
curl --request GET \ --url https://li.quest/v1/connections
{"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":""},"chroma":{"liveDeploymentHistoryId":"6ae4467b6255dab49421940b","collectionId":"fe96f741-47cb-43b3-b1b9-c7bfc174e641","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae4467b6255dab49421940b"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae4467b6255dab49421940b","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"en","tag":"Overview","count":48},{"language":"en","tag":"Composer","count":46},{"language":"zh-Hans","tag":"Composer","count":46},{"language":"zh-Hans","tag":"概述","count":44},{"language":"en","tag":"API Reference","count":34},{"language":"en","tag":"Intents \u0026 Solvers","count":32},{"language":"zh-Hans","tag":"意图与求解器","count":32},{"language":"en","tag":"Integrate via Composer API","count":30},{"language":"zh-Hans","tag":"通过 Composer API 集成","count":30},{"language":"zh-Hans","tag":"API 参考","count":29},{"language":"en","tag":"Reference","count":23},{"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":"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":"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":"byok-sep-25","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/returns-all-possible-connections-based-on-a-from-or-tochain","slug":"/api-reference/returns-all-possible-connections-based-on-a-from-or-tochain","pageMetadata":{"openapi":"get /v1/connections","title":"Returns all possible connections between two chains.","description":"This endpoint gives information about all possible transfers between chains.\n`fromChain` and `toChain` are required. Additional filters such as token, bridge, and exchange can be used to narrow the result further.\nInformation about which chains and tokens are supported can be taken from the response of the /v1/chains endpoint.\nInformation about which bridges and exchanges are supported can be taken from the response of the `/v1/tools` endpoint.","href":"/api-reference/returns-all-possible-connections-based-on-a-from-or-tochain"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"This endpoint gives information about all possible transfers between chains.\\n\", _jsx(_components.code, {\n children: \"fromChain\"\n }), \" and \", _jsx(_components.code, {\n children: \"toChain\"\n }), \" are required. Additional filters such as token, bridge, and exchange can be used to narrow the result further.\\nInformation about which chains and tokens are supported can be taken from the response of the /v1/chains endpoint.\\nInformation about which bridges and exchanges are supported can be taken from the response of the \", _jsx(_components.code, {\n children: \"/v1/tools\"\n }), \" endpoint.\"]\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}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"codeStyling":"system","config":{},"pageMetadata":{"openapi":"get /v1/connections","title":"Returns all possible connections between two chains.","description":"This endpoint gives information about all possible transfers between chains.\n`fromChain` and `toChain` are required. Additional filters such as token, bridge, and exchange can be used to narrow the result further.\nInformation about which chains and tokens are supported can be taken from the response of the /v1/chains endpoint.\nInformation about which bridges and exchanges are supported can be taken from the response of the `/v1/tools` endpoint.","href":"/api-reference/returns-all-possible-connections-based-on-a-from-or-tochain"}}},"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":{"parameters":["daec2e55-049c-4f5c-8177-90a6f2df2ff9","ce081cfb-bdaf-40a2-9130-3321bc7a9c74","6a3ae46d-8a89-4156-a1d4-9665ff4e6598","1621cfae-fbff-4f68-b663-4ce3a89eb14b","f3f21694-07ce-454d-b218-6fb0466023c8","b9ed2113-c0fd-4b26-a511-610abb434ee7","db2bb0f3-fd8c-41e7-a877-cd7a8f2137d4","4d6bf229-c3dd-4297-bbdf-4e36f4de3ce9","1f801825-2c38-420e-ad3b-95ab6ec734ee","c9f7d2e6-f2e7-49d4-8b18-62eb0c5a777d","a7a96f55-3379-4b39-97d5-11498c380047","6750ef60-e392-4065-89b7-6b9892b5f1a9","6fdbd4ff-010b-4273-b5b9-2ca3cf6a1c8f","693fde69-3ee8-4a0d-9079-698796ec97c7"],"responses":{"200":"6f5336f2-8414-4a6c-a65e-a0feaed51164"},"summary":"Returns all possible connections between two chains.","description":"This endpoint gives information about all possible transfers between chains.\n`fromChain` and `toChain` are required. Additional filters such as token, bridge, and exchange can be used to narrow the result further.\nInformation about which chains and tokens are supported can be taken from the response of the /v1/chains endpoint.\nInformation about which bridges and exchanges are supported can be taken from the response of the `/v1/tools` endpoint.","method":"get","type":"path","servers":["2d571c46-53ec-43a1-9793-fbf2719d026d","ea026e35-a5ad-4fd4-9864-837362b78550"],"security":[],"path":"/v1/connections","baseUrlOptions":["https://li.quest","https://staging.li.quest"],"title":"Returns all possible connections between two chains.","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"daec2e55-049c-4f5c-8177-90a6f2df2ff9":{"example":"POL","name":"fromChain","description":"The chain that should be the start of the possible connections.","schema":{"type":"string","isRequired":true,"description":"The chain that should be the start of the possible connections.","uniqueKey":"","typeLabel":"string"},"in":"query","required":true},"ce081cfb-bdaf-40a2-9130-3321bc7a9c74":{"name":"toChain","description":"The chain that should be the end of the possible connections.","schema":{"type":"string","isRequired":true,"description":"The chain that should be the end of the possible connections.","uniqueKey":"","typeLabel":"string"},"in":"query","required":true},"6a3ae46d-8a89-4156-a1d4-9665ff4e6598":{"example":"DAI","name":"fromToken","description":"Only return connections starting with this token.","schema":{"type":"string","isRequired":false,"description":"Only return connections starting with this token.","uniqueKey":"","typeLabel":"string"},"in":"query","required":false},"1621cfae-fbff-4f68-b663-4ce3a89eb14b":{"name":"toToken","description":"Only return connections ending with this token.","schema":{"type":"string","isRequired":false,"description":"Only return connections ending with this token.","uniqueKey":"","typeLabel":"string"},"in":"query","required":false},"f3f21694-07ce-454d-b218-6fb0466023c8":{"example":"EVM,SVM,UTXO,MVM,TVM,STL","name":"chainTypes","description":"Restrict the resulting connections to the given chainTypes. Available values: EVM, SVM, UTXO, MVM, TVM, STL.","schema":{"type":"string","isRequired":false,"description":"Restrict the resulting connections to the given chainTypes. Available values: EVM, SVM, UTXO, MVM, TVM, STL.","uniqueKey":"","typeLabel":"string"},"in":"query","required":false},"b9ed2113-c0fd-4b26-a511-610abb434ee7":{"name":"allowBridges","description":"List of bridges that are allowed for this transaction. Retrieve the current catalog from the `/v1/tools` endpoint.","schema":{"type":"array","items":{"type":"string","uniqueKey":"items.[INDEX]","typeLabel":"string"},"isRequired":false,"description":"List of bridges that are allowed for this transaction. Retrieve the current catalog from the `/v1/tools` endpoint.","uniqueKey":"","typeLabel":"string[]"},"in":"query","required":false},"db2bb0f3-fd8c-41e7-a877-cd7a8f2137d4":{"name":"denyBridges","description":"List of bridges that are not allowed for this transaction. Retrieve the current catalog from the `/v1/tools` endpoint.","schema":{"type":"array","items":{"type":"string","uniqueKey":"items.[INDEX]","typeLabel":"string"},"isRequired":false,"description":"List of bridges that are not allowed for this transaction. Retrieve the current catalog from the `/v1/tools` endpoint.","uniqueKey":"","typeLabel":"string[]"},"in":"query","required":false},"4d6bf229-c3dd-4297-bbdf-4e36f4de3ce9":{"name":"preferBridges","description":"List of bridges that should be preferred for this transaction. Retrieve the current catalog from the `/v1/tools` endpoint.","schema":{"type":"array","items":{"type":"string","uniqueKey":"items.[INDEX]","typeLabel":"string"},"isRequired":false,"description":"List of bridges that should be preferred for this transaction. Retrieve the current catalog from the `/v1/tools` endpoint.","uniqueKey":"","typeLabel":"string[]"},"in":"query","required":false},"1f801825-2c38-420e-ad3b-95ab6ec734ee":{"name":"allowExchanges","description":"List of exchanges that are allowed for this transaction. Retrieve the current catalog from the `/v1/tools` endpoint.","schema":{"type":"array","items":{"type":"string","uniqueKey":"items.[INDEX]","typeLabel":"string"},"isRequired":false,"description":"List of exchanges that are allowed for this transaction. Retrieve the current catalog from the `/v1/tools` endpoint.","uniqueKey":"","typeLabel":"string[]"},"in":"query","required":false},"c9f7d2e6-f2e7-49d4-8b18-62eb0c5a777d":{"name":"denyExchanges","description":"List of exchanges that are not allowed for this transaction. Retrieve the current catalog from the `/v1/tools` endpoint.","schema":{"type":"array","items":{"type":"string","uniqueKey":"items.[INDEX]","typeLabel":"string"},"isRequired":false,"description":"List of exchanges that are not allowed for this transaction. Retrieve the current catalog from the `/v1/tools` endpoint.","uniqueKey":"","typeLabel":"string[]"},"in":"query","required":false},"a7a96f55-3379-4b39-97d5-11498c380047":{"name":"preferExchanges","description":"List of exchanges that should be preferred for this transaction. Retrieve the current catalog from the `/v1/tools` endpoint.","schema":{"type":"array","items":{"type":"string","uniqueKey":"items.[INDEX]","typeLabel":"string"},"isRequired":false,"description":"List of exchanges that should be preferred for this transaction. Retrieve the current catalog from the `/v1/tools` endpoint.","uniqueKey":"","typeLabel":"string[]"},"in":"query","required":false},"6750ef60-e392-4065-89b7-6b9892b5f1a9":{"name":"allowSwitchChain","description":"Whether connections that require chain switch should be included in the response.","schema":{"default":true,"type":"boolean","isRequired":false,"description":"Whether connections that require chain switch should be included in the response.","uniqueKey":"","typeLabel":"boolean"},"in":"query","required":false},"6fdbd4ff-010b-4273-b5b9-2ca3cf6a1c8f":{"name":"allowDestinationCall","description":"Whether connections that includes destination call should be included in the response.","schema":{"default":true,"type":"boolean","isRequired":false,"description":"Whether connections that includes destination call should be included in the response.","uniqueKey":"","typeLabel":"boolean"},"in":"query","required":false},"693fde69-3ee8-4a0d-9079-698796ec97c7":{"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"}},"responses":{"6f5336f2-8414-4a6c-a65e-a0feaed51164":{"content":{"application/json":{"schema":{"title":"Root Type for ConnectionsResponse","description":"","type":"object","properties":{"connections":{"description":"The possible connections","type":"array","items":{"title":"Root Type for Connection","description":"A connection from one chain to another defined by tokens that can be exchanged for another.","required":["toTokens","toChainId","fromTokens","fromChainId"],"type":"object","properties":{"fromChainId":{"description":"The sending chain","type":"number","isRequired":true,"uniqueKey":"connections.items.[INDEX].fromChainId","typeLabel":"number"},"toChainId":{"description":"The receiving chain","type":"number","isRequired":true,"uniqueKey":"connections.items.[INDEX].toChainId","typeLabel":"number"},"fromTokens":{"description":"List of possible tokens that can be sent","type":"array","items":{"title":"Root Type for BaseToken","description":"Minimal token representation returned by the connections endpoint","required":["address","chainId"],"type":"object","properties":{"address":{"description":"Address of the token","type":"string","isRequired":true,"uniqueKey":"connections.items.[INDEX].fromTokens.items.[INDEX].address","typeLabel":"string"},"chainId":{"format":"number","description":"Id of the token's chain","type":"number","isRequired":true,"uniqueKey":"connections.items.[INDEX].fromTokens.items.[INDEX].chainId","typeLabel":"number\u003cnumber>"}},"example":{"address":"0x8f3cf7ad23cd3cadbd9735aff958023239c6a063","chainId":137},"uniqueKey":"connections.items.[INDEX].fromTokens.items.[INDEX]","typeLabel":"Root Type for BaseToken · object"},"isRequired":true,"uniqueKey":"connections.items.[INDEX].fromTokens","typeLabel":"Root Type for BaseToken · object[]"},"toTokens":{"description":"List of tokens that can be received","type":"array","items":{"title":"Root Type for BaseToken","description":"Minimal token representation returned by the connections endpoint","required":["address","chainId"],"type":"object","properties":{"address":{"description":"Address of the token","type":"string","isRequired":true,"uniqueKey":"connections.items.[INDEX].toTokens.items.[INDEX].address","typeLabel":"string"},"chainId":{"format":"number","description":"Id of the token's chain","type":"number","isRequired":true,"uniqueKey":"connections.items.[INDEX].toTokens.items.[INDEX].chainId","typeLabel":"number\u003cnumber>"}},"example":{"address":"0x8f3cf7ad23cd3cadbd9735aff958023239c6a063","chainId":137},"uniqueKey":"connections.items.[INDEX].toTokens.items.[INDEX]","typeLabel":"Root Type for BaseToken · object"},"isRequired":true,"uniqueKey":"connections.items.[INDEX].toTokens","typeLabel":"Root Type for BaseToken · object[]"}},"example":{"connections":[{"fromChainId":137,"toChainId":1,"fromTokens":[{"address":"0x8f3cf7ad23cd3cadbd9735aff958023239c6a063","chainId":137}],"toTokens":[{"address":"0x6b175474e89094c44da98b954eedeac495271d0f","chainId":1},{"address":"0x0000000000000000000000000000000000000000","chainId":1}]},{"fromChainId":137,"toChainId":10,"fromTokens":[{"address":"0x8f3cf7ad23cd3cadbd9735aff958023239c6a063","chainId":137}],"toTokens":[{"address":"0xda10009cbd5d07dd0cecc66161fc93d7c9000da1","chainId":10},{"address":"0x0000000000000000000000000000000000000000","chainId":10}]},{"fromChainId":137,"toChainId":56,"fromTokens":[{"address":"0x8f3cf7ad23cd3cadbd9735aff958023239c6a063","chainId":137}],"toTokens":[{"address":"0x1af3f329e8be154074d8769d1ffa4ee058b1dbc3","chainId":56},{"address":"0x2170ed0880ac9a755fd29b2688956bd959f933f8","chainId":56}]}]},"uniqueKey":"connections.items.[INDEX]","typeLabel":"Root Type for Connection · object"},"uniqueKey":"connections","typeLabel":"Root Type for Connection · object[]"}},"example":{"connections":[{"fromChainId":137,"toChainId":1,"fromTokens":[{"address":"0x8f3cf7ad23cd3cadbd9735aff958023239c6a063","chainId":137}],"toTokens":[{"address":"0x6b175474e89094c44da98b954eedeac495271d0f","chainId":1},{"address":"0x0000000000000000000000000000000000000000","chainId":1}]}]},"uniqueKey":"","typeLabel":"Root Type for ConnectionsResponse · object"},"examples":{"ConnectionsResponse":{"title":"ConnectionsResponse","value":{"connections":[{"fromChainId":137,"toChainId":1,"fromTokens":[{"address":"0x8f3cf7ad23cd3cadbd9735aff958023239c6a063","chainId":137}],"toTokens":[{"address":"0x6b175474e89094c44da98b954eedeac495271d0f","chainId":1},{"address":"0x0000000000000000000000000000000000000000","chainId":1}]}]}}},"exampleType":"examples"}},"description":"","exampleType":"examples"}},"security":{},"servers":{"2d571c46-53ec-43a1-9793-fbf2719d026d":{"url":"https://li.quest","description":"LI.FI Production Environment"},"ea026e35-a5ad-4fd4-9864-837362b78550":{"url":"https://staging.li.quest","description":"LI.FI Staging Environment"}}},"originalFileLocation":"openapi.yaml"},"subdomain":"lifi","siteName":"LI.FI","title":"Returns all possible connections between two chains. - LI.FI","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/api-reference/returns-all-possible-connections-based-on-a-from-or-tochain","matchLevel":0},"zh-Hans":{"href":"/zh-Hans/introduction/introduction","matchLevel":4}}},"lastModified":"2026-04-03T14:43:48.427Z","originalFileLocation":"api-reference/returns-all-possible-connections-based-on-a-from-or-tochain.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 gives information about all possible transfers between chains. fromChain and toChain are required. Additional filters such as token, bridge, and exchange can be used to narrow the result further. Information about which chains and tokens are supported can be taken from the response of the /v1/chains endpoint. Information about which bridges and exchanges are supported can be taken from the response of the /v1/tools endpoint.\">\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=\"Returns all possible connections between two chains. - LI.FI\">\u003cmeta data-mint-head property=\"og:description\" content=\"This endpoint gives information about all possible transfers between chains. fromChain and toChain are required. Additional filters such as token, bridge, and exchange can be used to narrow the result further. Information about which chains and tokens are supported can be taken from the response of the /v1/chains endpoint. Information about which bridges and exchanges are supported can be taken from the response of the /v1/tools endpoint.\">\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/returns-all-possible-connections-based-on-a-from-or-tochain\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://lifi.mintlify.app/_mintlify/api/og/v2?division=Connections\u0026amp;title=Returns+all+possible+connections+between+two+chains.\u0026amp;description=This+endpoint+gives+information+about+all+possible+transfers+between+chains.%0A%60fromChain%60+and+%60toChain%60+are+required.+Additional+filters+such+as+token%2C+bridge%2C+a\u0026amp;theme=bbd760f308f6962e114ab426\u0026amp;signature=24f3195c9320723e4f5aa94778bd7cae56b5f3a59bdaad1a4b551f44b132b3db\">\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=\"Returns all possible connections between two chains. - LI.FI\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"This endpoint gives information about all possible transfers between chains. fromChain and toChain are required. Additional filters such as token, bridge, and exchange can be used to narrow the result further. Information about which chains and tokens are supported can be taken from the response of the /v1/chains endpoint. Information about which bridges and exchanges are supported can be taken from the response of the /v1/tools endpoint.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://lifi.mintlify.app/_mintlify/api/og/v2?division=Connections\u0026amp;title=Returns+all+possible+connections+between+two+chains.\u0026amp;description=This+endpoint+gives+information+about+all+possible+transfers+between+chains.%0A%60fromChain%60+and+%60toChain%60+are+required.+Additional+filters+such+as+token%2C+bridge%2C+a\u0026amp;theme=bbd760f308f6962e114ab426\u0026amp;signature=24f3195c9320723e4f5aa94778bd7cae56b5f3a59bdaad1a4b551f44b132b3db\">\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/returns-all-possible-connections-based-on-a-from-or-tochain\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/returns-all-possible-connections-based-on-a-from-or-tochain.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/returns-all-possible-connections-based-on-a-from-or-tochain#webpage\",\"url\":\"https://docs.li.fi/api-reference/returns-all-possible-connections-based-on-a-from-or-tochain\",\"name\":\"Returns all possible connections between two chains.\",\"description\":\"This endpoint gives information about all possible transfers between chains. fromChain and toChain are required. Additional filters such as token, bridge, and exchange can be used to narrow the result further. Information about which chains and tokens are supported can be taken from the response of the /v1/chains endpoint. Information about which bridges and exchanges are supported can be taken from the response of the /v1/tools endpoint.\",\"dateModified\":\"2026-04-03T14:43:48.427Z\",\"isPartOf\":{\"@id\":\"https://docs.li.fi#website\"},\"breadcrumb\":{\"@id\":\"https://docs.li.fi/api-reference/returns-all-possible-connections-based-on-a-from-or-tochain#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.li.fi/api-reference/returns-all-possible-connections-based-on-a-from-or-tochain#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"General API\",\"item\":\"https://docs.li.fi/api-reference/get-information-about-all-currently-supported-chains\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Returns all possible connections between two chains.\",\"item\":\"https://docs.li.fi/api-reference/returns-all-possible-connections-based-on-a-from-or-tochain\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.li.fi/api-reference/returns-all-possible-connections-based-on-a-from-or-tochain#apireference\",\"headline\":\"Returns all possible connections between two chains.\",\"name\":\"Returns all possible connections between two chains.\",\"description\":\"This endpoint gives information about all possible transfers between chains. fromChain and toChain are required. Additional filters such as token, bridge, and exchange can be used to narrow the result further. Information about which chains and tokens are supported can be taken from the response of the /v1/chains endpoint. Information about which bridges and exchanges are supported can be taken from the response of the /v1/tools endpoint.\",\"url\":\"https://docs.li.fi/api-reference/returns-all-possible-connections-based-on-a-from-or-tochain\",\"mainEntityOfPage\":{\"@id\":\"https://docs.li.fi/api-reference/returns-all-possible-connections-based-on-a-from-or-tochain#webpage\"},\"dateModified\":\"2026-04-03T14:43:48.427Z\",\"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\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","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","description":"This endpoint can be used to get information about the bridges and exchanges available trough our service","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","description":"This endpoint can be used to get the most recent gas prices for the supplied 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","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)","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":"Returns all possible connections between two chains. - LI.FI","buildId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","deploymentId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CS552b7R.js","utils-DDTCYAF2.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-De8ttokP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DrwRDvAh.js","snippetPresets-DtAN0nWx.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-D5rWArI6.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-O2i12wsz.js","shallow-DV8xABTt.js","getApiPlaygroundDisplay-DBZ0B5Jx.js","CodeSnippet-BVi0tPUX.js","CodeSnippets-CqASbIwY.js","Page-m07pfKpT.js","getPastedJson-DG9vsMS8.js","icon-CXzRSCr8.js","MethodPill-BdKVtEuX.js","DuplicateIcon-CZlmBrJI.js","createIcon-biFEUKPL.js","DynamicMarkdown-B54_zNBF.js","SectionHeading-DwwHK3Pt.js","axios-vUo_bRtp.js","Markdown-DfhCTwyA.js","clsx-xpJZXxdP.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BTZUMDnx.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-DqdKa2R4.js"]}