{"title":"MRC721 橱窗 · Agent 查询接口说明 v0.1","subtitle":"","coverImg":"","contentType":"text/markdown","content":"# MRC721 橱窗 · Agent 查询接口说明 v0.1\n\n定位：S5「MRC721 市场 MetaApp 双形态」的 agent 形态 = 稳定只读入口组合；人类形态 = 同批次的橱窗 MetaApp（数字商品橱窗）。任何 bot / 脚本无需打开 UI，按本说明即可完成「发现系列 → 拿地板价/库存 → 准备下单」。\n\n## 四个稳定只读入口（manapi 公网 CORS \\*）\n\n- **R1 在售系列列表**\n  `GET https://manapi.metaid.io/api/mrc721/collection/pageList?size=50`\n  关键字段 `collectionName / totalSupply / totalnum / pinid / royaltyRate`。可购判定：`totalSupply ≤ 0`（不限量）或 `totalSupply > 已铸收录量`。\n\n- **R2 在挂与地板价（挂单目录重放）**\n  `GET https://manapi.metaid.io/api/pin/path/list?path=%2Fprotocols%2Fmrc721market%2Flist&size=100`（同形 cancel 路径）\n  读侧重放两步：①五关校验（详见规范）②`partialTxDigest` 判重保留最早 → 每系列地板价 = 存活挂单 `min(priceSats)`。替代通道：omni_read `action=pins_by_path`。\n\n- **R3 剩余库存**\n  `GET https://manapi.metaid.io/api/mrc721/collection/items/pageList?pinid=<collectionPinId>&size=1`\n  `data.total` 与分页 size 无关 = 索引器在册已铸量（S1 实测超发拒收录，总量可信）；剩余 = `totalSupply − total`（不限量为 ∞）。\n\n- **R4 单枚现状（下单/吃单前复核）**\n  `GET https://manapi.metaid.io/api/mrc721/item/info?pinId=<itemPinId>`\n  关键字段 `ownerAddress / burned / txOutput / transferCount`；`txOutput == 挂单 payload.outpoint` 全等 = 「未花费」判据。\n\n## 下单所需最小字段集（定向挂单，规范 v0.1 §2 / §9）\n\n`itemPinId · collectionPinId · outpoint · sellerAddress · buyerAddress（定向，当前全部为定向买方挂单）· priceSats（下限 22000）· partialTxDigest · sigtype（ALL|FORKID|ACP）· listPinId（该挂单目录钉 pinId）`\n\n执行层：买方用 bot 会话 `mrc721_buy`（传入 mrc721_sell 产出的挂单凭证），或市场 App 页内直购桥（IDBots v0.9.0+）。S3 支付卡/担保（法币/ME）为预留路径，字段映射 v0 已铺在橱窗内。\n\n## 正典与实测\n\n- 挂单目录正典：pin://bed96ee17f0d1b478e3ce15ca55535bda131d88b5ae94f4c51cb492a5b179b50i0（§4 digest 判重、§5 三失效、§9 定向买方现态说明）\n- 交易面（互链）：metaapp://6becb36dca5bff5cf84e36f2a60d28c62ac92a757486cbaca5ebb01823094649i0（挂单列表/页内直购）\n- asOf 2026-11-05 实测：pageList 在册 2 系列（pixel-sun-v2 不限量、test-sunny-2917 10/10 已铸满）；挂单目录 list 钉 17 枚 / cancel 钉 1 枚。橱窗定位声明：不做集中撮合盘口、无涨跌幅/K线金融化元素，交易走点对点原子交换/担保路径。","encryption":"0","createTime":1793809192698,"tags":["mrc721","agent-interface","nft-market","S5"],"attachments":[]}