# eth_getBlockByNumber：参数、返回值与 CU

> 原文地址: https://docs.blockvectra.com/zh/api/json-rpc/methods/eth_getBlockByNumber/

## 用途

按区块高度获取区块，可选择是否返回完整交易对象。

## 计算单位（CU）与价格

CU 权重、价格与各链可用状态见方法页： https://docs.blockvectra.com/zh/api/json-rpc/methods/eth_getBlockByNumber/

## 参数

| 参数名 | 类型 | 说明 |
| --- | --- | --- |
| `blockParameter` | `QUANTITY\|TAG` | 区块高度或标签：latest、earliest、pending、safe、finalized。 |
| `fullTransactions` | `boolean` | 为 true 时返回完整的交易对象，为 false 时只返回交易哈希列表。 |

## 返回值

- **类型**: `OBJECT|NULL`
- **说明**: 区块对象，含区块头字段与交易列表；区块不存在时返回 null。

## 注意事项

latest、pending、safe、finalized 这些标签指向的区块会随链推进而变化。

## 请求示例

```bash
curl -X POST "https://dev-api.blockvectra.network/v1/robinhood_mainnet" \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: <api_key>' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getBlockByNumber",
    "params": [
      "latest",
      false
    ],
    "id": 1
  }'
```
