eth_getBlockByNumber
Return a block by number or tag.
Base mainnet, chain ID 8453base:rpcfree — enforced matrix policy, not measured capacity or runtime publicationAvailability: unknownValidation: positive_fixture
Parameter limits
| JSON path | Frozen limit | Source |
|---|---|---|
| — | unknown | No numeric parameter ceiling is frozen; enforce the declared schema shape and deny an unknown oversized/range profile. |
Historical block retrieval is not an archive-state guarantee. Selectors must be preserved; do not substitute pending, safe, or finalized with latest.
Rate limits and tier
These are enforced product-policy values, not measured upstream capacity or an SLA. Enterprise is finite, never physical “unlimited” capacity.
| Tier | Limit / access | Category |
|---|---|---|
| Free | 10 RPS | base_read_rpc |
| Basic | 20 RPS | base_read_rpc |
| Pro | 100 RPS | base_read_rpc |
| Business | 250 RPS | base_read_rpc |
| Enterprise | 250 RPS | base_read_rpc |
See Base limits.
Errors
| Code | Meaning here | Client action |
|---|---|---|
-32602 | Parameters fail the declared schema or upstream parser. | Fix the positional parameters; parser acceptance is not execution success. |
-32003 | The enforced category/provider budget is exhausted. | Honor Retry-After; no capacity SLA is implied. |
Authentication/transport failures use the shared client error envelope. See Base errors.
Evidence
- Fixture kind:
positive_fixture. - Fixture source:
infra-4-sety/integration-base/research/R04/measurement/FIXTURES.jsonat/fixtures/3. - Fixture SHA-256:
eaef6dd7f176296a03d46f351e0378a8ea073e39d53f9ab49e256f69048b3e66. - Fixture registry:
infra-4-sety/integration-base/research/R04/measurement/FIXTURES.json. - Semantic assertion: non-null sealed block header with number/hash/parent/stateRoot/timestamp and hash transactions
- Source UTC:
2026-09-08T13:27:42.173Z. - Evidence boundary: only the frozen fixture assertion is reusable; it is not blanket provider or deployment evidence.
Limitations
- Availability is the frozen baseline, not deployed readiness. documented is the contract floor; evidence_kind retains unknown/source_summary.