---
name: api.nativebtc.org
description: api.nativebtc.org provides authenticated access to a live Bitcoin mempool WebSocket stream. It issues short-lived tickets that an agent uses to establish a WebSocket connection for real-time mempool data.
host: api.nativebtc.org
---

# api.nativebtc.org

NativeBTC is a narrow-purpose host that handles the authentication handshake required to subscribe to a Bitcoin mempool stream over WebSocket. It serves agents that need live, streaming mempool data rather than static or polled transaction lookups. Its single function is ticket issuance — the actual data consumption happens over the returned WebSocket URL.

## When to use this host

Use this host when an agent needs to open a live WebSocket subscription to the Bitcoin mempool and requires a fresh authenticated ticket to do so. Do not use it for one-shot transaction lookups, mempool queries by txid, or any REST-style data retrieval — use a Bitcoin REST API (e.g., mempool.space API or a similar endpoint) for those cases. Because the ticket expires after ttlSeconds, agents must re-invoke fetch-mempool-stream-ticket before each new connection attempt; it is not suitable for maintaining a single persistent long-lived connection without periodic re-authentication.

## Capabilities

### Mempool Stream Authentication

Issues a time-limited ticket and provides the WebSocket URL needed to authenticate and connect to the live Bitcoin mempool stream.

- **`fetch-mempool-stream-ticket`** — Issues a short-lived authenticated ticket and returns a WebSocket URL for subscribing to the Bitcoin mempool stream via api.nativebtc.org.

## Skill reference

### `fetch-mempool-stream-ticket`

**NativeBTC Mempool Stream Ticket** — Issues a short-lived authenticated ticket and returns a WebSocket URL for subscribing to the Bitcoin mempool stream via api.nativebtc.org.

*Use when:* Use when an agent needs to establish a live WebSocket connection to the Bitcoin mempool stream and requires a fresh, time-limited ticket to authenticate that connection.

*Not for:* Do not use for one-shot mempool queries or transaction lookups; use a REST mempool endpoint instead. Not suitable for persistent connections — the ticket expires after ttlSeconds and must be re-fetched.

**Returns:** Returns success=true with a ticket string, expiresAt timestamp, ttlSeconds=600, and both a relative websocketPath and a fully qualified websocketUrl for immediate WebSocket connection.

**Example:** `GET https://api.nativebtc.org/v1/mempool/stream-ticket`

---