# eth_feeHistory：參數、傳回值與 CU

> Source: https://docs.blockvectra.com/zh-hant/api/json-rpc/methods/eth_feeHistory/

## 用途

傳回一段區塊範圍內的歷史 base fee、gas 使用率以及可選的優先費分位數。

## 計算單位（CU）與價格

- 單次呼叫 CU: 10 CU
- 每百萬次呼叫價格（USD）: $1.00

## 參數

| 參數名 | 類型 | 說明 |
| --- | --- | --- |
| `blockCount` | `QUANTITY` | 要查詢的區塊數量，0x 十六進位數量。 |
| `newestBlock` | `QUANTITY\|TAG` | 範圍中最新的區塊高度或標籤，例如 latest。 |
| `rewardPercentiles` | `ARRAY` | 可選，按升序排列的 0 到 100 的百分位陣列，用於計算每個區塊的優先費分位數。 |

## 傳回值

- **類型**: `object`
- **說明**: 物件，包含 oldestBlock、baseFeePerGas（長度比 blockCount 多 1 的陣列）、gasUsedRatio，以及傳入 rewardPercentiles 時的 reward 二維陣列。

## 注意事項

這是 EIP-1559 的費用歷史介面；不傳 rewardPercentiles 時結果中不含 reward。

## 請求範例

```bash
export BLOCKVECTRA_API_KEY=rgw_your_api_key

curl -X POST "https://api.blockvectra.com/v1/robinhood_mainnet" \
  -H 'Content-Type: application/json' \
  -H "x-api-key: $BLOCKVECTRA_API_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_feeHistory",
    "params": [
      "<blockCount>",
      "latest",
      []
    ],
    "id": 1
  }'
```

## 可用鏈

全部 9 條支援鏈均可用。