Skip to main content

submitpackage RPC Method

Submit a package of raw transactions (serialized, hex-encoded) to local node.

Updated on
Feb 03, 2026
Please note that this RPC method is experimental and the interface may be unstable. Also, successful submission does not mean the transactions will propagate throughout the network

Parameters

package
array
REQUIRED

An array of raw transactions

maxfeerate
integer

Maximum allowed fee rate (in BTC/kvB) for transactions in the package

maxburnamount
integer

Maximum allowed amount (in BTC) of unspendable outputs, such as OP_RETURN, in the transaction package

Returns

tx-results

The transaction results keyed by wtxid, which contains the following fields:

wtxid

The transaction wtxid object with the following fields:

txid

The transaction hash in hex

other-wtxid

The wtxid of a different transaction with the same txid but different witness found in the mempool. This means the submitted transaction was ignored

vsize

The virtual transaction size as defined in BIP 141

fees

The transaction fees object which contains the following fields:

base

The transaction fee in BTC

effective-feerate

(Optional) If the transaction was not already in the mempool, the effective feerate in BTC per KvB. For example, the package feerate and/or feerate with modified fees from prioritisetransaction

effective-includes

(Optional) If effective-feerate is provided, the wtxids of the transactions whose fees and vsizes are included in effective-feerate

replaced-transactions

A list of txids of replaced transactions

Request
Response
1
{
2
"jsonrpc": "2.0",
3
"id": 1,
4
"result": {
5
"tx-results": {
6
"a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2": {
7
"txid": "f1e2d3c4b5a6f7e8d9c0b1a2f3e4d5c6b7a8f9e0d1c2b3a4f5e6d7c8b9a0",
8
"vsize": 141,
9
"fees": {
10
"base": 0.000015,
11
"effective-feerate": 0.00010638,
12
"effective-includes": [
13
"a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2",
14
"c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2c3d4"
15
]
16
},
17
"replaced-transactions": [
18
"d4c5b6a7e8f9d0c1b2a3e4f5d6c7b8a9f0e1d2c3b4a5f6e7d8c9b0a1f2e3d4c5"
19
]
20
},
21
"c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2c3d4": {
22
"txid": "e2d3c4b5a6f7e8d9c0b1a2f3e4d5c6b7a8f9e0d1c2b3a4f5e6d7c8b9a0f1",
23
"vsize": 225,
24
"fees": {
25
"base": 0.0000235
26
}
27
}
28
}
29
}
30
}
1
{
2
"jsonrpc": "2.0",
3
"id": 1,
4
"result": {
5
"tx-results": {
6
"a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2": {
7
"txid": "f1e2d3c4b5a6f7e8d9c0b1a2f3e4d5c6b7a8f9e0d1c2b3a4f5e6d7c8b9a0",
8
"vsize": 141,
9
"fees": {
10
"base": 0.000015,
11
"effective-feerate": 0.00010638,
12
"effective-includes": [
13
"a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2",
14
"c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2c3d4"
15
]
16
},
17
"replaced-transactions": [
18
"d4c5b6a7e8f9d0c1b2a3e4f5d6c7b8a9f0e1d2c3b4a5f6e7d8c9b0a1f2e3d4c5"
19
]
20
},
21
"c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2c3d4": {
22
"txid": "e2d3c4b5a6f7e8d9c0b1a2f3e4d5c6b7a8f9e0d1c2b3a4f5e6d7c8b9a0f1",
23
"vsize": 225,
24
"fees": {
25
"base": 0.0000235
26
}
27
}
28
}
29
}
30
}
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free