# eth_getBlockByNumber: parâmetros, retornos e CU

> Source: https://docs.blockvectra.com/pt-br/api/json-rpc/methods/eth_getBlockByNumber/

## Visão geral

Retorne um bloco pelo seu número, opcionalmente com objetos completos de transação.

## Unidades de computação (CU) e preços

- CU por chamada: 5 CU
- Preço por 1M de chamadas (USD): $0.50

## Parâmetros

| Parâmetro | Tipo | Descrição |
| --- | --- | --- |
| `blockParameter` | `QUANTITY\|TAG` | Número ou tag de bloco: latest, earliest, pending, safe ou finalized. |
| `fullTransactions` | `boolean` | true retorna objetos de transação completos; false retorna apenas a lista de hashes de transação. |

## Retornos

- **Tipo**: `OBJECT|NULL`
- **Descrição**: Objeto de bloco com campos de cabeçalho e lista de transações; null quando o bloco não for encontrado.

## Observações

Os blocos representados pelas tags latest, pending, safe e finalized mudam conforme a rede avança.

## Exemplo de requisição

```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_getBlockByNumber",
    "params": [
      "latest",
      false
    ],
    "id": 1
  }'
```

## Redes suportadas

Disponível em todas as 9 redes compatíveis.