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
1
Get a Quote
First, create a quote to see the exchange rate and how much crypto 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": "NGN",
"target_currency": "USDT",
"source_amount": "50000"
}'
View Response
View Response
Copy
{
"status": "success",
"message": "Created quote successfully",
"data": {
"id": "QUO_DnxR9RLTXIuy",
"profile_id": "BUS_9rDAqqREdmMQcQj3zsRlL",
"source_currency": "NGN",
"target_currency": "USDT",
"source_amount": "50000",
"target_amount": "33.50779726",
"rate": {
"product": "USDTNGN",
"rate": "1492.19",
"side": "buy",
"type": "FIXED",
"source_currency": "NGN",
"target_currency": "USDT"
},
"fees": [],
"reference": "QUO_DnxR9RLTXIuy",
"status": "pending",
"expires_at": "2025-10-29T13:52:57.407162722Z",
"created_at": "2025-10-29T13:22:57.407139812Z"
}
}
2
Create the Transfer
Use the quote ID to finalize the purchase:
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_DnxR9RLTXIuy"
}'
View Response
View Response
Copy
{
"status": "success",
"message": "Created transfer successfully",
"data": {
"id": "TRF_UDmJwU2RAzF7",
"profile_id": "BUS_9rDAqqREdmMQcQj3zsRlL",
"quote_id": "QUO_DnxR9RLTXIuy",
"description": "Bought USDT",
"sub_description": "With NGN",
"source_currency": "NGN",
"target_currency": "USDT",
"source_amount": "50000",
"target_amount": "33.50779726",
"trade": "buy",
"rate": {
"product": "USDTNGN",
"rate": "1492.19",
"side": "buy",
"type": "FIXED"
},
"fees": [],
"status": "pending",
"created_at": "2025-10-29T13:26:39.992612423Z"
}
}
3
Check Transfer Status
Monitor the transfer to confirm the purchase completed successfully:
Copy
curl -X GET https://api.sandbox.busha.so/v1/transfers/TRF_UDmJwU2RAzF7 \
-H "Authorization: Bearer YOUR_SECRET_KEY"
View Response
View Response
Copy
{
"status": "success",
"message": "Fetched transfer successfully",
"data": {
"id": "TRF_UDmJwU2RAzF7",
"description": "Bought USDT",
"sub_description": "With NGN",
"source_currency": "NGN",
"target_currency": "USDT",
"source_amount": "50000",
"target_amount": "33.50779726",
"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 USDT has been added to your wallet."
}
]
}
}
}
Buy BTC with 1,000 KES
1
Get a Quote
First, create a quote to see the exchange rate and how much crypto 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": "KES",
"target_currency": "BTC",
"source_amount": "1000"
}'
View Response
View Response
Copy
{
"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": [],
"reference": "QUO_a5D3oflYiz78",
"status": "pending",
"expires_at": "2025-11-20T16:00:35.039961155Z",
"created_at": "2025-11-20T15:30:35.039935771Z"
}
}
2
Create the Transfer
Use the quote ID to finalize the purchase:
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_a5D3oflYiz78"
}'
View Response
View Response
Copy
{
"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": [],
"status": "pending",
"created_at": "2025-11-20T15:33:06.12036014Z"
}
}
3
Check Transfer Status
Monitor the transfer to confirm the purchase completed successfully:
Copy
curl -X GET https://api.sandbox.busha.so/v1/transfers/TRF_vvTf73YOwNFD \
-H "Authorization: Bearer YOUR_SECRET_KEY"
View Response
View Response
Copy
{
"status": "success",
"message": "Fetched transfer successfully",
"data": {
"id": "TRF_vvTf73YOwNFD",
"description": "Bought BTC",
"sub_description": "With KES",
"source_currency": "KES",
"target_currency": "BTC",
"source_amount": "1000",
"target_amount": "0.00008471",
"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."
}
]
}
}
}
Other Currency Combinations
Buy ETH with 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": "NGN",
"target_currency": "ETH",
"source_amount": "100000"
}'
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": "KES",
"target_currency": "ETH",
"source_amount": "5000"
}'
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