BinanceTransfer: Universal Transfer Management

BinanceTransfer: Universal Transfer Management

BinanceTransfer: Universal Transfer Management

Details

Provides methods for initiating and querying universal transfers between wallet types on Binance. Inherits from BinanceBase.

Purpose and Scope

• Transfer Initiation: Move assets between spot, margin, futures, and funding wallets using the universal transfer endpoint.

• Transfer History: Query transfer records with pagination support.

Usage

All methods require authentication (valid API key and secret). These are wallet (/sapi/) endpoints, not spot (/api/) endpoints.

Official Documentation

Binance Universal Transfer

Endpoints Covered

Method	Endpoint	HTTP
add_transfer	POST /sapi/v1/asset/transfer	POST
get_transfer_history	GET /sapi/v1/asset/transfer	GET

Transfer Types

• MAIN_UMFUTURE: Spot to USDM Futures

• MAIN_CMFUTURE: Spot to COINM Futures

• MAIN_MARGIN: Spot to Cross Margin

• UMFUTURE_MAIN: USDM Futures to Spot

• UMFUTURE_MARGIN: USDM Futures to Cross Margin

• CMFUTURE_MAIN: COINM Futures to Spot

• MARGIN_MAIN: Cross Margin to Spot

• MARGIN_UMFUTURE: Cross Margin to USDM Futures

• MAIN_FUNDING: Spot to Funding

• FUNDING_MAIN: Funding to Spot

• FUNDING_UMFUTURE: Funding to USDM Futures

• UMFUTURE_FUNDING: USDM Futures to Funding

• MARGIN_FUNDING: Cross Margin to Funding

• FUNDING_MARGIN: Funding to Cross Margin

• FUNDING_CMFUTURE: Funding to COINM Futures

• CMFUTURE_FUNDING: COINM Futures to Funding

• MAIN_ISOLATED_MARGIN: Spot to Isolated Margin

• ISOLATED_MARGIN_MAIN: Isolated Margin to Spot

Super class

binance::BinanceBase -> BinanceTransfer

Methods

Public methods

• BinanceTransfer$add_transfer()

• BinanceTransfer$get_transfer_history()

• BinanceTransfer$clone()

Inherited methods

• binance::BinanceBase$initialize()

---

Method add_transfer()

Initiate a Universal Transfer

Transfers assets between wallet types (spot, margin, futures, funding).

API Endpoint

POST https://api.binance.com/sapi/v1/asset/transfer

Official Documentation

Binance Universal Transfer Verified: 2026-03-10

curl

curl -X POST 'https://api.binance.com/sapi/v1/asset/transfer' \
  -H 'X-MBX-APIKEY: your-api-key' \
  -d 'type=MAIN_UMFUTURE&asset=USDT&amount=100&timestamp=1661493146000&signature=...'

JSON Request

{
  "type": "MAIN_UMFUTURE",
  "asset": "USDT",
  "amount": "100",
  "timestamp": 1661493146000,
  "signature": "..."
}

JSON Response

{
  "tranId": 13526853623
}

Usage

BinanceTransfer$add_transfer(
  type,
  asset,
  amount,
  fromSymbol = NULL,
  toSymbol = NULL,
  recvWindow = NULL
)

Arguments

type

Character; transfer type. One of "MAIN_UMFUTURE", "MAIN_CMFUTURE", "MAIN_MARGIN", "UMFUTURE_MAIN", "UMFUTURE_MARGIN", "CMFUTURE_MAIN", "MARGIN_MAIN", "MARGIN_UMFUTURE", "MAIN_FUNDING", "FUNDING_MAIN", "FUNDING_UMFUTURE", "UMFUTURE_FUNDING", "MARGIN_FUNDING", "FUNDING_MARGIN", "FUNDING_CMFUTURE", "CMFUTURE_FUNDING", "MAIN_ISOLATED_MARGIN", "ISOLATED_MARGIN_MAIN".

asset

Character; asset to transfer (e.g., "USDT").

amount

Numeric; amount to transfer.

fromSymbol

Character or NULL; mandatory when type involves isolated margin (e.g., "BNBUSDT").

toSymbol

Character or NULL; mandatory when type involves isolated margin (e.g., "BNBUSDT").

recvWindow

Integer or NULL; max 60000.

Returns

data.table with one row and the following columns:

• tran_id (numeric): Unique transfer identifier assigned by Binance.

Examples

\dontrun{
transfer <- BinanceTransfer$new()
result <- transfer$add_transfer(
  type = "MAIN_UMFUTURE", asset = "USDT", amount = 100
)
print(result)
}

---

Method get_transfer_history()

Query Universal Transfer History

Retrieves transfer history for a given transfer type, with optional time range and pagination.

API Endpoint

GET https://api.binance.com/sapi/v1/asset/transfer

Official Documentation

Binance Universal Transfer Verified: 2026-03-10

curl

curl -X GET 'https://api.binance.com/sapi/v1/asset/transfer?type=MAIN_UMFUTURE&timestamp=1661493146000&signature=...' \
  -H 'X-MBX-APIKEY: your-api-key'

JSON Response

{
  "total": 2,
  "rows": [
    {
      "asset": "USDT",
      "amount": "100.00000000",
      "type": "MAIN_UMFUTURE",
      "status": "CONFIRMED",
      "tranId": 13526853623,
      "timestamp": 1661493146000
    }
  ]
}

Usage

BinanceTransfer$get_transfer_history(
  type,
  startTime = NULL,
  endTime = NULL,
  current = NULL,
  size = NULL,
  fromSymbol = NULL,
  toSymbol = NULL,
  recvWindow = NULL
)

Arguments

type

Character; transfer type. Same options as add_transfer().

startTime

Integer or NULL; start timestamp in milliseconds.

endTime

Integer or NULL; end timestamp in milliseconds.

current

Integer or NULL; current page (default 1, starting from 1).

size

Integer or NULL; page size (default 10, max 100).

fromSymbol

Character or NULL; must be sent when type involves isolated margin.

toSymbol

Character or NULL; must be sent when type involves isolated margin.

recvWindow

Integer or NULL; max 60000.

Returns

data.table with one row per transfer and the following columns:

• asset (character): Transferred asset (e.g., "USDT").

• amount (character): Amount transferred.

• type (character): Transfer type (e.g., "MAIN_UMFUTURE").

• status (character): Transfer status ("CONFIRMED", "FAILED", "PENDING").

• tran_id (numeric): Unique transfer identifier.

• timestamp (POSIXct): Transfer time converted from milliseconds.

Examples

\dontrun{
transfer <- BinanceTransfer$new()
history <- transfer$get_transfer_history(type = "MAIN_UMFUTURE")
print(history)
}

---

Method clone()

The objects of this class are cloneable with this method.

Usage

BinanceTransfer$clone(deep = FALSE)

Arguments

deep

Whether to make a deep clone.

Examples

if (FALSE) { # \dontrun{
# Synchronous
transfer <- BinanceTransfer$new()
result <- transfer$add_transfer(
  type = "MAIN_UMFUTURE", asset = "USDT", amount = 100
)
print(result)

# Asynchronous
transfer_async <- BinanceTransfer$new(async = TRUE)
main <- coro::async(function() {
  result <- await(transfer_async$add_transfer(
    type = "MAIN_UMFUTURE", asset = "USDT", amount = 100
  ))
  print(result)
})
main()
while (!later::loop_empty()) later::run_now()
} # }


## ------------------------------------------------
## Method `BinanceTransfer$add_transfer`
## ------------------------------------------------

if (FALSE) { # \dontrun{
transfer <- BinanceTransfer$new()
result <- transfer$add_transfer(
  type = "MAIN_UMFUTURE", asset = "USDT", amount = 100
)
print(result)
} # }

## ------------------------------------------------
## Method `BinanceTransfer$get_transfer_history`
## ------------------------------------------------

if (FALSE) { # \dontrun{
transfer <- BinanceTransfer$new()
history <- transfer$get_transfer_history(type = "MAIN_UMFUTURE")
print(history)
} # }