Sell Crypto for Fiat • Busha Developer Documentation

Quotes are valid for 3 minutes from creation. After that, they expire and transfers can no longer be created from them. Create the transfer before the quote expires. The quoted rate is honoured for the remainder of the same 3-minute quote validity window; creating a transfer does not restart it. For transfers involving deposits, ensure the deposit is received within the same quote validity window. Deposits received outside that window are settled at the market rate. Check the quote’s expires_at before creating the transfer. The transfer does not start a new quote validity window.

This example shows you how to sell cryptocurrency (USDT, BTC, ETH, etc.) for fiat currency (NGN, KES) using Busha’s API.

Use Cases

Cash out crypto to local bank account
Pay vendors in local currency from crypto balance
Sell stablecoins for local currency to cover expenses

Example: Sell Crypto for Fiat

USDT to NGN
USDT to KES

Sell 100 USDT for NGN

Get a Quote

Create a quote to see the exchange rate and how much fiat you’ll receive:

        curl -X POST https://api.sandbox.busha.so/v1/quotes \
          -H "Authorization: Bearer YOUR_SECRET_KEY" \
          -H "Content-Type: application/json" \
          -d '{
            "source_currency": "USDT",
            "target_currency": "NGN",
            "source_amount": "100",
            "pay_in": {
              "type": "address",
              "network": "TRX"
            }
          }'

View Response

{
  "status": "success",
  "message": "Created quote successfully",
  "data": {
    "id": "QUO_KfCZEaXJD10W",
    "profile_id": "BUS_CQr0jPzGGzmn1uW5W7OVs",
    "source_currency": "USDT",
    "target_currency": "NGN",
    "source_amount": "100",
    "target_amount": "147386",
    "rate": {
      "product": "USDTNGN",
      "rate": "1473.86",
      "side": "sell",
      "type": "FIXED",
      "source_currency": "USDT",
      "target_currency": "NGN"
    },
    "fees": [],
    "pay_in": {
      "network": "TRX",
      "type": "address"
    },
    "pay_out": {
      "type": "balance"
    },
    "reference": "QUO_KfCZEaXJD10W",
    "status": "pending",
    "expires_at": "2026-01-23T11:08:48.561332107Z",
    "created_at": "2026-01-23T11:05:48.561332107Z",
    "updated_at": "2026-01-23T11:05:48.561332107Z"
  }
}

Execute the Sale

Use the quote ID to get the crypto deposit address:

        curl -X POST https://api.sandbox.busha.so/v1/transfers \
          -H "Authorization: Bearer YOUR_SECRET_KEY" \
          -H "Content-Type: application/json" \
          -d '{
            "quote_id": "QUO_KfCZEaXJD10W"
          }'

View Response

{
  "status": "success",
  "message": "Created transfer successfully",
  "data": {
    "id": "TRF_6qPeJdrePrj6",
    "profile_id": "BUS_CQr0jPzGGzmn1uW5W7OVs",
    "quote_id": "QUO_KfCZEaXJD10W",
    "description": "Sold USDT",
    "sub_description": "For NGN",
    "source_currency": "USDT",
    "target_currency": "NGN",
    "source_amount": "100",
    "target_amount": "147386",
    "trade": "sell",
    "rate": {
      "product": "USDTNGN",
      "rate": "1473.86",
      "side": "sell",
      "type": "FIXED",
      "source_currency": "USDT",
      "target_currency": "NGN"
    },
    "fees": [],
    "pay_in": {
      "address": "TDbX2dG8s9fLNg4YBGPsoAHFzzYgY5df57",
      "expires_at": "2026-01-23T12:08:54.983548Z",
      "network": "TRX",
      "type": "address"
    },
    "status": "pending",
    "timeline": {
      "total_steps": 0,
      "current_step": 0,
      "transfer_status": "",
      "events": []
    },
    "created_at": "2026-01-23T11:08:54.912314446Z",
    "updated_at": "2026-01-23T11:08:54.912314516Z"
  }
}

Important: Send exactly 100 USDT (TRC20) to the address TDbX2dG8s9fLNg4YBGPsoAHFzzYgY5df57 and ensure the deposit is received before the quote’s 3-minute validity window ends to honour the quoted rate. Deposits received outside that window are settled at the market rate. The NGN will be credited to your balance once the deposit is confirmed on-chain.

Check Transfer Status

Monitor the transfer to confirm the sale completed successfully:

        curl -X GET https://api.sandbox.busha.so/v1/transfers/TRF_6qPeJdrePrj6 \
          -H "Authorization: Bearer YOUR_SECRET_KEY"

View Response

{
  "status": "success",
  "message": "Fetched transfer successfully",
  "data": {
    "id": "TRF_6qPeJdrePrj6",
    "profile_id": "BUS_CQr0jPzGGzmn1uW5W7OVs",
    "quote_id": "QUO_KfCZEaXJD10W",
    "description": "Sold USDT",
    "sub_description": "For NGN",
    "source_currency": "USDT",
    "target_currency": "NGN",
    "source_amount": "100",
    "target_amount": "147386",
    "trade": "sell",
    "rate": {
      "product": "USDTNGN",
      "rate": "1473.86",
      "side": "sell",
      "type": "FIXED",
      "source_currency": "USDT",
      "target_currency": "NGN"
    },
    "fees": [],
    "pay_in": {
      "address": "TDbX2dG8s9fLNg4YBGPsoAHFzzYgY5df57",
      "expires_at": "2026-01-23T12:08:54.983548Z",
      "network": "TRX",
      "type": "address"
    },
    "status": "pending",
    "timeline": {
      "total_steps": 3,
      "current_step": 1,
      "transfer_status": "pending",
      "events": [
        {
          "step": 1,
          "done": true,
          "status": "pending",
          "title": "Transfer Started",
          "description": "Waiting for your USDT deposit",
          "timestamp": "2026-01-23T11:08:54.9123Z"
        },
        {
          "step": 2,
          "done": false,
          "status": "funds_received",
          "title": "Crypto Received",
          "description": "We received your USDT Deposit",
          "timestamp": "2026-01-23T11:08:54.9123Z"
        },
        {
          "step": 3,
          "done": false,
          "status": "funds_converted",
          "title": "Funds Converted",
          "description": "Money has been added to your wallet.",
          "timestamp": "2026-01-23T11:08:54.912309Z"
        }
      ]
    },
    "created_at": "2026-01-23T11:08:54.912314Z",
    "updated_at": "2026-01-23T11:08:54.912314Z"
  }
}

Sell 10 USDT for KES

Get a Quote

Create a quote to see the exchange rate and how much fiat you’ll receive:

        curl -X POST https://api.sandbox.busha.so/v1/quotes \
          -H "Authorization: Bearer YOUR_SECRET_KEY" \
          -H "Content-Type: application/json" \
          -d '{
            "source_currency": "USDT",
            "target_currency": "KES",
            "source_amount": "10",
            "pay_in": {
              "type": "balance"
            }
          }'

View Response

{
  "status": "success",
  "message": "Created quote successfully",
  "data": {
    "id": "QUO_VmvpRemZACRy",
    "profile_id": "BUS_CQr0jPzGGzmn1uW5W7OVs",
    "source_currency": "USDT",
    "target_currency": "KES",
    "source_amount": "10",
    "target_amount": "1305",
    "rate": {
      "product": "USDTKES",
      "rate": "130.5",
      "side": "sell",
      "type": "FIXED",
      "source_currency": "USDT",
      "target_currency": "KES"
    },
    "fees": [],
    "pay_in": {
      "type": "balance"
    },
    "pay_out": {
      "type": "balance"
    },
    "reference": "QUO_VmvpRemZACRy",
    "status": "pending",
    "expires_at": "2025-11-20T15:10:26.67398174Z",
    "created_at": "2025-11-20T15:07:26.67398174Z"
  }
}

Execute the Sale

Use the quote ID to finalize the sale:

        curl -X POST https://api.sandbox.busha.so/v1/transfers \
          -H "Authorization: Bearer YOUR_SECRET_KEY" \
          -H "Content-Type: application/json" \
          -d '{
            "quote_id": "QUO_VmvpRemZACRy"
          }'

View Response

{
  "status": "success",
  "message": "Created transfer successfully",
  "data": {
    "id": "TRF_5d7yGiWuNUZP",
    "profile_id": "BUS_CQr0jPzGGzmn1uW5W7OVs",
    "quote_id": "QUO_VmvpRemZACRy",
    "description": "Sold USDT",
    "sub_description": "For KES",
    "source_currency": "USDT",
    "target_currency": "KES",
    "source_amount": "10",
    "target_amount": "1305",
    "trade": "sell",
    "rate": {
      "product": "USDTKES",
      "rate": "130.5",
      "side": "sell",
      "type": "FIXED"
    },
    "fees": [],
    "pay_in": {
      "type": "balance"
    },
    "pay_out": {
      "type": "balance"
    },
    "status": "pending",
    "timeline": {
      "total_steps": 0,
      "current_step": 0,
      "transfer_status": "",
      "events": []
    },
    "created_at": "2025-11-20T15:11:04.27887877Z",
    "updated_at": "2025-11-20T15:11:04.27887877Z"
  }
}

Check Transfer Status

Monitor the transfer to confirm the sale completed successfully:

        curl -X GET https://api.sandbox.busha.so/v1/transfers/TRF_5d7yGiWuNUZP \
          -H "Authorization: Bearer YOUR_SECRET_KEY"

View Response

{
  "status": "success",
  "message": "Fetched transfer successfully",
  "data": {
    "id": "TRF_5d7yGiWuNUZP",
    "profile_id": "BUS_CQr0jPzGGzmn1uW5W7OVs",
    "quote_id": "QUO_VmvpRemZACRy",
    "description": "Sold USDT",
    "sub_description": "For KES",
    "source_currency": "USDT",
    "target_currency": "KES",
    "source_amount": "10",
    "target_amount": "1305",
    "trade": "sell",
    "rate": {
      "product": "USDTKES",
      "rate": "130.5",
      "side": "sell",
      "type": "FIXED"
    },
    "fees": [],
    "pay_in": {
      "type": "balance"
    },
    "pay_out": {
      "type": "balance"
    },
    "status": "funds_converted",
    "timeline": {
      "total_steps": 2,
      "current_step": 2,
      "transfer_status": "funds_converted",
      "events": [
        {
          "step": 1,
          "done": true,
          "status": "funds_received",
          "title": "Crypto Received",
          "description": "Funded from Balance"
        },
        {
          "step": 2,
          "done": true,
          "status": "funds_converted",
          "title": "Funds Converted",
          "description": "Money has been added to your wallet."
        }
      ]
    },
    "created_at": "2025-11-20T15:11:04.27887Z",
    "updated_at": "2025-11-20T15:11:05.456789Z"
  }
}

Other Currency Combinations

Sell BTC for NGN

curl -X POST https://api.sandbox.busha.so/v1/quotes \
  -H "Authorization: Bearer YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "source_currency": "BTC",
    "target_currency": "NGN",
    "source_amount": "0.001",
    "pay_in": {
      "type": "balance"
    }
  }'

Sell ETH for KES

curl -X POST https://api.sandbox.busha.so/v1/quotes \
  -H "Authorization: Bearer YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "source_currency": "ETH",
    "target_currency": "KES",
    "source_amount": "0.01",
    "pay_in": {
      "type": "address",
      "network": "ETH"
    }
  }'

Learn More

Understanding Quotes - Deep dive into how quotes work
Process Payouts - Step-by-step payout guide
Supported Currencies - See all available currency pairs
Transfer Status Reference - All possible transfer statuses

​Use Cases

​Example: Sell Crypto for Fiat

​Sell 100 USDT for NGN

​Sell 10 USDT for KES

​Other Currency Combinations

​Learn More

Use Cases

Example: Sell Crypto for Fiat

Sell 100 USDT for NGN

Sell 10 USDT for KES

Other Currency Combinations

Learn More