Get Object

Access historical object state by version number via LedgerService/GetObject. Set version field for time-travel queries.

Service

sui.rpc.v2.LedgerService

Parity

Direct

This method has a direct mapping from the JSON-RPC method sui_tryGetPastObject.

Request

Parameters

{
  "object_id": "0x704c8c0d8052be7b5ca7174222a8980fb2ad3cd640f4482f931deb6436902627",
  "version": "39221891",
  "read_mask": {
    "paths": [
      "object_id",
      "version",
      "digest",
      "owner",
      "object_type",
      "previous_transaction",
      "storage_rebate",
      "json"
    ]
  }
}

Example (grpcurl)

grpcurl -H "x-api-key: YOUR_API_KEY" \
  -d '{"object_id":"0x704c8c0d8052be7b5ca7174222a8980fb2ad3cd640f4482f931deb6436902627","version":"39221891","read_mask":{"paths":["object_id","version","digest","owner","object_type","previous_transaction","storage_rebate","json"]}}' \
  grpc.surflux.dev:443 \
  sui.rpc.v2.LedgerService/GetObject

▶Run in Playground

Response

The response structure is defined by the sui/rpc/v2/ledger_service.proto definition.

Response Fields

Field	Type	Description
object	Object	See proto definition

info

For full field definitions, please refer to the Sui Protobuf definitions.