Parameters

transaction

object

The transaction call object:

from

string

The address from which the transaction is sent

to

string

REQUIRED

The address to which the transaction is addressed

gas

string

The integer of gas provided for the transaction execution

gasPrice

string

The integer of gasPrice used for each paid gas encoded as hexadecimal

value

string

The integer of value sent with this transaction encoded as hexadecimal

data

string

The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation.

blockNumber

string

The block number in hexadecimal format or the tags(latest or pending)

Object

object

The State Override Set option allows you to change the state of a contract before executing the call, which means you can modify the values of variables stored in the contract, such as balances and approvals for that call without actually modifying the contract. Each address maps to an object containing:

balance

string

The fake balance to set for the account before executing the call

nonce

string

The fake nonce to set for the account before executing the call

code

string

The fake EVM bytecode to inject into the account before executing the call

state

object

The fake key-value mapping to override all slots in the account storage before executing the call

stateDiff

integer

The fake key-value mapping to override individual slots in the account storage before executing the call

Returns

quantity

The estimated amount of gas used

Request

1
curl -X POST "https://docs-demo.matic.quiknode.pro/" \
2
  -H "Content-Type: application/json" \
3
  -d '{
4
  "jsonrpc": "2.0",
5
  "method": "eth_estimateGas",
6
  "params": [
7
    {
8
      "from": "0x8D97689C9818892B700e27F316cc3E41e17fBeb9",
9
      "to": "0xd3CdA913deB6f67967B99D67aCDFa1712C293601",
10
      "value": "0x186a0",
11
      "data": "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"
12
    },
13
    "latest"
14
  ],
15
  "id": 1
16
}'

1
curl -X POST "https://docs-demo.matic.quiknode.pro/" \
2
  -H "Content-Type: application/json" \
3
  -d '{
4
  "jsonrpc": "2.0",
5
  "method": "eth_estimateGas",
6
  "params": [
7
    {
8
      "from": "0x8D97689C9818892B700e27F316cc3E41e17fBeb9",
9
      "to": "0xd3CdA913deB6f67967B99D67aCDFa1712C293601",
10
      "value": "0x186a0",
11
      "data": "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"
12
    },
13
    "latest"
14
  ],
15
  "id": 1
16
}'

1
import { ethers } from "ethers";
2

3
async function main() {
4
    const provider = new ethers.JsonRpcProvider("https://docs-demo.matic.quiknode.pro/");
5
    const response = await provider.send("eth_estimateGas", [
6
    {
7
        "from": "0x8D97689C9818892B700e27F316cc3E41e17fBeb9",
8
        "to": "0xd3CdA913deB6f67967B99D67aCDFa1712C293601",
9
        "value": "0x186a0",
10
        "data": "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"
11
    },
12
    "latest"
13
]);
14
    console.log(response);
15
}
16

17
main();

1
import { ethers } from "ethers";
2

3
async function main() {
4
    const provider = new ethers.JsonRpcProvider("https://docs-demo.matic.quiknode.pro/");
5
    const response = await provider.send("eth_estimateGas", [
6
    {
7
        "from": "0x8D97689C9818892B700e27F316cc3E41e17fBeb9",
8
        "to": "0xd3CdA913deB6f67967B99D67aCDFa1712C293601",
9
        "value": "0x186a0",
10
        "data": "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"
11
    },
12
    "latest"
13
]);
14
    console.log(response);
15
}
16

17
main();

1
from web3 import Web3, HTTPProvider
2
w3 = Web3(HTTPProvider('https://docs-demo.matic.quiknode.pro/'))
3
response = w3.provider.make_request("eth_estimateGas", [{"from":"0x8D97689C9818892B700e27F316cc3E41e17fBeb9","to":"0xd3CdA913deB6f67967B99D67aCDFa1712C293601","value":"0x186a0","data":"0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"},"latest"])
4
print(response)

1
from web3 import Web3, HTTPProvider
2
w3 = Web3(HTTPProvider('https://docs-demo.matic.quiknode.pro/'))
3
response = w3.provider.make_request("eth_estimateGas", [{"from":"0x8D97689C9818892B700e27F316cc3E41e17fBeb9","to":"0xd3CdA913deB6f67967B99D67aCDFa1712C293601","value":"0x186a0","data":"0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"},"latest"])
4
print(response)

1
import { createPublicClient, http } from 'viem'
2

3
async function main() {
4
    const client = createPublicClient({
5
        transport: http('https://docs-demo.matic.quiknode.pro/')
6
    })
7

8
    const result = await client.request({
9
        method: 'eth_estimateGas',
10
        params: [
11
          {
12
            "from": "0x8D97689C9818892B700e27F316cc3E41e17fBeb9",
13
            "to": "0xd3CdA913deB6f67967B99D67aCDFa1712C293601",
14
            "value": "0x186a0",
15
            "data": "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"
16
          },
17
          "latest"
18
        ]
19
    })
20

21
    console.log(result)
22
}
23

24
main()

1
import { createPublicClient, http } from 'viem'
2

3
async function main() {
4
    const client = createPublicClient({
5
        transport: http('https://docs-demo.matic.quiknode.pro/')
6
    })
7

8
    const result = await client.request({
9
        method: 'eth_estimateGas',
10
        params: [
11
          {
12
            "from": "0x8D97689C9818892B700e27F316cc3E41e17fBeb9",
13
            "to": "0xd3CdA913deB6f67967B99D67aCDFa1712C293601",
14
            "value": "0x186a0",
15
            "data": "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"
16
          },
17
          "latest"
18
        ]
19
    })
20

21
    console.log(result)
22
}
23

24
main()

1
import { QuicknodeSdk } from '@quicknode/sdk'
2

3
const qn = new QuicknodeSdk({})
4

5
const result = await qn.rpc.call(
6
  'eth_estimateGas',
7
  [
8
  {
9
    "from": "0x8D97689C9818892B700e27F316cc3E41e17fBeb9",
10
    "to": "0xd3CdA913deB6f67967B99D67aCDFa1712C293601",
11
    "value": "0x186a0",
12
    "data": "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"
13
  },
14
  "latest"
15
],
16
  undefined,
17
  'https://docs-demo.matic.quiknode.pro/'
18
)
19

20
console.log(result)

1
import { QuicknodeSdk } from '@quicknode/sdk'
2

3
const qn = new QuicknodeSdk({})
4

5
const result = await qn.rpc.call(
6
  'eth_estimateGas',
7
  [
8
  {
9
    "from": "0x8D97689C9818892B700e27F316cc3E41e17fBeb9",
10
    "to": "0xd3CdA913deB6f67967B99D67aCDFa1712C293601",
11
    "value": "0x186a0",
12
    "data": "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"
13
  },
14
  "latest"
15
],
16
  undefined,
17
  'https://docs-demo.matic.quiknode.pro/'
18
)
19

20
console.log(result)

1
import asyncio
2
from quicknode_sdk import QuicknodeSdk, SdkFullConfig
3

4
async def main():
5
    qn = QuicknodeSdk(SdkFullConfig(api_key=None))
6
    result = await qn.rpc.call(
7
        "eth_estimateGas",
8
        [
9
            {
10
                "from": "0x8D97689C9818892B700e27F316cc3E41e17fBeb9",
11
                "to": "0xd3CdA913deB6f67967B99D67aCDFa1712C293601",
12
                "value": "0x186a0",
13
                "data": "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"
14
            },
15
            "latest"
16
        ],
17
        endpoint_url="https://docs-demo.matic.quiknode.pro/",
18
    )
19
    print(result)
20

21
asyncio.run(main())

1
import asyncio
2
from quicknode_sdk import QuicknodeSdk, SdkFullConfig
3

4
async def main():
5
    qn = QuicknodeSdk(SdkFullConfig(api_key=None))
6
    result = await qn.rpc.call(
7
        "eth_estimateGas",
8
        [
9
            {
10
                "from": "0x8D97689C9818892B700e27F316cc3E41e17fBeb9",
11
                "to": "0xd3CdA913deB6f67967B99D67aCDFa1712C293601",
12
                "value": "0x186a0",
13
                "data": "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"
14
            },
15
            "latest"
16
        ],
17
        endpoint_url="https://docs-demo.matic.quiknode.pro/",
18
    )
19
    print(result)
20

21
asyncio.run(main())

1
require "quicknode_sdk"
2

3
qn = QuicknodeSdk::SDK.from_config(api_key: nil)
4

5
result = qn.rpc.call(
6
  method: "eth_estimateGas",
7
  params: [
8
    {
9
      "from" => "0x8D97689C9818892B700e27F316cc3E41e17fBeb9",
10
      "to" => "0xd3CdA913deB6f67967B99D67aCDFa1712C293601",
11
      "value" => "0x186a0",
12
      "data" => "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"
13
    },
14
    "latest"
15
  ],
16
  endpoint_url: "https://docs-demo.matic.quiknode.pro/"
17
)
18

19
puts result

1
require "quicknode_sdk"
2

3
qn = QuicknodeSdk::SDK.from_config(api_key: nil)
4

5
result = qn.rpc.call(
6
  method: "eth_estimateGas",
7
  params: [
8
    {
9
      "from" => "0x8D97689C9818892B700e27F316cc3E41e17fBeb9",
10
      "to" => "0xd3CdA913deB6f67967B99D67aCDFa1712C293601",
11
      "value" => "0x186a0",
12
      "data" => "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"
13
    },
14
    "latest"
15
  ],
16
  endpoint_url: "https://docs-demo.matic.quiknode.pro/"
17
)
18

19
puts result

1
use quicknode_sdk::{QuicknodeSdk, SdkFullConfig};
2

3
#[tokio::main]
4
async fn main() -> Result<(), Box<dyn std::error::Error>> {
5
    let qn = QuicknodeSdk::new(&SdkFullConfig::keyless())?;
6
    let result = qn
7
        .rpc
8
        .call(
9
            "eth_estimateGas",
10
            Some(serde_json::json!([
11
    {
12
        "from": "0x8D97689C9818892B700e27F316cc3E41e17fBeb9",
13
        "to": "0xd3CdA913deB6f67967B99D67aCDFa1712C293601",
14
        "value": "0x186a0",
15
        "data": "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"
16
    },
17
    "latest"
18
])),
19
            None,
20
            Some("https://docs-demo.matic.quiknode.pro/".into()),
21
        )
22
        .await?;
23

24
    println!("{result}");
25
    Ok(())
26
}

1
use quicknode_sdk::{QuicknodeSdk, SdkFullConfig};
2

3
#[tokio::main]
4
async fn main() -> Result<(), Box<dyn std::error::Error>> {
5
    let qn = QuicknodeSdk::new(&SdkFullConfig::keyless())?;
6
    let result = qn
7
        .rpc
8
        .call(
9
            "eth_estimateGas",
10
            Some(serde_json::json!([
11
    {
12
        "from": "0x8D97689C9818892B700e27F316cc3E41e17fBeb9",
13
        "to": "0xd3CdA913deB6f67967B99D67aCDFa1712C293601",
14
        "value": "0x186a0",
15
        "data": "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"
16
    },
17
    "latest"
18
])),
19
            None,
20
            Some("https://docs-demo.matic.quiknode.pro/".into()),
21
        )
22
        .await?;
23

24
    println!("{result}");
25
    Ok(())
26
}

1
const body = {
2
    jsonrpc: '2.0',
3
    method: 'eth_estimateGas',
4
    params: [{"from":"0x8D97689C9818892B700e27F316cc3E41e17fBeb9","to":"0xd3CdA913deB6f67967B99D67aCDFa1712C293601","value":"0x186a0","data":"0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"},"latest"],
5
    id: 1
6
}
7

8
async function main() {
9
    const response = await fetch('https://docs-demo.matic.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: 'eth_estimateGas',
4
    params: [{"from":"0x8D97689C9818892B700e27F316cc3E41e17fBeb9","to":"0xd3CdA913deB6f67967B99D67aCDFa1712C293601","value":"0x186a0","data":"0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"},"latest"],
5
    id: 1
6
}
7

8
async function main() {
9
    const response = await fetch('https://docs-demo.matic.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.matic.quiknode.pro/"
5

6
payload = json.dumps({
7
  "jsonrpc": "2.0",
8
  "method": "eth_estimateGas",
9
  "params": [
10
    {
11
      "from": "0x8D97689C9818892B700e27F316cc3E41e17fBeb9",
12
      "to": "0xd3CdA913deB6f67967B99D67aCDFa1712C293601",
13
      "value": "0x186a0",
14
      "data": "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"
15
    },
16
    "latest"
17
  ],
18
  "id": 1
19
})
20
headers = {
21
  'Content-Type': 'application/json'
22
}
23

24
response = requests.request("POST", url, headers=headers, data=payload)
25

26
print(response.text)

1
import requests
2
import json
3

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

6
payload = json.dumps({
7
  "jsonrpc": "2.0",
8
  "method": "eth_estimateGas",
9
  "params": [
10
    {
11
      "from": "0x8D97689C9818892B700e27F316cc3E41e17fBeb9",
12
      "to": "0xd3CdA913deB6f67967B99D67aCDFa1712C293601",
13
      "value": "0x186a0",
14
      "data": "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"
15
    },
16
    "latest"
17
  ],
18
  "id": 1
19
})
20
headers = {
21
  'Content-Type': 'application/json'
22
}
23

24
response = requests.request("POST", url, headers=headers, data=payload)
25

26
print(response.text)

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

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

7
payload = {
8
  jsonrpc: "2.0",
9
  id: 1,
10
  method: "eth_estimateGas",
11
  params: [{"from":"0x8D97689C9818892B700e27F316cc3E41e17fBeb9","to":"0xd3CdA913deB6f67967B99D67aCDFa1712C293601","value":"0x186a0","data":"0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"},"latest"]
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.matic.quiknode.pro/")
6

7
payload = {
8
  jsonrpc: "2.0",
9
  id: 1,
10
  method: "eth_estimateGas",
11
  params: [{"from":"0x8D97689C9818892B700e27F316cc3E41e17fBeb9","to":"0xd3CdA913deB6f67967B99D67aCDFa1712C293601","value":"0x186a0","data":"0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"},"latest"]
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": "0x59c0"
5
}

1
{
2
  "jsonrpc": "2.0",
3
  "id": 1,
4
  "result": "0x59c0"
5
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free