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
- ETH to NGN
- USDT to KES
Sell 0.01 ETH for NGN
1
Get a Quote
Create a quote to see the exchange rate and how much fiat you’ll receive:
Copy
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": "NGN",
"source_amount": "0.01"
}'
View Response
View Response
Copy
{
"status": "success",
"message": "Created quote successfully",
"data": {
"id": "QUO_KnHEixq4aUwH",
"profile_id": "BUS_9rDAqqREdmMQcQj3zsRlL",
"source_currency": "ETH",
"target_currency": "NGN",
"source_amount": "0.01",
"target_amount": "57642.22",
"rate": {
"product": "ETHNGN",
"rate": "5764222.24",
"side": "sell",
"type": "FIXED",
"source_currency": "ETH",
"target_currency": "NGN"
},
"fees": [],
"reference": "QUO_KnHEixq4aUwH",
"status": "pending",
"expires_at": "2025-10-30T09:43:54.906019648Z",
"created_at": "2025-10-30T09:13:54.905993939Z"
}
}
2
Execute the Sale
Use the quote ID to finalize the sale:
Copy
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_KnHEixq4aUwH"
}'
View Response
View Response
Copy
{
"status": "success",
"message": "Created transfer successfully",
"data": {
"id": "TRF_91QAkVrRaXDZ",
"profile_id": "BUS_9rDAqqREdmMQcQj3zsRlL",
"quote_id": "QUO_KnHEixq4aUwH",
"description": "Sold ETH",
"sub_description": "For NGN",
"source_currency": "ETH",
"target_currency": "NGN",
"source_amount": "0.01",
"target_amount": "57642.22",
"trade": "sell",
"rate": {
"product": "ETHNGN",
"rate": "5764222.24",
"side": "sell",
"type": "FIXED"
},
"fees": [],
"status": "pending",
"created_at": "2025-10-30T09:14:06.134616492Z"
}
}
3
Check Transfer Status
Monitor the transfer to confirm the sale completed successfully:
Copy
curl -X GET https://api.sandbox.busha.so/v1/transfers/TRF_91QAkVrRaXDZ \
-H "Authorization: Bearer YOUR_SECRET_KEY"
View Response
View Response
Copy
{
"status": "success",
"message": "Fetched transfer successfully",
"data": {
"id": "TRF_91QAkVrRaXDZ",
"description": "Sold ETH",
"sub_description": "for NGN",
"source_currency": "ETH",
"target_currency": "NGN",
"source_amount": "0.01",
"target_amount": "57642.22",
"status": "funds_converted",
"timeline": {
"total_steps": 2,
"current_step": 2,
"transfer_status": "funds_converted",
"events": [
{
"step": 1,
"done": true,
"status": "funds_received",
"title": "Crypto Received"
},
{
"step": 2,
"done": true,
"status": "funds_converted",
"title": "Funds Converted"
}
]
}
}
}
Sell 10 USDT for KES
1
Get a Quote
Create a quote to see the exchange rate and how much fiat you’ll receive:
Copy
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": "KES",
"source_amount": "10"
}'
View Response
View Response
Copy
{
"status": "success",
"message": "Created quote successfully",
"data": {
"id": "QUO_VmvpRemZACRy",
"profile_id": "BUS_CQr0jPzGGzmn1uW5W7OVs",
"source_currency": "USDT",
"target_currency": "KES",
"source_amount": "10",
"target_amount": "1305",
"rate": {
"product": "USDTKES",
"rate": "130.5",
"side": "sell",
"type": "FIXED",
"source_currency": "USDT",
"target_currency": "KES"
},
"fees": [],
"reference": "QUO_VmvpRemZACRy",
"status": "pending",
"expires_at": "2025-11-20T15:37:26.674151054Z",
"created_at": "2025-11-20T15:07:26.67398174Z"
}
}
2
Execute the Sale
Use the quote ID to finalize the sale:
Copy
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_VmvpRemZACRy"
}'
View Response
View Response
Copy
{
"status": "success",
"message": "Created transfer successfully",
"data": {
"id": "TRF_5d7yGiWuNUZP",
"profile_id": "BUS_CQr0jPzGGzmn1uW5W7OVs",
"quote_id": "QUO_VmvpRemZACRy",
"description": "Sold USDT",
"sub_description": "For KES",
"source_currency": "USDT",
"target_currency": "KES",
"source_amount": "10",
"target_amount": "1305",
"trade": "sell",
"rate": {
"product": "USDTKES",
"rate": "130.5",
"side": "sell",
"type": "FIXED"
},
"fees": [],
"status": "pending",
"created_at": "2025-11-20T15:11:04.27887877Z"
}
}
3
Check Transfer Status
Monitor the transfer to confirm the sale completed successfully:
Copy
curl -X GET https://api.sandbox.busha.so/v1/transfers/TRF_5d7yGiWuNUZP \
-H "Authorization: Bearer YOUR_SECRET_KEY"
View Response
View Response
Copy
{
"status": "success",
"message": "Fetched transfer successfully",
"data": {
"id": "TRF_5d7yGiWuNUZP",
"profile_id": "BUS_CQr0jPzGGzmn1uW5W7OVs",
"quote_id": "QUO_VmvpRemZACRy",
"description": "Sold USDT",
"sub_description": "For KES",
"source_currency": "USDT",
"target_currency": "KES",
"source_amount": "10",
"target_amount": "1305",
"status": "funds_converted",
"timeline": {
"total_steps": 2,
"current_step": 2,
"transfer_status": "funds_converted",
"events": [
{
"step": 1,
"done": true,
"status": "funds_received",
"title": "Crypto Received",
"description": "Funded from Balance"
},
{
"step": 2,
"done": true,
"status": "funds_converted",
"title": "Funds Converted",
"description": "Money has been added to your wallet."
}
]
}
}
}
Other Currency Combinations
Sell BTC for NGNCopy
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"
}'
Copy
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"
}'
Learn More
- Understanding Quotes - Deep dive into how quotes work
- Process Payouts - Step-by-step payout guide
- Supported Currencies - See all available currency pairs
- Transfer Status Reference - All possible transfer statuses