chain_unsubscribeFinalizedHeads - Bittensor RPC Method

Cancels a WebSocket subscription that was started with chain_subscribeFinalizedHeads. After calling this method, no further finalized block header notifications will be delivered for that subscription. Provide the numeric subscription ID that was returned when the subscription was created.

Code Examples

This method requires a WebSocket connection and is not available over HTTP.

WebSocket (wscat)

wscat -c wss://api-bittensor-mainnet.n.dwellir.com/YOUR_API_KEY \
  -x '{
    "jsonrpc": "2.0",
    "method": "chain_unsubscribeFinalizedHeads",
    "params": ["SUBSCRIPTION_ID"],
    "id": 1
  }'

Use Cases

• Subscription cleanup -- Cancel the finalized-heads subscription when your application (indexer, dashboard, alerting system) no longer needs finality notifications.
• Resource management -- Prevent server-side resource leaks in long-running WebSocket applications.
• Subscription rotation -- Stop one subscription before starting a fresh one after reconnection or reconfiguration.

Notes

• Always unsubscribe when done. Even though the server cleans up on disconnect, explicit unsubscription is best practice.
• The British spelling alias chain_unsubscribeFinalisedHeads is also available and functionally identical.
• WebSocket-only; cannot be called over HTTP.

Related Methods

• chain_subscribeFinalizedHeads -- Start the finalized-heads subscription
• chain_unsubscribeFinalisedHeads -- British spelling alias
• chain_unsubscribeNewHeads -- Cancel a best-block header subscription
• chain_unsubscribeAllHeads -- Cancel an all-heads subscription
• chainHead_v1_unfollow -- Stop a v2 chain head follow subscription