Skip to main content

testmempoolaccept RPC Method

Returns the output of mempool acceptance tests, indicating if the mempool will accept serialized, hex-encoded raw transaction.

Updated on
Feb 04, 2026

Parameters

rawtxs
JSON array
REQUIRED

An array of raw transactions in the form of a hex string

maxfeerate
string/numeric

default=0.10. It rejects transactions with a fee rate higher than the specified value, and it is set to 0 to accept any fee rate

Returns

result
object

The result object which contains the following fields:

txid
string

The transaction id

wtxid
string

The transaction witness hash in hex

package-error
string

The package validation error, if any. It is only possible if rawtxs had more than one transaction

allowed
boolean

It indicates if the mempool allows current transaction to be inserted or not

vsize
integer

The virtual transaction size as defined in BIP 141. This is different from actual serialized size for witness transactions as witness data is discounted

fees
object

A JSON array containing information about the transaction fee paid by the transaction and it is only present if allowed is false

base
number

The transaction fee in BTC

reject-reason
string

The rejection string and it is only present if allowed is false

reject-details
string

Detailed rejection message from the mempool, present only if allowed is false. Useful for debugging as it reflects the full internal error from ValidationState

Request
Response
1
{
2
"jsonrpc": "2.0",
3
"id": 1,
4
"result": [
5
{
6
"txid": "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2",
7
"wtxid": "c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2c3d4",
8
"allowed": true,
9
"vsize": 141
10
},
11
{
12
"txid": "e2d3c4b5a6f7e8d9c0b1a2f3e4d5c6b7a8f9e0d1c2b3a4f5e6d7c8b9a0f1e2",
13
"wtxid": "f3e4d5c6b7a8f9e0d1c2b3a4f5e6d7c8b9a0f1e2d3c4b5a6f7e8d9c0b1a2f3",
14
"allowed": false,
15
"vsize": 225,
16
"fees": {
17
"base": 0.0000015
18
},
19
"reject-reason": "insufficient priority",
20
"reject-details": "insufficient fee, rejecting replacement 07d7a59a7bdad4c3a5070659ea04147c9b755ad9e173c52b6a38e017abf0f5b8; new feerate 0.00300000 BTC/kvB <= old feerate 0.00300000 BTC/kvB"
21
}
22
]
23
}
1
{
2
"jsonrpc": "2.0",
3
"id": 1,
4
"result": [
5
{
6
"txid": "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2",
7
"wtxid": "c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2c3d4",
8
"allowed": true,
9
"vsize": 141
10
},
11
{
12
"txid": "e2d3c4b5a6f7e8d9c0b1a2f3e4d5c6b7a8f9e0d1c2b3a4f5e6d7c8b9a0f1e2",
13
"wtxid": "f3e4d5c6b7a8f9e0d1c2b3a4f5e6d7c8b9a0f1e2d3c4b5a6f7e8d9c0b1a2f3",
14
"allowed": false,
15
"vsize": 225,
16
"fees": {
17
"base": 0.0000015
18
},
19
"reject-reason": "insufficient priority",
20
"reject-details": "insufficient fee, rejecting replacement 07d7a59a7bdad4c3a5070659ea04147c9b755ad9e173c52b6a38e017abf0f5b8; new feerate 0.00300000 BTC/kvB <= old feerate 0.00300000 BTC/kvB"
21
}
22
]
23
}
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free