Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.busha.io/llms.txt

Use this file to discover all available pages before exploring further.

This example shows you how to sell cryptocurrency (USDT, BTC, ETH, etc.) for fiat currency (NGN, KES) using Busha’s API.

​
Use Cases

  • Cash out crypto to local bank account
  • Pay vendors in local currency from crypto balance
  • Sell stablecoins for local currency to cover expenses

​
Example: Sell Crypto for Fiat

​
Sell 100 USDT for NGN

1

Get a Quote

Create a quote to see the exchange rate and how much fiat 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": "USDT",
            "target_currency": "NGN",
            "source_amount": "100",
            "pay_in": {
              "type": "address",
              "network": "TRX"
            }
          }'

{
  "status": "success",
  "message": "Created quote successfully",
  "data": {
    "id": "QUO_KfCZEaXJD10W",
    "profile_id": "BUS_CQr0jPzGGzmn1uW5W7OVs",
    "source_currency": "USDT",
    "target_currency": "NGN",
    "source_amount": "100",
    "target_amount": "147386",
    "rate": {
      "product": "USDTNGN",
      "rate": "1473.86",
      "side": "sell",
      "type": "FIXED",
      "source_currency": "USDT",
      "target_currency": "NGN"
    },
    "fees": [],
    "pay_in": {
      "network": "TRX",
      "type": "address"
    },
    "pay_out": {
      "type": "balance"
    },
    "reference": "QUO_KfCZEaXJD10W",
    "status": "pending",
    "expires_at": "2026-01-23T11:35:48.561357552Z",
    "created_at": "2026-01-23T11:05:48.561332107Z",
    "updated_at": "2026-01-23T11:05:48.561332107Z"
  }
}
2

Execute the Sale

Use the quote ID to get the crypto deposit address:
        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_KfCZEaXJD10W"
          }'

{
  "status": "success",
  "message": "Created transfer successfully",
  "data": {
    "id": "TRF_6qPeJdrePrj6",
    "profile_id": "BUS_CQr0jPzGGzmn1uW5W7OVs",
    "quote_id": "QUO_KfCZEaXJD10W",
    "description": "Sold USDT",
    "sub_description": "For NGN",
    "source_currency": "USDT",
    "target_currency": "NGN",
    "source_amount": "100",
    "target_amount": "147386",
    "trade": "sell",
    "rate": {
      "product": "USDTNGN",
      "rate": "1473.86",
      "side": "sell",
      "type": "FIXED",
      "source_currency": "USDT",
      "target_currency": "NGN"
    },
    "fees": [],
    "pay_in": {
      "address": "TDbX2dG8s9fLNg4YBGPsoAHFzzYgY5df57",
      "expires_at": "2026-01-23T12:08:54.983548Z",
      "network": "TRX",
      "type": "address"
    },
    "status": "pending",
    "timeline": {
      "total_steps": 0,
      "current_step": 0,
      "transfer_status": "",
      "events": []
    },
    "created_at": "2026-01-23T11:08:54.912314446Z",
    "updated_at": "2026-01-23T11:08:54.912314516Z"
  }
}
Important: Send exactly 100 USDT (TRC20) to the address TDbX2dG8s9fLNg4YBGPsoAHFzzYgY5df57 before the expiration time. The NGN will be credited to your balance once the deposit is confirmed on-chain.
3

Check Transfer Status

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

{
  "status": "success",
  "message": "Fetched transfer successfully",
  "data": {
    "id": "TRF_6qPeJdrePrj6",
    "profile_id": "BUS_CQr0jPzGGzmn1uW5W7OVs",
    "quote_id": "QUO_KfCZEaXJD10W",
    "description": "Sold USDT",
    "sub_description": "For NGN",
    "source_currency": "USDT",
    "target_currency": "NGN",
    "source_amount": "100",
    "target_amount": "147386",
    "trade": "sell",
    "rate": {
      "product": "USDTNGN",
      "rate": "1473.86",
      "side": "sell",
      "type": "FIXED",
      "source_currency": "USDT",
      "target_currency": "NGN"
    },
    "fees": [],
    "pay_in": {
      "address": "TDbX2dG8s9fLNg4YBGPsoAHFzzYgY5df57",
      "expires_at": "2026-01-23T12:08:54.983548Z",
      "network": "TRX",
      "type": "address"
    },
    "status": "pending",
    "timeline": {
      "total_steps": 3,
      "current_step": 1,
      "transfer_status": "pending",
      "events": [
        {
          "step": 1,
          "done": true,
          "status": "pending",
          "title": "Transfer Started",
          "description": "Waiting for your USDT deposit",
          "timestamp": "2026-01-23T11:08:54.9123Z"
        },
        {
          "step": 2,
          "done": false,
          "status": "funds_received",
          "title": "Crypto Received",
          "description": "We received your USDT Deposit",
          "timestamp": "2026-01-23T11:08:54.9123Z"
        },
        {
          "step": 3,
          "done": false,
          "status": "funds_converted",
          "title": "Funds Converted",
          "description": "Money has been added to your wallet.",
          "timestamp": "2026-01-23T11:08:54.912309Z"
        }
      ]
    },
    "created_at": "2026-01-23T11:08:54.912314Z",
    "updated_at": "2026-01-23T11:08:54.912314Z"
  }
}

​
Other Currency Combinations

Sell BTC for 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": "BTC",
    "target_currency": "NGN",
    "source_amount": "0.001",
    "pay_in": {
      "type": "balance"
    }
  }'
Sell ETH for 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": "ETH",
    "target_currency": "KES",
    "source_amount": "0.01",
    "pay_in": {
      "type": "address",
      "network": "ETH"
    }
  }'

​
Learn More