Estimate gas price
GET/estimate_gas_price
Gives an estimate of the gas unit price required to get a transaction on chain in a reasonable amount of time. The gas unit price is the amount that each transaction commits to pay for each unit of gas consumed in executing the transaction. The estimate is based on recent history: it gives the minimum gas that would have been required to get into recent blocks, for blocks that were full. (When blocks are not full, the estimate will match the minimum gas unit price.)
The estimation is given in three values: de-prioritized (low), regular, and prioritized (aggressive). Using a more aggressive value increases the likelihood that the transaction will make it into the next block; more aggressive values are computed with a larger history and higher percentile statistics. More details are in AIP-34.
Responses
- 200
- 400
- 403
- 500
- 503
Response Headers
X-APTOS-CHAIN-ID
integer
Chain ID of the current chain
X-APTOS-LEDGER-VERSION
integer
Current ledger version of the chain
X-APTOS-LEDGER-OLDEST-VERSION
integer
Oldest non-pruned ledger version of the chain
X-APTOS-LEDGER-TIMESTAMPUSEC
integer
Current timestamp of the chain
X-APTOS-EPOCH
integer
Current epoch of the chain
X-APTOS-BLOCK-HEIGHT
integer
Current block height of the chain
X-APTOS-OLDEST-BLOCK-HEIGHT
integer
Oldest non-pruned block height of the chain
X-APTOS-GAS-USED
integer
The cost of the call in terms of gas
X-APTOS-CURSOR
string
Cursor to be used for endpoints that support cursor-based pagination. Pass this to the
start
field of the endpoint on the next call to get the next page of results.
- application/json
- application/x-bcs
- Schema
- Example (from schema)
Schema
The deprioritized estimate for the gas unit price
The current estimate for the gas unit price
The prioritized estimate for the gas unit price
{
"deprioritized_gas_estimate": 0,
"gas_estimate": 0,
"prioritized_gas_estimate": 0
}
- Schema
- Example (from schema)
Schema
Array [
]
integer
[
0
]
Response Headers
X-APTOS-CHAIN-ID
integer
Chain ID of the current chain
X-APTOS-LEDGER-VERSION
integer
Current ledger version of the chain
X-APTOS-LEDGER-OLDEST-VERSION
integer
Oldest non-pruned ledger version of the chain
X-APTOS-LEDGER-TIMESTAMPUSEC
integer
Current timestamp of the chain
X-APTOS-EPOCH
integer
Current epoch of the chain
X-APTOS-BLOCK-HEIGHT
integer
Current block height of the chain
X-APTOS-OLDEST-BLOCK-HEIGHT
integer
Oldest non-pruned block height of the chain
X-APTOS-GAS-USED
integer
The cost of the call in terms of gas
- application/json
- Schema
- Example (from schema)
Schema
A message describing the error
These codes provide more granular error information beyond just the HTTP status code of the response.
Possible values: [account_not_found
, resource_not_found
, module_not_found
, struct_field_not_found
, version_not_found
, transaction_not_found
, table_item_not_found
, block_not_found
, state_value_not_found
, version_pruned
, block_pruned
, invalid_input
, invalid_transaction_update
, sequence_number_too_old
, vm_error
, health_check_failed
, mempool_is_full
, internal_error
, web_framework_error
, bcs_not_supported
, api_disabled
]
A code providing VM error details when submitting transactions to the VM
{
"message": "string",
"error_code": "account_not_found",
"vm_error_code": 0
}
Response Headers
X-APTOS-CHAIN-ID
integer
Chain ID of the current chain
X-APTOS-LEDGER-VERSION
integer
Current ledger version of the chain
X-APTOS-LEDGER-OLDEST-VERSION
integer
Oldest non-pruned ledger version of the chain
X-APTOS-LEDGER-TIMESTAMPUSEC
integer
Current timestamp of the chain
X-APTOS-EPOCH
integer
Current epoch of the chain
X-APTOS-BLOCK-HEIGHT
integer
Current block height of the chain
X-APTOS-OLDEST-BLOCK-HEIGHT
integer
Oldest non-pruned block height of the chain
X-APTOS-GAS-USED
integer
The cost of the call in terms of gas
- application/json
- Schema
- Example (from schema)
Schema
A message describing the error
These codes provide more granular error information beyond just the HTTP status code of the response.
Possible values: [account_not_found
, resource_not_found
, module_not_found
, struct_field_not_found
, version_not_found
, transaction_not_found
, table_item_not_found
, block_not_found
, state_value_not_found
, version_pruned
, block_pruned
, invalid_input
, invalid_transaction_update
, sequence_number_too_old
, vm_error
, health_check_failed
, mempool_is_full
, internal_error
, web_framework_error
, bcs_not_supported
, api_disabled
]
A code providing VM error details when submitting transactions to the VM
{
"message": "string",
"error_code": "account_not_found",
"vm_error_code": 0
}
Response Headers
X-APTOS-CHAIN-ID
integer
Chain ID of the current chain
X-APTOS-LEDGER-VERSION
integer
Current ledger version of the chain
X-APTOS-LEDGER-OLDEST-VERSION
integer
Oldest non-pruned ledger version of the chain
X-APTOS-LEDGER-TIMESTAMPUSEC
integer
Current timestamp of the chain
X-APTOS-EPOCH
integer
Current epoch of the chain
X-APTOS-BLOCK-HEIGHT
integer
Current block height of the chain
X-APTOS-OLDEST-BLOCK-HEIGHT
integer
Oldest non-pruned block height of the chain
X-APTOS-GAS-USED
integer
The cost of the call in terms of gas
- application/json
- Schema
- Example (from schema)
Schema
A message describing the error
These codes provide more granular error information beyond just the HTTP status code of the response.
Possible values: [account_not_found
, resource_not_found
, module_not_found
, struct_field_not_found
, version_not_found
, transaction_not_found
, table_item_not_found
, block_not_found
, state_value_not_found
, version_pruned
, block_pruned
, invalid_input
, invalid_transaction_update
, sequence_number_too_old
, vm_error
, health_check_failed
, mempool_is_full
, internal_error
, web_framework_error
, bcs_not_supported
, api_disabled
]
A code providing VM error details when submitting transactions to the VM
{
"message": "string",
"error_code": "account_not_found",
"vm_error_code": 0
}
Response Headers
X-APTOS-CHAIN-ID
integer
Chain ID of the current chain
X-APTOS-LEDGER-VERSION
integer
Current ledger version of the chain
X-APTOS-LEDGER-OLDEST-VERSION
integer
Oldest non-pruned ledger version of the chain
X-APTOS-LEDGER-TIMESTAMPUSEC
integer
Current timestamp of the chain
X-APTOS-EPOCH
integer
Current epoch of the chain
X-APTOS-BLOCK-HEIGHT
integer
Current block height of the chain
X-APTOS-OLDEST-BLOCK-HEIGHT
integer
Oldest non-pruned block height of the chain
X-APTOS-GAS-USED
integer
The cost of the call in terms of gas
- application/json
- Schema
- Example (from schema)
Schema
A message describing the error
These codes provide more granular error information beyond just the HTTP status code of the response.
Possible values: [account_not_found
, resource_not_found
, module_not_found
, struct_field_not_found
, version_not_found
, transaction_not_found
, table_item_not_found
, block_not_found
, state_value_not_found
, version_pruned
, block_pruned
, invalid_input
, invalid_transaction_update
, sequence_number_too_old
, vm_error
, health_check_failed
, mempool_is_full
, internal_error
, web_framework_error
, bcs_not_supported
, api_disabled
]
A code providing VM error details when submitting transactions to the VM
{
"message": "string",
"error_code": "account_not_found",
"vm_error_code": 0
}