Packages

packages.versions

Every version of a package with publisher, time and the modules each upgrade added or removed.

Details

Endpoint: GET /v1/packages/:id/versions
Credits: 2
Rate class: Light. Counts against your light requests per second.

Lists each version of the package family that the given id belongs to, with the version's package id, publish or upgrade digest, checkpoint, time (unix seconds), the address that sent it, its modules and the modules added or removed against the previous version. Any version id works as input. Version 1 is the publish, later versions are upgrades. Time, sender and digest come from the index and are null for a version it has not seen.

Parameters

Name	Type	Description
idrequired	string	Package id (0x...), any version of the family.
order	string	Version order. Default desc (newest first).One of "asc", "desc".
limit	integer	Versions per page. Default 50.From 1 to 200.
cursor	string	Opaque cursor from the previous page.

Request

Send your key in the x-api-key header, or leave it out to use the keyless tier.

curl

curl "https://api.tide.ad/v1/packages/0x2c8d603bc51326b8c13cef9dd07031a408a48dddb541963357661df5d3204809/versions?limit=10" \
  -H "x-api-key: YOUR_API_KEY"

TypeScript

const res = await fetch("https://api.tide.ad/v1/packages/0x2c8d603bc51326b8c13cef9dd07031a408a48dddb541963357661df5d3204809/versions?limit=10", {
  headers: {
    "x-api-key": process.env.TIDE_API_KEY!,
  },
});
const data = await res.json();

Response

JSON

{
  "originalId": "0x2c8d603bc51326b8c13cef9dd07031a408a48dddb541963357661df5d3204809",
  "latestVersion": 9,
  "total": 9,
  "items": [
    {
      "version": 9,
      "packageId": "0xbca0cefe720330e7bb4f2283438b68de6a0e656688db4ac90d61e71fe6151fe8",
      "kind": "upgrade",
      "digest": "3y8CSAfchzFEZXQXWEzXBoKeLAf2rmkBL2f8ydKzTLG7",
      "checkpoint": 339128472,
      "timestamp": 1793208437,
      "sender": "0x37f187e1e54e9c9b8c78b6c46a7281f644ebc62e75493623edcaa6d1dfcf64d2",
      "modules": [
        "account",
        "balance_manager",
        "balances"
      ],
      "modulesAdded": [],
      "modulesRemoved": [],
      "bytes": 72885,
      "dependencies": [
        "0x0000000000000000000000000000000000000000000000000000000000000001",
        "0x0000000000000000000000000000000000000000000000000000000000000002",
        "0xdeeb7a4662eec9f2f3def03fb937a663dddaa2e215b8078a284d026b7946c270"
      ]
    },
    {
      "version": 8,
      "packageId": "0x0e735f8c93a95722efd73521aca7a7652c0bb71ed1daf41b26dfd7d1ff71f748",
      "kind": "upgrade",
      "digest": "EQ161AkDa4Qa2DB5m8GUyJzb5C99n3xvetCfEC6ezoGT",
      "checkpoint": 277133779,
      "timestamp": 1779151974,
      "sender": "0x37f187e1e54e9c9b8c78b6c46a7281f644ebc62e75493623edcaa6d1dfcf64d2",
      "modules": [
        "account",
        "balance_manager",
        "balances"
      ],
      "modulesAdded": [],
      "modulesRemoved": [],
      "bytes": 71874,
      "dependencies": [
        "0x0000000000000000000000000000000000000000000000000000000000000001",
        "0x0000000000000000000000000000000000000000000000000000000000000002",
        "0xdeeb7a4662eec9f2f3def03fb937a663dddaa2e215b8078a284d026b7946c270"
      ]
    },
    {
      "version": 7,
      "packageId": "0xf48222c4e057fa468baf136bff8e12504209d43850c5778f76159292a96f621e",
      "kind": "upgrade",
      "digest": "DXyM3UxGMxtEyx9LZZA9ESqujEWDEKzdUEyKFyRJqk2S",
      "checkpoint": 263173042,
      "timestamp": 1775759584,
      "sender": "0x37f187e1e54e9c9b8c78b6c46a7281f644ebc62e75493623edcaa6d1dfcf64d2",
      "modules": [
        "account",
        "balance_manager",
        "balances"
      ],
      "modulesAdded": [],
      "modulesRemoved": [],
      "bytes": 71006,
      "dependencies": [
        "0x0000000000000000000000000000000000000000000000000000000000000001",
        "0x0000000000000000000000000000000000000000000000000000000000000002",
        "0xdeeb7a4662eec9f2f3def03fb937a663dddaa2e215b8078a284d026b7946c270"
      ]
    }
  ],
  "cursor": null,
  "asOf": {
    "checkpoint": 341494004,
    "timestamp": "2026-11-04T08:11:11.332Z",
    "lagMs": 723
  }
}

Long lists are cut to a few items here.