Updates

Get bigmap key updates

get

Returns updates history for the specified bigmap key.

Path parameters

addressstringRequired

Contract address

namestringRequired

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.

keystringRequired

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

sortone of | nullableOptional

Sorts bigmap updates by specified field. Supported fields: id (default).

offsetone of | nullableOptional

Specifies which or how many items should be skipped

limitinteger · int32 · max: 10000Optional

Maximum number of items to return

Default: 100

michelineone ofOptional

Format of the key value: 0 - JSON, 1 - JSON string, 2 - Micheline, 3 - Micheline string

Default: Json

Responses

application/json

object[]Optional

get

HTTPcURLJavaScriptPython

GET /v1/contracts/{address}/bigmaps/{name}/keys/{key}/updates HTTP/1.1
Host: xtz-index.nownodes.io
Accept: */*

200Success

[
  {
    "id": 1,
    "level": 1,
    "timestamp": "2025-04-23T18:38:37.374Z",
    "action": "text",
    "value": null
  }
]