Parameters

rawtxs

array

REQUIRED

Raw transaction hex strings to simulate. Transaction inputs must still be unspent. The default empty array returns zero without simulating a transaction. The balance change refers to the node wallet, including watched addresses only when requested.

options

object

Optional wallet simulation settings.

include_watchonly

boolean

Include watch-only addresses in the wallet balance calculation. Defaults to false.

Returns

result

object

Simulated change to the node wallet balance.

balance_change

number

Wallet balance change in BCH; a negative value represents a decrease. This is not a balance calculation for an arbitrary address.

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": "simulaterawtransaction",
6
  "params": [
7
    [],
8
    {
9
      "include_watchonly": false
10
    }
11
  ],
12
  "id": 1
13
}'

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": "simulaterawtransaction",
6
  "params": [
7
    [],
8
    {
9
      "include_watchonly": false
10
    }
11
  ],
12
  "id": 1
13
}'

1
const body = {
2
    jsonrpc: '2.0',
3
    method: 'simulaterawtransaction',
4
    params: [[],{"include_watchonly":false}],
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: 'simulaterawtransaction',
4
    params: [[],{"include_watchonly":false}],
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(json.loads("{\"jsonrpc\":\"2.0\",\"method\":\"simulaterawtransaction\",\"params\":[[],{\"include_watchonly\":False}],\"id\":1}"))
7
headers = {
8
  'Content-Type': 'application/json'
9
}
10

11
response = requests.request("POST", url, headers=headers, data=payload)
12

13
print(response.text)

1
import requests
2
import json
3

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

6
payload = json.dumps(json.loads("{\"jsonrpc\":\"2.0\",\"method\":\"simulaterawtransaction\",\"params\":[[],{\"include_watchonly\":False}],\"id\":1}"))
7
headers = {
8
  'Content-Type': 'application/json'
9
}
10

11
response = requests.request("POST", url, headers=headers, data=payload)
12

13
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: "simulaterawtransaction",
11
  params: [[],{"include_watchonly":false}]
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: "simulaterawtransaction",
11
  params: [[],{"include_watchonly":false}]
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
  "result": {
3
    "balance_change": 0
4
  },
5
  "error": null,
6
  "id": 1
7
}

1
{
2
  "result": {
3
    "balance_change": 0
4
  },
5
  "error": null,
6
  "id": 1
7
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free