Updates

Get bigmap key updates

Returns updates history for the specified bigmap key.

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

Path parameters

address*string

Contract address

name*string

Bigmap name is the last piece of the bigmap storage path. For example, if the storage path is ledger or assets.ledger, then the name is ledger. If there are multiple bigmaps with the same name, for example assets.ledger and tokens.ledger, you can specify the full path.

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/contracts/{address}/bigmaps/{name}/keys/{key}/updates', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

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