Withdraw cNGN

Withdraw cNGN tokens to an external blockchain wallet address.

Withdraw cNGN

POST https://api.cngn.co/v1/api/withdraw

Initiates a withdrawal of cNGN to an external wallet. Requires Send Crypto permission. Subject to service availability. The request body must be AES encrypted.

Request Body

Name	Type	Description
amount*	number	Amount of cNGN to withdraw.
address*	string	Destination blockchain wallet address.
networkId*	string	Target blockchain network ID. Use the Get Supported Networks endpoint to retrieve valid network IDs.
shouldSaveAddress	boolean	Whether to save the address as a whitelisted beneficiary. Default: false

200 Withdrawal was successfully

{
  "status": 200,
  "message": "Withdrawal was successfully",
  "data": {
    "trxRef": "WTH-20250615-DEF456",
    "address": "0x5678901234abcdef5678901234abcdef56789012"
  }
}

400 Invalid request

Encryption Required: The request body must be encrypted using AES-256-CBC before sending. See the Encrypting / Decrypting Request section.

Response Fields (Decrypted)

Field	Type	Description
trxRef	string	Transaction reference for tracking
address	string	The destination wallet address confirmation

Example Request

The request body should be encrypted. Below shows the plaintext payload before encryption:

{
  "amount": 25000,
  "address": "0x5678901234abcdef5678901234abcdef56789012",
  "networkId": "clx1network123",
  "shouldSaveAddress": true
}

Encrypted request:

curl -X POST https://api.cngn.co/v1/api/withdraw \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "content": "BASE64_ENCRYPTED_CONTENT",
    "iv": "BASE64_IV"
  }'