Objects

objects.at

An object as it was at a version, checkpoint or time, with its contents.

Details

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

Returns the object's state at one point: pass exactly one of version, checkpoint, time (unix seconds) or datetime (ISO, UTC). The answer says whether the object existed, was deleted or was wrapped then, and for an existing object gives the version, digest, type, owner and Move fields as JSON, plus the checkpoint and transaction that wrote that version. With checkpoint or time you get the version that was live at that point. Object contents are available from checkpoint 330677000; before that the call returns not_indexed, and /history still lists the versions. Answers for past points never change.

Parameters

Name	Type	Description
idrequired	string	Object id (0x...).
version	integer	Exact object version. Use /history to list versions.
checkpoint	integer	Checkpoint sequence number: the version live after that checkpoint.
time	integer	Unix seconds: the version live at that time.
datetime	string	ISO 8601 date and time, UTC, for example 2026-10-01T12:00:00Z.

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/objects/0x0000000000000000000000000000000000000000000000000000000000000006/at?checkpoint=341000000" \
  -H "x-api-key: YOUR_API_KEY"

TypeScript

const res = await fetch("https://api.tide.ad/v1/objects/0x0000000000000000000000000000000000000000000000000000000000000006/at?checkpoint=341000000", {
  headers: {
    "x-api-key": process.env.TIDE_API_KEY!,
  },
});
const data = await res.json();

Response

JSON

{
  "objectId": "0x0000000000000000000000000000000000000000000000000000000000000006",
  "state": "exists",
  "version": 1015972725,
  "checkpoint": 341000000,
  "timestamp": 1793659452,
  "digest": "2jv52iz3h7h4fgWiqUQ4fZybBZSqYGREe3hj5xFUhGXR",
  "type": "0x0000000000000000000000000000000000000000000000000000000000000002::clock::Clock",
  "owner": {
    "kind": "shared",
    "initialSharedVersion": 1
  },
  "previousTransaction": "ALKbJwXwcVMq1T7fWqbDog3oibDSbxa8pKxxQck3Fz1w",
  "storageRebateMist": "0",
  "hasPublicTransfer": false,
  "fields": {
    "id": "0x0000000000000000000000000000000000000000000000000000000000000006",
    "timestamp_ms": "1793659452916"
  },
  "asOf": {
    "checkpoint": 341000000,
    "timestamp": "2026-11-02T22:44:12.916Z",
    "lagMs": null
  }
}