Walrus

walrus.blobs

Walrus blobs a wallet owns, with epochs, size and expiry.

Details

Endpoint: GET /v1/wallet/:wallet/walrus-blobs
Credits: 2
Rate class: Light. Counts against your light requests per second.

Lists the Walrus Blob objects owned by an address, with the same fields as the single blob lookup. The wallet can be a 0x address, a name.sui or an @name. Results come from the chain as it is now, in the order the chain returns them. Page with cursor; each page is up to limit blobs. Blobs held inside a kiosk or another object are not listed.

Parameters

Name	Type	Description
walletrequired	string	Owner: a 0x address, a name.sui or an @name.
cursor	string	Cursor from the previous page.
limit	integer	Blobs per page, 1 to 200.Default 50. From 1 to 200.

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/wallet/0xbfaadd8980b532c65ca09be4fdc9901c5ccafc1814f035502e526288aefd092f/walrus-blobs?limit=5" \
  -H "x-api-key: YOUR_API_KEY"

TypeScript

const res = await fetch("https://api.tide.ad/v1/wallet/0xbfaadd8980b532c65ca09be4fdc9901c5ccafc1814f035502e526288aefd092f/walrus-blobs?limit=5", {
  headers: {
    "x-api-key": process.env.TIDE_API_KEY!,
  },
});
const data = await res.json();

Response

JSON

{
  "items": [
    {
      "blobId": "7U5-LVLV8KU5pdtiH6kFEZBfioVOuG0qAOtNJLGJSkA",
      "blobIdU256": "29079719307106015783461271371659700130291690376202304833200198792448564940525",
      "objectId": "0x0000c78ab9f709ebad353419de9f7e78d884e6431d9054dfd16f5950ae8b9875",
      "version": 1039434682,
      "status": "certified",
      "sizeBytes": "962",
      "encoding": "RS2",
      "registeredEpoch": 41,
      "certifiedEpoch": 41,
      "storageStartEpoch": 41,
      "storageEndEpoch": 56,
      "storageSizeBytes": "66034000",
      "expiresAt": "2027-05-04T15:11:10.224Z",
      "expiryIsEstimate": true,
      "deletable": true,
      "owner": {
        "kind": "address",
        "address": "0xbfaadd8980b532c65ca09be4fdc9901c5ccafc1814f035502e526288aefd092f"
      }
    },
    {
      "blobId": "Tt8yayrFWXBmz_qE7uNVJtH3mn4oH3eFQEOsuFQdJ2w",
      "blobIdU256": "48918897117247030333011706996551718886739932113783548866751635912251308957518",
      "objectId": "0x000358a929397d68d32a13e09db124e91a2f4230d659388a56e10db3295907de",
      "version": 1004864575,
      "status": "certified",
      "sizeBytes": "393",
      "encoding": "RS2",
      "registeredEpoch": 39,
      "certifiedEpoch": 39,
      "storageStartEpoch": 39,
      "storageEndEpoch": 54,
      "storageSizeBytes": "66034000",
      "expiresAt": "2027-04-06T15:11:10.224Z",
      "expiryIsEstimate": true,
      "deletable": true,
      "owner": {
        "kind": "address",
        "address": "0xbfaadd8980b532c65ca09be4fdc9901c5ccafc1814f035502e526288aefd092f"
      }
    },
    {
      "blobId": "zmyZf2k3-3uaMef6_lIkfSw7SMBEVylq45Dqg6FFuCI",
      "blobIdU256": "15704217286692026933258509472592856003359962401438792212014136990252662353102",
      "objectId": "0x000631fddf5b714f0995aec7f720883b73a53b794f5cd5ddd4da68aa4f22efa6",
      "version": 1044053310,
      "status": "certified",
      "sizeBytes": "350",
      "encoding": "RS2",
      "registeredEpoch": 41,
      "certifiedEpoch": 41,
      "storageStartEpoch": 41,
      "storageEndEpoch": 56,
      "storageSizeBytes": "66034000",
      "expiresAt": "2027-05-04T15:11:10.224Z",
      "expiryIsEstimate": true,
      "deletable": true,
      "owner": {
        "kind": "address",
        "address": "0xbfaadd8980b532c65ca09be4fdc9901c5ccafc1814f035502e526288aefd092f"
      }
    }
  ],
  "currentEpoch": 43,
  "cursor": "v6rdiYC1MsZcoJvk_cmQHFzK_BgU8DVQLlJiiK79CS8B_ciPfXzzCvqy-C6DgNEe6PcO-5DoY9Hehhb64bsJ6ncEYmxvYgRCbG9iAL-q3YmAtTLGXKCb5P3JkBxcyvwYFPA1UC5SYoiu_Qkv_ciPfXzzCvqy-C6DgNEe6PcO-5DoY9Hehhb64bsJ6ncEYmxvYgRCbG9iAAAADHKuQxScK3kFvizTI6VAVKDO2CE6Zsg93VyAtUCaKqO5PDwAAAAA",
  "asOf": {
    "checkpoint": 341440239,
    "timestamp": "2026-11-04T04:33:11.346Z",
    "lagMs": 1943
  }
}

Long lists are cut to a few items here.