EthereumScan帮助文档

# 气体追踪器(Gas Tracker)

# 引入模组

from ethereum_scan.features.obj import Key, Accounts

# 获取估计的确认时间

# 方法说明

该方法返回在区块链上确认交易的估计时间（以秒为单位）。

# 参数说明

参数 描述 参数类型 是否必须 默认值
gas_price 每单位天然气支付的价格，以wei string 是 无

# 示例代码

from ethereum_scan.features.obj import Key, GasTracker
# 实例化密钥类
key = Key(api_key="你申请的API-KEY")
# 实例化气体追踪器类
gas_tracker = GasTracker(key)
# 获取确认时间
confirmation_time = gas_tracker.get_estimation_of_confirmation_time(gas_price="Gas价格")
# 打印确认时间
print(confirmation_time)

# 运行结果

9453

提示

结果以秒为单位返回。

# 获取Gas预估

提示

EIP-1159更改:

  • 安全/提议/快速的汽油价格建议现在被建模为优先费用
  • 新字段suggestBaseFee, 下一个待处理块的 baseFee
  • 新字段gasUsedRatio, 用于估计网络的繁忙程度

详细了解EIP-1159 (opens new window)中的Gas变化

# 方法说明

该方法返回当前的 Safe、Proposed 和 Fast gas 价格。

# 参数说明

该方法无参数

# 示例代码

from ethereum_scan.features.obj import Key, GasTracker
# 实例化密钥类
key = Key(api_key="你申请的API-KEY")
# 实例化气体追踪器类
gas_tracker = GasTracker(key)
# 获取Gas预估
gas_oracle = gas_tracker.get_gas_oracle()
# 打印Gas预估
print(gas_oracle)

# 运行结果

{
    "LastBlock":"13053741",
    "SafeGasPrice":"20",
    "ProposeGasPrice":"22",
    "FastGasPrice":"24",
    "suggestBaseFee":"19.230609716",
    "gasUsedRatio":"0.370119078777807,0.8954731,0.550911766666667,0.212457033333333,0.552463633333333"
}

提示

gas 价格以Gwei返回

# 获取每日平均 Gas 限制

PRO

PRO用户可调用

# 方法说明

该方法返回以太坊网络的历史每日平均 gas 限制。

# 参数说明

参数 描述 参数类型 是否必须 默认值
start_date 开始日期，格式为YY-MM-DD string 是 无
end_date 结束日期, 格式为YY-MM-DD string 是 无
sort 排序方式, 分别为: 升序排序(asc), 降序排序(desc) string 否 asc

# 示例代码

from ethereum_scan.features.obj import Key, GasTracker
# 实例化密钥类
key = Key(api_key="你申请的API-KEY")
# 实例化气体追踪器类
gas_tracker = GasTracker(key)
# 每日平均 Gas 限制
data_list = gas_tracker.get_daily_average_gas_limit(start_date="开始日期", end_date="结束日期")
# 遍历数据列表
for i in data_list:
    print(i)

# 运行结果

{
    "UTCDate":"2019-02-01",
    "unixTimeStamp":"1548979200",
    "gasLimit":"8001360"
},
{
    "UTCDate":"2019-02-27",
    "unixTimeStamp":"1551225600",
    "gasLimit":"8001071"
},
{
    "UTCDate":"2019-02-28",
    "unixTimeStamp":"1551312000",
    "gasLimit":"8001137"
}

# 获取以太坊每日总 Gas 量

PRO

PRO用户可调用

# 方法说明

该方法返回以太坊网络上每天用于交易的 gas 总量。

# 参数说明

参数 描述 参数类型 是否必须 默认值
start_date 开始日期，格式为YY-MM-DD string 是 无
end_date 结束日期, 格式为YY-MM-DD string 是 无
sort 排序方式, 分别为: 升序排序(asc), 降序排序(desc) string 否 asc

# 示例代码

from ethereum_scan.features.obj import Key, GasTracker
# 实例化密钥类
key = Key(api_key="你申请的API-KEY")
# 实例化气体追踪器类
gas_tracker = GasTracker(key)
# 获取每日总Gas量
data_list = gas_tracker.get_ethereum_daily_total_gas_used(start_date="开始日期", end_date="结束日期")
# 遍历数据列表
for i in data_list:
    print(i)

# 运行结果

{
    "UTCDate":"2019-02-01",
    "unixTimeStamp":"1548979200",
    "gasUsed":"32761450415"
},
{
    "UTCDate":"2019-02-27",
    "unixTimeStamp":"1551225600",
    "gasUsed":"32657440136"
},
{
    "UTCDate":"2019-02-28",
    "unixTimeStamp":"1551312000",
    "gasUsed":"33081119561"
}

# 获取每日平均 Gas 价格

PRO

PRO用户可调用

# 方法说明

该方法返回以太坊网络上使用的每日平均 gas 价格。

# 参数说明

参数 描述 参数类型 是否必须 默认值
start_date 开始日期，格式为YY-MM-DD string 是 无
end_date 结束日期, 格式为YY-MM-DD string 是 无
sort 排序方式, 分别为: 升序排序(asc), 降序排序(desc) string 否 asc

# 示例代码

from ethereum_scan.features.obj import Key, GasTracker
# 实例化密钥类
key = Key(api_key="你申请的API-KEY")
# 实例化气体追踪器类
gas_tracker = GasTracker(key)
# 获取每日平均Gas价格列表
data_list = gas_tracker.get_daily_average_gas_price(start_date="开始日期", end_date="结束日期")
# 遍历数据列表
for i in data_list:
    print(i)

# 运行结果

{
    "UTCDate":"2019-02-01",
    "unixTimeStamp":"1548979200",
    "maxGasPrice_Wei":"60814303896257",
    "minGasPrice_Wei":"432495",
    "avgGasPrice_Wei":"13234562600"
},
{
    "UTCDate":"2019-02-27",
    "unixTimeStamp":"1551225600",
    "maxGasPrice_Wei":"42000000000000",
    "minGasPrice_Wei":"1000000",
    "avgGasPrice_Wei":"16334617513"
},
{
    "UTCDate":"2019-02-28",
    "unixTimeStamp":"1551312000",
    "maxGasPrice_Wei":"237222222222257",
    "minGasPrice_Wei":"100000000",
    "avgGasPrice_Wei":"18834674068"
}

← 统计(Stats) →