Skip to main content
This example shows you how to convert fiat currency (NGN, KES) to cryptocurrency (USDT, BTC, etc.) using Busha’s API.

​
Use Cases

  • A Customer wants to buy Bitcoin with Naira
  • Converting local currency to stablecoins for international payments

​
Example: Convert 50,000 NGN to USDT

1

Get a Quote

First, create a quote to see the exchange rate and how much crypto 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": "NGN",
        "target_currency": "USDT",
        "source_amount": "50000"
      }'
Response:
{
  "status": "success",
  "message": "Created quote successfully",
  "data": {
    "id": "QUO_DnxR9RLTXIuy",
    "profile_id": "BUS_9rDAqqREdmMQcQj3zsRlL",
    "source_currency": "NGN",
    "target_currency": "USDT",
    "source_amount": "50000",
    "target_amount": "33.50779726",
    "rate": {
      "product": "USDTNGN",
      "rate": "1492.19",
      "side": "buy",
      "type": "FIXED",
      "source_currency": "NGN",
      "target_currency": "USDT"
    },
    "fees": [],
    "pay_in": {
      "type": "balance"
    },
    "pay_out": {
      "type": "balance"
    },
    "reference": "QUO_DnxR9RLTXIuy",
    "status": "pending",
    "expires_at": "2025-10-29T13:52:57.407162722Z",
    "created_at": "2025-10-29T13:22:57.407139812Z",
    "updated_at": "2025-10-29T13:22:57.407139812Z"
  }
}
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_DnxR9RLTXIuy"
      }'
Response:
{
  "status": "success",
  "message": "Created transfer successfully",
  "data": {
    "id": "TRF_UDmJwU2RAzF7",
    "profile_id": "BUS_9rDAqqREdmMQcQj3zsRlL",
    "quote_id": "QUO_DnxR9RLTXIuy",
    "description": "Bought USDT",
    "sub_description": "With NGN",
    "source_currency": "NGN",
    "target_currency": "USDT",
    "source_amount": "50000",
    "target_amount": "33.50779726",
    "trade": "buy",
    "rate": {
      "product": "USDTNGN",
      "rate": "1492.19",
      "side": "buy",
      "type": "FIXED",
      "source_currency": "NGN",
      "target_currency": "USDT"
    },
    "fees": [],
    "status": "pending",
    "timeline": {
      "total_steps": 0,
      "current_step": 0,
      "transfer_status": "",
      "events": []
    },
    "created_at": "2025-10-29T13:26:39.992612423Z",
    "updated_at": "2025-10-29T13:26:39.992612477Z"
  }
}
3

Check Transfer Status

Monitor the transfer to confirm it completed successfully:
    curl -X GET https://api.sandbox.busha.so/v1/transfers/TRF_UDmJwU2RAzF7 \
      -H "Authorization: Bearer YOUR_SECRET_KEY"
Response:
{
  "status": "success",
  "message": "Fetched transfer successfully",
  "data": {
    "id": "TRF_UDmJwU2RAzF7",
    "profile_id": "BUS_9rDAqqREdmMQcQj3zsRlL",
    "quote_id": "QUO_DnxR9RLTXIuy",
    "description": "Bought USDT",
    "sub_description": "With NGN",
    "source_currency": "NGN",
    "target_currency": "USDT",
    "source_amount": "50000",
    "target_amount": "33.50779726",
    "trade": "buy",
    "rate": {
      "product": "USDTNGN",
      "rate": "1492.19",
      "side": "buy",
      "type": "FIXED",
      "source_currency": "NGN",
      "target_currency": "USDT"
    },
    "fees": [],
    "status": "funds_converted",
    "timeline": {
      "total_steps": 2,
      "current_step": 2,
      "transfer_status": "funds_converted",
      "events": [
        {
          "step": 1,
          "done": true,
          "status": "funds_received",
          "title": "Payment Received",
          "description": "Funded from Balance",
          "timestamp": "2025-10-29T13:26:40.236124Z"
        },
        {
          "step": 2,
          "done": true,
          "status": "funds_converted",
          "title": "Funds Converted",
          "description": "Your USDT has been added to your wallet.",
          "timestamp": "2025-10-29T13:26:40.236124Z"
        }
      ]
    },
    "created_at": "2025-10-29T13:26:39.992612Z",
    "updated_at": "2025-10-29T13:26:41.01604Z"
  }
}

​
Other Examples

Convert KES to BTC 
curl -X POST https://api.sandbox.busha.so/v1/quotes \
  -H "Authorization: Bearer YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "source_currency": "KES",
    "target_currency": "BTC",
    "source_amount": "10000"
  }'
Convert NGN to ETH 
curl -X POST https://api.sandbox.busha.so/v1/quotes \
  -H "Authorization: Bearer YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "source_currency": "NGN",
    "target_currency": "ETH",
    "source_amount": "100000"
  }'

​
Learn More