Skip to main content

Documentation Index

Fetch the complete documentation index at: https://helius-feat-shred-subscriptions.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Buy a Shred IP

Purchase a $500/month IP slot directly from your dashboard. No sales call required.

What is Shred Subscriptions?

Shred Subscriptions is the self-serve tier of Helius’s Shred Delivery product. You purchase IP slots from the dashboard, each delivering raw Solana shreds via UDP to the server you choose. It’s built for teams who need raw shreds at the earliest possible moment but want to skip the sales process and start receiving data the same day they pay.

Self-serve

Buy in the dashboard, receive shreds immediately. No procurement back-and-forth.

Per-IP scaling

One subscription per project; add IPs as your fleet grows. Each IP is independently activated.

Same shreds as Shred Delivery

The data path and validator stake advantage are identical to Shred Delivery.

Bring your own server

You provide the receiving server. Activation captures its source IP from the curl request itself.

Pricing

ResourcePrice
Shred IP slot$500 / month / IP
  • Billed monthly per active IP slot.
  • Adding an IP mid-period is prorated; you’re charged only for the remaining days in the current billing period.
  • Cancelling stops billing at the next period boundary. Service continues uninterrupted through the paid period — no refund for partial months.

Purchasing your first IP

  1. Open the Shred Subscriptions dashboard.
  2. Click Add IP and complete checkout. Crypto and fiat payments are both supported.
  3. After payment confirms, the dashboard displays your API key in a banner. Copy it now — it’s shown exactly once and cannot be retrieved again.
  4. Run the activation curl from the server that should receive shreds (see below).

Activating an IP

Run this from the server you want to receive shreds on. The source IP of the request is what Helius will forward shreds to.
curl -X POST https://gateway.helius.dev/v0/shred-subscriptions/activate \
  -H "Authorization: Bearer YOUR_API_KEY"
A 200 OK means your server is now bound to that key. Shreds start flowing within a few minutes.
Activation is one-shot per key. Once your server is bound, the same key cannot be re-bound to a different IP — even if you re-run the curl from elsewhere. To move the binding to a new server, rotate the key first.This is the security property that blocks redirect-on-leak attacks: a stolen key cannot be used to redirect your shreds to an attacker’s server.

Rotating an API key

Rotation issues a fresh key and immediately invalidates the previous one. Use it when:
  • You suspect the key has leaked.
  • You want to move the binding to a different server.
  • You’re rotating credentials as part of routine hygiene.
From the dashboard, click Rotate on the IP slot. The new key is shown once in the banner — copy it. Then re-run the activation curl from the new server (or the same server, if you’re rotating for hygiene only). The slot itself persists across rotations — your billing, IP-slot count, and cancel_at (if set) are unchanged. Only the credential changes.

Cancellation

Click Cancel IP on the slot. You’ll see the scheduled cancel date — service continues until that date, then stops automatically. No refund for the unused portion of the period. If you cancel your last IP, the parent subscription terminates at the same period end and the dashboard goes back to the “No active shred subscriptions” state. You can re-add an IP at any time before the cancellation date to keep the subscription alive without interruption.

Scope of the API key

Shred-subscription API keys are scoped strictly to shred delivery. They cannot be used to authenticate against any other Helius product:
ProductAuthenticated with this key?
Shred delivery (Tachyon)✅ Yes
RPC (mainnet / devnet)❌ No
Digital Asset Standard (DAS) API❌ No
Webhooks❌ No
Enhanced WebSocket❌ No
LaserStream gRPC / Yellowstone❌ No
If you need RPC, DAS, or other Helius services alongside shred delivery, use your regular Helius API key for those. The two keys are independent.

Troubleshooting

I lost the API key after issuance. Rotate the slot from the dashboard. The old key becomes invalid and a new one is shown once. The activation curl returns 409 Conflict. The key has already been bound to a different IP. To re-bind from a new server, rotate the slot and run activation again with the new key. The activation curl returns 401 Unauthorized. Check that you copied the full API key. The key is a UUID — about 36 characters with hyphens. I want to move my shred-receiving server to a new IP. Rotate the slot, then run the activation curl from the new server with the new key. I want to scale to multiple IPs. From the dashboard, click Add IP. Each new IP gets its own key and is activated independently from its target server. Pricing is per IP. Cancellation didn’t stop shreds immediately. Expected — service continues through the period you’ve already paid for. The dashboard shows the scheduled stop date.

Shred Delivery

The enterprise tier — same data path, with white-glove provisioning and custom contracts. Choose this if you need a Helius engineer to design the integration with you.

LaserStream

Processed transactions with commitment guarantees and 24-hour historical replay. Choose this if you don’t need raw shreds and want production-grade reliability with developer SDKs.