{ "success": true, "message": "Swap initiated successfully", "timestamp": "2026-04-18T14:22:08.631Z", "data": { "status": "AWAITING_DEPOSIT", "type": "SWAP", "reference": "a3f9c2e1-7b4d-4a8e-9c62-1d8f4e6b2a90", "rate": 1, "fee": { "total": 0.5, "platform": 0.45, "developer": 0.05, "currency": "USDC" }, "source": { "amount": 100, "currency": "USDC" }, "destination": { "amount": 99.5, "currency": "USDT" }, "deposit": { "amount": 100, "address": "0x8F3aC91d2B741E59f064E9053a4d2E8F1c0b6D93a", "asset": "base:usdc", "note": [ "Kindly send the exact amount to the wallet address to complete the transaction.", "This dynamic wallet address has a 30 minutes expiry window and can only be used once." ] } }}
{
"success": false,
"message": "amount must be greater than 0 for the selected corridor",
"timestamp": "2026-04-18T14:22:08.631Z",
"data": null
}
{"docsConfig":{"theme":"almond","$schema":"https://mintlify.com/docs.json","name":"Switch","description":"Stablecoin collection and settlement layer.","colors":{"primary":"#66bf7a","light":"#66bf7a","dark":"#66bf7a"},"logo":{"light":"https://mintcdn.com/switch-5f170989/jpy1RN3Z-Ng3OPF8/logo/light.svg?fit=max\u0026auto=format\u0026n=jpy1RN3Z-Ng3OPF8\u0026q=85\u0026s=b78b7223aca5d6541dbdf50cd011f6fb","dark":"https://mintcdn.com/switch-5f170989/jpy1RN3Z-Ng3OPF8/logo/dark.svg?fit=max\u0026auto=format\u0026n=jpy1RN3Z-Ng3OPF8\u0026q=85\u0026s=909ea85137921abd2070e8677c6d6fa3","href":"https://docs.onswitch.xyz"},"favicon":"https://mintcdn.com/switch-5f170989/jpy1RN3Z-Ng3OPF8/logo/favicon.png?fit=max\u0026auto=format\u0026n=jpy1RN3Z-Ng3OPF8\u0026q=85\u0026s=31250d37473b8ab4bee17340cff8f617","api":{"params":{"expanded":"all"},"playground":{"display":"interactive"}},"appearance":{"default":"dark","strict":true},"background":{"color":{"dark":"#0B0B0B"}},"navbar":{"links":[{"href":"https://onswitch.xyz","label":"Website"},{"href":"https://app.onswitch.xyz","label":"Dashboard"},{"href":"https://switch.openstatus.dev/","label":"Status"}],"primary":{"type":"button","label":"Book a demo","href":"https://onswitch.xyz/"}},"seo":{"metatags":{"og:type":"website","twitter:card":"summary_large_image"}},"icons":{"library":"lucide"},"styling":{"eyebrows":"breadcrumbs","codeblocks":"dark","latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"switch-5f170989","hasAudioNarration":false,"actualSubdomain":"switch-5f170989","customDomains":["docs.onswitch.xyz"],"gitSource":{"type":"github","owner":"switchhq","repo":"documentation","deployBranch":"development","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6ae9498dfc206e01340c57c5:success","clientVersion":"0.0.4177","searchFilterCounts":[{"language":"default","tag":"API Reference","count":35},{"language":"default","tag":"Wallet","count":11},{"language":"default","tag":"Documentation","count":10},{"language":"default","tag":"Guides","count":10},{"language":"default","tag":"Payment","count":4},{"language":"default","tag":"Beneficiary","count":3},{"language":"default","tag":"Coverage","count":3},{"language":"default","tag":"Offramp","count":3},{"language":"default","tag":"Onramp","count":3},{"language":"default","tag":"Compliance","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":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":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":"#topbar-cta-button{color:#000000!important}#topbar-cta-button:hover,#topbar-cta-button:focus-visible{color:#000000!important}#topbar-cta-button>a>div>span{color:#123f2f;font-weight:500}"}],"page":{"pagePath":"api-reference/swap/initiate","slug":"/api-reference/swap/initiate","pageMetadata":{"title":"Initiate","description":"Initiate a swap transaction between two stablecoin assets.","deprecated":null,"version":null,"openapi":"/openapi.json post /swap/initiate","href":"/api-reference/swap/initiate","autogeneratedByOpenApi":true},"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: \"Initiate a swap transaction between two stablecoin assets.\"\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":"dark","config":{},"pageMetadata":{"title":"Initiate","description":"Initiate a swap transaction between two stablecoin assets.","deprecated":null,"version":null,"openapi":"/openapi.json post /swap/initiate","href":"/api-reference/swap/initiate","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Swap"],"summary":"Initiate","description":"Initiate a swap transaction between two stablecoin assets.","operationId":"initiateSwap","security":["9017554f-1872-4e8d-bced-5742938732ab"],"requestBody":"24a8f300-52bf-4368-a71f-acb291954fa1","responses":{"200":"cd6170c9-09b7-4f7d-b38d-a613c39058ed","400":"412471ad-38bf-41fb-bbff-e86b6794b86b"},"method":"post","type":"path","servers":["e542dbe2-0125-4bf4-b749-0dd054d6bf7c"],"path":"/swap/initiate","baseUrlOptions":["https://api.onswitch.xyz"],"title":"Initiate","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["amount","from_asset","to_asset","beneficiary"],"properties":{"amount":{"type":"number","minimum":0,"isRequired":true,"uniqueKey":"amount","typeLabel":"number"},"from_asset":{"type":"string","enum":["base:usdc","solana:usdc","solana:usdt","ethereum:usdc","ethereum:usdt","polygon:usdc","polygon:usdt","bsc:usdc","bsc:usdt","arbitrum:usdc","optimism:usdc","gnosis:usdc","gnosis:usdt","arbitrum:usdt","avalanche:usdc","monad:usdc","optimism:usdt","monad:usdt","plasma:usdt","avalanche:usdt","tron:usdt","linea:usdt","mantle:usdt","hyperevm:usdt","berachain:usdt","linea:usdc","berachain:usdc","sonic:usdc","base:cngn","bsc:cngn"],"isRequired":true,"uniqueKey":"from_asset","typeLabel":"enum\u003cstring>"},"to_asset":{"type":"string","enum":["base:usdc","solana:usdc","solana:usdt","ethereum:usdc","ethereum:usdt","polygon:usdc","polygon:usdt","bsc:usdc","bsc:usdt","arbitrum:usdc","optimism:usdc","gnosis:usdc","gnosis:usdt","arbitrum:usdt","avalanche:usdc","monad:usdc","optimism:usdt","monad:usdt","plasma:usdt","avalanche:usdt","tron:usdt","linea:usdt","mantle:usdt","hyperevm:usdt","berachain:usdt","linea:usdc","berachain:usdc","sonic:usdc","base:cngn","bsc:cngn"],"isRequired":true,"uniqueKey":"to_asset","typeLabel":"enum\u003cstring>"},"beneficiary":{"oneOf":[{"type":"object","title":"Receive to saved beneficiary","description":"The recipient of the swap transaction.","required":["id"],"properties":{"id":{"type":"string","pattern":"^[a-f0-9]{24}$","description":"Unique identifier for the beneficiary","isRequired":true,"uniqueKey":"beneficiary.oneOf.0.id","typeLabel":"string"}},"additionalProperties":true,"isRequired":true,"uniqueKey":"beneficiary.oneOf.0","typeLabel":"Receive to saved beneficiary · object"},{"type":"object","title":"Receive to Switch wallet","description":"The recipient of the swap transaction.","required":["wallet"],"properties":{"wallet":{"type":"string","description":"Internal switch wallet `id`","isRequired":true,"uniqueKey":"beneficiary.oneOf.1.wallet","typeLabel":"string"}},"additionalProperties":true,"isRequired":true,"uniqueKey":"beneficiary.oneOf.1","typeLabel":"Receive to Switch wallet · object"},{"type":"object","title":"Receive to external wallet","description":"The recipient of the swap transaction.","required":["wallet_address"],"properties":{"wallet_address":{"type":"string","isRequired":true,"uniqueKey":"beneficiary.oneOf.2.wallet_address","typeLabel":"string"}},"additionalProperties":true,"isRequired":true,"uniqueKey":"beneficiary.oneOf.2","typeLabel":"Receive to external wallet · object"}],"isRequired":true,"uniqueKey":"beneficiary","typeLabel":"Receive to saved beneficiary · object | Receive to Switch wallet · object | Receive to external wallet · object"},"exact_output":{"type":"boolean","default":false,"uniqueKey":"exact_output","typeLabel":"boolean"},"callback_url":{"type":"string","format":"uri","description":"Webhook URL to receive transaction status updates.","uniqueKey":"callback_url","typeLabel":"string\u003curi>"},"reference":{"type":"string","format":"uuid","uniqueKey":"reference","typeLabel":"string\u003cuuid>"},"developer_fee":{"type":"number","description":"Optional developer fee percentage (0-100)","minimum":0,"maximum":100,"uniqueKey":"developer_fee","typeLabel":"number"},"developer_recipient":{"type":"string","description":"Optional wallet address to receive developer fee.","uniqueKey":"developer_recipient","typeLabel":"string"},"refund_address":{"type":"string","description":"Optional wallet address to receive refunds for failed/expired deposits. The refund address must be on the same blockchain specified for the payment.","uniqueKey":"refund_address","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"amount":100,"from_asset":"base:usdc","to_asset":"solana:usdt","beneficiary":{"wallet_address":"0x8F3aC91d2B741E59f064E9053a4d2E8F1c0b6D93a"},"exact_output":false,"callback_url":"https://your-app.com/webhook","reference":"a3f9c2e1-7b4d-4a8e-9c62-1d8f4e6b2a90","developer_fee":0.5,"developer_recipient":"0x8F3aC91d2B741E59f064E9053a4d2E8F1c0b6D93a","refund_address":"0x8F3aC91d2B741E59f064E9053a4d2E8F1c0b6D93a"},"examples":{"Example":{"title":"Example","value":{"amount":100,"from_asset":"base:usdc","to_asset":"solana:usdt","beneficiary":{"wallet_address":"0x8F3aC91d2B741E59f064E9053a4d2E8F1c0b6D93a"},"exact_output":false,"callback_url":"https://your-app.com/webhook","reference":"a3f9c2e1-7b4d-4a8e-9c62-1d8f4e6b2a90","developer_fee":0.5,"developer_recipient":"0x8F3aC91d2B741E59f064E9053a4d2E8F1c0b6D93a","refund_address":"0x8F3aC91d2B741E59f064E9053a4d2E8F1c0b6D93a"}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"cd6170c9-09b7-4f7d-b38d-a613c39058ed":{"description":"Successfully initiated swap transaction","content":{"application/json":{"schema":{"type":"object","required":["success","message","timestamp","data"],"properties":{"success":{"type":"boolean","isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"timestamp":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"timestamp","typeLabel":"string\u003cdate-time>"},"data":{"oneOf":[{"description":"Response data","type":"object","required":["status","type","reference","rate","fee","source","destination","deposit"],"properties":{"status":{"type":"string","enum":["AWAITING_DEPOSIT","PROCESSING","COMPLETED","FAILED"],"isRequired":true,"uniqueKey":"data.oneOf.0.status","typeLabel":"enum\u003cstring>"},"type":{"type":"string","enum":["SWAP"],"isRequired":true,"uniqueKey":"data.oneOf.0.type","typeLabel":"enum\u003cstring>"},"reference":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"data.oneOf.0.reference","typeLabel":"string\u003cuuid>"},"rate":{"type":"number","isRequired":true,"uniqueKey":"data.oneOf.0.rate","typeLabel":"number"},"fee":{"type":"object","required":["total","platform","developer","currency"],"properties":{"total":{"type":"number","isRequired":true,"uniqueKey":"data.oneOf.0.fee.total","typeLabel":"number"},"platform":{"type":"number","isRequired":true,"uniqueKey":"data.oneOf.0.fee.platform","typeLabel":"number"},"developer":{"type":"number","isRequired":true,"uniqueKey":"data.oneOf.0.fee.developer","typeLabel":"number"},"currency":{"type":"string","isRequired":true,"uniqueKey":"data.oneOf.0.fee.currency","typeLabel":"string"}},"isRequired":true,"uniqueKey":"data.oneOf.0.fee","typeLabel":"object"},"source":{"type":"object","required":["amount","currency"],"properties":{"amount":{"type":"number","isRequired":true,"uniqueKey":"data.oneOf.0.source.amount","typeLabel":"number"},"currency":{"type":"string","isRequired":true,"uniqueKey":"data.oneOf.0.source.currency","typeLabel":"string"}},"isRequired":true,"uniqueKey":"data.oneOf.0.source","typeLabel":"object"},"destination":{"type":"object","required":["amount","currency"],"properties":{"amount":{"type":"number","isRequired":true,"uniqueKey":"data.oneOf.0.destination.amount","typeLabel":"number"},"currency":{"type":"string","isRequired":true,"uniqueKey":"data.oneOf.0.destination.currency","typeLabel":"string"}},"isRequired":true,"uniqueKey":"data.oneOf.0.destination","typeLabel":"object"},"deposit":{"type":"object","required":["amount","address","asset","note"],"properties":{"amount":{"type":"number","isRequired":true,"uniqueKey":"data.oneOf.0.deposit.amount","typeLabel":"number"},"address":{"type":"string","isRequired":true,"uniqueKey":"data.oneOf.0.deposit.address","typeLabel":"string"},"asset":{"type":"string","enum":["base:usdc","solana:usdc","solana:usdt","ethereum:usdc","ethereum:usdt","polygon:usdc","polygon:usdt","bsc:usdc","bsc:usdt","arbitrum:usdc","optimism:usdc","gnosis:usdc","gnosis:usdt","arbitrum:usdt","avalanche:usdc","monad:usdc","optimism:usdt","monad:usdt","plasma:usdt","avalanche:usdt","tron:usdt","linea:usdt","mantle:usdt","hyperevm:usdt","berachain:usdt","linea:usdc","berachain:usdc","sonic:usdc","base:cngn","bsc:cngn"],"isRequired":true,"uniqueKey":"data.oneOf.0.deposit.asset","typeLabel":"enum\u003cstring>"},"note":{"type":"array","items":{"type":"string","uniqueKey":"data.oneOf.0.deposit.note.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.oneOf.0.deposit.note","typeLabel":"string[]"}},"isRequired":true,"uniqueKey":"data.oneOf.0.deposit","typeLabel":"object"}},"isRequired":true,"uniqueKey":"data.oneOf.0","typeLabel":"object"},{"description":"Response data","type":"null","required":["status","type","reference","rate","fee","source","destination","deposit"],"properties":{"status":{"type":"string","enum":["AWAITING_DEPOSIT","PROCESSING","COMPLETED","FAILED"]},"type":{"type":"string","enum":["SWAP"]},"reference":{"type":"string","format":"uuid"},"rate":{"type":"number"},"fee":{"type":"object","required":["total","platform","developer","currency"],"properties":{"total":{"type":"number"},"platform":{"type":"number"},"developer":{"type":"number"},"currency":{"type":"string"}}},"source":{"type":"object","required":["amount","currency"],"properties":{"amount":{"type":"number"},"currency":{"type":"string"}}},"destination":{"type":"object","required":["amount","currency"],"properties":{"amount":{"type":"number"},"currency":{"type":"string"}}},"deposit":{"type":"object","required":["amount","address","asset","note"],"properties":{"amount":{"type":"number"},"address":{"type":"string"},"asset":{"type":"string","enum":["base:usdc","solana:usdc","solana:usdt","ethereum:usdc","ethereum:usdt","polygon:usdc","polygon:usdt","bsc:usdc","bsc:usdt","arbitrum:usdc","optimism:usdc","gnosis:usdc","gnosis:usdt","arbitrum:usdt","avalanche:usdc","monad:usdc","optimism:usdt","monad:usdt","plasma:usdt","avalanche:usdt","tron:usdt","linea:usdt","mantle:usdt","hyperevm:usdt","berachain:usdt","linea:usdc","berachain:usdc","sonic:usdc","base:cngn","bsc:cngn"]},"note":{"type":"array","items":{"type":"string"}}}}},"isRequired":true,"uniqueKey":"data.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data","typeLabel":"object | null"}},"uniqueKey":"","typeLabel":"object"},"example":{"success":true,"message":"Swap initiated successfully","timestamp":"2026-04-18T14:22:08.631Z","data":{"status":"AWAITING_DEPOSIT","type":"SWAP","reference":"a3f9c2e1-7b4d-4a8e-9c62-1d8f4e6b2a90","rate":1,"fee":{"total":0.5,"platform":0.45,"developer":0.05,"currency":"USDC"},"source":{"amount":100,"currency":"USDC"},"destination":{"amount":99.5,"currency":"USDT"},"deposit":{"amount":100,"address":"0x8F3aC91d2B741E59f064E9053a4d2E8F1c0b6D93a","asset":"base:usdc","note":["Kindly send the exact amount to the wallet address to complete the transaction.","This dynamic wallet address has a 30 minutes expiry window and can only be used once."]}}},"examples":{"Example":{"title":"Example","value":{"success":true,"message":"Swap initiated successfully","timestamp":"2026-04-18T14:22:08.631Z","data":{"status":"AWAITING_DEPOSIT","type":"SWAP","reference":"a3f9c2e1-7b4d-4a8e-9c62-1d8f4e6b2a90","rate":1,"fee":{"total":0.5,"platform":0.45,"developer":0.05,"currency":"USDC"},"source":{"amount":100,"currency":"USDC"},"destination":{"amount":99.5,"currency":"USDT"},"deposit":{"amount":100,"address":"0x8F3aC91d2B741E59f064E9053a4d2E8F1c0b6D93a","asset":"base:usdc","note":["Kindly send the exact amount to the wallet address to complete the transaction.","This dynamic wallet address has a 30 minutes expiry window and can only be used once."]}}}}},"exampleType":"examples"}},"exampleType":"examples"},"412471ad-38bf-41fb-bbff-e86b6794b86b":{"description":"Bad request - Invalid input parameters or validation error","content":{"application/json":{"schema":{"type":"object","required":["success","message","timestamp"],"properties":{"success":{"type":"boolean","example":false,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"message":{"type":"string","description":"Error message describing what went wrong","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"timestamp":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"timestamp","typeLabel":"string\u003cdate-time>"},"data":{"oneOf":[{"description":"Additional error details","uniqueKey":"data.oneOf.0","typeLabel":"any"},{"description":"Additional error details","type":"null","uniqueKey":"data.oneOf.1","typeLabel":"null"}],"uniqueKey":"data","typeLabel":"any | null"}},"uniqueKey":"","typeLabel":"object"},"example":{"success":false,"message":"amount must be greater than 0 for the selected corridor","timestamp":"2026-04-18T14:22:08.631Z","data":null},"examples":{"Example":{"title":"Example","value":{"success":false,"message":"amount must be greater than 0 for the selected corridor","timestamp":"2026-04-18T14:22:08.631Z","data":null}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"9017554f-1872-4e8d-bced-5742938732ab":{"ServiceKey":{"type":"apiKey","in":"header","name":"x-service-key","description":"Service key for API authentication","scopes":[]}}},"servers":{"e542dbe2-0125-4bf4-b749-0dd054d6bf7c":{"url":"https://api.onswitch.xyz","description":"Production server"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-service-key","description":"Service key for API authentication","scopes":[]},"schema":{"title":"x-service-key","type":"string","description":"Service key for API authentication","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ServiceKey","name":"x-service-key"}],"title":"ServiceKey"}]},"originalFileLocation":"openapi.json"},"subdomain":"switch-5f170989","siteName":"Switch","title":"Initiate - Switch","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-08-04T11:29:04.060Z","originalFileLocation":"api-reference/swap/initiate.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"dark\";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=\"Initiate a swap transaction between two stablecoin assets.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Switch\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/switch-5f170989/mYb0D2zStfliEs54/_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/switch-5f170989/mYb0D2zStfliEs54/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/switch-5f170989/mYb0D2zStfliEs54/_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/switch-5f170989/mYb0D2zStfliEs54/_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/switch-5f170989/mYb0D2zStfliEs54/_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/switch-5f170989/mYb0D2zStfliEs54/_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/switch-5f170989/mYb0D2zStfliEs54/_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/switch-5f170989/mYb0D2zStfliEs54/_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/switch-5f170989/mYb0D2zStfliEs54/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Initiate - Switch\">\u003cmeta data-mint-head property=\"og:description\" content=\"Initiate a swap transaction between two stablecoin assets.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Switch\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.onswitch.xyz/api-reference/swap/initiate\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://switch-5f170989.mintlify.site/_mintlify/api/og/v2?division=Swap\u0026amp;title=Initiate\u0026amp;description=Initiate+a+swap+transaction+between+two+stablecoin+assets.\u0026amp;theme=b056b4ce2e9b47c192425118\u0026amp;signature=f6bed853172ce1e3ddd2a053c143365f7cbc95be0e26042f9f5c0d00f6e240ed\">\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=\"Initiate - Switch\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Initiate a swap transaction between two stablecoin assets.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://switch-5f170989.mintlify.site/_mintlify/api/og/v2?division=Swap\u0026amp;title=Initiate\u0026amp;description=Initiate+a+swap+transaction+between+two+stablecoin+assets.\u0026amp;theme=b056b4ce2e9b47c192425118\u0026amp;signature=f6bed853172ce1e3ddd2a053c143365f7cbc95be0e26042f9f5c0d00f6e240ed\">\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/switch-5f170989/mYb0D2zStfliEs54/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Switch\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#66bf7a\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.onswitch.xyz/api-reference/swap/initiate\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/swap/initiate.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.onswitch.xyz/#organization\",\"name\":\"Switch\",\"url\":\"https://docs.onswitch.xyz\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/switch-5f170989/jpy1RN3Z-Ng3OPF8/logo/light.svg?fit=max\u0026auto=format\u0026n=jpy1RN3Z-Ng3OPF8\u0026q=85\u0026s=b78b7223aca5d6541dbdf50cd011f6fb\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.onswitch.xyz#website\",\"name\":\"Switch\",\"url\":\"https://docs.onswitch.xyz\",\"publisher\":{\"@id\":\"https://docs.onswitch.xyz/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.onswitch.xyz/api-reference/swap/initiate#webpage\",\"url\":\"https://docs.onswitch.xyz/api-reference/swap/initiate\",\"name\":\"Initiate\",\"description\":\"Initiate a swap transaction between two stablecoin assets.\",\"dateModified\":\"2026-08-04T11:29:04.060Z\",\"isPartOf\":{\"@id\":\"https://docs.onswitch.xyz#website\"},\"breadcrumb\":{\"@id\":\"https://docs.onswitch.xyz/api-reference/swap/initiate#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.onswitch.xyz/api-reference/swap/initiate#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Swap\",\"item\":\"https://docs.onswitch.xyz/api-reference/swap/get-quote\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Initiate\",\"item\":\"https://docs.onswitch.xyz/api-reference/swap/initiate\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.onswitch.xyz/api-reference/swap/initiate#apireference\",\"headline\":\"Initiate\",\"name\":\"Initiate\",\"description\":\"Initiate a swap transaction between two stablecoin assets.\",\"url\":\"https://docs.onswitch.xyz/api-reference/swap/initiate\",\"mainEntityOfPage\":{\"@id\":\"https://docs.onswitch.xyz/api-reference/swap/initiate#webpage\"},\"dateModified\":\"2026-08-04T11:29:04.060Z\",\"publisher\":{\"@id\":\"https://docs.onswitch.xyz/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.onswitch.xyz#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Switch\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Switch\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/swap/initiate.md","siteName":"Switch","nav":{"global":null,"tabs":[{"tab":"Documentation","icon":"book","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"Guides","icon":"map","pages":[{"title":"Guides","href":"/guides/get-rate"}]},{"tab":"Changelog","icon":"history","pages":[{"title":"Changelog","href":"/changelog"}]},{"tab":"API Reference","icon":"code","groups":[{"group":"Institution","pages":[{"title":"Get institution","deprecated":null,"version":null,"openapi":"/openapi.json get /institution","href":"/api-reference/institution/get-institution"},{"title":"Lookup institution","deprecated":null,"version":null,"openapi":"/openapi.json post /institution/lookup","href":"/api-reference/institution/lookup-institution"}]},{"group":"Coverage","pages":[{"title":"Get coverage","deprecated":null,"version":null,"openapi":"/openapi.json get /coverage","href":"/api-reference/miscellaneous/get-coverage"},{"title":"Get assets","deprecated":null,"version":null,"openapi":"/openapi.json get /asset","href":"/api-reference/miscellaneous/get-assets"},{"title":"Get rates","deprecated":null,"version":null,"openapi":"/openapi.json get /rates","href":"/api-reference/miscellaneous/get-rates"}]},{"group":"Beneficiary","pages":[{"title":"Get requirements","deprecated":null,"version":null,"openapi":"/openapi.json get /beneficiary/requirement","href":"/api-reference/beneficiary/get-requirements"},{"title":"Get beneficiaries","deprecated":null,"version":null,"openapi":"/openapi.json get /beneficiary/fetch","href":"/api-reference/beneficiary/get-beneficiaries"},{"title":"Create beneficiary","deprecated":null,"version":null,"openapi":"/openapi.json post /beneficiary/create","href":"/api-reference/beneficiary/create-beneficiary"}]},{"group":"Compliance","pages":[{"title":"AML lookup","deprecated":null,"version":null,"openapi":"/openapi.json post /compliance/aml/lookup","href":"/api-reference/compliance/aml-lookup"},{"title":"AML histories","deprecated":null,"version":null,"openapi":"/openapi.json get /compliance/aml/history","href":"/api-reference/compliance/aml-histories"}]},{"group":"Payment","pages":[{"title":"Get payments","deprecated":null,"version":null,"openapi":"/openapi.json get /payment/history","href":"/api-reference/history/get-payments"},{"title":"Get summary","deprecated":null,"version":null,"openapi":"/openapi.json get /payment/summary","href":"/api-reference/history/get-summary"},{"title":"Confirm deposit","deprecated":null,"version":null,"openapi":"/openapi.json post /payment/confirm","href":"/api-reference/payment/confirm-deposit"},{"title":"Get status","deprecated":null,"version":null,"openapi":"/openapi.json get /payment/status","href":"/api-reference/payment/get-status"}]},{"group":"Webhook","pages":[{"title":"Get webhooks","deprecated":null,"version":null,"openapi":"/openapi.json get /webhook/history","href":"/api-reference/webhook/get-webhooks"},{"title":"Resend webhook","deprecated":null,"version":null,"openapi":"/openapi.json post /webhook/resend","href":"/api-reference/webhook/resend-webhook"}]},{"group":"Offramp","pages":[{"title":"Get quote","deprecated":null,"version":null,"openapi":"/openapi.json post /offramp/quote","href":"/api-reference/offramp/get-quote"},{"title":"Get rate","deprecated":null,"version":null,"openapi":"/openapi.json post /offramp/rate","href":"/api-reference/offramp/get-rate"},{"title":"Initiate","deprecated":null,"version":null,"openapi":"/openapi.json post /offramp/initiate","href":"/api-reference/offramp/initiate"}]},{"group":"Onramp","pages":[{"title":"Get quote","deprecated":null,"version":null,"openapi":"/openapi.json post /onramp/quote","href":"/api-reference/onramp/get-quote"},{"title":"Get rate","deprecated":null,"version":null,"openapi":"/openapi.json post /onramp/rate","href":"/api-reference/onramp/get-rate"},{"title":"Initiate","deprecated":null,"version":null,"openapi":"/openapi.json post /onramp/initiate","href":"/api-reference/onramp/initiate"}]},{"group":"Swap","pages":[{"title":"Get quote","description":"Get a real-time quote for swapping between two stablecoin assets including exchange rate and fees.","deprecated":null,"version":null,"openapi":"/openapi.json post /swap/quote","href":"/api-reference/swap/get-quote"},{"title":"Initiate","deprecated":null,"version":null,"openapi":"/openapi.json post /swap/initiate","href":"/api-reference/swap/initiate"}]},{"group":"Wallet","pages":[{"title":"Create wallet","description":"Create a new wallet with unified balance across multiple chains. One account, one balance, any chain.","deprecated":null,"version":null,"openapi":"/openapi.json post /wallet/create","href":"/api-reference/wallet/create-wallet"},{"title":"Get wallets","deprecated":null,"version":null,"openapi":"/openapi.json get /wallets","href":"/api-reference/wallet/get-wallets"},{"title":"Get wallet","deprecated":null,"version":null,"openapi":"/openapi.json get /wallet/{wallet_id}","href":"/api-reference/wallet/get-wallet"},{"title":"Update wallet","deprecated":null,"version":null,"openapi":"/openapi.json patch /wallet/{wallet_id}","href":"/api-reference/wallet/update-wallet"},{"title":"Export wallet","deprecated":null,"version":null,"openapi":"/openapi.json post /wallet/export","href":"/api-reference/wallet/export-wallet"},{"title":"Get balance","deprecated":null,"version":null,"openapi":"/openapi.json get /wallet/{wallet_id}/balance","href":"/api-reference/wallet/get-balance"},{"title":"Transfer funds","deprecated":null,"version":null,"openapi":"/openapi.json post /wallet/transfer","href":"/api-reference/wallet/transfer-funds"},{"title":"Estimate fee","deprecated":null,"version":null,"openapi":"/openapi.json post /wallet/fee","href":"/api-reference/wallet/estimate-fee"},{"title":"Rescue token","deprecated":null,"version":null,"openapi":"/openapi.json post /wallet/rescue","href":"/api-reference/wallet/rescue-token"},{"title":"Get transactions","deprecated":null,"version":null,"openapi":"/openapi.json get /wallet/{wallet_id}/transactions","href":"/api-reference/wallet/get-transactions"},{"title":"Lookup transaction","deprecated":null,"version":null,"openapi":"/openapi.json get /wallet/{wallet_id}/transaction/{reference}","href":"/api-reference/wallet/lookup-transaction"}]}]}]},"basePath":"","title":"Initiate - Switch","deploymentId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","buildId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-jJHA3WSo.js","utils-DbZn3Mjn.js","cloneDeep-CnBnaSyy.js","_Uint8Array-CMQtTgBR.js","isObject-FP1Yky1u.js","utils-Bl2DvzOJ.js","addUniqueKeysToSchema-BwOLo9p1.js","snippetPresets-BBiPpKa-.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","Page-DRLI_2Ue.js","ApiExamples-C0px4Tml.js","isEqual-zAyttAAO.js","usePlaygroundInputsStore-Dell6dGw.js","shallow-0VKqkSqN.js","getApiPlaygroundDisplay-CP_ctPEB.js","CodeSnippet-5L35ic0s.js","CodeSnippets-DOXbNhJw.js","getPastedJson-VhzT9m2P.js","icon-CD8_AtCO.js","MethodPill-DGgOMftG.js","DuplicateIcon-DZ6A_EtN.js","createIcon-DUl4oM5f.js","DynamicMarkdown-BGHukeRM.js","SectionHeading-ChrEUs8u.js","axios-vUo_bRtp.js","Markdown-Dj-na-_-.js","dist-C5gjFYHe.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","katex-YMM-FMeD.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","AssistantPageLink-DEBW87tT.js"]}