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
- USDT to NGN
- USDT to KES
Sell 100 USDT for NGN
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": "NGN",
"source_amount": "100",
"pay_in": {
"type": "address",
"network": "TRX"
}
}'
View Response
View Response
Copy
{
"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"
}
}
Execute the Sale
Use the quote ID to get the crypto deposit address:
Important: Send exactly 100 USDT (TRC20) to the address
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_KfCZEaXJD10W"
}'
View Response
View Response
Copy
{
"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"
}
}
TDbX2dG8s9fLNg4YBGPsoAHFzzYgY5df57 before the expiration time. The NGN will be credited to your balance once the deposit is confirmed on-chain.Check Transfer Status
Monitor the transfer to confirm the sale completed successfully:
Copy
curl -X GET https://api.sandbox.busha.so/v1/transfers/TRF_6qPeJdrePrj6 \
-H "Authorization: Bearer YOUR_SECRET_KEY"
View Response
View Response
Copy
{
"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"
}
}
Sell 10 USDT for KES
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",
"pay_in": {
"type": "balance"
}
}'
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": [],
"pay_in": {
"type": "balance"
},
"pay_out": {
"type": "balance"
},
"reference": "QUO_VmvpRemZACRy",
"status": "pending",
"expires_at": "2025-11-20T15:37:26.674151054Z",
"created_at": "2025-11-20T15:07:26.67398174Z"
}
}
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": [],
"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:11:04.27887877Z",
"updated_at": "2025-11-20T15:11:04.27887877Z"
}
}
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",
"trade": "sell",
"rate": {
"product": "USDTKES",
"rate": "130.5",
"side": "sell",
"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": "Crypto Received",
"description": "Funded from Balance"
},
{
"step": 2,
"done": true,
"status": "funds_converted",
"title": "Funds Converted",
"description": "Money has been added to your wallet."
}
]
},
"created_at": "2025-11-20T15:11:04.27887Z",
"updated_at": "2025-11-20T15:11:05.456789Z"
}
}
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",
"pay_in": {
"type": "balance"
}
}'
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",
"pay_in": {
"type": "address",
"network": "ETH"
}
}'
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