币安Binance如何通过API查询充值记录？
用币安API查充值记录，核心是调用 GET /sapi/v1/capital/deposit/hisrec 这个接口，带上你的API密钥和查询参数，就能拿到交易哈希、金额、状态、确认数等全部信息。
前置条件：准备好API密钥
在调用任何API之前，你需要先在币安账户里生成API密钥。
操作步骤：
登录币安官网，点击右上角【用户中心】→【API管理】
点击【创建API】，选择系统生成或自行命名
给API密钥命名（如"充值查询"），完成安全验证
创建成功后，系统会生成 API Key 和 Secret Key。Secret Key只显示一次，立即复制保存到安全位置
所需权限：查询充值记录只需要 读取权限（Read），不需要开启交易或提现权限。
完成标志：你手里有一组 API Key 和 Secret Key，且API密钥状态为"已启用"。
风险提醒：Secret Key相当于你的账户密码，泄露后他人可以调用API操作你的账户。建议开启IP白名单限制，只允许特定IP地址调用。
第二步：调用主充值查询接口
核心接口是 GET /sapi/v1/capital/deposit/hisrec，用于获取链上充值历史记录。
接口地址：
https://api.binance.com/sapi/v1/capital/deposit/hisrec
主要请求参数：
| 参数名 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| timestamp | LONG | 是 | 当前时间戳（毫秒），建议用系统当前时间 |
| coin | STRING | 否 | 按币种筛选，如 BTC、USDT |
| status | INT | 否 | 状态：0=待确认，6=已到账但不可提现，1=成功 |
| startTime | LONG | 否 | 查询起始时间戳，默认当前时间前90天 |
| endTime | LONG | 否 | 查询结束时间戳，默认当前时间 |
| limit | INT | 否 | 返回条数，默认1000，最大1000 |
| txId | STRING | 否 | 按交易哈希精确查询 |
| includeSource | BOOLEAN | 否 | 设为 true 时返回来源地址 |
注意：startTime 和 endTime 的时间间隔不能超过90天。
响应字段说明：接口将返回包含充值ID、金额、币种、网络、状态、地址、交易哈希、确认数等信息的结构化数据。
完成标准：接口返回了包含交易哈希、金额、状态的充值记录列表。
第三步：按条件筛选查询
情况A：查某币种最近30天记录
请求示例：GET /sapi/v1/capital/deposit/hisrec?coin=USDT&status=1&startTime=起始时间戳&endTime=结束时间戳
情况B：用交易哈希查单笔记录
请求示例：GET /sapi/v1/capital/deposit/hisrec?txId=对应交易哈希
这是最精确的查询方式，适合核验某笔充值是否到账。
情况C：查待确认的充值
请求示例：GET /sapi/v1/capital/deposit/hisrec?status=0
status=0 返回还在等待区块链确认的记录，可用于监控充值进度。
第四步：法币充值记录查询（独立接口）
如果你要查的是法币充值（如银行转账、信用卡买币），不能用上面的接口。法币有单独的接口：GET /sapi/v1/fiat/orders。
请求参数：
transactionType：必填，0=查询充值记录，1=查询提现记录
beginTime / endTime：选填，不填默认查最近30天
page / rows：分页参数，每页最大500条
第五步：子账户充值查询（主账户专用）
如果你是主账户想查子账户的充值记录，调用 GET /sapi/v1/capital/deposit/subHisrec。
关键参数：
subAccount：必填，子账户的邮箱
其他参数（coin、status、startTime等）与主接口相同
完成标志：主账户成功获取了指定子账户的充值记录。
常见错误排查
错误代码-2015：提示无效API密钥、IP或权限，通常表示API密钥权限不足或IP不在白名单内。
查询结果为空：检查时间范围是否超过90天，或txId是否填错了。默认只返回近90天数据。
时间戳校验失败：确保timestamp是毫秒级Unix时间戳，且与服务器时间偏差不超过30秒。
常见问题
问：API查询充值记录需要付费吗？ 不需要。币安API查询是免费的，但每个接口有请求频率限制（权重制）。主充值查询接口权重为1，法币接口权重较高，查询频率不宜过高。
问：status字段的各种值代表什么？
0：待确认，链上交易还在等待区块确认
1：成功，已完全到账
6：已到账但不可提现（通常因安全冻结）
7：充值异常（网络不符或地址错误）
8：等待用户确认（如Travel Rule需要补充信息）
问：如何获取币安支持的充值币种列表？ 调用 GET /sapi/v1/capital/config/getall 接口，会返回所有币种的充提支持状态和网络信息。
下一步
完成以上操作后，用Postman或编程语言（Python/JavaScript）发一个测试请求，调用 GET /sapi/v1/capital/deposit/hisrec?coin=USDT 确认能正常返回数据。如果你还没创建API密钥，先去币安【API管理】页面生成一组，记录Secret Key后立即开启IP白名单。
