Skip to content

Latest commit

 

History

History
85 lines (61 loc) · 2.09 KB

get_mempool-info.md

File metadata and controls

85 lines (61 loc) · 2.09 KB
Raw

{% comment %} This file is licensed under the MIT License (MIT) available on http://opensource.org/licenses/MIT. {% endcomment %} {% assign filename="_data/devdocs/en/bitcoin-core/rest/requests/get_mempool-info.md" %}

GET MemPool/Info

{% include helpers/subhead-links.md %}

{% assign summary_restGetMemPool-info="returns information about the node's current transaction memory pool." %}

{% autocrossref %}

The GET mempool/info operation {{summary_restGetMemPool-info}} Supports only json as output format.

Request

{% highlight text %} GET /mempool/info.json {% endhighlight %}

Parameters: none

Result as JSON

{% itemplate ntpd1 %}

  • n: "result" t: "object" p: "Required
    (exactly 1)" d: "A object containing information about the memory pool"

  • n: "→
    size" t: "number (int)" p: "Required
    (exactly 1)" d: "The number of transactions currently in the memory pool"

  • n: "→
    bytes" t: "number (int)" p: "Required
    (exactly 1)" d: "The total number of bytes in the transactions in the memory pool"

  • n: "→
    usage" t: "number (int)" p: "Required
    (exactly 1)" d: "Added in Bitcoin Core 0.11.0

    Total memory usage for the mempool in bytes"

  • n: "→
    maxmempool" t: "number (int)" p: "Required
    (exactly 1)" d: "Added in Bitcoin Core 0.12.0

    Maximum memory usage for the mempool in bytes"

  • n: "→
    mempoolminfee" t: "number (int)" p: "Required
    (exactly 1)" d: "Added in Bitcoin Core 0.12.0

    The lowest fee per kilobyte paid by any transaction in the memory pool"

{% enditemplate %}

Examples from Bitcoin Core 0.13.1

Get memory pool info in JSON:

{% highlight bash %} curl http://localhost:8332/rest/mempool/info.json {% endhighlight %}

Result (whitespaced added):

{% highlight json %} { "size": 989, "bytes": 736919, "usage": 1970496, "maxmempool": 300000000, "mempoolminfee": 0 }

{% endhighlight %}

See also

  • [GET MemPool/Contents][rest get mempool-contents]: {{summary_restGetMemPool-contents}}
  • [GetMemPoolInfo][rpc getmempoolinfo] RPC: {{summary_getMemPoolInfo}}

{% endautocrossref %}