Updates

Get bigmap key updates

Returns updates history for the specified bigmap key.

GEThttps://xtz-index.nownodes.io/v1/bigmaps/{id}/keys/{key}/updates

Path parameters

id*integer (int32)

Bigmap Id

key*string

Either a key hash (expr123...) or a plain value (foo...). Even if the key is complex (an object or an array), you can specify it as is, for example, /keys/{"address":"tz123","nat":"123"}.

Query parameters

Response

200

Body

application/json

idinteger (int32)

Internal Id, can be used for pagination

levelinteger (int32)

Level of the block where the bigmap key was updated

timestampstring (date-time)

Timestamp of the block where the bigmap key was updated

actionnullable string

Action with the key (add_key, update_key, remove_key)

valuenullable any

Value in JSON or Micheline format, depending on the micheline query parameter. Note, if the action is remove_key it will contain the last non-null value.

Request

JavaScriptCurlPython

const response = await fetch('https://xtz-index.nownodes.io/v1/bigmaps/{id}/keys/{key}/updates', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

[
  {
    "id": 0,
    "level": 0,
    "timestamp": "2024-12-22T01:43:00.345Z",
    "action": "text"
  }
]