Move out a token that landed on one of your addresses but isn’t USDC or USDT.
Sends a coin we don’t support from one of your addresses to any external address you choose. Use it when something other than USDC or USDT lands on an address. We don’t handle those automatically, so it stays there until you move it.
Call this from your server only, never from a browser or app, so your API key stays secret.
The whole balance of that coin is sent. You can’t send part of it, because we don’t know what the coin is worth.Recovery isn’t supported on Solana.
Endpoint
POST https://merchant.minisend.xyz/api/v1/recover
Authorization: Bearer wsk_live_your_key_here
The key needs the withdraw permission, the same as withdrawals, because this also sends money out.
Body
string
required
"master" to recover from your master wallet, or the walletRef of the address to recover from.
string
required
The network the coin is on. Any network your wallets work on except Solana.
string
required
The coin’s contract address (its ID on the blockchain). If it’s the real USDC or USDT on that network, we refuse it. Use a withdrawal for those instead.
string
required
Where to send the coin. It can’t be one of your own addresses.
Something isn’t right in the request, token_address is the real USDC or USDT on that network, the address is one of your own, or chain is SOL
401
Your API key is missing or wrong
403
Your key doesn’t have the withdraw permission, or your account is switched off
404
You don’t have a wallet on that network, or there’s no address with that walletRef
503
We couldn’t start the recovery just now. Try again
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Docs","description":"Accept USDC and USDT payments and settle to local currency in Kenya, Nigeria, Ghana, and Uganda. Developer documentation for the Minisend Merchant API, checkout sessions, payment links, webhooks, and dashboard.","colors":{"primary":"#8c54fb","light":"#5748eb"},"logo":{"light":"https://merchant.minisend.xyz/minisend-wordmark.png","dark":"https://merchant.minisend.xyz/minisend-white.png","href":"https://minisend.xyz"},"favicon":"https://merchant.minisend.xyz/mark.png","navbar":{"links":[],"primary":{"type":"button","label":"Launch Dashboard","href":"https://merchant.minisend.xyz"}},"footer":{"socials":{"x":"https://x.com/minisendapp","website":"https://minisend.xyz","linkedin":"https://www.linkedin.com/company/minisend","telegram":"https://t.me/minisendapp"},"links":[{"header":"Product","items":[{"label":"Merchant dashboard","href":"https://merchant.minisend.xyz"},{"label":"Consumer app","href":"https://app.minisend.xyz"},{"label":"Marketing site","href":"https://minisend.xyz"}]},{"header":"Developers","items":[{"label":"Quickstart","href":"https://docs.minisend.xyz/quickstart"},{"label":"API reference","href":"https://docs.minisend.xyz/api-reference/authentication"},{"label":"Webhooks","href":"https://docs.minisend.xyz/webhooks/overview"}]},{"header":"Company","items":[{"label":"About","href":"https://minisend.xyz"},{"label":"Support","href":"https://t.me/minisendapp"}]}]},"seo":{"metatags":{"canonical":"https://docs.minisend.xyz","og:site_name":"Minisend Docs","twitter:card":"summary_large_image"},"indexing":"navigable"},"fonts":{"heading":{"family":"DM Sans"},"body":{"family":"DM Sans"}},"icons":{"library":"fontawesome"},"contextual":{"options":["copy","view","claude","assistant","chatgpt"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"minisend","hasAudioNarration":false,"actualSubdomain":"minisend","customDomains":["docs.minisend.xyz"],"gitSource":{"type":"github","owner":"mintlify-community","repo":"docs-minisend-23040ad8","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6af394bef34c33c6f6ce4621","clientVersion":"0.0.4143","searchFilterCounts":[{"language":"default","tag":"Docs","count":34},{"language":"default","tag":"API Reference","count":31},{"language":"default","tag":"Wallet API endpoints","count":14},{"language":"default","tag":"Dashboard","count":10},{"language":"default","tag":"Off-ramp endpoints","count":7},{"language":"default","tag":"Get Started","count":6},{"language":"default","tag":"Onramp endpoints","count":5},{"language":"default","tag":"Off-ramp API","count":4},{"language":"default","tag":"Wallet API","count":4},{"language":"default","tag":"Endpoints","count":3}]},"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":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[],"page":{"pagePath":"api-reference/wallet-api/recover","slug":"/api-reference/wallet-api/recover","pageMetadata":{"title":"Recover a stray token","sidebarTitle":"Recover","description":"Move out a token that landed on one of your addresses but isn't USDC or USDT.","icon":"life-ring","iconType":"duotone","href":"/api-reference/wallet-api/recover"},"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: \"Move out a token that landed on one of your addresses but isn’t USDC or USDT.\"\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`,p:`p`,pre:`pre`,span:`span`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{CodeBlock,Heading,ParamField,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Sends a coin we don’t support from one of your addresses to any external address you choose. Use it when something other than USDC or USDT lands on an address. We don’t handle those automatically, so it stays there until you move it.`}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Call this from your server only, never from a browser or app, so your API key stays secret.`})}),`\n`,_jsx(_components.p,{children:`The whole balance of that coin is sent. You can’t send part of it, because we don’t know what the coin is worth.`}),`\n`,_jsx(_components.p,{children:`Recovery isn’t supported on Solana.`}),`\n`,_jsx(Heading,{level:`2`,id:`endpoint`,children:`Endpoint`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`text`,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:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`POST https://merchant.minisend.xyz/api/v1/recover`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`text`,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:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Authorization: Bearer wsk_live_your_key_here`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsxs(_components.p,{children:[`The key needs the `,_jsx(_components.code,{children:`withdraw`}),` permission, the same as `,_jsx(_components.a,{href:`/api-reference/wallet-api/withdrawals`,children:`withdrawals`}),`, because this also sends money out.`]}),`\n`,_jsx(Heading,{level:`2`,id:`body`,children:`Body`}),`\n`,_jsx(ParamField,{body:`source`,type:`string`,required:true,id:`param-source`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`\"master\"`}),` to recover from your master wallet, or the `,_jsx(_components.code,{children:`walletRef`}),` of the address to recover from.`]})}),`\n`,_jsx(ParamField,{body:`chain`,type:`string`,required:true,id:`param-chain`,children:_jsx(_components.p,{children:`The network the coin is on. Any network your wallets work on except Solana.`})}),`\n`,_jsx(ParamField,{body:`token_address`,type:`string`,required:true,id:`param-token-address`,children:_jsxs(_components.p,{children:[`The coin’s contract address (its ID on the blockchain). If it’s the real USDC or USDT on that network, we refuse it. Use a `,_jsx(_components.a,{href:`/api-reference/wallet-api/withdrawals`,children:`withdrawal`}),` for those instead.`]})}),`\n`,_jsx(ParamField,{body:`destination_address`,type:`string`,required:true,id:`param-destination-address`,children:_jsx(_components.p,{children:`Where to send the coin. It can’t be one of your own addresses.`})}),`\n`,_jsx(Heading,{level:`2`,id:`example`,children:`Example`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`9`,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:`9`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://merchant.minisend.xyz/api/v1/recover`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer wsk_live_your_key_here\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"source\": \"user-9214\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"chain\": \"BASE\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"token_address\": \"0x1234000000000000000000000000000000abcd\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"destination_address\": \"0x9f2c000000000000000000000000000000dead\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`response-202`,children:`Response (202)`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`14`,language:`json`,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:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`14`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"recovery\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"7a1c2e3f-...\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"state\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"queued\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"source\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"user-9214\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"chain\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"BASE\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"token\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"0x1234000000000000000000000000000000abcd\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"amount\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"25.000000\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"destination_address\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"0x9f2c000000000000000000000000000000dead\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"tx_hash\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"created_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-09-28T09:00:00.000Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"updated_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-09-28T09:00:00.000Z\"`})]}),`\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:[`It works just like a `,_jsx(_components.a,{href:`/api-reference/wallet-api/withdrawals`,children:`withdrawal`}),`: you get a `,_jsx(_components.code,{children:`202`}),`, and the `,_jsx(_components.code,{children:`state`}),` goes from `,_jsx(_components.code,{children:`queued`}),` to `,_jsx(_components.code,{children:`sending`}),`, then `,_jsx(_components.code,{children:`completed`}),` or `,_jsx(_components.code,{children:`failed`}),`. Follow it with `,_jsx(_components.a,{href:`/api-reference/wallet-api/get-withdrawal`,children:`get a withdrawal`}),` or the `,_jsx(_components.a,{href:`/wallet-api/webhooks`,children:_jsx(_components.code,{children:`wallet.withdrawal.completed`})}),` webhook.`]}),`\n`,_jsx(Heading,{level:`2`,id:`errors`,children:`Errors`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Status`}),_jsx(_components.th,{children:`Meaning`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsxs(_components.td,{children:[`Something isn’t right in the request, `,_jsx(_components.code,{children:`token_address`}),` is the real USDC or USDT on that network, the address is one of your own, or `,_jsx(_components.code,{children:`chain`}),` is `,_jsx(_components.code,{children:`SOL`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`401`})}),_jsx(_components.td,{children:`Your API key is missing or wrong`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`403`})}),_jsxs(_components.td,{children:[`Your key doesn’t have the `,_jsx(_components.code,{children:`withdraw`}),` permission, or your account is switched off`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`404`})}),_jsxs(_components.td,{children:[`You don’t have a wallet on that network, or there’s no address with that `,_jsx(_components.code,{children:`walletRef`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`503`})}),_jsx(_components.td,{children:`We couldn’t start the recovery just now. Try again`})]})]})]})]})}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":"Recover a stray token","sidebarTitle":"Recover","description":"Move out a token that landed on one of your addresses but isn't USDC or USDT.","icon":"life-ring","iconType":"duotone","href":"/api-reference/wallet-api/recover"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Endpoint","slug":"endpoint","depth":2,"children":[]},{"title":"Body","slug":"body","depth":2,"children":[]},{"title":"Example","slug":"example","depth":2,"children":[]},{"title":"Response (202)","slug":"response-202","depth":2,"children":[]},{"title":"Errors","slug":"errors","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"minisend","siteName":"Docs","title":"Recover a stray token - Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-08T22:00:41.023Z","originalFileLocation":"api-reference/wallet-api/recover.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=\"Move out a token that landed on one of your addresses but isn\u0026#x27;t USDC or USDT.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"https://merchant.minisend.xyz/mark.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"https://merchant.minisend.xyz/mark.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"https://merchant.minisend.xyz/mark.png\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/png\" href=\"https://merchant.minisend.xyz/mark.png\">\u003cmeta data-mint-head property=\"og:title\" content=\"Recover a stray token - Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Move out a token that landed on one of your addresses but isn\u0026#x27;t USDC or USDT.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Minisend Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.minisend.xyz/api-reference/wallet-api/recover\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://minisend.mintlify.site/_mintlify/api/og/v2?division=Wallet+API+endpoints\u0026amp;title=Recover+a+stray+token\u0026amp;description=Move+out+a+token+that+landed+on+one+of+your+addresses+but+isn%27t+USDC+or+USDT.\u0026amp;theme=0ff258933f7c55654b2ec4af\u0026amp;signature=0af62089364df40050a6767e4ebe72a4ffba84a547e6362f4f4a3a83352f7241\">\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=\"Recover a stray token - Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Move out a token that landed on one of your addresses but isn\u0026#x27;t USDC or USDT.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://minisend.mintlify.site/_mintlify/api/og/v2?division=Wallet+API+endpoints\u0026amp;title=Recover+a+stray+token\u0026amp;description=Move+out+a+token+that+landed+on+one+of+your+addresses+but+isn%27t+USDC+or+USDT.\u0026amp;theme=0ff258933f7c55654b2ec4af\u0026amp;signature=0af62089364df40050a6767e4ebe72a4ffba84a547e6362f4f4a3a83352f7241\">\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=\"https://mintlify.s3.us-west-1.amazonaws.com/minisend/_generated/favicon/browserconfig.xml?v=3\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#8c54fb\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.minisend.xyz/api-reference/wallet-api/recover\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/wallet-api/recover.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.minisend.xyz/#organization\",\"name\":\"Docs\",\"url\":\"https://docs.minisend.xyz\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://merchant.minisend.xyz/minisend-wordmark.png\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.minisend.xyz#website\",\"name\":\"Docs\",\"url\":\"https://docs.minisend.xyz\",\"publisher\":{\"@id\":\"https://docs.minisend.xyz/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.minisend.xyz/api-reference/wallet-api/recover#webpage\",\"url\":\"https://docs.minisend.xyz/api-reference/wallet-api/recover\",\"name\":\"Recover a stray token\",\"description\":\"Move out a token that landed on one of your addresses but isn't USDC or USDT.\",\"dateModified\":\"2026-11-08T22:00:41.023Z\",\"isPartOf\":{\"@id\":\"https://docs.minisend.xyz#website\"},\"breadcrumb\":{\"@id\":\"https://docs.minisend.xyz/api-reference/wallet-api/recover#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.minisend.xyz/api-reference/wallet-api/recover#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Wallet API endpoints\",\"item\":\"https://docs.minisend.xyz/api-reference/wallet-api/create-wallet\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Recover a stray token\",\"item\":\"https://docs.minisend.xyz/api-reference/wallet-api/recover\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.minisend.xyz/api-reference/wallet-api/recover#article\",\"headline\":\"Recover a stray token\",\"name\":\"Recover a stray token\",\"description\":\"Move out a token that landed on one of your addresses but isn't USDC or USDT.\",\"url\":\"https://docs.minisend.xyz/api-reference/wallet-api/recover\",\"mainEntityOfPage\":{\"@id\":\"https://docs.minisend.xyz/api-reference/wallet-api/recover#webpage\"},\"dateModified\":\"2026-11-08T22:00:41.023Z\",\"publisher\":{\"@id\":\"https://docs.minisend.xyz/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.minisend.xyz#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/wallet-api/recover.md","siteName":"Docs","nav":{"global":null,"tabs":[{"tab":"Docs","pages":[{"title":"Docs","href":"/introduction"}]},{"tab":"API Reference","groups":[{"group":"Overview","pages":[{"title":"Authentication","icon":"lock-keyhole","sidebarTitle":"Authentication","iconType":"duotone","href":"/api-reference/authentication"},{"title":"Errors","icon":"triangle-exclamation","sidebarTitle":"Errors","iconType":"duotone","href":"/api-reference/errors"}]},{"group":"Endpoints","pages":[{"title":"Create a checkout session","icon":"circle-plus","sidebarTitle":"Create checkout","iconType":"duotone","href":"/api-reference/create-checkout"},{"title":"Get checkout session status","icon":"magnifying-glass","sidebarTitle":"Get checkout","iconType":"duotone","href":"/api-reference/get-checkout"},{"title":"Payment link endpoints","icon":"link","sidebarTitle":"Payment link","iconType":"duotone","href":"/api-reference/payment-link"}]},{"group":"Off-ramp endpoints","pages":[{"title":"Get a quote","sidebarTitle":"Get a quote","icon":"calculator","iconType":"duotone","href":"/api-reference/offramp/quote"},{"title":"List institutions","sidebarTitle":"Institutions","icon":"building-columns","iconType":"duotone","href":"/api-reference/offramp/institutions"},{"title":"Validate a recipient","sidebarTitle":"Validate account","icon":"user-check","iconType":"duotone","href":"/api-reference/offramp/validate-account"},{"title":"Create an order","sidebarTitle":"Create order","icon":"circle-plus","iconType":"duotone","href":"/api-reference/offramp/create-order"},{"title":"Submit a deposit","sidebarTitle":"Submit deposit","icon":"hashtag","iconType":"duotone","href":"/api-reference/offramp/submit-deposit"},{"title":"Get an order","sidebarTitle":"Get order","icon":"magnifying-glass","iconType":"duotone","href":"/api-reference/offramp/get-order"},{"title":"List orders","sidebarTitle":"List orders","icon":"list","iconType":"duotone","href":"/api-reference/offramp/list-orders"}]},{"group":"Onramp endpoints","pages":[{"title":"Get a quote","sidebarTitle":"Get a quote","icon":"calculator","iconType":"duotone","href":"/api-reference/onramp/quote"},{"title":"List bank codes","sidebarTitle":"Institutions","icon":"building-columns","iconType":"duotone","href":"/api-reference/onramp/institutions"},{"title":"Create an order","sidebarTitle":"Create order","icon":"circle-plus","iconType":"duotone","href":"/api-reference/onramp/create-order"},{"title":"Get an order","sidebarTitle":"Get order","icon":"magnifying-glass","iconType":"duotone","href":"/api-reference/onramp/get-order"},{"title":"List orders","sidebarTitle":"List orders","icon":"list","iconType":"duotone","href":"/api-reference/onramp/list-orders"}]},{"group":"Wallet API endpoints","pages":[{"title":"Create a wallet","sidebarTitle":"Create wallet","icon":"circle-plus","iconType":"duotone","href":"/api-reference/wallet-api/create-wallet"},{"title":"Get a wallet by reference","sidebarTitle":"Get by reference","icon":"tag","iconType":"duotone","href":"/api-reference/wallet-api/get-wallet-by-ref"},{"title":"Get a wallet","sidebarTitle":"Get wallet","icon":"magnifying-glass","iconType":"duotone","href":"/api-reference/wallet-api/get-wallet"},{"title":"Get a wallet's balance","sidebarTitle":"Get balance","icon":"coins","iconType":"duotone","href":"/api-reference/wallet-api/get-balance"},{"title":"List all deposits","sidebarTitle":"List deposits","icon":"inbox","iconType":"duotone","href":"/api-reference/wallet-api/list-deposits"},{"title":"Get a wallet's deposits","sidebarTitle":"Wallet deposits","icon":"arrow-down-to-line","iconType":"duotone","href":"/api-reference/wallet-api/get-wallet-deposits"},{"title":"List wallets","sidebarTitle":"List wallets","icon":"list","iconType":"duotone","href":"/api-reference/wallet-api/list-wallets"},{"title":"Auto-sweep settings","sidebarTitle":"Sweep config","icon":"arrows-repeat","iconType":"duotone","href":"/api-reference/wallet-api/sweep-config"},{"title":"Request a withdrawal","sidebarTitle":"Withdrawals","icon":"paper-plane","iconType":"duotone","href":"/api-reference/wallet-api/withdrawals"},{"title":"Get a withdrawal","sidebarTitle":"Get withdrawal","icon":"receipt","iconType":"duotone","href":"/api-reference/wallet-api/get-withdrawal"},{"title":"Send a transfer","sidebarTitle":"Transfers","description":"Move USDC or USDT from one of your users' addresses to another of yours, on one chain.","icon":"arrow-right-arrow-left","iconType":"duotone","href":"/api-reference/wallet-api/transfers"},{"title":"Recover a stray token","sidebarTitle":"Recover","icon":"life-ring","iconType":"duotone","href":"/api-reference/wallet-api/recover"},{"title":"Find a deposit","sidebarTitle":"Find a deposit","description":"Look again for a deposit that was paid but never showed up.","icon":"magnifying-glass-dollar","iconType":"duotone","href":"/api-reference/wallet-api/deposits-find"},{"title":"Settlement chain","sidebarTitle":"Settlement","icon":"route","iconType":"duotone","href":"/api-reference/wallet-api/settlement"}]}]}]},"basePath":"","title":"Recover a stray token - Docs","buildId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","deploymentId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","dynamics":[],"chunks":[]}