Get mempool transactions

Retrieves all transactions that have been recently broadcast to the mempool. These are pending transactions awaiting confirmation.

GET

/extended/v1/tx/mempool

Retrieves all transactions that have been recently broadcast to the mempool. These are pending transactions awaiting confirmation.

If you need to monitor new transactions, we highly recommend subscribing to WebSockets or Socket.io for real-time updates.

Query parameters

sender_addressstring

Filter to only return transactions with this sender address.

Example: "SP1GPBP8NBRXDRJBFQBV7KMAZX1Z7W2RFWJEH0V10"

recipient_addressstring

Filter to only return transactions with this recipient address (only applicable for STX transfer tx types).

addressstring

Filter to only return transactions with this address as the sender or recipient (recipient only applicable for STX transfer tx types).

order_bystring

Option to sort results by transaction age, size, or fee rate.

Example: "fee"Value in: "age" | "size" | "fee"

orderstring

Option to sort results in ascending or descending order.

Example: "asc"Value in: "asc" | "desc"

limitinteger

Max number of mempool transactions to fetch

Example: 20Default: 20Maximum: 50

offsetinteger

Index of first mempool transaction to fetch

Example: 42000

unanchoredboolean

Include transaction data from unanchored (i.e. unconfirmed) microblocks

Example: trueDefault: false
Status codeDescription
200List of mempool transactions
curl
curl -X GET "https://api.mainnet.hiro.so/extended/v1/tx/mempool"

GET request that returns mempool transactions

Example response
{
  "limit": 0,
  "offset": 0,
  "total": 0,
  "results": [
    {
      "tx_id": "string",
      "nonce": 0,
      "fee_rate": "string",
      "sender_address": "string",
      "sponsor_nonce": 0,
      "sponsored": true,
      "sponsor_address": "string",
      "post_condition_mode": "allow",
      "post_conditions": [
        {
          "principal": {
            "type_id": "principal_origin"
          },
          "condition_code": "sent_equal_to",
          "amount": "string",
          "type": "stx"
        }
      ],
      "anchor_mode": "on_chain_only",
      "tx_status": "pending",
      "receipt_time": 0,
      "receipt_time_iso": "string",
      "tx_type": "token_transfer",
      "token_transfer": {
        "recipient_address": "string",
        "amount": "string",
        "memo": "string"
      }
    }
  ]
}