Recover a stray token

Sends a coin we don’t support from one of your addresses to an address you’ve already approved. 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.

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.

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

Has to be on your approved list already, the same list withdrawals use.

Example

curl -X POST https://merchant.minisend.xyz/api/v1/recover \
  -H "Authorization: Bearer wsk_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "source": "user-9214",
    "chain": "BASE",
    "token_address": "0x1234000000000000000000000000000000abcd",
    "destination_address": "0x9f2c000000000000000000000000000000dead"
  }'

Response (202)

{
  "recovery": {
    "id": "7a1c2e3f-...",
    "state": "queued",
    "source": "user-9214",
    "chain": "BASE",
    "token": "0x1234000000000000000000000000000000abcd",
    "amount": "25.000000",
    "destination_address": "0x9f2c000000000000000000000000000000dead",
    "tx_hash": null,
    "created_at": "2026-09-28T09:00:00.000Z",
    "updated_at": "2026-09-28T09:00:00.000Z"
  }
}

It works just like a withdrawal: you get a 202, and the state goes from queued to sending, then completed or failed. Follow it with get a withdrawal or the wallet.withdrawal.completed webhook.

Errors

Status	Meaning
`400`	Something isn’t right in the request, or `token_address` is the real USDC or USDT on that network
`401`	Your API key is missing or wrong
`403`	The address isn’t on your approved list yet
`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

Overview

Endpoints

Off-ramp endpoints

Onramp endpoints

Wallet API endpoints

Recover a stray token

Endpoint

Body

Example

Response (202)

Errors

​Endpoint

​Body

​Example

​Response (202)

​Errors

Endpoint

Body

Example

Response (202)

Errors