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

Use Cases

  • Buy Bitcoin with local currency
  • Buy stablecoins for international payments
  • Purchase crypto from local currency balance

Example: Buy Crypto with Fiat

Buy USDT with 50,000 NGN

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"
          }'
{
  "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": [],
    "reference": "QUO_DnxR9RLTXIuy",
    "status": "pending",
    "expires_at": "2025-10-29T13:52:57.407162722Z",
    "created_at": "2025-10-29T13:22:57.407139812Z"
  }
}
2

Create the Transfer

Use the quote ID to finalize the purchase:
        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"
          }'
{
  "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"
    },
    "fees": [],
    "status": "pending",
    "created_at": "2025-10-29T13:26:39.992612423Z"
  }
}
3

Check Transfer Status

Monitor the transfer to confirm the purchase completed successfully:
        curl -X GET https://api.sandbox.busha.so/v1/transfers/TRF_UDmJwU2RAzF7 \
          -H "Authorization: Bearer YOUR_SECRET_KEY"
{
  "status": "success",
  "message": "Fetched transfer successfully",
  "data": {
    "id": "TRF_UDmJwU2RAzF7",
    "description": "Bought USDT",
    "sub_description": "With NGN",
    "source_currency": "NGN",
    "target_currency": "USDT",
    "source_amount": "50000",
    "target_amount": "33.50779726",
    "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"
        },
        {
          "step": 2,
          "done": true,
          "status": "funds_converted",
          "title": "Funds Converted",
          "description": "Your USDT has been added to your wallet."
        }
      ]
    }
  }
}

Other Currency Combinations

Buy ETH with 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": "NGN",
    "target_currency": "ETH",
    "source_amount": "100000"
  }'
Buy ETH with 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": "KES",
    "target_currency": "ETH",
    "source_amount": "5000"
  }'

Learn More