accountSubscribe

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "accountSubscribe",
  "params": [
    "SysvarC1ock11111111111111111111111111111111",
    {
      "encoding": "jsonParsed",
      "commitment": "processed"
    }
  ]
}

{
  "jsonrpc": "2.0",
  "result": 3085,
  "id": 1
}

{
  "jsonrpc": "2.0",
  "method": "accountNotification",
  "params": {
    "result": {
      "context": {
        "slot": 439749547
      },
      "value": {
        "lamports": 1169280,
        "data": {
          "program": "sysvar",
          "parsed": {
            "info": {
              "epoch": 1017,
              "epochStartTimestamp": 1786759601,
              "leaderScheduleEpoch": 1018,
              "slot": 439749547,
              "unixTimestamp": 1786928216
            },
            "type": "clock"
          },
          "space": 40
        },
        "owner": "Sysvar1111111111111111111111111111111111111",
        "executable": false,
        "rentEpoch": 18446744073709552000,
        "space": 40
      }
    },
    "subscription": 3085
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "accountSubscribe",
  "params": [
    "SysvarC1ock11111111111111111111111111111111",
    {
      "encoding": "jsonParsed",
      "commitment": "processed"
    }
  ]
}

{
  "jsonrpc": "2.0",
  "result": 3085,
  "id": 1
}

{
  "jsonrpc": "2.0",
  "method": "accountNotification",
  "params": {
    "result": {
      "context": {
        "slot": 439749547
      },
      "value": {
        "lamports": 1169280,
        "data": {
          "program": "sysvar",
          "parsed": {
            "info": {
              "epoch": 1017,
              "epochStartTimestamp": 1786759601,
              "leaderScheduleEpoch": 1018,
              "slot": 439749547,
              "unixTimestamp": 1786928216
            },
            "type": "clock"
          },
          "space": 40
        },
        "owner": "Sysvar1111111111111111111111111111111111111",
        "executable": false,
        "rentEpoch": 18446744073709552000,
        "space": 40
      }
    },
    "subscription": 3085
  }
}

Subscribe to an account to receive notifications when the lamports or data for a given account public key changes.

On ThorNode

Send over the complete wss:// URL copied from the dashboard. Each active subscription counts toward the per-token cap; over the cap the request is answered with -32005 subscription limit exceeded and not forwarded. Frames pass through unchanged.

Parameters

array

required

Hide properties

string

required

Account Pubkey, as base-58 encoded string.

string

Encoding format for account data. Can be base58, base64, base64+zstd, or jsonParsed.

base58 is slow
jsonParsed encoding attempts to use program-specific state parsers to return more human-readable and explicit account state data
If jsonParsed is requested but a parser cannot be found, the field falls back to binary encoding, detectable when the data field is type string.

string

The commitment level for the subscription. Can be finalized, confirmed, or processed.

string

deprecated

Deprecated — no-op as of Agave 4.2. Setting notifyOn has no effect. The field will be removed at a later date.

Response

integer

Subscription id (needed to unsubscribe)

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "accountSubscribe",
  "params": [
    "SysvarC1ock11111111111111111111111111111111",
    {
      "encoding": "jsonParsed",
      "commitment": "processed"
    }
  ]
}

{
  "jsonrpc": "2.0",
  "result": 3085,
  "id": 1
}

{
  "jsonrpc": "2.0",
  "method": "accountNotification",
  "params": {
    "result": {
      "context": {
        "slot": 439749547
      },
      "value": {
        "lamports": 1169280,
        "data": {
          "program": "sysvar",
          "parsed": {
            "info": {
              "epoch": 1017,
              "epochStartTimestamp": 1786759601,
              "leaderScheduleEpoch": 1018,
              "slot": 439749547,
              "unixTimestamp": 1786928216
            },
            "type": "clock"
          },
          "space": 40
        },
        "owner": "Sysvar1111111111111111111111111111111111111",
        "executable": false,
        "rentEpoch": 18446744073709552000,
        "space": 40
      }
    },
    "subscription": 3085
  }
}

API reference

ThorEdge RPC

FastGate RPC

Yellowstone gRPC

Bifrost

Hofund

On ThorNode

Parameters

Response

​On ThorNode

​Parameters

​Response

On ThorNode

Parameters

Response