get

/v4/analytics/positions/at/{storingId}

Get closest position states at a timestamp

Return the closest position state(s) to a Unix timestamp for a storingId.

order=DESC (default) returns the last state at or before the timestamp; order=ASC returns the first state at or after it.

Each entry mirrors the gRPC StateV2 shape, so the response carries the raw state blob unmodified.

Examples:
- Latest state ≤ T: GET /v4/analytics/positions/at/<storingId>?timestamp=1748635620
- First state ≥ T: GET /v4/analytics/positions/at/<storingId>?timestamp=1748635620&order=ASC
- One specific user: GET /v4/analytics/positions/at/<storingId>?timestamp=1748635620&positionKey=0xUser

Path parameters

storingIdstring

required

Query parameters

timestampnumber | string

required

orderenum

required

default: DESC

ASCDESC

positionKeystring

positionGranularityKeystring

Responses

200

Response for status 200

Schema

object

statesobject[]

required

Closest state(s) at or near the requested timestamp, one entry per position

blockNumbernumber

blockTimestampnumber

storingIdstring

positionKeystring

ownerstring

positionGranularityKeystring

stateobject

txHashesstring[]

Example

{
  "states": [
    {
      "blockNumber": 0,
      "blockTimestamp": 0,
      "storingId": "string",
      "positionKey": "string",
      "owner": "string",
      "positionGranularityKey": "string",
      "state": {},
      "txHashes": [
        "string"
      ]
    }
  ]
}

get

https://analytics.merkl.xyz/v4/analytics/positions/at/{storingId}

Merkl Analytics API

curl -X GET "https://analytics.merkl.xyz/v4/analytics/positions/at/{storingId}"

Fill the required path parameter storingId to send.