Child Address Withdraw

Withdraws USDC from a child address’s Gateway balance and mints it to address on the destination blockchain. Only the child address’s own Gateway balance is used.

Your business needs a master wallet on the destination blockchain. The network fee is paid by the master wallet when gasless withdrawals are enabled, and by the child address otherwise.

If the destination is not a Gateway-supported chain, the request fails with 400 and the message Gateway withdrawal is not supported on <blockchain> <network>.

POST /v1/addresses/{addressId}/gateway/withdraw

Child Address Withdraw

cURL

curl --request POST \
  --url https://api.blockradar.co/v1/addresses/{addressId}/gateway/withdraw \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "amount": "1",
  "blockchain": "base",
  "address": "0x2455eC6700092991Ce0782365A89d5Cd89c8Fa22",
  "reference": "tcApNlezq"
}
'

200

{
  "data": {
    "amlScreening": {
      "message": "Address is not sanctioned",
      "provider": "ofac, fbi, tether, circle",
      "status": "success"
    },
    "amount": "1",
    "amountPaid": "1",
    "amountUSD": "1",
    "asset": {
      "address": "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
      "createdAt": "2024-05-27T14:31:19.442Z",
      "currency": "USD",
      "decimals": 6,
      "id": "0927dc05-7d4e-4c0a-82c6-98ceb170ab84",
      "isActive": true,
      "isNative": false,
      "name": "USD Coin",
      "network": "testnet",
      "standard": null,
      "symbol": "USDC",
      "updatedAt": "2025-04-17T04:50:20.019Z"
    },
    "assetSwept": null,
    "assetSweptAmount": null,
    "assetSweptAt": null,
    "assetSweptGasFee": null,
    "assetSweptHash": null,
    "assetSweptRecipientAddress": null,
    "assetSweptSenderAddress": null,
    "blockHash": null,
    "blockNumber": null,
    "blockchain": {
      "createdAt": "2024-05-27T14:31:14.966Z",
      "derivationPath": "m/44'/60'/0'/0",
      "id": "74733889-4ecd-403e-9840-94e87c043f24",
      "isActive": true,
      "isEvmCompatible": true,
      "isL2": true,
      "name": "base",
      "slug": "base",
      "symbol": "eth",
      "tokenStandard": null,
      "updatedAt": "2024-11-26T20:04:13.945Z"
    },
    "chainId": 84532,
    "confirmations": null,
    "confirmed": false,
    "createdAt": "2025-08-17T01:48:37.989Z",
    "currency": "USD",
    "fee": null,
    "feeHash": null,
    "gasFee": null,
    "gasPrice": null,
    "gasUsed": null,
    "hash": null,
    "id": "c5e9ec3c-c7b1-4d84-a76e-056b8246f461",
    "metadata": null,
    "network": "testnet",
    "note": "Withdrawal of 1 USDC from gateway smart wallet 0x0077777d7EBA4688BDeF3E311b846F25870A19B9",
    "rate": null,
    "rateUSD": "1",
    "reason": "Balance Before: 9.749252 USDC | Network Fee: 2.005999 USDC | Gasless: false",
    "recipientAddress": "0x2455eC6700092991Ce0782365A89d5Cd89c8Fa22",
    "reference": "tcApNlezq",
    "senderAddress": "0x947514e4B803e312C312da0F1B41fEDdbe15ae7a",
    "signedTransaction": null,
    "status": "PENDING",
    "toAmount": null,
    "toCurrency": null,
    "tokenAddress": null,
    "type": "GATEWAY_WITHDRAW",
    "updatedAt": "2025-08-17T01:48:37.989Z",
    "wallet": {
      "address": "0x947514e4B803e312C312da0F1B41fEDdbe15ae7a",
      "configurations": null,
      "createdAt": "2024-08-22T16:05:46.167Z",
      "derivationPath": "m/44'/60'/0'/0/0",
      "description": "This is Base wallet",
      "id": "e17dea25-6c01-4b3a-a4ae-51f411bf69cd",
      "isActive": true,
      "name": "Base Wallet",
      "network": "testnet",
      "status": "ACTIVE",
      "updatedAt": "2024-08-22T16:05:46.167Z"
    }
  },
  "message": "Withdraw initiated successfully",
  "statusCode": 200
}

Authorizations

x-api-key · string · header · required

Path Parameters

addressId · string · required

Example:

"YOUR_ADDRESS_ID"

Body

application/json

amount · string · required

Amount of USDC to withdraw.

Example:

"1"

blockchain · string · required

Slug of the destination blockchain, for example base or polygon. Must be a Gateway-supported chain.

Example:

"base"

address · string · required

Recipient address on the destination blockchain.

Example:

"0x2455eC6700092991Ce0782365A89d5Cd89c8Fa22"

reference · string

Your own reference for the transaction.

Example:

"tcApNlezq"

note · string

Not used by Gateway withdrawals. Blockradar sets the transaction's note automatically.

metadata · object

Key-value pairs stored on the transaction.

Example:

{ "user_id": 1 }

Response

200 - application/json

200

data · object

Show child attributes

message · string

Example:

"Withdraw initiated successfully"

statusCode · number

Example:

200