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 via Bank Transfer

1

Get a Quote

Create a quote with temporary bank account funding:
        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",
            "pay_in": {
              "type": "temporary_bank_account"
            }
          }'

{
  "status": "success",
  "message": "Created quote successfully",
  "data": {
    "id": "QUO_gCcLjJ0P0uEc",
    "profile_id": "BUS_CQr0jPzGGzmn1uW5W7OVs",
    "source_currency": "NGN",
    "target_currency": "USDT",
    "source_amount": "50000",
    "target_amount": "33.48543819",
    "rate": {
      "product": "USDTNGN",
      "rate": "1490.2",
      "side": "buy",
      "type": "FIXED",
      "source_currency": "NGN",
      "target_currency": "USDT"
    },
    "fees": [
      {
        "amount": {
          "amount": "100",
          "currency": "NGN"
        },
        "name": "payment gateway fee",
        "type": "FIXED"
      }
    ],
    "pay_in": {
      "type": "temporary_bank_account"
    },
    "pay_out": {
      "type": "balance"
    },
    "reference": "QUO_gCcLjJ0P0uEc",
    "status": "pending",
    "expires_at": "2026-01-23T11:34:17.175170741Z",
    "created_at": "2026-01-23T11:04:17.175146315Z",
    "updated_at": "2026-01-23T11:04:17.175146315Z"
  }
}
2

Create the Transfer

Use the quote ID to get temporary bank details:
        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_gCcLjJ0P0uEc"
          }'

{
  "status": "success",
  "message": "Created transfer successfully",
  "data": {
    "id": "TRF_JSaOYnl7Sla0",
    "profile_id": "BUS_CQr0jPzGGzmn1uW5W7OVs",
    "quote_id": "QUO_gCcLjJ0P0uEc",
    "description": "Bought USDT",
    "sub_description": "With NGN",
    "source_currency": "NGN",
    "target_currency": "USDT",
    "source_amount": "50000",
    "target_amount": "33.48543819",
    "trade": "buy",
    "rate": {
      "product": "USDTNGN",
      "rate": "1490.2",
      "side": "buy",
      "type": "FIXED",
      "source_currency": "NGN",
      "target_currency": "USDT"
    },
    "fees": [
      {
        "amount": {
          "amount": "100",
          "currency": "NGN"
        },
        "name": "payment gateway fee",
        "type": "FIXED"
      }
    ],
    "pay_in": {
      "expires_at": "2026-01-23T11:37:32.289498887Z",
      "recipient_details": {
        "account_name": "BIBAGE TECHNOLOGIES LTD || Liverppol Business",
        "account_number": "0327318166",
        "bank_code": "090614",
        "bank_name": "Aella Microfinance Bank",
        "email": "[email protected]"
      },
      "type": "temporary_bank_account"
    },
    "status": "pending",
    "timeline": {
      "total_steps": 0,
      "current_step": 0,
      "transfer_status": "",
      "events": []
    },
    "created_at": "2026-01-23T11:07:31.197428968Z",
    "updated_at": "2026-01-23T11:07:31.197429043Z"
  }
}
Important: Transfer exactly ₦50,000 to the provided bank account before the expiration time. The USDT will be credited to your balance once payment is confirmed.
3

Check Transfer Status

Monitor the transfer to confirm the purchase completed successfully:
        curl -X GET https://api.sandbox.busha.so/v1/transfers/TRF_JSaOYnl7Sla0 \
          -H "Authorization: Bearer YOUR_SECRET_KEY"

{
  "status": "success",
  "message": "Fetched transfer successfully",
  "data": {
    "id": "TRF_JSaOYnl7Sla0",
    "profile_id": "BUS_CQr0jPzGGzmn1uW5W7OVs",
    "quote_id": "QUO_gCcLjJ0P0uEc",
    "description": "Bought USDT",
    "sub_description": "With NGN",
    "source_currency": "NGN",
    "target_currency": "USDT",
    "source_amount": "50000",
    "target_amount": "33.48543819",
    "trade": "buy",
    "rate": {
      "product": "USDTNGN",
      "rate": "1490.2",
      "side": "buy",
      "type": "FIXED",
      "source_currency": "NGN",
      "target_currency": "USDT"
    },
    "fees": [
      {
        "amount": {
          "amount": "100",
          "currency": "NGN"
        },
        "name": "payment gateway fee",
        "type": "FIXED"
      }
    ],
    "pay_in": {
      "expires_at": "2026-01-23T11:37:32.289498887Z",
      "recipient_details": {
        "account_name": "BIBAGE TECHNOLOGIES LTD || Liverppol Business",
        "account_number": "0327318166",
        "bank_code": "090614",
        "bank_name": "Aella Microfinance Bank",
        "email": "[email protected]"
      },
      "type": "temporary_bank_account"
    },
    "status": "funds_converted",
    "timeline": {
      "total_steps": 3,
      "current_step": 3,
      "transfer_status": "funds_converted",
      "events": [
        {
          "step": 1,
          "done": true,
          "status": "pending",
          "title": "Transfer Started",
          "description": "Waiting for your NGN payment",
          "timestamp": "2026-01-23T11:07:34.553579Z"
        },
        {
          "step": 2,
          "done": true,
          "status": "funds_received",
          "title": "Payment Received",
          "description": "We received your NGN Payment",
          "timestamp": "2026-01-23T11:07:34.553579Z"
        },
        {
          "step": 3,
          "done": true,
          "status": "funds_converted",
          "title": "Funds Converted",
          "description": "Your USDT has been added to your wallet.",
          "timestamp": "2026-01-23T11:07:34.65765Z"
        }
      ]
    },
    "created_at": "2026-01-23T11:07:31.197428Z",
    "updated_at": "2026-01-23T11:07:35.404245Z"
  }
}

​
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",
    "pay_in": {
      "type": "balance"
    }
  }'
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",
    "pay_in": {
      "type": "balance"
    }
  }'

​
Learn More