获取兑换记录

描述

获取最近90天兑换记录

HTTP请求

• GET /api/v3/account/convert-records
• 限频规则: 20次/秒/UID
• 需要统一账户管理只读/读写权限

请求示例

curl "https://api.bitget.com/api/v3/account/convert-records?fromCoin=BTC&toCoin=USDT" \
   -H "ACCESS-KEY:*******" \
   -H "ACCESS-SIGN:*" \
   -H "ACCESS-PASSPHRASE:*" \
   -H "ACCESS-TIMESTAMP:1659076670000" \
   -H "locale:en-US" \
   -H "Content-Type: application/json" 

请求参数

参数名	参数类型	是否必须	描述
fromCoin	String	是	兑换币种 eg: USDT 它指的是被转换的币种
toCoin	String	是	目标币种 eg: BTC 它指的是被转换成的（接收的）币种
startTime	String	否	开始时间戳 Unix时间戳的毫秒数格式，如 1597026383085 最大查询范围90天
endTime	String	否	结束时间戳 Unix时间戳的毫秒数格式，如 1597026383085 startTime和endTime间隔不超过30天
limit	String	否	每页查询条数 最大100，默认100
cursor	String	否	分页游标 用于翻页，首次查询不传，查询第二页及后面的数据时，取上一次查询返回cursor

返回示例

{
    "code": "00000",
    "msg": "success",
    "requestTime": 1730369634178,
    "data": {
        "list": [
            {
                "fromCoin": "USDT",
                "fromCoinSize": "281.72276656",
                "toCoin": "ETH",
                "toCoinSize": "0.0986029682",
                "price": "0.0003499",
                "ts": "1730359119358"
            },
            {
                "fromCoin": "USDT",
                "fromCoinSize": "3305.13434913",
                "toCoin": "ETH",
                "toCoinSize": "1.1567970221",
                "price": "0.00035",
                "ts": "1730359063138"
            }
        ],
        "cursor": "1235780967957364737"
    }
}

返回参数

返回字段	参数类型	字段说明
list	Array	兑换记录列表
>fromCoin	String	兑换币种 它指的是被转换的币种
>fromCoinSize	String	兑换币种数量
>toCoin	String	目标币种 它指的是被转换成的（接收的）币种
>toCoinSize	String	目标币种数量
>price	String	兑换时价格
>ts	String	闪兑记录生成时间, ms
cursor	String	分页游标