# Etherscan — Zapi reference

> Current gas price tiers and base fee, from Etherscan's V2 multichain API.

**Base URL:** `https://api.zpi.web.id`
**Auth:** Send `x-api-key: YOUR_KEY` header on every request. Get a free key at https://zpi.web.id/dashboard/keys.
**Response envelope:** `{ content, message, errors }`
**Rate limit:** 60 req/min on free tier.

**Related:**
- Detail page: https://zpi.web.id/api/finance/etherscan
- Endpoint catalog: https://zpi.web.id/category/finance
- Concise index: https://zpi.web.id/llms.txt
- Full reference: https://zpi.web.id/llms-full.txt

---

## Etherscan

**Category:** finance · **Slug:** `etherscan`
**Detail page:** https://zpi.web.id/api/finance/etherscan

Current gas price tiers and base fee, from Etherscan's V2 multichain API.

**Tags:** finance, etherscan

### Gas Oracle

Current gas price tiers and base fee, from Etherscan's V2 multichain API.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/finance:etherscan/gas-oracle`
- **Cache TTL:** 30s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `chainId` | number | query | no | Chain selector. 1 is Ethereum mainnet, 137 Polygon; both serve this oracle without credentials. |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/finance:etherscan/gas-oracle?chainId=1" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/finance:etherscan/gas-oracle?chainId=1", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/finance:etherscan/gas-oracle?chainId=1",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "unit": "gwei",
  "chainId": 1,
  "dataset": "gas-oracle",
  "provider": "etherscan",
  "lastBlock": 25800500,
  "fastGasPrice": 0.227841836,
  "gasUsedRatio": [
    0.862360183333333,
    0.946595916666667,
    0.3724444,
    0.445706816666667,
    0.753381933333333
  ],
  "safeGasPrice": 0.16983154,
  "suggestBaseFee": 0.16983154,
  "proposeGasPrice": 0.17083154
}
```

---


_Generated: 2026-08-21T07:32:55.129Z_