Tatum Storage API – Walrus File Uploads, Certification Status & Renewals

Use the Storage API to upload files to Walrus decentralized storage, track certification status, list uploads, and manage automatic renewals.

The Tatum Storage API lets you store files on Walrus, a decentralized storage network. Uploads run asynchronously: the upload response returns a jobId and blobId, then you poll the status endpoint until the file is certified on-chain.

How to Upload Files, Track Status and Manage Renewals

Key benefits of the Storage API

Decentralized file storage — Upload files to Walrus storage through a Tatum API endpoint.
Asynchronous certification — Stage a file first, then track certification through PENDING, UPLOADING, CERTIFIED, or FAILED states.
Download-ready responses — Once certified, retrieve Walrus download URLs from the upload status response.
Upload inventory — List upload jobs for the current API key with pagination.
Renewal control — Let Tatum renew storage automatically, soft-cancel renewal, or queue an instant on-chain delete.

Storage API endpoints

Use these endpoints to upload files, monitor upload jobs, and manage Walrus storage renewal.

📚
Upload a file to Walrus storage
POST /v4/data/storage/upload
Upload a file to Walrus storage. The response returns a jobId, current status, stored filename, file size, MIME type, and pre-computed blobId. Poll the upload status endpoint to track certification progress.
Explore Docs →

📚
List Walrus storage uploads
GET /v4/data/storage/uploads List upload jobs for the current API key, ordered by most recently created. Use limit and offset query parameters to paginate through results.
Explore Docs →

📚
Get Walrus storage upload status
GET /v4/data/storage/upload/{jobId}
Get the current status of a Walrus upload job. When the status is CERTIFIED, the response includes downloadUrlByQuiltId and downloadUrlByQuiltPatchId for retrieving the file from Walrus aggregator nodes.ll NFTs / multi-tokens in specified collections (supports filtering and pagination).
Explore Docs →

📚
Cancel Walrus storage renewal
DELETE /v4/data/storage/upload/{jobId}
Cancel renewal for a certified Walrus storage upload. Use the default soft cancel to stop future renewal while keeping the file available until its current storage epoch expires, or set instant=true to queue an immediate on-chain delete.
Explore Docs →

Storage lifecycle

Upload the file with POST /v4/data/storage/upload. The file is staged and the API returns a jobId and blobId immediately.
Poll the job status with GET /v4/data/storage/upload/{jobId}. The job moves through PENDING, UPLOADING, and CERTIFIED when successful.
Download the certified file using the Walrus download URLs returned in the status response.
Manage renewal with DELETE /v4/data/storage/upload/{jobId} if you no longer want Tatum to renew the file.

If a job reaches FAILED, the status response includes an errorMessage. Failed jobs are not retried automatically; submit a new upload request to try again.

Blockchains API FAQs

Which blockchains are supported?

The Blockchains API supports a wide range of networks across multiple architectures including:

EVM blockchains (Ethereum, Polygon, BNB Smart Chain, Arbitrum, Optimism, Base)
UTXO blockchains (Bitcoin, Litecoin, Dogecoin, Bitcoin Cash)
Emerging ecosystems such as Berachain, Monad, and Unichain

What makes the Blockchains API different from native RPC APIs?

Native blockchain RPC APIs differ significantly across chains. The Blockchains API standardizes requests and responses so developers can query multiple blockchains using a consistent interface.

Can I retrieve internal transactions?

Yes. The API supports retrieving internal transactions for multiple EVM networks including Ethereum, BNB Smart Chain, Polygon, Arbitrum, Optimism, Avalanche, and others.

What can developers build using the Blockchains API?

Developers use the Blockchains API to build blockchain explorers, analytics dashboards, compliance tools, transaction monitors, and other applications that require direct blockchain data access.

Use cases for developers

Store application files in decentralized storage.
Track asynchronous upload and certification progress in dashboards or admin tools.
Retrieve certified file download URLs after on-chain certification.
Build upload history views for files associated with a Tatum API key.
Stop automatic renewal for files that no longer need to remain available.