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

Get mempool transactions

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

Filter to only return transactions with this sender address.

Example: "SP1GPBP8NBRXDRJBFQBV7KMAZX1Z7W2RFWJEH0V10"

`recipient_address`string

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

`address`string

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

`order_by`string

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

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

`order`string

Option to sort results in ascending or descending order.

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

`limit`integer

max number of mempool transactions to fetch

Example: 20Default: 20Maximum: 50

`offset`integer

index of first mempool transaction to fetch

Example: 42000

`unanchored`boolean

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

Example: trueDefault: false

Status code	Description
`200`	List of mempool transactions

Terminal

$ curl -X GET "https://api.hiro.so/extended/v1/tx/mempool?sender_address=SP1GPBP8NBRXDRJBFQBV7KMAZX1Z7W2RFWJEH0V10&recipient_address=string&address=string&order_by=fee&order=asc&limit=20&offset=42000&unanchored=true"

GET request that returns transactions

{
  "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"
      }
    }
  ]
}

Get mempool transactions