Back to Details

mempool-space-openapi-skill

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

mempool.space API Skill

mempool.space API 技能

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.
使用本技能可通过
uxc
+ OpenAPI执行mempool.space的公开Bitcoin和Lightning浏览器操作。
复用
uxc
技能以实现共享执行、认证和错误处理指导。

Prerequisites

前置条件

  • uxc
    is installed and available in 
    PATH
    .
  • Network access to 
    https://mempool.space/api
    .
  • Access to the curated OpenAPI schema URL: 
    • https://raw.githubusercontent.com/holon-run/uxc/main/skills/mempool-space-openapi-skill/references/mempool-space-public.openapi.json
  • uxc
    已安装且可在
    PATH
    中访问。
  • 具备访问
    https://mempool.space/api
    的网络环境。
  • 可访问精选OpenAPI schema的URL： 
    • https://raw.githubusercontent.com/holon-run/uxc/main/skills/mempool-space-openapi-skill/references/mempool-space-public.openapi.json

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
本技能涵盖mempool.space的只读优先操作范围，包括：
  • Bitcoin手续费估算和内存池状态读取
  • 区块顶端高度检查
  • 地址和交易状态读取
  • Lightning网络搜索、统计、节点排名、节点详情和通道读取
本技能不涵盖：
  • 交易广播或包提交
  • WebSocket订阅
  • 内部或管理路由
  • mempool.space提供的所有Esplora兼容端点

Authentication

认证方式

mempool.space public reads in this skill do not require authentication.
本技能中的mempool.space公开只读操作无需认证。

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
    • mempool-space-openapi-cli -h
  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
    • mempool-space-openapi-cli get:/v1/lightning/channels/{short_id} -h
  3. Prefer narrow reads before broader scans:
    • 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. 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
    • mempool-space-openapi-cli get:/v1/lightning/channels/{short_id} short_id=835866331763769345
  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. 首先检查操作schema：
    • 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} short_id=835866331763769345

Operations

操作列表

  • 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/{public_key}
  • get:/v1/lightning/channels
  • get:/v1/lightning/channels/{short_id}
  • 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/{public_key}
  • get:/v1/lightning/channels
  • get:/v1/lightning/channels/{short_id}

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.
  • mempool.space
    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.
  • mempool-space-openapi-cli <operation> ...
    is equivalent to 
    uxc https://mempool.space/api --schema-url <mempool_space_openapi_schema> <operation> ...
    .
  • 自动化操作需基于JSON输出格式；请勿使用
    --text
    参数。
  • 优先解析稳定字段：
    ok
    、
    kind
    、
    protocol
    、
    data
    、
    error
    。
  • 本v1技能为只读模式。请勿使用
    tx/push
    、包提交或内部路由。
  • 在使用更广泛的通用Esplora接口之前，优先使用本技能中精选的手续费、内存池和Lightning读取操作。
  • mempool.space
    是一个公开的浏览器服务，因此内存池状态和Lightning排名可能会快速变化。请重新查询，不要假设缓存值仍然有效。
  • 对于
    get:/v1/lightning/channels/{short_id}
    操作，尽管路由标签显示为
    short_id
    ，但mempool.space目前接受通道
    id
    字符串；优先使用搜索或节点通道列表返回的值。
  • mempool-space-openapi-cli <operation> ...
    等同于
    uxc https://mempool.space/api --schema-url <mempool_space_openapi_schema> <operation> ...
    。

References

参考资料

  • Usage patterns: 
    references/usage-patterns.md
  • Curated OpenAPI schema: 
    references/mempool-space-public.openapi.json
  • Official mempool repository: https://github.com/mempool/mempool
  • 使用模式：
    references/usage-patterns.md
  • 精选OpenAPI schema：
    references/mempool-space-public.openapi.json
  • 官方mempool仓库：https://github.com/mempool/mempool