mempool-space-openapi-skill

---
name: mempool-space-openapi-skill
description: Operate mempool.space public Bitcoin and Lightning explorer APIs through UXC with a curated OpenAPI schema, no-auth setup, and read-first guardrails.
license: MIT
---

# 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:
  - `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

## 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`
   - `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`

## 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}`

## 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> ...`.

## References

- Usage patterns: `references/usage-patterns.md`
- Curated OpenAPI schema: `references/mempool-space-public.openapi.json`
- Official mempool repository: https://github.com/mempool/mempool