v1

latestOpenAPI 3.0.32026-07-26184851.6 MB

Withdraw Fiat

Master Wallet Execute

post/v1/wallets/{walletId}/withdraw/fiat/execute

Request body

referencestring

client reference for tracking transaction

accountIdentifierstring required

destination bank account identifier

amountnumber required

amount to withdraw in asset units

assetIdstring required

asset ID of the stablecoin to withdraw

codestring

currencystring required

destination fiat currency code

institutionIdentifierstring required

bank or institution identifier code

Example request

{
  "reference": "client-reference-value",
  "accountIdentifier": "8034007516",
  "amount": 1000,
  "assetId": "a79270bf-5a79-4bdc-8fef-586bfcff6e9f",
  "code": "445223",
  "currency": "NGN",
  "institutionIdentifier": "OPAYNGPC"
}

Response

200

messagestring

statusboolean

Example response

{
  "data": {
    "amount": "1000",
    "amountPaid": "1000",
    "amountUSD": "0.68",
    "asset": {
      "address": "0x46C85152bFe9f96829aA94755D9f915F9B10EF5F",
      "createdAt": "2026-01-20T08:10:37.843Z",
      "currency": "NGN",
      "decimals": 6,
      "id": "4a54eddc-b2bc-42a2-8197-4f2cb250866e",
      "isActive": true,
      "name": "cNGN",
      "network": "mainnet",
      "symbol": "cNGN",
      "updatedAt": "2026-01-20T08:10:37.843Z"
    },
    "blockchain": {
      "createdAt": "2026-01-20T08:10:37.776Z",
      "derivationPath": "m/44'/60'/0'/0",
      "id": "384ba700-5831-49a1-8cba-7d89385d5a25",
      "isActive": true,
      "isEvmCompatible": true,
      "isL2": true,
      "name": "base",
      "networkFeeModel": "native",
      "slug": "base",
      "symbol": "eth",
      "updatedAt": "2026-01-20T08:10:37.776Z"
    },
    "createdAt": "2026-01-29T06:07:10.726Z",
    "createdChannel": "dashboard",
    "currency": "NGN",
    "fee": "2",
    "id": "db53c3ef-5643-4f98-92cf-d02aef300f45",
    "network": "mainnet",
    "processingStatus": "PENDING",
    "rate": "1",
    "rateUSD": "0.00068",
    "recipientAddress": "0x30F6A8457F8E42371E204a9c103f2Bd42341dD0F",
    "reference": "v7OlAUdQzvrEabyMJJ3",
    "senderAddress": "0x969838345E5cd5F755DfcADB57e72F5d23271e48",
    "status": "PENDING",
    "toAmount": "1000",
    "toCurrency": "NGN",
    "tokenAddress": "0x46C85152bFe9f96829aA94755D9f915F9B10EF5F",
    "type": "OFFRAMP",
    "updatedAt": "2026-01-29T06:07:10.726Z",
    "wallet": {
      "address": "0x969838345E5cd5F755DfcADB57e72F5d23271e48",
      "configurations": {
        "addresses": {
          "prefunding": {
            "rules": []
          }
        },
        "autoSettlement": {
          "rules": []
        },
        "autoSweeping": {
          "isActive": true
        },
        "withdrawal": {
          "gasless": {
            "operator": "gt"
          }
        }
      },
      "createdAt": "2026-01-20T08:44:44.305Z",
      "derivationPath": "m/44'/60'/0'/0/0",
      "description": "This is Base master Wallet",
      "id": "7aa5120b-2106-43c6-92c7-6458b7d2de8b",
      "isActive": true,
      "name": "Base Mainnet",
      "network": "mainnet",
      "status": "ACTIVE",
      "updatedAt": "2026-01-20T08:44:44.305Z"
    }
  },
  "message": "Successful",
  "status": true
}