ToolAssay

Block by timestamp from DefiLlama — the closest block number to a unix timestamp

Block by timestamp from DefiLlama — the closest block number to a unix timestamp on a given chain.

Answeringour last check, 2026-09-24
1 of 1checks answered this week
600 msmedian answer time
$0.005listed price per call
$0.005price it asked us

Paid test badge: not yet. The checks above are free: we call the tool without paying and read the payment request it sends back. The Verified badge needs paid calls whose answers match the promised output, and nobody can buy a badge.

Endpoint

GET https://defillama.use.x402atlas.com/block

CategoryEverything else
Provider hostdefillama.use.x402atlas.com
Networkseip155:137, eip155:42161, eip155:8453, solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp
Payment schemesexact
Self-reported calls, 30 days2 from 1 payers (the provider's figure, not ours)

Our checks, last 30 days

DayResultHTTPAskedTime
2026-09-24 valid payment request 402$0.005 600 ms

Example input (from the provider)

{
  "method": "GET",
  "queryParams": {
    "chain": "ethereum",
    "timestamp": "1650000000"
  },
  "type": "http"
}

Promised output schema (from the provider)

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "method": {
          "enum": [
            "GET"
          ],
          "type": "string"
        },
        "queryParams": {
          "properties": {
            "chain": {
              "description": "Chain name (e.g. ethereum, arbitrum, polygon); no slashes or query characters",
              "maxLength": 100,
              "minLength": 1,
              "pattern": "^[^/?#]+$",
              "type": "string"
            },
            "timestamp": {
              "description": "Unix timestamp (seconds, digits only) to find the closest block for",
              "maxLength": 20,
              "minLength": 1,
              "pattern": "^[0-9]+$",
              "type": "string"
            }
          },
          "required": [
            "chain",
            "timestamp"
          ],
          "type": "object"
        },
        "type": {
          "const": "http",
          "type": "string"
        }
      },
      "required": [
        "type",
        "method"
      ],
      "type": "object"
    },
    "output": {
      "properties": {
        "example": {
          "properties": {
            "data": {
              "properties": {
                "height": {
                  "description": "Block height closest to the requested timestamp",
                  "type": "integer"
                },
                "timestamp": {
                  "description": "Unix timestamp (seconds) of that block",
                  "type": "integer"
                }
              },
              "type": "object"
            },
            "queried_at": {
              "description": "When this bridge fetched the upstream data",
              "format": "date-time",
              "type": "string"
            }
          },
          "required": [
            "queried_at",
            "data"
          ],
          "type": "object"
        },
        "type": {
          "type": "string"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    }
  },
  "required": [
    "input"
  ],
  "type": "object"
}

This page as JSON