Docs

chain_unsubscribeFinalisedHeads - Bittensor RPC Method

Cancel a finalized heads subscription on Bittensor (British spelling alias). WebSocket-only.

Cancels a WebSocket subscription that was started with chain_subscribeFinalisedHeads (British spelling). This is a legacy alias for chain_unsubscribeFinalizedHeads and is functionally identical. Provide the subscription ID returned when the subscription was created.

Code Examples

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

WebSocket (wscat)

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

Use Cases

  • Legacy client support -- Used by older clients or libraries that use British spelling (Finalised vs Finalized).
  • Subscription cleanup -- Cancel a finalized-heads subscription when you no longer need finality notifications.

Notes

  • This is a British spelling alias. Modern clients should use chain_unsubscribeFinalizedHeads.
  • Always unsubscribe when done to prevent server-side resource leaks.
  • WebSocket-only; cannot be called over HTTP.