TON Center 查 Jetton 转账：owner、wallet 与 master 别填反

开始前准备

• 准备完整 owner 地址、目标 Jetton master、TON 主网/测试网以及预计转账时间。
• 能查看 HTTP 状态和 JSON；无密钥按官方 1 RPS 限制低频读取，提高配额需自行申请密钥，不把密钥放公开链接。

1. 选对 API v3 网络入口

主网基础地址为 https://toncenter.com/api/v3，测试网为 https://testnet.toncenter.com/api/v3。v3 是索引数据层，不能把 v2 的响应结构套过来，也不需要调用 message/sendBoc 等写入接口。

检查结果：网络、基础地址和 API 版本固定，请求是只读 GET。

• 依据：TON Center API v3：主网/测试网地址与索引层 ↗

2. 填写 owner 和 master 筛选

使用 /jetton/transfers，把持有者地址填入 owner_address，把代币发行合约填入 jetton_master。jetton_wallet 参数是 Jetton wallet 地址，不能填成普通 owner。direction=in/out 只在提供 owner_address 时生效。

检查结果：三个地址类型分别明确；方向与 owner 一起使用，未用 symbol 代替 master。

• 依据：TON Center：GET jetton/transfers 筛选、分页和回包 ↗

3. 构造低频请求并核对状态

请求形态为 GET {基础地址}/jetton/transfers?owner_address={URL编码后的owner}&jetton_master={URL编码后的master}&direction=in&limit=10&offset=0&sort=desc。先检查 HTTP 状态和 JSON 是否成功；需要 key 时通过 X-API-Key 请求头提供。超出限制或参数错误应保存错误，不能当作零转账。

检查结果：完整请求参数与读取时间已保存，成功状态和可解析的 JSON 均成立才读取记录。

• 依据：TON Center：GET jetton/transfers 筛选、分页和回包 ↗
• 依据：TON Center API v3：主网/测试网地址与索引层 ↗

4. 检查每条记录与执行状态

在 jetton_transfers 中核对 source、destination、jetton_master、amount、transaction_hash、transaction_lt、trace_id 和 transaction_aborted。原始 amount 先保留字符串，未核对代币精度前不猜展示金额；aborted 或局部记录不能直接判成收款完成。

检查结果：记录身份与计划相符；交易/trace 标识与失败字段单列，金额未做无依据换算。

• 依据：TON Center：GET jetton/transfers 筛选、分页和回包 ↗

5. 分页和时间检查后再解释空结果

按 limit/offset 批量读历史，sort 按 lt 排序；可用 start_utime/end_utime 限定 UTC 时间戳。首次返回十条不是全部历史，空列表也可能来自网络、地址类型、时间筛选或索引延迟。去掉可疑筛选逐项核对，保留请求和结果，不发新交易来验证旧记录。

检查结果：输出筛选范围、已读分页和具体交易证据；未找到时注明未查到及尚缺的核查项。

• 依据：TON Center：GET jetton/transfers 筛选、分页和回包 ↗
• 依据：TON Center API v3：主网/测试网地址与索引层 ↗

怎样确认完成

• 得到可重复的网络、筛选参数、分页范围及匹配记录/待查原因，不需要钱包签名。
• 本文仅核对官方文档，尚无独立 API 实际运行回执；单条记录不代替收款方最终验收。

常见错误与边界

• owner、Jetton wallet、Jetton master 是三种不同地址角色。
• direction 离开 owner_address 不构成有效收发方向过滤。
• HTTP 失败、参数错误、未读分页和索引未更新都不能写成没有链上转账。