Mempool.space

https://mempool.space/docs
Admin
Mempool.space is a Bitcoin mempool and block explorer that provides real-time and historical...
Tokens:74,834
Snippets:204
Trust Score:9.8
Update:1 year ago
Show doc for...
Tokens:
Raw
### GET Blocks (Bulk) - cURL Example

Source: https://mempool.space/docs/api/rest

This cURL command demonstrates how to fetch detailed data for a specific block (block height 100000) from the mempool.space API. It utilizes the 'blocks-bulk' endpoint and specifies the desired block height.

```shell
curl -sSL "https://mempool.space/api/v1/blocks-bulk/100000/100000"
```

--------------------------------

### GET /api/v1/services/accelerator/accelerations

Source: https://mempool.space/docs/api/rest

Returns all transactions currently being accelerated.

```APIDOC
## GET /api/v1/services/accelerator/accelerations

### Description
Returns all transactions currently being accelerated.

### Method
GET

### Endpoint
/api/v1/services/accelerator/accelerations

### Parameters
None

### Request Example
```bash
curl -sSL "https://mempool.space/api/v1/services/accelerator/accelerations"
```

### Response
#### Success Response (200)
- **txid** (string) - Transaction ID.
- **added** (integer) - Timestamp when the transaction was added.
- **feeDelta** (integer) - The fee delta applied.
- **effectiveVsize** (integer) - Effective virtual size of the transaction.
- **effectiveFee** (integer) - Effective fee of the transaction.
- **pools** (array) - List of pool IDs involved in acceleration.

#### Response Example
```json
[
  {
    "txid": "8a183c8ae929a2afb857e7f2acd440aaefdf2797f8f7eab1c5f95ff8602abc81",
    "added": 1707558316,
    "feeDelta": 3500,
    "effectiveVsize": 111,
    "effectiveFee": 1671,
    "pools": [
      111
    ]
  },
  {
    "txid": "6097f295e21bdd8d725bd8d9ad4dd72b05bd795dc648bfef52150a9b2b7f7a45",
    "added": 1707560464,
    "feeDelta": 60000,
    "effectiveVsize": 812,
    "effectiveFee": 7790,
    "pools": [
      111
    ]
  }
]
```
```

--------------------------------

### GET /api/v1/fees/recommended

Source: https://mempool.space/docs/api/rest

Provides suggested transaction fee rates for different confirmation times.

```APIDOC
## GET /api/v1/fees/recommended

### Description
Returns our currently suggested fees for new transactions.

### Method
GET

### Endpoint
/api/v1/fees/recommended

### Parameters
None

### Request Example
```json
{}
```

### Response
#### Success Response (200)
- **fastestFee** (integer) - Recommended fee rate for the fastest confirmation (sat/vB).
- **halfHourFee** (integer) - Recommended fee rate for confirmation within 30 minutes (sat/vB).
- **hourFee** (integer) - Recommended fee rate for confirmation within 1 hour (sat/vB).
- **economyFee** (integer) - Recommended fee rate for economical confirmation (sat/vB).
- **minimumFee** (integer) - The minimum fee rate accepted by the network (sat/vB).

#### Response Example
```json
{
  "fastestFee": 1,
  "halfHourFee": 1,
  "hourFee": 1,
  "economyFee": 1,
  "minimumFee": 1
}
```
```

--------------------------------

### GET /api/v1/services/accelerator/top-up-history

Source: https://mempool.space/docs/api/rest

Returns a list of top ups the user has made as prepayment for the accelerator service.

```APIDOC
## GET /api/v1/services/accelerator/top-up-history

### Description
Returns a list of top ups the user has made as prepayment for the accelerator service.

### Method
GET

### Endpoint
/api/v1/services/accelerator/top-up-history

### Parameters
#### Query Parameters
- **X-Mempool-Auth** (string) - Required - Authentication token.

### Request Example
```bash
curl -H "X-Mempool-Auth: stacksats" -sSL "https://mempool.space/api/v1/services/accelerator/top-up-history"
```

### Response
#### Success Response (200)
- **type** (string) - The type of currency used for the top-up.
- **invoiceId** (string) - The unique identifier for the top-up invoice.
- **amount** (integer) - The amount of the top-up in satoshis.
- **status** (string) - The status of the top-up (e.g., 'pending', 'paid').
- **date** (integer) - The timestamp when the top-up was made.
- **link** (string or null) - A link related to the payment, if applicable.

#### Response Example
```json
[
  {
    "type": "Bitcoin",
    "invoiceId": "CCunucVyNw7jUiUz64mmHz",
    "amount": 10311031,
    "status": "pending",
    "date": 1706372653000,
    "link": "/payment/bitcoin/CCunucVyNw7jUiUz64mmHz"
  },
  {
    "type": "Bitcoin",
    "invoiceId": "SG1U27R9PdWi3gH3jB9tm9",
    "amount": 21000000,
    "status": "paid",
    "date": 1706372582000,
    "link": null
  }
]
```
```

--------------------------------

### GET /api/block/:hash/txs[/:start_index]

Source: https://mempool.space/docs/api/rest

Retrieves a list of transactions within a specified block, optionally starting from a given index. Up to 25 transactions are returned.

```APIDOC
## GET /api/block/:hash/txs[/:start_index]

### Description
Returns a list of transactions in the block (up to 25 transactions beginning at `start_index`). Transactions returned here do not have the `status` field, since all the transactions share the same block and confirmation status.

### Method
GET

### Endpoint
`/api/block/:hash/txs[/:start_index]`

### Parameters
#### Path Parameters
- **hash** (string) - Required - The hash of the block.
- **start_index** (integer) - Optional - The index from which to start retrieving transactions.

### Request Example
```bash
curl -sSL "https://mempool.space/api/block/000000000000000015dc777b3ff2611091336355d3f0ee9766a2cf3be8e4b1ce/txs"
```

### Response
#### Success Response (200)
- **transactions** (array) - An array of transaction objects.
  - **txid** (string) - The transaction ID.
  - **version** (integer) - The transaction version.
  - **locktime** (integer) - The transaction locktime.
  - **vin** (array) - Array of transaction inputs.
  - **vout** (array) - Array of transaction outputs.
  - **size** (integer) - The transaction size in bytes.
  - **weight** (integer) - The transaction weight.
  - **fee** (integer) - The transaction fee.
  - **status** (object) - Transaction status (may be absent).
    - **confirmed** (boolean) - Whether the transaction is confirmed.
    - **block_height** (integer) - The block height of confirmation.
    - **block_hash** (string) - The block hash of confirmation.
    - **block_time** (integer) - The block timestamp of confirmation.

#### Response Example
```json
[
  {
    "txid": "cfe624ccdd8010cf78dbedd1b25e1ff601b470c4d7d90fa9fc8c1bcc5cdc6e0e",
    "version": 1,
    "locktime": 0,
    "vin": [],
    "vout": [],
    "size": 102,
    "weight": 408,
    "fee": 0,
    "status": {
      "confirmed": true,
      "block_height": 363366,
      "block_hash": "000000000000000015dc777b3ff2611091336355d3f0ee9766a2cf3be8e4b1ce",
      "block_time": 1435766771
    }
  },
  ...
]
```
```

--------------------------------

### GET Block Audit Summary API Request (cURL)

Source: https://mempool.space/docs/api/rest

This example shows how to request a detailed audit summary for a specific block hash via the mempool.space API. The response provides comprehensive data including block height, ID, timestamp, transaction details (template, missing, added, fresh, sigop, fullrbf, accelerated), match rate, expected fees, and expected weight.

```bash
curl -sSL "https://mempool.space/api/v1/block/00000000000000000000f218ceda7a5d9c289040b9c3f05ef9f7c2f4930e0123/audit-summary"
```

--------------------------------

### GET /api/v1/prices

Source: https://mempool.space/docs/api/rest

Retrieves the latest Bitcoin price in various major currencies.

```APIDOC
## GET /api/v1/prices

### Description
Returns bitcoin latest price denominated in main currencies.

### Method
GET

### Endpoint
/api/v1/prices

### Parameters
#### Query Parameters
None

### Request Example
```bash
curl -sSL "https://mempool.space/api/v1/prices"
```

### Response
#### Success Response (200)
- **time** (integer) - Unix timestamp of the price data.
- **USD** (number) - Bitcoin price in USD.
- **EUR** (number) - Bitcoin price in EUR.
- **GBP** (number) - Bitcoin price in GBP.
- **CAD** (number) - Bitcoin price in CAD.
- **CHF** (number) - Bitcoin price in CHF.
- **AUD** (number) - Bitcoin price in AUD.
- **JPY** (number) - Bitcoin price in JPY.

#### Response Example
```json
{
  "time": 1703252411,
  "USD": 43753,
  "EUR": 40545,
  "GBP": 37528,
  "CAD": 58123,
  "CHF": 37438,
  "AUD": 64499,
  "JPY": 6218915
}
```
```

--------------------------------

### GET /api/v1/lightning/channels

Source: https://mempool.space/docs/api/rest

Retrieves a list of a node's Lightning Network channels, paginated by index.

```APIDOC
## GET /api/v1/lightning/channels

### Description
Returns a list of a node's channels given its `:pubKey`. Ten channels are returned at a time. Use `:index` for paging. `:channelStatus` can be `open`, `active`, or `closed`.

### Method
GET

### Endpoint
/api/v1/lightning/channels

#### Query Parameters
- **public_key** (string) - Required - The public key of the node.
- **status** (string) - Required - The status of the channels to retrieve (`open`, `active`, or `closed`).
- **index** (integer) - Optional - The index for pagination. Defaults to 0.

### Request Example
```curl
curl -sSL "https://mempool.space/api/v1/lightning/channels?public_key=026165850492521f4ac8abd9bd8088123446d126f648ca35e60f88177dc149ceb2&status=open"
```

### Response
#### Success Response (200)
- **status** (integer) - The status of the channel (1 for open, 0 for closed).
- **closing_reason** (string) - The reason for closing the channel (null if open).
- **capacity** (integer) - The total capacity of the channel in satoshis.
- **short_id** (string) - A shorter, human-readable identifier for the channel.
- **id** (string) - The unique identifier for the channel.
- **fee_rate** (integer) - The fee rate for routing.
- **node** (object) - Information about the counterparty node.
  - **alias** (string) - The alias of the node.
  - **public_key** (string) - The public key of the node.
  - **base_fee_mtokens** (integer) - The base fee for routing in milli-satoshi.
  - **cltv_delta** (integer) - The CLTV delta for the channel.
  - **fee_rate** (integer) - The fee rate for routing.
  - **is_disabled** (integer) - Indicates if the node is disabled (1 for yes, 0 for no).
  - **max_htlc_mtokens** (integer) - The maximum HTLC amount in milli-satoshi.
  - **min_htlc_mtokens** (integer) - The minimum HTLC amount in milli-satoshi.
  - **updated_at** (string) - The timestamp when the node information was last updated.
  - **longitude** (number) - The longitude coordinate of the node's location.
  - **latitude** (number) - The latitude coordinate of the node's location.

#### Response Example
```json
[
  {
    "status": 1,
    "closing_reason": null,
    "capacity": 59200000,
    "short_id": "751361x1324x1",
    "id": "826130156244172801",
    "fee_rate": 1,
    "node": {
      "alias": "ipayblue.com",
      "public_key": "026165850492521f4ac8abd9bd8088123446d126f648ca35e60f88177dc149ceb2",
      "base_fee_mtokens": 0,
      "cltv_delta": 0,
      "fee_rate": 0,
      "is_disabled": 0,
      "max_htlc_mtokens": 297000000000,
      "min_htlc_mtokens": 1000,
      "updated_at": "2022-08-23T17:53:43.000Z",
      "longitude": -0.1278,
      "latitude": 51.5074
    }
  }
]
```
```

--------------------------------

### GET Hashrate mining

Source: https://mempool.space/docs/api/rest

Returns network-wide hashrate and difficulty figures over a specified trailing time period.

```APIDOC
## GET /api/v1/mining/hashrate/:timePeriod

### Description
Returns network-wide hashrate and difficulty figures over the specified trailing `:timePeriod`:
  * Current (real-time) hashrate
  * Current (real-time) difficulty
  * Historical daily average hashrates
  * Historical difficulty

Valid values for `:timePeriod` are `1m`, `3m`, `6m`, `1y`, `2y`, `3y`. If no time interval is specified, all available data is returned.
Be sure that `INDEXING_BLOCKS_AMOUNT` is set properly in your backend config so that enough blocks are indexed to properly serve your request.

### Method
GET

### Endpoint
`/api/v1/mining/hashrate/:timePeriod`

### Parameters
#### Path Parameters
- **timePeriod** (string) - Optional - The time period for which to retrieve hashrate and difficulty data. Valid values: `1m`, `3m`, `6m`, `1y`, `2y`, `3y`.

### Request Example
```
curl -sSL "https://mempool.space/api/v1/mining/hashrate/3d"
```

### Response
#### Success Response (200)
- **hashrates** (array) - An array of historical average hashrates.
  - **timestamp** (integer) - The timestamp for the average hashrate.
  - **avgHashrate** (number) - The average hashrate during that period.
- **difficulty** (array) - An array of historical difficulty figures.
  - **timestamp** (integer) - The timestamp for the difficulty figure.
  - **difficulty** (number) - The difficulty value.
  - **height** (integer) - The block height at which this difficulty was recorded.
- **currentHashrate** (number) - The current real-time network hashrate.
- **currentDifficulty** (number) - The current real-time network difficulty.

#### Response Example
```json
{
  "hashrates": [
    {
      "timestamp": 1652486400,
      "avgHashrate": 236499762108771800000
    },
    {
      "timestamp": 1652572800,
      "avgHashrate": 217473276787331300000
    },
    {
      "timestamp": 1652659200,
      "avgHashrate": 189877203506913000000
    }
  ],
  "difficulty": [
    {
      "timestamp": 1652468330,
      "difficulty": 31251101365711.12,
      "height": 736249
    }
  ],
  "currentHashrate": 252033247355212300000,
  "currentDifficulty": 31251101365711.12
}
```
```

--------------------------------

### GET /api/tx/:txid/merkleblock-proof

Source: https://mempool.space/docs/api/rest

Retrieves a Merkle inclusion proof for a transaction in bitcoind's merkleblock format.

```APIDOC
## GET /api/tx/:txid/merkleblock-proof

### Description
Returns a merkle inclusion proof for the transaction using bitcoind's merkleblock format.

### Method
GET

### Endpoint
/api/tx/:txid/merkleblock-proof

### Parameters
#### Path Parameters
- **txid** (string) - Required - The transaction ID.

#### Query Parameters
None

#### Request Body
None

### Request Example
```bash
curl -sSL "https://mempool.space/api/tx/15e10745f15593a899cef391191bdd3d7c12412cc4696b7bcb669d0feadc8521/merkleblock-proof"
```

### Response
#### Success Response (200)
- **merkle_proof** (string) - The Merkle inclusion proof in bitcoind's merkleblock format.

#### Response Example
```
0300000058f6dd09ac5aea942c01d12e75b351e73f4304cc442741000000000000000000ef0c2fa8517414b742094a020da7eba891b47d660ef66f126ad01e5be99a2fd09ae093558e411618c14240df820700000ce4d15e17594f257b22d1ddf47d07b3b88779a8374fcd515ad883d79726c6027da6abfcbc1341a049b30277d3bf14e4663...
```
```

--------------------------------

### POST /mempool-block

Source: https://mempool.space/docs/api/websocket

Subscribe to live mempool projected block templates.

```APIDOC
## POST /mempool-block

### Description
Subscribe to live mempool projected block template, index 0 being the first mempool block. A full set of stripped transactions in that block is returned when the subscription starts, and deltas (removed and added transactions) are then sent every time the mempool changes.

### Method
POST

### Endpoint
/mempool-block

### Parameters
#### Request Body
- **track-mempool-block** (integer) - Required - The index of the mempool block to track. `0` for the first mempool block.

### Request Example
```json
{
  "track-mempool-block": 0
}
```

### Response
#### Success Response (200)
- **projected-block-transactions** (object) - Contains projected block transaction data.
  - **index** (integer) - The index of the projected block.
  - **sequence** (integer) - A sequence number for the mempool state.

#### Response Example
```json
{
  "projected-block-transactions": {
    "index": 0,
    "sequence": 80270
  }
}
```
```

--------------------------------

### Get Past Blocks (cURL, CommonJS, ES Module)

Source: https://mempool.space/docs/api/rest

Retrieves details for the past 10 blocks. If a start height is provided, it returns the 10 blocks preceding and including that height. Supports cURL, CommonJS, and ES Module.

```cURL
curl -sSL "https://mempool.space/api/blocks/730000"
```

```CommonJS
const fetch = require('node-fetch');

async function getPastBlocks(startHeight) {
  try {
    const url = startHeight ? `https://mempool.space/api/blocks/${startHeight}` : 'https://mempool.space/api/blocks';
    const response = await fetch(url);
    const blocks = await response.json();
    console.log('Past Blocks:', blocks);
  } catch (error) {
    console.error('Error fetching past blocks:', error);
  }
}

getPastBlocks(730000);
```

```ES Module
async function getPastBlocks(startHeight) {
  try {
    const url = startHeight ? `https://mempool.space/api/blocks/${startHeight}` : 'https://mempool.space/api/blocks';
    const response = await fetch(url);
    const blocks = await response.json();
    console.log('Past Blocks:', blocks);
  } catch (error) {
    console.error('Error fetching past blocks:', error);
  }
}

getPastBlocks(730000);
```

--------------------------------

### Get Block Transactions (cURL, CommonJS, ES Module)

Source: https://mempool.space/docs/api/rest

Retrieves a list of transactions within a specified block, optionally starting from a given index. Transactions returned do not include the 'status' field as they share the same block confirmation status. Supports cURL, CommonJS, and ES Module.

```cURL
curl -sSL "https://mempool.space/api/block/000000000000000015dc777b3ff2611091336355d3f0ee9766a2cf3be8e4b1ce/txs"
```

```CommonJS
const fetch = require('node-fetch');

async function getBlockTxs(blockHash, startIndex = 0) {
  try {
    const response = await fetch(`https://mempool.space/api/block/${blockHash}/txs${startIndex > 0 ? '/' + startIndex : ''}`);
    const txs = await response.json();
    console.log(`Transactions in block ${blockHash} (starting at index ${startIndex}):`, txs);
  } catch (error) {
    console.error('Error fetching block transactions:', error);
  }
}

getBlockTxs('000000000000000015dc777b3ff2611091336355d3f0ee9766a2cf3be8e4b1ce');
```

```ES Module
async function getBlockTxs(blockHash, startIndex = 0) {
  try {
    const response = await fetch(`https://mempool.space/api/block/${blockHash}/txs${startIndex > 0 ? '/' + startIndex : ''}`);
    const txs = await response.json();
    console.log(`Transactions in block ${blockHash} (starting at index ${startIndex}):`, txs);
  } catch (error) {
    console.error('Error fetching block transactions:', error);
  }
}

getBlockTxs('000000000000000015dc777b3ff2611091336355d3f0ee9766a2cf3be8e4b1ce');
```

--------------------------------

### Mempool.space API: Block Transaction Details

Source: https://mempool.space/docs/api/websocket

This example shows a detailed JSON response for a confirmed transaction within a block from the mempool.space API. It includes transaction ID, version, locktime, input (vin) and output (vout) details, script public keys, and script signatures. This data is essential for in-depth transaction analysis.

```json
{
  "txid": "9d3ea0d131c45450c135d549b62032019bc47a80368e14edc72caf38f5a88033",
  "version": 1,
  "locktime": 0,
  "vin": [
    {
      "txid": "69da555a9c69788a3a081958457894e56b1ee6766bc72cecf881b1b4f327f78b",
      "vout": 0,
      "prevout": {
        "scriptpubkey": "a914c9848245ae4f5d5934b5cbdfb79e04cdd337470b87",
        "scriptpubkey_asm": "OP_HASH160 OP_PUSHBYTES_20 c9848245ae4f5d5934b5cbdfb79e04cdd337470b OP_EQUAL",
        "scriptpubkey_type": "p2sh",
        "scriptpubkey_address": "3L4YUynB4X44rJBY9CmiLMN8Wjti49JCYB",
        "value": 24962957
      },
      "scriptsig": "0048304502210099219ee0cd5da341650078e3c63885b3cc2211069f2551cf436e0100f421e1760220349b4ec284255b458d6da539fa17314e8330459e0a653c254f775d4ec8f32b3f0147304402203a8353c5ee76a2e266432e5f993f882e05725297e64c0833cf44719f7dda8d3b022058a2f72e7739efd21657b4943cac60a0a3c749e712787f0e85726da4c3adcf8e014c695221027f2a0df8e86535d08ca3e766a178f90c813d2dd1d55b0166e82518efbffb18c02103556a35844b517e2fc8216701e2e0a64dbcbe62ad420ac6dd73dc79e69efeb69521031ef21bd55171032b7aec21ec82932735fb986f1d4d8611feee62ab38acf4a6bb53ae",
      "scriptsig_asm": "OP_0 OP_PUSHBYTES_72 304502210099219ee0cd5da341650078e3c63885b3cc2211069f2551cf436e0100f421e1760220349b4ec284255b458d6da539fa17314e8330459e0a653c254f775d4ec8f32b3f01 OP_PUSHBYTES_71 304402203a8353c5ee76a2e266432e5f993f882e05725297e64c0833cf44719f7dda8d3b022058a2f72e7739efd21657b4943cac60a0a3c749e712787f0e85726da4c3adcf8e01 OP_PUSHDATA1 5221027f2a0df8e86535d08ca3e766a178f90c813d2dd1d55b0166e82518efbffb18c02103556a35844b517e2fc8216701e2e0a64dbcbe62ad420ac6dd73dc79e69efeb69521031ef21bd55171032b7aec21ec82932735fb986f1d4d8611feee62ab38acf4a6bb53ae",
      "is_coinbase": false,
      "sequence": 4294967295,
      "inner_redeemscript_asm": "OP_PUSHNUM_2 OP_PUSHBYTES_33 027f2a0df8e86535d08ca3e766a178f90c813d2dd1d55b0166e82518efbffb18c0 OP_PUSHBYTES_33 03556a35844b517e2fc8216701e2e0a64dbcbe62ad420ac6dd73dc79e69efeb695 OP_PUSHBYTES_33 031ef21bd55171032b7aec21ec82932735fb986f1d4d8611feee62ab38acf4a6bb OP_PUSHNUM_3 OP_CHECKMULTISIG"
    },
    {
      "txid": "43852d32c7ae6d362d446d090daa4d389f78ec77e6693f9248cd924dc0b1ecc3",
      "vout": 1,
      "prevout": {
        "scriptpubkey": "a914a3aff5f5765f167c1582fd85517ddde83174118187",
        "scriptpubkey_asm": "OP_HASH160 OP_PUSHBYTES_20 a3aff5f5765f167c1582fd85517ddde831741181 OP_EQUAL",
        "scriptpubkey_type": "p2sh",
        "scriptpubkey_address": "3GcWrnGFoNzbn1KaiP5czS5xPELdWcgDX2",
        "value": 1719827
      },
      "scriptsig": "0047304402205f83d22a0476158aa0986682c96ce2b2dab26c814968dba62905cdfeef1b3ac7022059438a3439bb18bd49242010c8a276ea6f1810d523042e679fa6679d60e89e0201483045022100eb085df09e0fb4894090a5f39b9f2188392f7ac2847ed8255629baffc7371f170220120463b91d6c4bb8968fb3eda9012b88d13d8ca71de28e7a64b1dd88282ff144014c69522103650083cbc9cd1da1224e0780bce1ee8abd5150c5252defd0edeccd3521610b282102510ab30a6a97464ef0d61f71ec8b1d2325f12934ff15ba73579bfd0ac5f4fc1a2102985b3be77f56a9a29c5f68d3c893d6c4d76ec8c07792f0291d375c29b71ee2f853ae",
      "scriptsig_asm": "OP_0 OP_PUSHBYTES_71 304402205f83d22a0476158aa0986682c96ce2b2dab26c814968dba62905cdfeef1b3ac7022059438a3439bb18bd49242010c8a276ea6f1810d523042e679fa6679d60e89e0201 OP_PUSHBYTES_72 3045022100eb085df09e0fb4894090a5f39b9f2188392f7ac2847ed8255629baffc7371f170220120463b91d6c4bb8968fb3eda9012b88d13d8ca71de28e7a64b1dd88282ff14401 OP_PUSHDATA1 522103650083cbc9cd1da1224e0780bce1ee8abd5150c5252defd0edeccd3521610b28 OP_PUSHBYTES_33 02510ab30a6a97464ef0d61f71ec8b1d2325f12934ff15ba73579bfd0ac5f4fc1a OP_PUSHBYTES_33 02985b3be77f56a9a29c5f68d3c893d6c4d76ec8c07792f0291d375c29b71ee2f8 OP_PUSHNUM_3 OP_CHECKMULTISIG"
    }
  ],
  "vout": [
    {
      "scriptpubkey": "0014292fce548b228cd3df6334dd525fac62e7eb5f7a",
      "scriptpubkey_asm": "OP_0 OP_PUSHBYTES_20 292fce548b228cd3df6334dd525fac62e7eb5f7a",
      "scriptpubkey_type": "v0_p2wpkh"
    }
  ]
}
```

--------------------------------

### GET Block Audit Score API Request (cURL)

Source: https://mempool.space/docs/api/rest

This example demonstrates how to fetch the block audit score for a specific block hash using the mempool.space API. The response includes the block's hash, match rate, expected fees, and expected weight. A valid block hash is required as a parameter.

```bash
curl -sSL "https://mempool.space/api/v1/mining/blocks/audit/score/000000000000000000032535698c5b0c48283b792cf86c1c6e36ff84464de785"
```

--------------------------------

### Get Network Hashrate and Difficulty

Source: https://mempool.space/docs/api/rest

Fetches network-wide hashrate and difficulty figures over a specified trailing time period. This endpoint provides current real-time hashrate and difficulty, as well as historical daily averages. Ensure `INDEXING_BLOCKS_AMOUNT` is configured correctly in your backend for accurate results.

```cURL
curl -sSL "https://mempool.space/api/v1/mining/hashrate/3d"
```

--------------------------------

### Get Recommended Fees

Source: https://mempool.space/docs/api/rest

Fetches the recommended fees for new transactions. This endpoint returns suggested fee rates for different transaction speeds: fastest, half-hour, hour, economy, and minimum.

```curl
curl -sSL "https://mempool.space/api/v1/fees/recommended"
```

```javascript
fetch('https://mempool.space/api/v1/fees/recommended').then(response => response.json()).then(data => console.log(data))
```

--------------------------------

### Get Past Blocks (v1) (cURL, CommonJS, ES Module)

Source: https://mempool.space/docs/api/rest

Retrieves details for the past 15 blocks from Mempool's Node.js backend, including fee and mining details in an 'extras' field. If a start height is specified, it returns the past 15 blocks before and including that height. Supports cURL, CommonJS, and ES Module.

```cURL
curl -sSL "https://mempool.space/api/v1/blocks/730000"
```

```CommonJS
const fetch = require('node-fetch');

async function getPastBlocksV1(startHeight) {
  try {
    const url = startHeight ? `https://mempool.space/api/v1/blocks/${startHeight}` : 'https://mempool.space/api/v1/blocks';
    const response = await fetch(url);
    const blocks = await response.json();
    console.log('Past Blocks (v1):', blocks);
  } catch (error) {
    console.error('Error fetching past blocks (v1):', error);
  }
}

getPastBlocksV1(730000);
```

```ES Module
async function getPastBlocksV1(startHeight) {
  try {
    const url = startHeight ? `https://mempool.space/api/v1/blocks/${startHeight}` : 'https://mempool.space/api/v1/blocks';
    const response = await fetch(url);
    const blocks = await response.json();
    console.log('Past Blocks (v1):', blocks);
  } catch (error) {
    console.error('Error fetching past blocks (v1):', error);
  }
}

getPastBlocksV1(730000);
```

--------------------------------

### GET /api/v1/blocks[/:startHeight]

Source: https://mempool.space/docs/api/rest

Retrieves details on the past 15 blocks from Mempool's Node.js backend, including fee and mining details. If `:startHeight` is provided, it returns the 15 blocks preceding and including that height.

```APIDOC
## GET /api/v1/blocks[/:startHeight]

### Description
Returns details on the past 15 blocks from Mempool's Node.js backend. Includes fee and mining details in an `extras` field. If `:startHeight` is specified, the past 15 blocks before (and including) `:startHeight` are returned.

### Method
GET

### Endpoint
`/api/v1/blocks[/:startHeight]`

### Parameters
#### Path Parameters
- **startHeight** (integer) - Optional - The block height to start retrieving blocks from (inclusive).

### Request Example
```bash
curl -sSL "https://mempool.space/api/v1/blocks/730000"
```

### Response
#### Success Response (200)
- **blocks** (array) - An array of block objects.
  - **id** (string) - The block hash.
  - **height** (integer) - The block height.
  - **version** (integer) - The block version.
  - **timestamp** (integer) - The block timestamp.
  - **bits** (integer) - The block target difficulty.
  - **nonce** (integer) - The nonce found for the block.
  - **difficulty** (number) - The block difficulty.
  - **merkle_root** (string) - The Merkle root of the block.
  - **tx_count** (integer) - The number of transactions in the block.
  - **extras** (object) - Additional fee and mining details.

#### Response Example
```json
[
  {
    "id": "0000000000000000000384f28cb3b9cf4377a39cfd6c29ae9466951de38c0529",
    "height": 730000,
    "version": 536870912,
    "timestamp": 1648829449,
    "bits": 386521239,
    "nonce": 3580664066,
    "difficulty": 28587155782195.1,
    "merkle_root": "efa344bcd6c0607f93b709515dd6dc5496178112d680338ebea459e3de7b4fbc",
    "tx_count": 1627,
    "extras": {}
  },
  ...
]
```
```

--------------------------------

### Get Block Transaction IDs (cURL, CommonJS, ES Module)

Source: https://mempool.space/docs/api/rest

Retrieves a list of all transaction IDs contained within a specified block. This endpoint is useful for getting a complete overview of transactions in a block. It supports cURL, CommonJS, and ES Module.

```cURL
curl -sSL "https://mempool.space/api/block/000000000000000015dc777b3ff2611091336355d3f0ee9766a2cf3be8e4b1ce/txids"
```

```CommonJS
const fetch = require('node-fetch');

async function getTxidsInBlock(blockHash) {
  try {
    const response = await fetch(`https://mempool.space/api/block/${blockHash}/txids`);
    const txids = await response.json();
    console.log(`Txids in block ${blockHash}:`, txids);
  } catch (error) {
    console.error('Error fetching txids in block:', error);
  }
}

getTxidsInBlock('000000000000000015dc777b3ff2611091336355d3f0ee9766a2cf3be8e4b1ce');
```

```ES Module
async function getTxidsInBlock(blockHash) {
  try {
    const response = await fetch(`https://mempool.space/api/block/${blockHash}/txids`);
    const txids = await response.json();
    console.log(`Txids in block ${blockHash}:`, txids);
  } catch (error) {
    console.error('Error fetching txids in block:', error);
  }
}

getTxidsInBlock('000000000000000015dc777b3ff2611091336355d3f0ee9766a2cf3be8e4b1ce');
```

--------------------------------

### WebSocket API - General Live Data

Source: https://mempool.space/docs/api/websocket

Subscribe to live data streams such as blocks, mempool statistics, and charts.

```APIDOC
## WebSocket /api/v1/ws

### Description
Subscribe to live data streams. Available data types include `blocks`, `mempool-block`, `live-2h-chart`, and `stats`.

### Method
`WS` (WebSocket)

### Endpoint
`wss://mempool.space/api/v1/ws`

### Parameters
#### Request Payload
- **action** (string) - Required - The action to perform, typically "want".
- **data** (array of strings) - Required - An array of data types to subscribe to. Examples: `"mempool-blocks"`, `"stats"`.

### Request Example
```json
{
  "action": "want",
  "data": ["mempool-blocks", "stats"]
}
```

### Response
#### Success Response (200)
The response will be a JSON object containing the requested data. The structure varies based on the subscribed data types.

#### Response Example (for `mempool-blocks` and `stats`)
```json
{
  "mempool-blocks": [
    {
      "blockSize": 1801614,
      "blockVSize": 997936.5,
      "nTx": 3391,
      "totalFees": 8170664,
      "medianFee": 6.011217160720601,
      "feeRange": [
        4.584615384615384,
        5,
        5.100456621004566,
        6.002319288751449,
        7.235398230088496,
        10.377668308702791,
        200
      ]
    }
  ],
  "mempoolInfo": {
    "loaded": true,
    "size": 264505,
    "bytes": 108875402,
    "usage": 649908688,
    "total_fee": 1.61036575,
    "maxmempool": 300000000,
    "mempoolminfee": 0.00001858,
    "minrelaytxfee": 0.00001,
    "incrementalrelayfee": 0.00001,
    "unbroadcastcount": 0,
    "fullrbf": true
  },
  "vBytesPerSecond": 1651,
  "fees": {
    "fastestFee": 7,
    "halfHourFee": 6,
    "hourFee": 5,
    "economyFee": 4,
    "minimumFee": 2
  },
  "da": {
    "progressPercent": 32.49007936507937,
    "difficultyChange": 0.7843046881601534,
    "estimatedRetargetDate": 1735514828279,
    "remainingBlocks": 1361,
    "remainingTime": 811481279,
    "previousRetarget": 4.429396745461176,
    "previousTime": 1734312810,
    "nextRetargetHeight": 876960,
    "timeAvg": 596239,
    "adjustedTimeAvg": 596239,
    "timeOffset": 0,
    "expectedBlocks": 650.895
  }
}
```
```

--------------------------------

### GET Transaction Status

Source: https://mempool.space/docs/api/rest

Returns the confirmation status of a transaction.

```APIDOC
## GET /api/tx/:txid/status

### Description
Returns the confirmation status of a transaction.

### Method
GET

### Endpoint
`/api/tx/{txid}/status`

### Parameters
#### Path Parameters
- **txid** (string) - Required - The ID of the transaction to check.

### Request Example
```bash
curl -sSL "https://mempool.space/api/tx/15e10745f15593a899cef391191bdd3d7c12412cc4696b7bcb669d0feadc8521/status"
```

### Response
#### Success Response (200)
- **confirmed** (boolean) - True if the transaction is confirmed, false otherwise.
- **block_height** (integer) - Optional - The height of the block in which the transaction was confirmed.
- **block_hash** (string) - Optional - The hash of the block in which the transaction was confirmed.
- **block_time** (integer) - Optional - The timestamp of the block in which the transaction was confirmed.
```
Tokens:
Raw