Get mempool transactions

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

Query Parameters

sender_address?STX Address

STX Address

Pattern"^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}"

recipient_address?STX Address

STX Address

Pattern"^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}"

address?STX Address

STX Address

Pattern"^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}"

order_by?Order By

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

order?Order

Results order

unanchored?boolean

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

Defaultfalse

offset?Offset

Result offset

Default0

limit?Limit

Results per page

Default20

Rangevalue <= 50

Response Body

List of mempool transactions

TypeScript Definitions

Use the response body type in TypeScript.

limitinteger

offsetinteger

totalinteger

resultsarray<TokenTransferMempoolTransaction & SmartContractMempoolTransaction & ContractCallMempoolTransaction & PoisonMicroblockMempoolTransaction & CoinbaseMempoolTransaction & TenureChangeMempoolTransaction>

Default Response

TypeScript Definitions

Use the response body type in TypeScript.

errorstring

message?string

[key: string]any

curl -X GET "https://api.hiro.so//extended/v1/tx/mempool?sender_address=SP318Q55DEKHRXJK696033DQN5C54D9K2EE6DHRWP&recipient_address=SP318Q55DEKHRXJK696033DQN5C54D9K2EE6DHRWP&address=SP318Q55DEKHRXJK696033DQN5C54D9K2EE6DHRWP&order_by=age&order=asc&unanchored=true&offset=0&limit=20"

fetch("https://api.hiro.so//extended/v1/tx/mempool?sender_address=SP318Q55DEKHRXJK696033DQN5C54D9K2EE6DHRWP&recipient_address=SP318Q55DEKHRXJK696033DQN5C54D9K2EE6DHRWP&address=SP318Q55DEKHRXJK696033DQN5C54D9K2EE6DHRWP&order_by=age&order=asc&unanchored=true&offset=0&limit=20")

package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
)

func main() {
  url := "https://api.hiro.so//extended/v1/tx/mempool?sender_address=SP318Q55DEKHRXJK696033DQN5C54D9K2EE6DHRWP&recipient_address=SP318Q55DEKHRXJK696033DQN5C54D9K2EE6DHRWP&address=SP318Q55DEKHRXJK696033DQN5C54D9K2EE6DHRWP&order_by=age&order=asc&unanchored=true&offset=0&limit=20"

  req, _ := http.NewRequest("GET", url, nil)
  
  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  body, _ := ioutil.ReadAll(res.Body)

  fmt.Println(res)
  fmt.Println(string(body))
}

import requests

url = "https://api.hiro.so//extended/v1/tx/mempool?sender_address=SP318Q55DEKHRXJK696033DQN5C54D9K2EE6DHRWP&recipient_address=SP318Q55DEKHRXJK696033DQN5C54D9K2EE6DHRWP&address=SP318Q55DEKHRXJK696033DQN5C54D9K2EE6DHRWP&order_by=age&order=asc&unanchored=true&offset=0&limit=20"

response = requests.request("GET", url)

print(response.text)

{
  "limit": 20,
  "offset": 0,
  "total": 1,
  "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"
      }
    }
  ]
}

{
  "error": "string",
  "message": "string"
}