omni_gas_fee_gwei_usd
Calculate Ethereum transaction gas fees in Gwei and USD for ETH, ERC-20, Uniswap, and NFT transactions using EIP-1559 base and priority fees.
Instructions
Ethereum Gas Fee Estimator (Gwei, EIP-1559 & USD Cost). Calculate exact dollar transaction costs on Ethereum mainnet and L2 networks across simple transfers, ERC-20 transfers, and Uniswap smart contract swaps. Discipline: CRYPTO. Governing mathematical model / formula: Total Fee = Gas Units × (Base Fee + Priority Fee) in Gwei × (1 ETH / 10⁹ Gwei) × ETH Price.
USAGE GUIDELINES:
WHEN TO USE: Invoke for deterministic calculation of total_tx_fee_usd (Estimated Transaction Cost), total_gas_units (Gas Units Consumed), eth_burned_amount (ETH Burned by Protocol), effective_gwei_rate (Total Gas Price) using base_fee_gwei (Network Base Fee (Gwei) in Gwei), priority_fee_gwei (Priority Tip to Validator (Gwei) in Gwei), transaction_type (Transaction Complexity (1=ETH, 2=ERC20, 3=DEX Swap, 4=NFT Mint)), eth_market_price (ETH Market Price ($)). Guarantees exact machine floating-point precision, eliminating LLM arithmetic mistakes and formula hallucinations.
WHEN NOT TO USE: Do not use for qualitative evaluations or unquantified reasoning. All input parameters must be valid numerical values.
DISAMBIGUATION & BOUNDARIES:
Use this dedicated specialist tool for 'Ethereum Gas Fee Estimator (Gwei, EIP-1559 & USD Cost)' rather than generic dispatchers like omni_universal_query.
For multi-calculation chained jobs, use 'omni_batch_calculate'.
To inspect schema fields, see 'omni_describe_solver'.
BEHAVIOR & SAFETY:
Pure deterministic computation with machine floating-point precision.
Read-only, idempotent, and stateless. Zero side effects or persistent state mutations.
Input validation: All arguments are validated against physical and domain bounds. Out-of-bounds inputs return a safe diagnostic error status without throwing runtime exceptions.
RETURNS:
Structured JSON object containing:
status (string): "success" on valid execution or "error" if validation fails
calculator (string): "gas-fee-gwei-usd"
category (string): "crypto"
name (string): "Ethereum Gas Fee Estimator (Gwei, EIP-1559 & USD Cost)"
formula (string): Governing mathematical formula string
inputs (object): Echoed input parameter dictionary with applied defaults
metrics (object): Dictionary of computed outputs:
metrics.total_tx_fee_usd (Estimated Transaction Cost): Formatted display string (e.g. '$12.48 USD')
metrics.total_gas_units (Gas Units Consumed): Formatted display string (e.g. '150,000 Gas')
metrics.eth_burned_amount (ETH Burned by Protocol): Formatted display string (e.g. '0.00360 ETH')
metrics.effective_gwei_rate (Total Gas Price): Formatted display string (e.g. '26.0 Gwei')
execution_time_ms (number): Latency in milliseconds.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "omni_gas_fee_gwei_usd"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| base_fee_gwei | No | Network Base Fee (Gwei) (Gwei). Protocol algorithmic burn fee (EIP-1559). Default: 24. Min: 1. Max: 500. | |
| eth_market_price | No | ETH Market Price ($). Current ETH exchange price. Default: 3200. Min: 500. Max: 25000. | |
| transaction_type | No | Transaction Complexity (1=ETH, 2=ERC20, 3=DEX Swap, 4=NFT Mint). 1: 21k gas, 2: 65k gas, 3: 150k gas, 4: 180k gas. Default: 3. Min: 1. Max: 4. | |
| priority_fee_gwei | No | Priority Tip to Validator (Gwei) (Gwei). Miner / builder incentive tip. Default: 2. Min: 0.5. Max: 50. |