---
title: "GET /v4/block-timestamp/bounds"
method: GET
path: "/v4/block-timestamp/bounds"
tags: ["Block Timestamp"]
---

# GET /v4/block-timestamp/bounds

`GET /v4/block-timestamp/bounds`

Get the closest lower and upper bound blocks for a given timestamp from BlockTimestampMapping

## Query parameters

- `chainId` number, required — Chain ID
- `timestamp` number, required — Unix timestamp

## Response `200`

Response for status 200

- object
  - `lower` object, required — Closest block with timestamp <= target
    - `blockNumber` number, required — Block number
    - `timestamp` number, required — Unix timestamp
  - `upper` object, required — Closest block with timestamp >= target
    - `blockNumber` number, required — Block number
    - `timestamp` number, required — Unix timestamp
  - `exactMatch` boolean, required — True when lower and upper are the same block

---

[API](https://skmtc.dev/merkl/apis/merkl-api.md) · [All operations](https://skmtc.dev/merkl/apis/merkl-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/merkl/merkl-api/revisions/a7e5b9f6fb5f/schema)