Skip to main content
This example shows you how to convert cryptocurrency (USDT, BTC, ETH, etc.) to 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
  • Convert stablecoins to Naira for expenses
  • Marketplace seller withdrawals to fiat

​
Example: Convert 0.01 ETH to NGN

1

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": "ETH",
        "target_currency": "NGN",
        "source_amount": "0.01"
      }'
Response:
{
  "status": "success",
  "message": "Created quote successfully",
  "data": {
    "id": "QUO_KnHEixq4aUwH",
    "profile_id": "BUS_9rDAqqREdmMQcQj3zsRlL",
    "source_currency": "ETH",
    "target_currency": "NGN",
    "source_amount": "0.01",
    "target_amount": "57642.22",
    "rate": {
      "product": "ETHNGN",
      "rate": "5764222.24",
      "side": "sell",
      "type": "FIXED",
      "source_currency": "ETH",
      "target_currency": "NGN"
    },
    "fees": [],
    "pay_in": {
      "type": "balance"
    },
    "pay_out": {
      "type": "balance"
    },
    "reference": "QUO_KnHEixq4aUwH",
    "status": "pending",
    "expires_at": "2025-10-30T09:43:54.906019648Z",
    "created_at": "2025-10-30T09:13:54.905993939Z",
    "updated_at": "2025-10-30T09:13:54.905993939Z"
  }
}
2

Create the Transfer

Use the quote ID to finalize the conversion:
    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_KnHEixq4aUwH"
      }'
Response:
{
  "status": "success",
  "message": "Created transfer successfully",
  "data": {
    "id": "TRF_91QAkVrRaXDZ",
    "profile_id": "BUS_9rDAqqREdmMQcQj3zsRlL",
    "quote_id": "QUO_KnHEixq4aUwH",
    "description": "Sold ETH",
    "sub_description": "For NGN",
    "source_currency": "ETH",
    "target_currency": "NGN",
    "source_amount": "0.01",
    "target_amount": "57642.22",
    "trade": "sell",
    "rate": {
      "product": "ETHNGN",
      "rate": "5764222.24",
      "side": "sell",
      "type": "FIXED",
      "source_currency": "ETH",
      "target_currency": "NGN"
    },
    "fees": [],
    "status": "pending",
    "timeline": {
      "total_steps": 0,
      "current_step": 0,
      "transfer_status": "",
      "events": []
    },
    "created_at": "2025-10-30T09:14:06.134616492Z",
    "updated_at": "2025-10-30T09:14:06.134616552Z"
  }
}
3

Check Transfer Status

Monitor the transfer to confirm it completed successfully:
    curl -X GET https://api.sandbox.busha.so/v1/transfers/TRF_91QAkVrRaXDZ \
      -H "Authorization: Bearer YOUR_SECRET_KEY"
Response:
{
  "id": "595d95db-38ac-4867-95a1-a54dbf9d7960",
  "user_id": "BUS_9rDAqqREdmMQcQj3zsRlL",
  "description": "Sold ETH",
  "sub_description": "for NGN",
  "rate": "@ NGN 5,764,222.24/ ETH",
  "amount": "0.01",
  "currency": "ETH",
  "available_balance": "2.49",
  "pending_balance": "0",
  "hold": "0",
  "escrow": "0",
  "savings": "0",
  "total_balance": "2.49",
  "timestamp": "2025-10-30T09:14:06.701944Z",
  "category": "sell",
  "meta": {
    "credit": "",
    "debit": "ETH 0.01",
    "rate": "NGN 5764222.24",
    "bank": "",
    "address": "",
    "blockchain_url": "",
    "confirmations": "0",
    "required_confirmations": "0",
    "fiat_value": "0",
    "fiat_currency": ""
  },
  "status": "completed",
  "status_description": "",
  "reference": "CNV_91QAkVrRaXDZ",
  "events": null
}

​
Other Examples

Convert USDT to 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": "USDT",
    "target_currency": "NGN",
    "source_amount": "100"
  }'
Convert BTC to 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": "BTC",
    "target_currency": "KES",
    "source_amount": "0.001"
  }'

​
Learn More