How to send crypto.

Sending crypto on quidax is easy peasy, you just have to follow these steps

Making Request.

To send crypto, you would need to call the API endpoint and pass the following parameters:


  • currency: this is the cryptocurrency you want to send, examples: ngn, usdt, btc, ltc, eth, xrp, usdt, dash, trx, doge, xrp, bnb, matic, shib, axs, safemoon, cake, xlm, aave, link.
  • amount: amount to transfer.
  • fund_uid: wallet address, or user id where you are planning to send the crypto
  • transaction_note: transaction note this is a transaction note, that can be used internally.
  • narration: transaction narration


  • user_id: The User ID. Use 'me' for the main authenticated user, use the user_id if sending for a Sub-account linked to the authenticated user.


curl --request POST \
     --url<user_id>/withdraws \
     --header 'Accept: application/json' \
     --header 'Authorization: Bearer <api_secret_key>' \
     --header 'Content-Type: application/json' \
     --data '
     "currency": "trx",
     "fund_uid": "TWMjBKD61DLXXQr6AvVnDMcVs5p46QSFzT",
     "amount": "5",
     "transaction_note": "Stay safe",
     "narration": "We love you."
const options = {
  method: 'POST',
  headers: {
    accept: 'application/json',
    'content-type': 'application/json',
    Authorization: 'Bearer s3cr3tk3y'
  body: JSON.stringify({
    currency: 'btc',
    fund_uid: '<fund_uid>',
    amount: '0.0000004',
    transaction_note: 'Stay safe',
    narration: 'We love you.'

fetch('<user_id>/withdraws', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));
import requests

url = "<user_id>/withdraws"

payload = {
    "currency": "btc",
    "amount": "0.0000004",
    "fund_uid": "<fund_uid>",
    "transaction_note": "Stay safe",
    "narration": "We love you."

headers = {
    "accept": "application/json",
    "content-type": "application/json",
    "Authorization": "Bearer s3cr3tk3y"

response =, json=payload, headers=headers)



  "status": "success",
  "message": "Successful",
  "data": {
    "id": "f7ud47rz",
    "reference": null,
    "type": "coin_address",
    "currency": "trx",
    "amount": "1.0",
    "fee": "1.0",
    "total": "2.0",
    "txid": null,
    "transaction_note": "love you",
    "narration": "smile more",
    "status": "Processing",
    "reason": null,
    "created_at": "2021-11-24T14:47:11.000Z",
    "done_at": null,
    "recipient": {
      "type": "coin_address",
      "details": {
        "address": "TWMjBKD61DLXXQr6AvVnDMcVs5p46QSFzT",
        "destination_tag": null,
        "name": null
    "wallet": {
      "id": "j5lzsrz7",
      "currency": "trx",
      "balance": "0.0000020029",
      "locked": "2.0",
      "staked": "0.0",
      "converted_balance": "0.00011356443",
      "reference_currency": "ngn",
      "is_crypto": true,
      "created_at": "2021-04-09T09:48:14.000Z",
      "updated_at": "2021-11-24T14:47:11.000Z",
      "deposit_address": "TZCDWPRaoMay6GSJpbv6yEk2Nn7nE11XwX",
      "destination_tag": null
    "user": {
      "id": "23azi7bj",
      "sn": "QDXXIRPXXKS",
      "email": "[email protected]",
      "reference": null,
      "first_name": "Oye",
      "last_name": "Olalekan",
      "display_name": "appstate",
      "created_at": "2021-04-09T09:48:14.000Z",
      "updated_at": "2021-04-09T10:54:32.000Z"


WIthdraw Status

Withdrawals are processed in the background so your integrations would need to listen to withdraw.successful or withdraw.rejected webhook to get the finally status of the withdrawal.

Here is a link to the API reference: