---
title: voteSubscribe
hideTableOfContents: true
h1: voteSubscribe RPC Method
---

Subscribe to receive notification anytime a new vote is observed in gossip.
These votes are pre-consensus therefore there is no guarantee these votes will
enter the ledger.

<Callout type="warn" title={"Unstable Method"}>
  This subscription is unstable and only available if the validator was started
  with the `--rpc-pubsub-enable-vote-subscription` flag. The format of this
  subscription may change in the future.
</Callout>

<DocSideBySide>

<DocLeftSide>

### Parameters

**None**

### Result

`<integer>` - subscription id (needed to unsubscribe)

</DocLeftSide>

<DocRightSide>

### Code sample

```json
{ "jsonrpc": "2.0", "id": 1, "method": "voteSubscribe" }
```

### Response

```json
{ "jsonrpc": "2.0", "result": 0, "id": 1 }
```

</DocRightSide>
</DocSideBySide>

#### Notification Format:

The notification will be an object with the following fields:

- `hash: <string>` - The vote hash
- `slots: <array>` - The slots covered by the vote, as an array of u64 integers
- `timestamp: <i64|null>` - The timestamp of the vote
- `signature: <string>` - The signature of the transaction that contained this
  vote
- `votePubkey: <string>` - The public key of the vote account, as base-58
  encoded string

```json
{
  "jsonrpc": "2.0",
  "method": "voteNotification",
  "params": {
    "result": {
      "hash": "8Rshv2oMkPu5E4opXTRyuyBeZBqQ4S477VG26wUTFxUM",
      "slots": [1, 2],
      "timestamp": null
    },
    "subscription": 0
  }
}
```
