ETHGas API Documentation

The End of Latency. The Beginning of Realtime.

Welcome to the ETHGas API docs! This is your gateway to building on the real-time infrastructure layer for Ethereum's blockspace economy.

🚀 What is ETHGas?

ETHGas transforms Ethereum's chaotic gas markets into a structured, liquid, and tradable asset class. We're building the foundational financial market for Ethereum's blockspace - turning gas from a volatile friction point into a new asset class.

For Developers Like You

🎯 Build Better dApps

• Gas abstraction for seamless user experiences
• Predictable transaction costs
• Real-time gas price feeds

⚡ Trade Blockspace

• Whole block markets for MEV opportunities
• Inclusion preconf markets for gas price trading
• Professional-grade APIs and WebSocket feeds

🔧 Integrate with Validators

• Automated fee optimization
• Builder infrastructure
• Validator delegation tools

🛠️ Quick Start

1. Choose Your Environment

# TestNet (Recommended for development)
API: https://hoodi.app.ethgas.com/api
WS:  wss://hoodi.app.ethgas.com/ws

# MainNet (Production)
API: https://mainnet.app.ethgas.com/api  
WS:  wss://mainnet.app.ethgas.com/ws

2. Authenticate

import requests

# Get login message
response = requests.post('https://hoodi.app.ethgas.com/api/v1/user/login', 
                        params={'addr': '0x...'})

# Sign and verify (see docs for full flow)
# Get your JWT access token

3. Start Building

# Get market data
markets = requests.get('https://hoodi.app.ethgas.com/api/v1/p/wholeblock/markets')

# Place orders (authenticated)
headers = {'Authorization': f'Bearer {access_token}'}
order = requests.post('https://hoodi.app.ethgas.com/api/v1/wholeblock/order', 
                     headers=headers, json=order_data)

📚 Documentation

Core APIs

• REST API - Complete HTTP API reference
• WebSocket API - Real-time data streams
• Authentication - JWT-based auth flow

Trading

• Whole Block Markets - Trade entire blocks
• Inclusion Preconf - Gas price trading
• Market Data - Public market information

Integration

• Builder Tools - Block building infrastructure
• Validator Integration - Validator operations
• Bundle Submission - Transaction bundles

🛠️ Development

Local Setup

git clone <repository-url>
cd ETHGas_Docs
npm install
npm start

Open http://localhost:3002 to view the docs locally.

Build for Production

npm run build

🤝 Contributing

Help us improve the docs! Found a bug or have a suggestion? We'd love your input.

📞 Support

• TestNet App: testnet.ethgas.com
• ETHGas Homepage: ethgas.com
• Community: Join our Discord for real-time support

---

Building the real-time infrastructure for Ethereum's economy.