Buy Crypto with Fiat • Busha Developer Documentation

Quotes are valid for 3 minutes from creation. After that, they expire and transfers can no longer be created from them. Create the transfer before the quote expires. The quoted rate is honoured for the remainder of the same 3-minute quote validity window; creating a transfer does not restart it. For transfers involving deposits, ensure the deposit is received within the same quote validity window. Deposits received outside that window are settled at the market rate. Check the quote’s expires_at before creating the transfer. The transfer does not start a new quote validity window.

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:07:17.175146315Z",
    "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 and ensure the deposit is received before the quote’s 3-minute validity window ends to honour the quoted rate. Deposits received outside that window are settled at the market rate. 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-20T15:33:35.039935771Z",
    "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