Chain

events.list

Move events by type or package in any time or checkpoint range.

Details

Endpoint: GET /v1/events
Credits: 5
Rate class: Heavy. Counts against your heavy requests per second.

Returns decoded Move events, newest first or oldest first, for one event type (type, with or without type parameters) or for everything a package emitted (package, optionally with module). Narrow with sender, fromTime and toTime (unix seconds) or fromCheckpoint and toCheckpoint. Each event has its transaction digest, checkpoint, time and the decoded JSON. Page with cursor, up to 200 per page. Pass type or package, not both. Covers all of history since genesis.

Parameters

Name	Type	Description
type	string	Event type, for example 0x2::coin::CurrencyCreated or a full generic instance. Give type or package.
package	string	Package id: all events emitted by that package.
module	string	With package: only events from this module.
sender	string	Only events sent by this address.
fromTime	integer	Unix seconds, inclusive.
toTime	integer	Unix seconds, inclusive.
fromCheckpoint	integer	First checkpoint, inclusive.
toCheckpoint	integer	Last checkpoint, inclusive.
sort	string	desc is newest first (default).One of "desc", "asc".
limit	integer	Events per page, default 50.From 1 to 200.
cursor	string	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/events?type=0x2::coin::CurrencyCreated&limit=3" \
  -H "x-api-key: YOUR_API_KEY"

TypeScript

const res = await fetch("https://api.tide.ad/v1/events?type=0x2::coin::CurrencyCreated&limit=3", {
  headers: {
    "x-api-key": process.env.TIDE_API_KEY!,
  },
});
const data = await res.json();

Response

JSON

{
  "items": [
    {
      "type": "0x0000000000000000000000000000000000000000000000000000000000000002::coin::CurrencyCreated<0x1e8b532cca6569cab9f9b9ebc73f8c13885012ade714729aa3b450e0339ac766::coin::COIN>",
      "package": "0x1e8b532cca6569cab9f9b9ebc73f8c13885012ade714729aa3b450e0339ac766",
      "module": "coin",
      "sender": "0x355511750caf954d34e5aa6324f886bd30dc9b829c880a2efb2c44986348fcaf",
      "json": {
        "decimals": 8
      },
      "digest": "FAFnKgNd52r7AtJhYBx2btDN17G6KAAGYj4Jf4HLXnVf",
      "checkpoint": 1448820,
      "txIndex": 1,
      "eventIndex": 0,
      "timestamp": 1682991609
    },
    {
      "type": "0x0000000000000000000000000000000000000000000000000000000000000002::coin::CurrencyCreated<0x435aa4ae1769b58f19df91b38ce5c49695c566faf841186d062ab1778581fc82::coin::COIN>",
      "package": "0x435aa4ae1769b58f19df91b38ce5c49695c566faf841186d062ab1778581fc82",
      "module": "coin",
      "sender": "0x355511750caf954d34e5aa6324f886bd30dc9b829c880a2efb2c44986348fcaf",
      "json": {
        "decimals": 8
      },
      "digest": "EwzKcHrdXPnfogoaW8GjucW5GavsxwGu8wh5ucMEYtda",
      "checkpoint": 1448626,
      "txIndex": 0,
      "eventIndex": 0,
      "timestamp": 1682991402
    }
  ],
  "cursor": null,
  "historyFrom": null,
  "asOf": {
    "checkpoint": 341518272,
    "timestamp": "2026-11-04T09:49:37.912Z",
    "lagMs": 2207
  }
}