The Suave Aggregator SDK will only function properly in a browser-like environment. You can use a library like web3-mock to simulate this in Node.js.
Suave Aggregator is a multi-chain liquidity aggregation protocol that supports any-to-any swaps by aggregating bridges and exchanges.If you prefer Swagger docs please find them here.
Supported Chains
Suave Aggregator supports the following chains for token swapping and bridging (with more coming soon):
Chain Name
Chain ID
Ethereum
1
Optimism
10
Polygon
137
Arbitrum
42161
{"docsConfig":{"$schema":"https://mintlify.com/docs.json","theme":"mint","name":"Suave Docs","colors":{"primary":"#7F56D9","light":"#07C983","dark":"#07C983"},"favicon":"/favicon.svg","logo":{"light":"https://mintcdn.com/suave/tjkg_y2xg-GO4Glm/logo/light.svg?fit=max\u0026auto=format\u0026n=tjkg_y2xg-GO4Glm\u0026q=85\u0026s=a5a14b2e64ebbcb9c977644fb1d2b0f9","dark":"https://mintcdn.com/suave/tjkg_y2xg-GO4Glm/logo/dark.svg?fit=max\u0026auto=format\u0026n=tjkg_y2xg-GO4Glm\u0026q=85\u0026s=5d7ca245acdc634ea51df18024fcccda"},"api":{"openapi":["openapi.yml"]},"footer":{"socials":{"twitter":"https://twitter.com/@suave_money_","github":"https://github.com/suave-money","linkedin":"https://www.linkedin.com/company/suavemoney/"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"suave","hasAudioNarration":false,"actualSubdomain":"suave","customDomains":["docs.suave.money"],"gitSource":{"type":"github","owner":"suave-money","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{},"buildId":"6ae91fa1f2d1fb3a80bda038:success","clientVersion":"0.0.4142","searchFilterCounts":[{"language":"default","tag":"Documentation","count":26},{"language":"default","tag":"Suave Checkout","count":20},{"language":"default","tag":"API Documentation","count":10},{"language":"default","tag":"SDK Documentation","count":8},{"language":"default","tag":"Suave Aggregator","count":6},{"language":"default","tag":"Payment webhooks","count":4},{"language":"default","tag":"Functionality","count":4},{"language":"default","tag":"Routing","count":3},{"language":"default","tag":"SDK Guide","count":3},{"language":"default","tag":"Payment API","count":2}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"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":"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},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"table{width:100%}thead,tbody{width:100%;display:table}th{text-align:left}"}],"page":{"pagePath":"suave.ag/overview","slug":"/suave.ag/overview","pageMetadata":{"title":"Overview","description":null,"href":"/suave.ag/overview","hidden":false},"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`,p:`p`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Card,Heading,Table}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsx(Card,{title:`Disclaimer`,icon:`triangle-exclamation`,children:_jsxs(_components.p,{children:[`The Suave Aggregator SDK will only function properly in a browser-like environment. You can use a library like `,_jsx(_components.a,{href:`https://github.com/DePayFi/web3-mock`,children:`web3-mock`}),` to simulate this in Node.js.`]})}),`\n`,_jsx(_components.p,{children:`Suave Aggregator is a multi-chain liquidity aggregation protocol that supports any-to-any swaps by aggregating bridges and exchanges.`}),`\n`,_jsxs(_components.p,{children:[`If you prefer Swagger docs please find them `,_jsx(_components.a,{href:`https://api.suave.ag/docs/`,children:`here`}),`.`]}),`\n`,_jsx(Heading,{level:`3`,id:`supported-chains`,children:`Supported Chains`}),`\n`,_jsx(_components.p,{children:`Suave Aggregator supports the following chains for token swapping and bridging (with more coming soon):`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Chain Name`}),_jsx(_components.th,{children:`Chain ID`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Ethereum`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`1`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Optimism`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`10`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Polygon`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`137`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Arbitrum`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`42161`})]})]})]})]})}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":{"config":{},"pageMetadata":{"title":"Overview","description":null,"href":"/suave.ag/overview","hidden":false}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Supported Chains","slug":"supported-chains","depth":3,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"suave","siteName":"Suave Docs","title":"Overview - Suave Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-02-08T00:30:45.722Z","originalFileLocation":"suave.ag/overview.mdx"},"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=\"system\"}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=\"application-name\" content=\"Suave Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/suave/V4Iuedio_MWCEOt1/_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/suave/V4Iuedio_MWCEOt1/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/suave/V4Iuedio_MWCEOt1/_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/suave/V4Iuedio_MWCEOt1/_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/suave/V4Iuedio_MWCEOt1/_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/suave/V4Iuedio_MWCEOt1/_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/suave/V4Iuedio_MWCEOt1/_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/suave/V4Iuedio_MWCEOt1/_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/suave/V4Iuedio_MWCEOt1/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Overview - Suave Docs\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Suave Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.suave.money/suave.ag/overview\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://suave.mintlify.site/_mintlify/api/og/v2?division=Suave+Aggregator\u0026amp;title=Overview\u0026amp;theme=c7ecf57c11c803a883fe135d\u0026amp;signature=3a44530c9f47516c5a4d32abfa5f16f840f1cfe199482bdbe5a927cbdbd9f629\">\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=\"Overview - Suave Docs\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://suave.mintlify.site/_mintlify/api/og/v2?division=Suave+Aggregator\u0026amp;title=Overview\u0026amp;theme=c7ecf57c11c803a883fe135d\u0026amp;signature=3a44530c9f47516c5a4d32abfa5f16f840f1cfe199482bdbe5a927cbdbd9f629\">\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/suave/V4Iuedio_MWCEOt1/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Suave Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#7F56D9\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.suave.money/suave.ag/overview\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/suave.ag/overview.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.suave.money/#organization\",\"name\":\"Suave Docs\",\"url\":\"https://docs.suave.money\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/suave/tjkg_y2xg-GO4Glm/logo/light.svg?fit=max\u0026auto=format\u0026n=tjkg_y2xg-GO4Glm\u0026q=85\u0026s=a5a14b2e64ebbcb9c977644fb1d2b0f9\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.suave.money#website\",\"name\":\"Suave Docs\",\"url\":\"https://docs.suave.money\",\"publisher\":{\"@id\":\"https://docs.suave.money/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.suave.money/suave.ag/overview#webpage\",\"url\":\"https://docs.suave.money/suave.ag/overview\",\"name\":\"Overview\",\"dateModified\":\"2026-02-08T00:30:45.722Z\",\"isPartOf\":{\"@id\":\"https://docs.suave.money#website\"},\"breadcrumb\":{\"@id\":\"https://docs.suave.money/suave.ag/overview#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.suave.money/suave.ag/overview#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Suave Docs\",\"item\":\"https://docs.suave.money\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Overview\",\"item\":\"https://docs.suave.money/suave.ag/overview\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.suave.money/suave.ag/overview#article\",\"headline\":\"Overview\",\"name\":\"Overview\",\"url\":\"https://docs.suave.money/suave.ag/overview\",\"mainEntityOfPage\":{\"@id\":\"https://docs.suave.money/suave.ag/overview#webpage\"},\"dateModified\":\"2026-02-08T00:30:45.722Z\",\"publisher\":{\"@id\":\"https://docs.suave.money/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.suave.money#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Suave Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Suave Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/suave.ag/overview.md","siteName":"Suave Docs","nav":{"global":null,"anchors":[{"anchor":"Documentation","icon":"book-open","groups":[{"group":"Suave Aggregator","pages":[{"title":"Overview","href":"/suave.ag/overview"},{"group":"SDK Guide","pages":[{"title":"Installation","description":"To get started with the Suave SDK, follow these installation instructions.","href":"/suave.ag/sdk/install"},{"title":"Request Routes \u0026 Quotes","href":"/suave.ag/sdk/request"},{"title":"Execute Routes \u0026 Quotes","href":"/suave.ag/sdk/execute"}]},{"group":"API Reference","pages":[{"title":"Cross-chain swap routes","openapi":"POST /v1/routes","href":"/suave.ag/api/routes"},{"title":"Get supported tokens","openapi":"GET /v1/tokens","href":"/suave.ag/api/get-tokens"}]}]},{"group":"Suave Checkout","pages":[{"title":"Introduction","href":"/checkout.suave.money/introduction"},{"title":"Use Cases","href":"/checkout.suave.money/use-cases"},{"group":"API Documentation","pages":[{"title":"Authentication","href":"/checkout.suave.money/api/authentication"},{"title":"Data types","href":"/checkout.suave.money/api/data-types"},{"group":"Quote API","pages":[{"title":null,"href":"/checkout.suave.money/api/quote/overview"},{"title":"Get Routing","openapi":"GET /api/v1/quote","href":"/checkout.suave.money/api/quote/get"}]},{"group":"Payment API","pages":[{"title":"Create Payment Link","openapi":"POST /api/v1/payment_link","href":"/checkout.suave.money/api/endpoint/create"},{"title":"Get Payment Order","openapi":"GET /api/v1/payment/{id}","href":"/checkout.suave.money/api/endpoint/get"}]},{"group":"Payment webhooks","pages":[{"title":null,"href":"/checkout.suave.money/api/webhook/overview"},{"title":"Get Webhooks","openapi":"GET /api/v1/webhook_subscription","href":"/checkout.suave.money/api/webhook/get"},{"title":"Create Webhook","openapi":"POST /api/v1/webhook_subscription","href":"/checkout.suave.money/api/webhook/create"},{"title":"Delete Webhook","openapi":"DELETE /api/v1/webhook_subscription/{id}","href":"/checkout.suave.money/api/webhook/delete"}]}]},{"group":"SDK Documentation","pages":[{"title":null,"href":"/checkout.suave.money/sdk/overview"},{"title":null,"href":"/checkout.suave.money/sdk/getting-started"},{"group":"Functionality","pages":[{"group":"Routing","pages":[{"title":null,"href":"/checkout.suave.money/sdk/get-routes"},{"title":null,"href":"/checkout.suave.money/sdk/get-routes-streaming"},{"title":null,"href":"/checkout.suave.money/sdk/execute-route"}]},{"title":null,"href":"/checkout.suave.money/sdk/quotes"}]},{"group":"React","pages":[{"title":null,"href":"/checkout.suave.money/sdk/hooks"},{"title":null,"href":"/checkout.suave.money/sdk/components"}]}]}]}]},{"anchor":"Demo","href":"https://checkout.suave.money/demo","icon":"computer-classic"},{"anchor":"Contact us","href":"mailto:team@suave.money","icon":"envelope"}]},"basePath":"","title":"Overview - Suave Docs","buildId":"dpl_G2Qd45vZZ7MkBiGF9yYx8ZsbbKXX","deploymentId":"dpl_G2Qd45vZZ7MkBiGF9yYx8ZsbbKXX","dynamics":[],"chunks":[]}
