用途:面向智能体与开发者的统一 BSV 索引 API,用于获取 UTXO、查询铭文/ordinals、代币、身份与链上内容,并广播交易。
主要能力:TXO 端点支持单笔输出、按交易、按键搜索、批量 outpoints、花费状态;owner 端点提供 /owner/{owner}/txos(SSE 流式 UTXO)、余额与多地址同步;/beef/{txid} 返回完整 BEEF、原始交易或默克尔证明;/arcade 提供广播及状态查询与事件流;BSV21 覆盖代币详情、余额、未花费、历史与批量查询(批量上限 100),lockType 通常为 p2pkh;ORDFS 内容服务在 /content/ 下(不带 /1sat 前缀),支持 :seq 序列解析、流式 Range、目录铭文与 MAP/父级头部;另有 BAP 身份、链信息、OpNS、BSocial、Paymail 与 overlay 提交/查询端点。
使用方式:托管实例多数端点公开可用,加 Authorization: Bearer YOUR_API_KEY 可提升限额(公开 100 次/分,认证 1000 次/分);owner/txos 为 SSE,可用 EventSource 监听 txo 与 done 事件收集 UTXO 后再构建交易;广播时向 /arcade/tx POST BEEF 十六进制并设 Content-Type: application/octet-stream;txo/search 支持 ev:/tp:/own: 前缀键与 tags、unspent、limit 查询参数。
适用场景:BSV 钱包与交易构建、铭文和 ordinals 索引、代币余额查询、身份与订阅验证、链上内容检索。
限制:具体响应字段、完整参数以仓库 references/api-reference.md 为准;自托管可部署于 Railway,各模块通过 config.yaml 以 embedded/remote/disabled 配置,详见仓库 config.example.yaml。其余部署细节与定价资料暂未提供。