---
title: "Sub-account Spot Asset Transfer History (For Master Account)"
method: GET
path: "/sapi/v1/sub-account/sub/transfer/history"
tags: ["Sub-Account"]
---

# Sub-account Spot Asset Transfer History (For Master Account)

`GET /sapi/v1/sub-account/sub/transfer/history`

## Request

- Base URL: `https://api.binance.com`
- URL: `https://api.binance.com/sapi/v1/sub-account/sub/transfer/history`
- Auth: API key in header `X-MBX-APIKEY`

- fromEmail and toEmail cannot be sent at the same time.
- Return fromEmail equal master account email by default.

Weight(IP): 1

## Query parameters

- `fromEmail` string
- `toEmail` string
- `startTime` integer
- `endTime` integer
- `page` integer
- `limit` integer
- `recvWindow` integer
- `timestamp` integer, required
- `signature` string, required

## Response `200`

Sub-account Spot Asset Transfer History

- object[]
  - `from` string, required
  - `to` string, required
  - `asset` string, required
  - `qty` string, required
  - `status` string, required
  - `tranId` integer, required
  - `time` integer, required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized Request

## Changes

- **2021-10-25** `a484ce871a72`: 6 breaking, 11 info
  - for the `query` request parameter `endTime`, the format changed from no format to `int64`
  - for the `query` request parameter `limit`, the format changed from no format to `int32`
  - for the `query` request parameter `page`, the format changed from no format to `int32`
  - for the `query` request parameter `recvWindow`, the format changed from no format to `int64`
  - …13 more

[Operation history](https://skmtc.dev/binance/apis/binance-public-spot-api/changes/sapi/v1/sub-account/sub/transfer/history/get.md)

---

[API](https://skmtc.dev/binance/apis/binance-public-spot-api.md) - [All operations](https://skmtc.dev/binance/apis/binance-public-spot-api/llms.txt) - [OpenAPI document](https://skmtc.dev/binance/apis/binance-public-spot-api/revisions/0dd2f133e12d?raw)
