用 UniSat 开放接口自查铭文到账：查询地址铭文列表的端点与字段

空投到账的铭文，钱包没显示、区块浏览器搜不到、客服说”已发送”——三边各执一词时，普通用户其实可以拿出第四种声音：索引服务的开放接口。UniSat 的开放 API 把按地址查询铭文、查询铭文详情、内容与事件做成了正式文档化的端点，本文讲怎么用它做第三方核对，也讲”接口说有”这四个字的含金量到底是多少。

一组端点各自管什么

在 UniSat 开发者文档的比特币开放 API 里，铭文相关的常规端点分四层：按地址拉铭文列表（Get Address Inscriptions，路径为 /v1/indexer/address/{address}/inscription-data 的 GET 请求）、按铭文编号查单枚详情（Get Inscription Info）、取铭文原始内容（Get Inscription Content）、查该铭文的历史转账事件（Get Inscription Events）。列表接口一次返回该地址名下铭文的汇总与分页明细，详情与内容接口以铭文编号为主键，事件接口给出转账轨迹。文档页以嵌入的 OpenAPI（Swagger）规范逐字段定义请求与响应，字段含义以规范为准，页面不重复展开。对开发者友好的地方在于：同一套结构在 Fractal Bitcoin 等其他网络有对应族接口，跨链核对时可以复用理解。

把接口当”第二意见”的操作顺序

典型场景：有人说给你空投了一千枚铭文。第一步，别急着信发钱方的截图，把收款地址粘进列表接口，看总数与分页字段是否对得上他们声称的量级；第二步，随机抽几枚用详情接口核对创建交易与所在输出，落点地址是否真是你的收款地址；第三步，如果你的钱包迟迟不显示，用事件接口看该铭文当前归属——归属指向你的地址而钱包不渲染，多半是钱包索引滞后或资产开关问题；归属指向别处，说明这批空投根本没到你的地址，先解决纠纷再谈显示。三步走完，“接口说有、钱包说没有、对方说转了”三种说法里谁在撒谎，通常已经一目了然。

接口数据的四个边界

第一，接口反映的是 UniSat 索引器视角的链上状态，索引有延迟、也可能出错，与你自己跑 ord 全节点的结论不一致时，谁对谁错需要具体判断，接口不天然代表终审。第二，列表接口返回归属，不代表资产安全：私钥或助记词若已泄露，“地址上有一千枚”与”你还能把它们转走”是两回事。第三，开放 API 有调用频率与配额约束，批量核对时注意返回里的分页游标与错误码，把 429 之类的限流误读成”资产消失”是新手常见事故。第四，接口字段会随版本演进，核对脚本应当固定版本、保留原始响应，别让”字段改了”变成悬案。

一个务实的心法

开放接口最大的价值，不是替代链上验证，而是把验证的颗粒度交到用户手里：你不必信任某个网页”显示给你看”的余额，你可以自己按地址逐条取数、逐条比对。它同时也是一个责任边界探测器——发钱方声称到账，你就用接口指出账；钱包说没显示，你用事件接口指出归属。数据面前，各方说法被迫对齐。至于终极信任，仍然只在链本身：接口是望远镜，不是地契。

自己动手调接口时，还有几条工程上的安全线值得画出来。请求走 HTTPS，把接口地址抄进脚本前核对域名拼写，钓鱼站克隆一份文档页是低成本高回报的骗局；API 密钥只放在请求头里，不要拼进 URL 日志，也不要贴进截图问社群”为什么报错”；对分页返回保留每一页的原始响应文件，出现归属争议时，你手里那份带时间戳的 JSON 比任何人的口头保证都硬。最后是复核顺序的纪律：接口给出异常结论时——比如列表与详情互相矛盾——按”链上交易原文、独立索引器、服务商接口”的顺序逐级升档，永远把服务商接口放在证据链的最下端，它是方便，不是权威。

本文为机制说明，不构成任何投资建议。