Skip to main content
Tusky’s default billing model is pay-as-you-go — you pay only for the storage you consume, with no upfront commitments, no subscriptions, and no KYC requirements. Payments are processed through the x402 protocol, enabling HTTP-native cryptocurrency micropayments.

​
How It Works

1

Estimate cost

Before uploading, use the upload cost endpoint to preview the cost:
curl -X POST https://api.tusky.io/v2/uploads/cost \
  -H "Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "files": [{ "size": 10485760 }],
    "epochs": 5
  }'
2

Upload your file

When you upload a file, the payment is processed automatically. If you have a prepaid balance, it is deducted first. Otherwise, the x402 protocol handles the micropayment inline with the HTTP request.
3

Payment settled

The cost is settled on-chain. You receive a receipt with the transaction hash for full transparency.

​
Pricing

The cost of storing a file on Tusky is: 
Total Cost = Walrus Storage Cost
ComponentDescription
Walrus Storage CostThe on-chain cost to store your blob on the Walrus network for the specified number of epochs. This varies based on file size and storage duration.
Tusky passes through Walrus storage costs directly with no markup or infrastructure fee. You pay only what the Walrus network charges.

​
x402 Protocol

Tusky uses the x402 protocol for HTTP-native cryptocurrency payments. This means payments happen inline with your API requests — no separate payment step, no payment gateway, no accounts.

​
How x402 Works

  1. The client sends a standard HTTP request.
  2. If payment is required, the server responds with 402 Payment Required and payment instructions.
  3. The client (or SDK) automatically signs and submits the payment.
  4. The server processes the request after payment confirmation.
The Tusky SDK handles x402 payment flows automatically. You don’t need to interact with the protocol directly unless you are building a custom integration.

​
Key Benefits

No Accounts Required

Pay per request without creating billing accounts or providing personal information.

No KYC

Cryptocurrency payments eliminate the need for identity verification.

Instant Settlement

Payments settle on-chain in seconds, not days.

Transparent Pricing

Every payment is recorded on-chain with a verifiable transaction hash.

​
Supported Tokens

TokenDescription
SUIThe native token of the Sui network. Used for gas fees on Sui transactions.
WALThe Walrus utility token. Can be used for storage payments where accepted.

​
SDK Example

import { Tusky } from "@tusky-io/ts-sdk";

const tusky = new Tusky({ apiKey: process.env.TUSKY_API_KEY });

// Upload with pay-as-you-go — payment is handled automatically
const file = await tusky.file.upload("env_abc123", "./data.csv", {
  name: "dataset.csv",
  epochs: 5,
});

console.log("File uploaded:", file.id);
console.log("Cost:", file.cost);

​
What’s Next

Prepaid

Fund your wallet in advance for seamless uploads without per-request payments.

Enterprise

Custom pricing for high-volume use cases.