Install @coin-voyage/swapkit to add a cross-chain token swap experience to your React application.
Use @coin-voyage/swapkit when you want to add token swap capabilities to your application. It gives your users an embeddable interface for connecting a wallet, selecting source and destination tokens, requesting a quote, configuring slippage, executing the swap, and tracking its status.SwapKit is independent from the SALE and DEPOSIT payment flows provided by PayKit. If your application needs to accept customer payments or fund a specified wallet or account, use @coin-voyage/paykit.
Installation
Install SwapKit with its core peer dependencies:
npm i @coin-voyage/swapkit @tanstack/react-query react react-dom styled-components
bun add @coin-voyage/swapkit @tanstack/react-query react react-dom styled-components
Install the wallet peer dependencies listed by @coin-voyage/swapkit for the chains your application supports. SwapKit uses styled-components and does not require Tailwind CSS.
Add the swap widget
Wrap Swap with the re-exported WalletProvider and SwapKitProvider:
defaultSourceCurrency and defaultDestinationCurrency accept a chain ID and an optional token address. Defaults are read when the widget mounts; remount the widget with a new React key to apply changed defaults.
Configure the swap experience
Use defaultSlippageBps to start with a custom slippage tolerance. When you omit it, SwapKit lets the quote service choose the tolerance automatically.
Use onComplete to receive the completed swap’s orderId and transactionHash.
Use onError to surface execution errors in your application.
Set mode on SwapKitProvider to "light", "dark", or "auto", and pass theme to customize the widget. See Styling / Theme for an example and all theme properties.
SwapKitProvider uses the public API client and accepts an API key, but never an
admin signing key.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"CoinVoyage","description":"CoinVoyage enables seamless crypto payments into your app from any supported chain and coin.","colors":{"primary":"#d6296f","light":"#e688bd","dark":"#fc1777"},"logo":{"light":"https://mintcdn.com/coinvoyage-3c99945b/k1rKznLxzrSYSaFy/assets/logo-light.svg?fit=max\u0026auto=format\u0026n=k1rKznLxzrSYSaFy\u0026q=85\u0026s=2b6b11284d0d65d96596f7018cd0b7a5","dark":"https://mintcdn.com/coinvoyage-3c99945b/k1rKznLxzrSYSaFy/assets/logo.svg?fit=max\u0026auto=format\u0026n=k1rKznLxzrSYSaFy\u0026q=85\u0026s=85255bd9be1e06b981fc529f59ec164a"},"favicon":"https://mintcdn.com/coinvoyage-3c99945b/k1rKznLxzrSYSaFy/assets/favicon.ico?fit=max\u0026auto=format\u0026n=k1rKznLxzrSYSaFy\u0026q=85\u0026s=6f48ac74892e40e9ff118ec7b80a3520","api":{"playground":{"display":"interactive"}},"navbar":{"links":[{"icon":"twitter","href":"https://x.com/Coin_Voyage","label":"X"},{"href":"https://github.com/coin-voyage/","label":"Github"}],"primary":{"type":"github","href":"https://github.com/coin-voyage"}},"footer":{"socials":{"x":"https://x.com/Coin_Voyage"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"coinvoyage-3c99945b","hasAudioNarration":false,"actualSubdomain":"coinvoyage-3c99945b","customDomains":["docs.coinvoyage.io"],"gitSource":{"type":"github","owner":"coin-voyage","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"feedback":{"agentFeedback":true,"thumbs":true,"edits":true,"issues":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6af32744734ccd78509c2e8b","clientVersion":"0.0.4227","searchFilterCounts":[{"language":"default","tag":"API reference","count":50},{"language":"default","tag":"Documentation","count":45},{"language":"default","tag":"API integration","count":13},{"language":"default","tag":"ApiClient reference","count":10},{"language":"default","tag":"off-ramp","count":9},{"language":"default","tag":"Dashboard","count":7},{"language":"default","tag":"onramp","count":7},{"language":"default","tag":"orders","count":7},{"language":"default","tag":"invoices","count":6},{"language":"default","tag":"Core concepts","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"email":"help@coinvoyage.io","showHelpButton":true}},"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":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"sdk/swapkit","slug":"/sdk/swapkit","pageMetadata":{"title":"CoinVoyage SwapKit — embeddable token swaps","sidebarTitle":"SwapKit","description":"Install @coin-voyage/swapkit to add a cross-chain token swap experience to your React application.","layout":{"description":{"visible":false}},"href":"/sdk/swapkit"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Install @coin-voyage/swapkit to add a cross-chain token swap experience to your React application.\"\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`,pre:`pre`,span:`span`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,CodeGroup,Heading,Note}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!CodeGroup)_missingMdxReference(`CodeGroup`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Use `,_jsx(_components.code,{children:`@coin-voyage/swapkit`}),` when you want to add token swap capabilities to your application. It gives your users an embeddable interface for connecting a wallet, selecting source and destination tokens, requesting a quote, configuring slippage, executing the swap, and tracking its status.`]}),`\n`,_jsxs(_components.p,{children:[`SwapKit is independent from the SALE and DEPOSIT payment flows provided by PayKit. If your application needs to accept customer payments or fund a specified wallet or account, use `,_jsx(_components.a,{href:`/sdk/overview`,children:_jsx(_components.code,{children:`@coin-voyage/paykit`})}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`installation`,children:`Installation`}),`\n`,_jsx(_components.p,{children:`Install SwapKit with its core peer dependencies:`}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`npm`,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`npm`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` i`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` @coin-voyage/swapkit`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` @tanstack/react-query`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` react`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` react-dom`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` styled-components`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`pnpm`,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`pnpm`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` add`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` @coin-voyage/swapkit`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` @tanstack/react-query`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` react`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` react-dom`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` styled-components`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`yarn`,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`yarn`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` add`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` @coin-voyage/swapkit`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` @tanstack/react-query`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` react`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` react-dom`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` styled-components`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`bun`,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`bun`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` add`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` @coin-voyage/swapkit`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` @tanstack/react-query`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` react`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` react-dom`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` styled-components`})]}),`\n`]})})})]}),`\n`,_jsxs(_components.p,{children:[`Install the wallet peer dependencies listed by `,_jsx(_components.code,{children:`@coin-voyage/swapkit`}),` for the chains your application supports. SwapKit uses `,_jsx(_components.code,{children:`styled-components`}),` and does not require Tailwind CSS.`]}),`\n`,_jsx(Heading,{level:`2`,id:`add-the-swap-widget`,children:`Add the swap widget`}),`\n`,_jsxs(_components.p,{children:[`Wrap `,_jsx(_components.code,{children:`Swap`}),` with the re-exported `,_jsx(_components.code,{children:`WalletProvider`}),` and `,_jsx(_components.code,{children:`SwapKitProvider`}),`:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`23`,language:`tsx`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`tsx`,children:_jsxs(_components.code,{language:`tsx`,numberOfLines:`23`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"use client\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`;`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`Swap`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`SwapKitProvider`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`WalletProvider`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` } `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`from`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"@coin-voyage/swapkit\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`;`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`export`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` function`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` SwapWidget`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`() {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` return`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` (`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#4EC9B0`},children:`WalletProvider`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`>`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#4EC9B0`},children:`SwapKitProvider`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#9CDCFE`},children:` apiKey`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`{`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`process`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`env`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:`NEXT_PUBLIC_COIN_VOYAGE_API_KEY`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`!`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`}`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#9CDCFE`},children:` environment`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"production\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#9CDCFE`},children:` mode`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"dark\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:` >`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#4EC9B0`},children:`Swap`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#9CDCFE`},children:` defaultSourceCurrency`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`{`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{ `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`chain_id:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 1`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`}`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#9CDCFE`},children:` defaultDestinationCurrency`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`{`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` chain_id:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 30000000000001`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` address:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`}`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:` />`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:` \u003c/`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#4EC9B0`},children:`SwapKitProvider`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`>`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:` \u003c/`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#4EC9B0`},children:`WalletProvider`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`>`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` );`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`defaultSourceCurrency`}),` and `,_jsx(_components.code,{children:`defaultDestinationCurrency`}),` accept a chain ID and an optional token address. Defaults are read when the widget mounts; remount the widget with a new React `,_jsx(_components.code,{children:`key`}),` to apply changed defaults.`]}),`\n`,_jsx(Heading,{level:`2`,id:`configure-the-swap-experience`,children:`Configure the swap experience`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Use `,_jsx(_components.code,{children:`defaultSlippageBps`}),` to start with a custom slippage tolerance. When you omit it, SwapKit lets the quote service choose the tolerance automatically.`]}),`\n`,_jsxs(_components.li,{children:[`Use `,_jsx(_components.code,{children:`onComplete`}),` to receive the completed swap’s `,_jsx(_components.code,{children:`orderId`}),` and `,_jsx(_components.code,{children:`transactionHash`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Use `,_jsx(_components.code,{children:`onError`}),` to surface execution errors in your application.`]}),`\n`,_jsxs(_components.li,{children:[`Set `,_jsx(_components.code,{children:`mode`}),` on `,_jsx(_components.code,{children:`SwapKitProvider`}),` to `,_jsx(_components.code,{children:`\"light\"`}),`, `,_jsx(_components.code,{children:`\"dark\"`}),`, or `,_jsx(_components.code,{children:`\"auto\"`}),`, and pass `,_jsx(_components.code,{children:`theme`}),` to customize the widget. See `,_jsx(_components.a,{href:`/sdk/styling/swapkit`,children:`Styling / Theme`}),` for an example and all theme properties.`]}),`\n`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`SwapKitProvider`}),` uses the public API client and accepts an API key, but never an\nadmin signing key.`]})}),`\n`,_jsxs(_components.p,{children:[`For a custom swap interface or backend integration, see the `,_jsx(_components.a,{href:`/sdk/apiclient/swaps`,children:`ApiClient swap methods`}),`.`]})]})}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":"CoinVoyage SwapKit — embeddable token swaps","sidebarTitle":"SwapKit","description":"Install @coin-voyage/swapkit to add a cross-chain token swap experience to your React application.","layout":{"description":{"visible":false}},"href":"/sdk/swapkit"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Installation","slug":"installation","depth":2,"children":[]},{"title":"Add the swap widget","slug":"add-the-swap-widget","depth":2,"children":[]},{"title":"Configure the swap experience","slug":"configure-the-swap-experience","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"coinvoyage-3c99945b","siteName":"CoinVoyage","title":"CoinVoyage SwapKit — embeddable token swaps - CoinVoyage","navMaps":{"firstHrefInVersion":{"v3":{"href":"/sdk/swapkit","matchLevel":0}},"firstHrefInLanguage":{}},"lastModified":"2026-09-09T10:44:27.793Z","originalFileLocation":"sdk/swapkit.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=\"description\" content=\"Install @coin-voyage/swapkit to add a cross-chain token swap experience to your React application.\">\u003cmeta data-mint-head name=\"application-name\" content=\"CoinVoyage\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/coinvoyage-3c99945b/mD1PGld3WSyNJF_d/_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/coinvoyage-3c99945b/mD1PGld3WSyNJF_d/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/coinvoyage-3c99945b/mD1PGld3WSyNJF_d/_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/coinvoyage-3c99945b/mD1PGld3WSyNJF_d/_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/coinvoyage-3c99945b/mD1PGld3WSyNJF_d/_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/coinvoyage-3c99945b/mD1PGld3WSyNJF_d/_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/coinvoyage-3c99945b/mD1PGld3WSyNJF_d/_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/coinvoyage-3c99945b/mD1PGld3WSyNJF_d/_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/coinvoyage-3c99945b/mD1PGld3WSyNJF_d/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"CoinVoyage SwapKit — embeddable token swaps - CoinVoyage\">\u003cmeta data-mint-head property=\"og:description\" content=\"Install @coin-voyage/swapkit to add a cross-chain token swap experience to your React application.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"CoinVoyage\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.coinvoyage.io/sdk/swapkit\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://coinvoyage-3c99945b.mintlify.site/_mintlify/api/og/v2?division=SwapKit\u0026amp;title=CoinVoyage+SwapKit+%E2%80%94+embeddable+token+swaps\u0026amp;description=Install+%40coin-voyage%2Fswapkit+to+add+a+cross-chain+token+swap+experience+to+your+React+application.\u0026amp;theme=4cc65740291881c9362fb0cc\u0026amp;signature=3ee0e9ba26b9e2cb6beca6ff14f58f25a8d1e29804c464ffff00311c429fc587\">\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=\"CoinVoyage SwapKit — embeddable token swaps - CoinVoyage\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Install @coin-voyage/swapkit to add a cross-chain token swap experience to your React application.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://coinvoyage-3c99945b.mintlify.site/_mintlify/api/og/v2?division=SwapKit\u0026amp;title=CoinVoyage+SwapKit+%E2%80%94+embeddable+token+swaps\u0026amp;description=Install+%40coin-voyage%2Fswapkit+to+add+a+cross-chain+token+swap+experience+to+your+React+application.\u0026amp;theme=4cc65740291881c9362fb0cc\u0026amp;signature=3ee0e9ba26b9e2cb6beca6ff14f58f25a8d1e29804c464ffff00311c429fc587\">\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/coinvoyage-3c99945b/mD1PGld3WSyNJF_d/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"CoinVoyage\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#d6296f\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.coinvoyage.io/sdk/swapkit\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/sdk/swapkit.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.coinvoyage.io/#organization\",\"name\":\"CoinVoyage\",\"url\":\"https://docs.coinvoyage.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/coinvoyage-3c99945b/k1rKznLxzrSYSaFy/assets/logo-light.svg?fit=max\u0026auto=format\u0026n=k1rKznLxzrSYSaFy\u0026q=85\u0026s=2b6b11284d0d65d96596f7018cd0b7a5\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.coinvoyage.io#website\",\"name\":\"CoinVoyage\",\"url\":\"https://docs.coinvoyage.io\",\"publisher\":{\"@id\":\"https://docs.coinvoyage.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.coinvoyage.io/sdk/swapkit#webpage\",\"url\":\"https://docs.coinvoyage.io/sdk/swapkit\",\"name\":\"CoinVoyage SwapKit — embeddable token swaps\",\"description\":\"Install @coin-voyage/swapkit to add a cross-chain token swap experience to your React application.\",\"dateModified\":\"2026-09-09T10:44:27.793Z\",\"isPartOf\":{\"@id\":\"https://docs.coinvoyage.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.coinvoyage.io/sdk/swapkit#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.coinvoyage.io/sdk/swapkit#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"CoinVoyage\",\"item\":\"https://docs.coinvoyage.io\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"CoinVoyage SwapKit — embeddable token swaps\",\"item\":\"https://docs.coinvoyage.io/sdk/swapkit\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.coinvoyage.io/sdk/swapkit#article\",\"headline\":\"CoinVoyage SwapKit — embeddable token swaps\",\"name\":\"CoinVoyage SwapKit — embeddable token swaps\",\"description\":\"Install @coin-voyage/swapkit to add a cross-chain token swap experience to your React application.\",\"url\":\"https://docs.coinvoyage.io/sdk/swapkit\",\"mainEntityOfPage\":{\"@id\":\"https://docs.coinvoyage.io/sdk/swapkit#webpage\"},\"dateModified\":\"2026-09-09T10:44:27.793Z\",\"publisher\":{\"@id\":\"https://docs.coinvoyage.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.coinvoyage.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"CoinVoyage\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"CoinVoyage\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/sdk/swapkit.md","siteName":"CoinVoyage","nav":{"global":null,"versions":[{"version":"v3","default":true,"tabs":[{"tab":"Documentation","groups":[{"group":"Get started","pages":[{"title":"CoinVoyage: non-custodial cross-chain crypto payments","sidebarTitle":"Introduction","href":"/introduction"},{"title":"CoinVoyage integration flows","sidebarTitle":"Choose an integration","href":"/flows/overview"},{"title":"Quickstart: install CoinVoyage and accept payments","sidebarTitle":"PayKit quickstart","href":"/quickstart"}]},{"group":"Core concepts","pages":[{"title":"How CoinVoyage routes and settles cross-chain payments","sidebarTitle":"How it works","href":"/concepts/how-it-works"},{"title":"Orders: DEPOSIT, SALE, REFUND modes and statuses","sidebarTitle":"Orders","href":"/concepts/pay-orders"},{"title":"Hosted payment links","href":"/guides/hosted-payment-links"},{"title":"Blockchain networks and chain IDs supported by CoinVoyage","sidebarTitle":"Supported networks","href":"/concepts/supported-networks"},{"title":"Fiat off-ramp regions, currencies, and payment rails","sidebarTitle":"Supported regions","href":"/concepts/supported-regions"}]},{"group":"PayKit","pages":[{"title":"CoinVoyage PayKit SDK — SALE and DEPOSIT payments","sidebarTitle":"PayKit overview","href":"/sdk/overview"},{"title":"WalletProvider — configure multi-chain wallet connectors","sidebarTitle":"WalletProvider","href":"/sdk/walletprovider"},{"title":"PayKitProvider — set up your global payment context","sidebarTitle":"PayKitProvider","href":"/sdk/paykitprovider"},{"title":"PayButton — ready-made crypto payment UI component","sidebarTitle":"PayButton","href":"/sdk/paybutton"},{"title":"useOrderStatusWS - order status WebSocket hook","sidebarTitle":"useOrderStatusWS","description":"Subscribe to CoinVoyage order status events from React with automatic reconnects and connection-state callbacks.","href":"/sdk/useorderstatusws"}]},{"group":"SwapKit","pages":[{"title":"CoinVoyage SwapKit — embeddable token swaps","sidebarTitle":"SwapKit","href":"/sdk/swapkit"}]},{"group":"Styling / Theme","pages":[{"title":"PayKit styling and theming","sidebarTitle":"PayKit","description":"Customize the PayKit payment modal with colors, button styles, and light or dark themes.","href":"/sdk/styling/paykit"},{"title":"SwapKit styling and theming","sidebarTitle":"SwapKit","href":"/sdk/styling/swapkit"}]},{"group":"Invoices","pages":[{"title":"CoinVoyage invoices","sidebarTitle":"Overview","href":"/invoices/overview"},{"title":"Invoices API","sidebarTitle":"REST API guide","href":"/invoices/api"}]},{"group":"API integration","pages":[{"title":"CoinVoyage API overview","sidebarTitle":"API overview","href":"/api/overview"},{"group":"ApiClient reference","root":{"title":"ApiClient - server-side CoinVoyage REST API client","sidebarTitle":"Overview","href":"/sdk/apiclient"},"expanded":false,"pages":[{"title":"ApiClient authentication and authorization signatures","sidebarTitle":"Authentication","href":"/sdk/apiclient/authentication"},{"title":"ApiClient order methods","sidebarTitle":"Orders","href":"/sdk/apiclient/orders"},{"title":"Swap API — quote and execute standalone swaps","sidebarTitle":"Swaps","href":"/sdk/apiclient/swaps"},{"title":"ApiClient wallet and currency search methods","sidebarTitle":"Wallet and search","href":"/sdk/apiclient/wallets-and-search"},{"title":"ApiClient on-ramp methods","sidebarTitle":"On-ramp","href":"/sdk/apiclient/on-ramp"},{"title":"ApiClient off-ramp methods","sidebarTitle":"Off-ramp","href":"/sdk/apiclient/off-ramp"},{"title":"ApiClient invoice methods","sidebarTitle":"Invoices","href":"/sdk/apiclient/invoices"},{"title":"ApiClient fee methods","sidebarTitle":"Fees","href":"/sdk/apiclient/fees"},{"title":"ApiClient webhooks and WebSocket subscriptions","sidebarTitle":"Webhooks and WebSockets","href":"/sdk/apiclient/webhooks-and-websockets"},{"title":"ApiClient core types","sidebarTitle":"Core types","href":"/sdk/apiclient/types"}]},{"title":"CoinVoyage API rate limits, 429 responses, and retry behavior","sidebarTitle":"Rate limits","href":"/resources/rate-limits"},{"title":"PayKit Headless (Preview) - x402 payments for agents and servers","sidebarTitle":"PayKit Headless (Preview)","href":"/sdk/paykit-headless"}]},{"group":"Going live","pages":[{"title":"Set up webhooks for real-time payment notifications","sidebarTitle":"Set up webhooks","href":"/webhooks/overview"},{"title":"CoinVoyage webhook event types and payload reference","sidebarTitle":"Webhook events","href":"/webhooks/events"},{"title":"Production checklist","sidebarTitle":"Production checklist","href":"/guides/production-checklist"}]},{"group":"Dashboard","pages":[{"title":"CoinVoyage Dashboard: manage payments and settings","sidebarTitle":"Overview","href":"/dashboard/overview"},{"title":"Transactions: search, inspect, and refund payments","sidebarTitle":"Transactions","href":"/dashboard/transactions"},{"title":"Settlement currencies: choose your payout asset and chain","sidebarTitle":"Settlement","href":"/dashboard/settlement"},{"title":"Withdrawals: off-ramp crypto settlement balances to fiat","sidebarTitle":"Withdrawals","href":"/dashboard/withdrawals"},{"title":"Custom fees: charge an extra percentage on every payment","sidebarTitle":"Custom fees","href":"/dashboard/custom-fees"},{"title":"Invoices: send crypto payment requests to customers","sidebarTitle":"Invoices","href":"/dashboard/invoices"},{"title":"Manage API keys and webhooks in the Developers tab","sidebarTitle":"Developers","href":"/dashboard/developers"}]},{"group":"Resources","pages":[{"title":"CoinVoyage pricing: transaction fees and volume plans","sidebarTitle":"Pricing","href":"/resources/pricing"},{"title":"CoinVoyage SDK and API changelog — release notes","sidebarTitle":"Changelog","href":"/resources/changelog"},{"title":"CoinVoyage integration FAQ: auth, testing, and flows","sidebarTitle":"FAQs","href":"/resources/faqs"},{"title":"CoinVoyage support: contact, examples, and resources","sidebarTitle":"Support","href":"/resources/support"}]}]},{"tab":"API reference","icon":"square-terminal","pages":[{"title":"API reference","href":"/api-reference/api-keys/list-api-keys"}]}]}]},"basePath":"","title":"CoinVoyage SwapKit — embeddable token swaps - CoinVoyage","deploymentId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","buildId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","dynamics":[],"chunks":[]}