GuideReference

Crypto Deposit

This guide explains how to make a crypto → crypto deposit via Busha API.

Crypto Deposit is similar to Fiat Deposit in that you create a Quote with the same values for source_currency and target_currency. The distinction is in that the type of currency must be a crypto currency and the pay_in object uses the address pay_in type with the corresponding network for the currency.

Initialize the crypto deposit quote:

curl -i -X POST \
  https://api.busha.co/v1/quotes \
  -H 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "source_currency": "BTC",
    "target_currency": "BTC",
    "source_amount": "0.0001",
    "pay_in": {
      "type": "address",
      "network": "BTC"
    }
  }'

Quote Initialization Response:

{
  "status": "success",
  "message": "Created quote successfully",
  "data": {
    "id": "QUO_nEnsWPZ8KErY598DCj9Pk",
    "profile_id": "BUS_tg6yujbZ1nMu5BLQkPGGO",
    "source_currency": "BTC",
    "target_currency": "BTC",
    "source_amount": "0.0001",
    "target_amount": "0.0001",
    "rate": {
      "product": "",
      "rate": "1",
      "side": "sell",
      "type": "FIXED",
      "source_currency": "BTC",
      "target_currency": "BTC"
    },
    "fees": [],
    "pay_in": {
      "network": "BTC",
      "type": "address"
    },
    "reference": "QUO_nEnsWPZ8KErY598DCj9Pk",
    "status": "pending",
    "created_at": "2025-02-24T14:52:33.221141634Z",
    "updated_at": "2025-02-24T14:52:33.221141634Z"
  }
}

Finalize the transfer:

curl -i -X POST \
  https://api.busha.co/v1/transfers \
  -H 'Authorization: Bearer YOUR_SECRET_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "quote_id": "QUO_nEnsWPZ8KErY598DCj9Pk"
  }'

Upon getting a response for finalizing the transfer, just like the fiat deposit, you will then see the wallet address that corresponds with the currency and network requested. See the example below:

{
  "status": "success",
  "message": "Created transfer successfully",
  "data": {
    "id": "TRF_ZALYpZBvgHLLImcWY9CxI",
    "profile_id": "BUS_tg6yujbZ1nMu5BLQkPGGO",
    "quote_id": "QUO_nEnsWPZ8KErY598DCj9Pk",
    "source_currency": "BTC",
    "target_currency": "BTC",
    "source_amount": "0.0001",
    "target_amount": "0.0001",
    "rate": {
      "rate": "1",
      "side": "sell",
      "type": "FIXED",
      "source_currency": "BTC",
      "target_currency": "BTC"
    },
    "fees": [],
    "pay_in": {
      "address": "tb1qzw4ynldc55lpkx3vcsk03susv9nwzj6qp78qsq",
      "expires_at": "2025-02-24T15:53:33.518656Z",
      "network": "BTC",
      "type": "address"
    },
    "status": "pending",
    "created_at": "2025-02-24T14:53:32.411488796Z",
    "updated_at": "2025-02-24T14:53:32.411488876Z"
  }
}

A payment into the address above: data.pay_in.address will be deposited directly into the Busha crypto wallet and your transaction should be completed.