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

整理：链小知（AI 辅助）
资料核对日期：2026-10-12
引用地址：https://lianxiaozhi.com/tools/guides/toncenter-check-jetton-transfers
难度：进阶
核验方式：官方文档整理，未执行真实账户操作

用 GET /api/v3/jetton/transfers 按 owner 和 master 查询，核对方向、分页、失败字段和 trace，保持只读。

## 使用工具
- [TON Center](https://lianxiaozhi.com/tools/toncenter) · [官方入口](https://toncenter.com/)

## 前置条件
- 准备完整 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：主网/测试网地址与索引层](https://docs.ton.org/api/v3/overview)

## 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 筛选、分页和回包](https://docs.ton.org/api/v3/jettons/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 筛选、分页和回包](https://docs.ton.org/api/v3/jettons/get-jetton-transfers)
依据：[TON Center API v3：主网/测试网地址与索引层](https://docs.ton.org/api/v3/overview)

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

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

核对结果：记录身份与计划相符；交易/trace 标识与失败字段单列，金额未做无依据换算。
依据：[TON Center：GET jetton/transfers 筛选、分页和回包](https://docs.ton.org/api/v3/jettons/get-jetton-transfers)

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

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

核对结果：输出筛选范围、已读分页和具体交易证据；未找到时注明未查到及尚缺的核查项。
依据：[TON Center：GET jetton/transfers 筛选、分页和回包](https://docs.ton.org/api/v3/jettons/get-jetton-transfers)
依据：[TON Center API v3：主网/测试网地址与索引层](https://docs.ton.org/api/v3/overview)

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

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

## 相关知识
- [区块确认与最终性是什么？交易成功和充值到账为何不同步](https://lianxiaozhi.com/learn/confirmations-and-finality)
- [如何核对 Meme 币？先确认链、合约地址和交易池](https://lianxiaozhi.com/learn/meme-token-identity)

## 官方依据
- [TON Center API v3：主网/测试网地址与索引层](https://docs.ton.org/api/v3/overview)
- [TON Center：GET jetton/transfers 筛选、分页和回包](https://docs.ton.org/api/v3/jettons/get-jetton-transfers)