划转历史

获取现货合约划转记录（游标分页）。

接口信息

• 方法: GET
• 路径: /fapi/v1/account/transfer/history
• 鉴权: 需要签名认证（详见 公共模块 · 签名说明）

请求参数

参数	位置	类型	必填	说明
start_time	query	integer	否	开始时间（毫秒时间戳）
end_time	query	integer	否	结束时间（毫秒时间戳）
cursor	query	string	否	分页游标
limit	query	integer	否	每页数量，默认 100，最大 100

请求示例

GET /fapi/v1/account/transfer/history?limit=50

响应字段

字段	类型	说明
code	integer	状态码
message	string	返回消息
data.has_more	boolean	是否有更多
data.next_cursor	string	下一页游标
data.items	array	划转记录列表
data.items[].id	integer	转账 ID
data.items[].asset	string	资产类型
data.items[].amount	string	转账金额
data.items[].from_account	integer	转出账户：1=现货，2=合约
data.items[].to_account	integer	转入账户
data.items[].status	integer	状态：1=处理中，2=已完成，3=失败
data.items[].fail_reason	string	失败原因
data.items[].created_at	integer	创建时间（毫秒）

响应示例

{
  "code": 0,
  "message": "success",
  "data": {
    "has_more": false,
    "next_cursor": "",
    "items": [
      {
        "id": 123456,
        "asset": "USDT",
        "amount": "1000.00",
        "from_account": 1,
        "to_account": 2,
        "status": 2,
        "fail_reason": "",
        "created_at": 1711929600000
      }
    ]
  }
}