# mempool.space on Onekey

> 6 endpoints for mempool.space (0 stable, 6 beta), 1 to 5 credits each. Category: Finance & markets. One key, one JSON shape.

Base URL: https://api.onekey.dev
Auth: header `x-api-key: <key>`. Call shape: `GET /v1/{platform}/{endpoint}?{params}`.
Every response is `{success, data, metadata, error}`; check `success` first. Cost is in `metadata.credits_charged`. Free when served from cache (0.2 credit for a cached response over 100 KB). Failed and not-found calls are refunded.
Status: stable = verified against the live source; beta = not yet verified, fields may be missing.

Page: https://onekey.dev/platforms/mempool
Reference (Markdown): https://onekey.dev/docs/api/mempool.md
All docs: https://onekey.dev/llms.txt

## Canonical fields returned

Unified-schema fields (same names on every platform), with how many of the 6 mapped mempool.space endpoints return each:

- `entity.date` (ISO 8601 date): 4
- `entity.id` (string): 3
- `package.version` (string): 1
- plus 28 platform-specific fields under `ext.`

## Endpoints

### mempool.address

Address totals (mempool.space).
- Price: 1 credit per fresh call. Status: beta. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/mempool/address?address=1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `address` (string, required): Bitcoin address
- Fields returned: `entity.id`, `ext.txCount`, `ext.fundedTxoCount`, `ext.fundedSats`, `ext.spentSats`, `ext.mempoolTxCount`
- Reference: https://onekey.dev/docs/api/mempool/address.md

### mempool.difficulty_adjustment

Bitcoin difficulty adjustment progress and estimate.
- Price: 1 credit per fresh call. Status: beta. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/mempool/difficulty_adjustment` with header `x-api-key: YOUR_API_KEY`
- Parameters: none
- Fields returned: `entity.date`, `ext.progressPct`, `ext.difficultyChangePct`, `ext.remainingBlocks`, `ext.nextRetargetHeight`
- Reference: https://onekey.dev/docs/api/mempool/difficulty_adjustment.md

### mempool.fees_recommended

Recommended fee rates (sat/vB) by urgency.
- Price: 1 credit per fresh call. Status: beta. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/mempool/fees_recommended` with header `x-api-key: YOUR_API_KEY`
- Parameters: none
- Fields returned: `ext.fastest`, `ext.halfHour`, `ext.hour`, `ext.economy`, `ext.minimum`
- Reference: https://onekey.dev/docs/api/mempool/fees_recommended.md

### mempool.prices

Bitcoin price in major fiat currencies.
- Price: 1 credit per fresh call. Status: beta. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/mempool/prices` with header `x-api-key: YOUR_API_KEY`
- Parameters: none
- Fields returned: `entity.date`, `ext.usd`, `ext.eur`, `ext.gbp`, `ext.jpy`
- Reference: https://onekey.dev/docs/api/mempool/prices.md

### mempool.recent_blocks

Recent Bitcoin blocks (mempool.space v1 format).
- Price: 5 credits per fresh call. Status: beta. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/mempool/recent_blocks` with header `x-api-key: YOUR_API_KEY`
- Parameters: none
- Fields returned: `entity.id`, `entity.date`, `ext.height`, `ext.txCount`, `ext.size`, `ext.weight`, `ext.difficulty`, `ext.nonce`, `ext.merkleRoot`, `ext.previousBlockHash`
- Reference: https://onekey.dev/docs/api/mempool/recent_blocks.md

### mempool.tx

Bitcoin transaction summary by txid (mempool.space).
- Price: 1 credit per fresh call. Status: beta. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/mempool/tx?txid=4a5e1e4baab89f3a32518a88c31bc87f618f76673e2cc77ab2127b7afdeda33b` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `txid` (string, required): Transaction id (64 hex)
- Fields returned: `entity.id`, `package.version`, `entity.date`, `ext.fee`, `ext.size`, `ext.weight`, `ext.confirmed`, `ext.blockHeight`
- Reference: https://onekey.dev/docs/api/mempool/tx.md

## Sample request

```bash
curl "https://api.onekey.dev/v1/mempool/address?address=1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa" \
  -H "x-api-key: YOUR_API_KEY"
```