mempool.space API Skill
Use this skill to run mempool.space public Bitcoin and Lightning explorer operations through uxc + OpenAPI.
Reuse the uxc skill for shared execution, auth, and error-handling guidance.
Prerequisites
- -
uxc is installed and available in PATH. - Network access to
https://mempool.space/api. - Access to the curated OpenAPI schema URL:
- INLINECODE5
Scope
This skill covers a read-first mempool.space surface for:
- - Bitcoin fee estimation and mempool state reads
- block tip height checks
- address and transaction status reads
- Lightning network search, statistics, node rankings, node detail, and channel reads
This skill does not cover:
- - transaction broadcast or package submission
- websocket subscriptions
- internal or admin routes
- every Esplora-compatible endpoint exposed by mempool.space
Authentication
mempool.space public reads in this skill do not require authentication.
Core Workflow
- 1. Use the fixed link command by default:
-
command -v mempool-space-openapi-cli
- If missing, create it:
uxc link mempool-space-openapi-cli https://mempool.space/api --schema-url https://raw.githubusercontent.com/holon-run/uxc/main/skills/mempool-space-openapi-skill/references/mempool-space-public.openapi.json
- INLINECODE8
- 2. Inspect operation schema first:
-
mempool-space-openapi-cli get:/v1/fees/recommended -h
-
mempool-space-openapi-cli get:/mempool -h
-
mempool-space-openapi-cli get:/address/{address} -h
-
mempool-space-openapi-cli get:/v1/lightning/search -h
- INLINECODE13
- 3. Prefer narrow reads before broader scans:
-
mempool-space-openapi-cli get:/v1/fees/recommended
-
mempool-space-openapi-cli get:/blocks/tip/height
- INLINECODE16
- 4. Execute with key/value parameters:
-
mempool-space-openapi-cli get:/address/{address} address=bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh
-
mempool-space-openapi-cli get:/tx/{txid}/status txid=4d5d7f2d5dc69aa68a51887db07dd6d906f31f9141320f9f0b4bab76d735a47f
-
mempool-space-openapi-cli get:/v1/lightning/search searchText=bfx
-
mempool-space-openapi-cli get:/v1/lightning/channels public_key=033d8656219478701227199cbd6f670335c8d408a92ae88b962c49d4dc0e83e025 status=active
- INLINECODE21
Operations
- - INLINECODE22
- INLINECODE23
- INLINECODE24
- INLINECODE25
- INLINECODE26
- INLINECODE27
- INLINECODE28
- INLINECODE29
- INLINECODE30
- INLINECODE31
- INLINECODE32
Guardrails
- - Keep automation on the JSON output envelope; do not use
--text. - Parse stable fields first:
ok, kind, protocol, data, error. - Treat this v1 skill as read-only. Do not use
tx/push, package submission, or internal routes. - Prefer the curated fee, mempool, and Lightning reads here before dropping to the much larger generic Esplora surface.
- INLINECODE40 is a public explorer service, so mempool state and Lightning rankings can move quickly. Re-query instead of assuming cached values remain current.
- For
get:/v1/lightning/channels/{short_id}, mempool.space currently accepts the channel id string even though the route label says short_id; prefer values returned by search or node channel listing. - INLINECODE44 is equivalent to
uxc https://mempool.space/api --schema-url <mempool_space_openapi_schema> <operation> ....
References
- - Usage patterns: INLINECODE46
- Curated OpenAPI schema: INLINECODE47
- Official mempool repository: https://github.com/mempool/mempool
mempool.space API 技能
通过 uxc + OpenAPI 使用此技能运行 mempool.space 公共比特币和闪电网络浏览器操作。
复用 uxc 技能以获取共享执行、认证和错误处理指导。
前提条件
- - uxc 已安装并可在 PATH 中使用。
- 可访问 https://mempool.space/api 网络。
- 可访问精选的 OpenAPI 模式 URL：
- https://raw.githubusercontent.com/holon-run/uxc/main/skills/mempool-space-openapi-skill/references/mempool-space-public.openapi.json
范围
此技能涵盖以读取为主的 mempool.space 功能，包括：
- - 比特币费用估算和内存池状态读取
- 区块顶端高度检查
- 地址和交易状态读取
- 闪电网络搜索、统计、节点排名、节点详情和通道读取
此技能不涵盖：
- - 交易广播或包提交
- WebSocket 订阅
- 内部或管理路由
- mempool.space 暴露的每个 Esplora 兼容端点
认证
此技能中的 mempool.space 公共读取操作无需认证。
核心工作流程
- 1. 默认使用固定链接命令：
- command -v mempool-space-openapi-cli
- 如果缺失，则创建：
uxc link mempool-space-openapi-cli https://mempool.space/api --schema-url https://raw.githubusercontent.com/holon-run/uxc/main/skills/mempool-space-openapi-skill/references/mempool-space-public.openapi.json
- mempool-space-openapi-cli -h
- 2. 首先检查操作模式：
- mempool-space-openapi-cli get:/v1/fees/recommended -h
- mempool-space-openapi-cli get:/mempool -h
- mempool-space-openapi-cli get:/address/{address} -h
- mempool-space-openapi-cli get:/v1/lightning/search -h
- mempool-space-openapi-cli get:/v1/lightning/channels/{short_id} -h
- 3. 优先进行窄范围读取，再进行广泛扫描：
- mempool-space-openapi-cli get:/v1/fees/recommended
- mempool-space-openapi-cli get:/blocks/tip/height
- mempool-space-openapi-cli get:/v1/lightning/statistics/latest
- 4. 使用键/值参数执行：
- mempool-space-openapi-cli get:/address/{address} address=bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh
- mempool-space-openapi-cli get:/tx/{txid}/status txid=4d5d7f2d5dc69aa68a51887db07dd6d906f31f9141320f9f0b4bab76d735a47f
- mempool-space-openapi-cli get:/v1/lightning/search searchText=bfx
- mempool-space-openapi-cli get:/v1/lightning/channels public_key=033d8656219478701227199cbd6f670335c8d408a92ae88b962c49d4dc0e83e025 status=active
- mempool-space-openapi-cli get:/v1/lightning/channels/{short
id} shortid=835866331763769345
操作
- - get:/v1/fees/recommended
- get:/mempool
- get:/blocks/tip/height
- get:/address/{address}
- get:/tx/{txid}/status
- get:/v1/lightning/statistics/latest
- get:/v1/lightning/search
- get:/v1/lightning/nodes/rankings
- get:/v1/lightning/nodes/{publickey}
- get:/v1/lightning/channels
- get:/v1/lightning/channels/{shortid}
防护措施
- - 保持自动化处理 JSON 输出格式；不要使用 --text。
- 首先解析稳定字段：ok、kind、protocol、data、error。
- 将此 v1 技能视为只读。不要使用 tx/push、包提交或内部路由。
- 优先使用此处精选的费用、内存池和闪电网络读取功能，再考虑使用更大的通用 Esplora 功能。
- mempool.space 是一个公共浏览器服务，因此内存池状态和闪电网络排名可能快速变化。请重新查询，不要假设缓存值仍然有效。
- 对于 get:/v1/lightning/channels/{shortid}，mempool.space 目前接受通道 id 字符串，尽管路由标签显示为 shortid；优先使用搜索或节点通道列表返回的值。
- mempool-space-openapi-cli <操作> ... 等同于 uxc https://mempool.space/api --schema-url spaceopenapi_schema> <操作> ...。
参考资料
- - 使用模式：references/usage-patterns.md
- 精选的 OpenAPI 模式：references/mempool-space-public.openapi.json
- 官方 mempool 仓库：https://github.com/mempool/mempool
