mempool-space-openapi-skill

Original：🇺🇸 English

Translated

1 scripts

Operate mempool.space public Bitcoin and Lightning explorer APIs through UXC with a curated OpenAPI schema, no-auth setup, and read-first guardrails.

4installs

Sourceholon-run/uxc

Added on2026-04-24

NPX Install

npx skill4agent add holon-run/uxc mempool-space-openapi-skill

SKILL.md Content

View Translation Comparison →

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

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

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

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

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