用公共浏览器查铭文省事，但每一次查询都把你关心的地址暴露给陌生服务器，还要接受对方限流与改版。ord 的另一种用法是在自己机器上运行 ord server，它会同时提供给人看的 HTML 和给程序用的 JSON-API：官方文档说明，默认情况下只要给请求带上 Accept: application/json 头，同样的路径就返回结构化 JSON，字段组织与网页页面一一对应。写监控脚本、做对账工具、或者只是不想让第三方知道你在查什么，这套接口是铭文数据最直接的技术入口。
先用三个零依赖端点确认服务活着。/blockcount 与 /blockheight 返回最新区块高度，/blocktime 返回最新块的 UNIX 时间戳，/status 则返回这台服务器的安装与索引详情——各类索引开关是否开启都写在里面。自建节点的排障第一步永远是读 /status：很多查不到聪的问题不是节点坏了，而是启动时没开对应索引，这一点文档在多个端点的说明里反复强调。
数据主力端点分四类。地址类：/address/<ADDRESS> 列出某个地址的全部资产，返回输出列表、铭文编号、聪余额与 Runes 余额，文档注明它要求建索引时带 --index-addresses 开关——默认不索引地址维度，这是自建节点查地址返回空的最常见原因。聪类：/sat/<SAT> 返回一枚聪的档案：所在区块、度数、小数、名字、序号、携带的铭文列表，以及 satpoint——它此刻停在哪个输出的哪个字节偏移上；这个端点要求 --index-sats，公共浏览器上的聪页面本质就是这些数据渲染出来的。区块类：/block/<哈希或高度> 返回区块内交易与铭文明细，/blocks 返回最近一百个块的哈希与其中精选铭文，/inscriptions/block/<高度> 列出某块铸造的全部铭文。铭文类：/inscriptions 分页返回最新一百条，/inscription/<ID> 查单条详情——示例返回里能看到 satpoint、解码状态、铸造时间、输出价值这些字段，POST /inscriptions 带一组编号还能批量取详情，巡检脚本靠它省掉逐条请求。
还有两类端点值得单列。/outputs/<ADDRESS> 按地址列 UTXO，并用 type 查询参数区分’不含铭文”含铭文’等类别，是拆分混在一起的小额输出之前的盘点工具。Runes 系列的 /runes 与 /rune/<名称> 则依赖 --index-runes，把代币账本也纳入同一台服务器。/offers 与 POST /offer 构成一套基于 PSBT 的点对点报价通道，提交的正文是 base64 编码的 PSBT——这条链路的资金安全完全取决于你对 PSBT 的审查能力，不熟练时不要自动接入脚本。
自建服务有两个边界要写在明面上。其一是索引成本：--index-sats、--index-addresses、--index-runes 都要在建索引时决定，事后补开意味着重建，文档的建议是先把需求想全再启动首次索引。其二是暴露面：默认监听本机端口时风险有限，一旦打算放到公网，就要明白你的节点变成了公开查询服务；文档给出 --disable-json-api 整体关闭接口的选项，配合 server_username 与 server_password 两个配置项做访问控制。自用还是给团队供数，决定了这两者怎么平衡。
一个实用自查流程收尾：脚本先调 /status 确认所需索引开关已开，再调 /blockheight 确认同步进度追平，然后才去取 /inscription/<ID> 或 /sat/<SAT> 的数据；任何一步的空结果，先回查开关与同步高度，再怀疑数据本身。还要记住这些端点返回的是 ord 一家索引器的解读：聪归属、铭文编号、烧毁标记都按 ord 的规则计算，主流实现口径一致，但把接口结果当作唯一事实仍然偷懒——涉及大额转移时，用另一台独立节点或第二套索引交叉复核一遍，核对的对象永远是那几笔原始交易本身。公共页面会变、会限流、会改版式，自己节点上的 JSON 接口则按文档口径持续回答同一类问题——把查询权留在本地，是铭文玩家少数能完全自己控制的环节。
本文为机制说明，不构成任何投资建议。
发表评论
还没有评论，来说两句吧。
评论区为展示样式，提交不会被处理。