Buy Crypto with Fiat • Busha Developer Documentation

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

NGN to USDT
KES to BTC

Buy USDT with 50,000 NGN via Bank Transfer

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"
            }
          }'

View Response

{
  "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"
  }
}

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"
          }'

View Response

{
  "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": "ajibola@busha.co"
      },
      "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.

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"

View Response

{
  "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": "ajibola@busha.co"
      },
      "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"
  }
}

Buy BTC with 1,000 KES

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": "KES",
            "target_currency": "BTC",
            "source_amount": "1000",
            "pay_in": {
              "type": "balance"
            }
          }'

View Response

{
  "status": "success",
  "message": "Created quote successfully",
  "data": {
    "id": "QUO_a5D3oflYiz78",
    "profile_id": "BUS_CQr0jPzGGzmn1uW5W7OVs",
    "source_currency": "KES",
    "target_currency": "BTC",
    "source_amount": "1000",
    "target_amount": "0.00008471",
    "rate": {
      "product": "BTCKES",
      "rate": "11803984.7",
      "side": "buy",
      "type": "FIXED",
      "source_currency": "KES",
      "target_currency": "BTC"
    },
    "fees": [],
    "pay_in": {
      "type": "balance"
    },
    "pay_out": {
      "type": "balance"
    },
    "reference": "QUO_a5D3oflYiz78",
    "status": "pending",
    "expires_at": "2025-11-20T16:00:35.039961155Z",
    "created_at": "2025-11-20T15:30:35.039935771Z"
  }
}

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_a5D3oflYiz78"
          }'

View Response

{
  "status": "success",
  "message": "Created transfer successfully",
  "data": {
    "id": "TRF_vvTf73YOwNFD",
    "profile_id": "BUS_CQr0jPzGGzmn1uW5W7OVs",
    "quote_id": "QUO_a5D3oflYiz78",
    "description": "Bought BTC",
    "sub_description": "With KES",
    "source_currency": "KES",
    "target_currency": "BTC",
    "source_amount": "1000",
    "target_amount": "0.00008471",
    "trade": "buy",
    "rate": {
      "product": "BTCKES",
      "rate": "11803984.7",
      "side": "buy",
      "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:33:06.12036014Z",
    "updated_at": "2025-11-20T15:33:06.12036014Z"
  }
}

Check Transfer Status

Monitor the transfer to confirm the purchase completed successfully:

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

View Response

{
  "status": "success",
  "message": "Fetched transfer successfully",
  "data": {
    "id": "TRF_vvTf73YOwNFD",
    "profile_id": "BUS_CQr0jPzGGzmn1uW5W7OVs",
    "quote_id": "QUO_a5D3oflYiz78",
    "description": "Bought BTC",
    "sub_description": "With KES",
    "source_currency": "KES",
    "target_currency": "BTC",
    "source_amount": "1000",
    "target_amount": "0.00008471",
    "trade": "buy",
    "rate": {
      "product": "BTCKES",
      "rate": "11803984.7",
      "side": "buy",
      "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": "Payment Received",
          "description": "Funded from Balance"
        },
        {
          "step": 2,
          "done": true,
          "status": "funds_converted",
          "title": "Funds Converted",
          "description": "Your BTC has been added to your wallet."
        }
      ]
    },
    "created_at": "2025-11-20T15:33:06.12036Z",
    "updated_at": "2025-11-20T15:33:07.456789Z"
  }
}

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

Understanding Quotes - Deep dive into how quotes work
Create Your First Quote - Step-by-step guide
Supported Currencies - See all available currency pairs
Transfer Status Reference - All possible transfer statuses

​Use Cases

​Example: Buy Crypto with Fiat

​Buy USDT with 50,000 NGN via Bank Transfer

​Buy BTC with 1,000 KES

​Other Currency Combinations

​Learn More

Use Cases

Example: Buy Crypto with Fiat

Buy USDT with 50,000 NGN via Bank Transfer

Buy BTC with 1,000 KES

Other Currency Combinations

Learn More