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

object

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

wtxid

object

The transaction wtxid object with the following fields:

txid

string

The transaction hash in hex

other-wtxid

string

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

integer

The virtual transaction size as defined in BIP 141

fees

object

The transaction fees object which contains the following fields:

base

number

The transaction fee in BTC

effective-feerate

number

(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

array

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

replaced-transactions

array

A list of txids of replaced transactions

Request

1
curl -X POST "https://docs-demo.bch-mainnet.quiknode.pro/" \
2
  -H "Content-Type: application/json" \
3
  -d '{
4
  "jsonrpc": "2.0",
5
  "method": "submitpackage",
6
  "params": [
7
    "RAW_TXS_1",
8
    "RAW_TXS_2"
9
  ],
10
  "id": 1
11
}'

1
curl -X POST "https://docs-demo.bch-mainnet.quiknode.pro/" \
2
  -H "Content-Type: application/json" \
3
  -d '{
4
  "jsonrpc": "2.0",
5
  "method": "submitpackage",
6
  "params": [
7
    "RAW_TXS_1",
8
    "RAW_TXS_2"
9
  ],
10
  "id": 1
11
}'

1
const body = {
2
    jsonrpc: '2.0',
3
    method: 'submitpackage',
4
    params: ["RAW_TXS_1","RAW_TXS_2"],
5
    id: 1
6
}
7

8
async function main() {
9
    const response = await fetch('https://docs-demo.bch-mainnet.quiknode.pro/', {
10
        method: 'POST',
11
        headers: {'Content-Type': 'application/json'},
12
        body: JSON.stringify(body)
13
    })
14
    const data = await response.json()
15
    console.log(data)
16
}
17

18
main()

1
const body = {
2
    jsonrpc: '2.0',
3
    method: 'submitpackage',
4
    params: ["RAW_TXS_1","RAW_TXS_2"],
5
    id: 1
6
}
7

8
async function main() {
9
    const response = await fetch('https://docs-demo.bch-mainnet.quiknode.pro/', {
10
        method: 'POST',
11
        headers: {'Content-Type': 'application/json'},
12
        body: JSON.stringify(body)
13
    })
14
    const data = await response.json()
15
    console.log(data)
16
}
17

18
main()

1
import requests
2
import json
3

4
url = "https://docs-demo.bch-mainnet.quiknode.pro/"
5

6
payload = json.dumps({
7
  "jsonrpc": "2.0",
8
  "method": "submitpackage",
9
  "params": [
10
    "RAW_TXS_1",
11
    "RAW_TXS_2"
12
  ],
13
  "id": 1
14
})
15
headers = {
16
  'Content-Type': 'application/json'
17
}
18

19
response = requests.request("POST", url, headers=headers, data=payload)
20

21
print(response.text)

1
import requests
2
import json
3

4
url = "https://docs-demo.bch-mainnet.quiknode.pro/"
5

6
payload = json.dumps({
7
  "jsonrpc": "2.0",
8
  "method": "submitpackage",
9
  "params": [
10
    "RAW_TXS_1",
11
    "RAW_TXS_2"
12
  ],
13
  "id": 1
14
})
15
headers = {
16
  'Content-Type': 'application/json'
17
}
18

19
response = requests.request("POST", url, headers=headers, data=payload)
20

21
print(response.text)

1
require "uri"
2
require "json"
3
require "net/http"
4

5
uri = URI("https://docs-demo.bch-mainnet.quiknode.pro/")
6

7
payload = {
8
  jsonrpc: "2.0",
9
  id: 1,
10
  method: "submitpackage",
11
  params: ["RAW_TXS_1","RAW_TXS_2"]
12
}
13

14
request = Net::HTTP::Post.new(uri)
15
request["Content-Type"] = "application/json"
16
request.body = JSON.generate(payload)
17

18
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
19
  http.request(request)
20
end
21

22
puts response.body

1
require "uri"
2
require "json"
3
require "net/http"
4

5
uri = URI("https://docs-demo.bch-mainnet.quiknode.pro/")
6

7
payload = {
8
  jsonrpc: "2.0",
9
  id: 1,
10
  method: "submitpackage",
11
  params: ["RAW_TXS_1","RAW_TXS_2"]
12
}
13

14
request = Net::HTTP::Post.new(uri)
15
request["Content-Type"] = "application/json"
16
request.body = JSON.generate(payload)
17

18
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
19
  http.request(request)
20
end
21

22
puts response.body

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