Skip to main content
POST
ETH.STORE®

Authorizations

Authorization
string
header
required

Authorization header with value: Bearer YOUR_TOKEN. Refer to the API Keys section to create your API key.

Body

application/json
range
Fixed Window · object
required

Selects which ETH.STORE® daily datapoints to return.

  • Evaluation window (free): returns the most recent daily datapoints for a trailing period — 24h (the latest day), 7d, 30d, 90d, or all_time (the full history, paginated).
  • Unix timestamp, epoch, or slot range (Scale & Enterprise): returns every daily datapoint whose beaconchain-day overlaps the requested range. The range is snapped outward to whole UTC days so partial days are included in full.
chain
enum<string>
default:mainnet

The Ethereum chain to query.

Available options:
mainnet,
hoodi
cursor
string
default:""

Cursor value for pagination. See our pagination guide for more details.

page_size
integer
default:10

The number of items to return per page.

Required range: 1 <= x <= 10

Response

Successful response.

data
object[]
required

One ETH.STORE® datapoint per beaconchain-day in the requested range, ordered from most recent to oldest.

range
object
required

The time span actually covered by the returned results — from the first to the last matching data point — specified in slots, epochs, and Unix timestamps.

This reflects the data that was found, not the range that was queried. When no data is found, it falls back to the requested range, or to the full available history if no range was given.

paging
object