> ## Documentation Index
> Fetch the complete documentation index at: https://docs.uniblock.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# eth_subscribe

> Starts a subscription (on WebSockets / IPC / TCP transports) to a particular event. For every event that matches the subscription a JSON-RPC notification with event details and subscription ID will be sent to a client.

### Parameters

<ParamField query="chainId" type="string" default="10200" required>
  Unique identifier for a blockchain network.
</ParamField>

<ParamField body="id" type="number" default={1} required>
  Request identifier used to match responses.
</ParamField>

<ParamField body="jsonrpc" type="string" default="2.0" required>
  JSON-RPC version.
</ParamField>

<ParamField body="method" type="string" default="eth_subscribe" required>
  JSON-RPC method name.
</ParamField>

<ParamField body="params" type="object" default={["logs",{"fromBlock":"latest","toBlock":"latest"}]} placeholder="[&#x22;logs&#x22;,{&#x22;fromBlock&#x22;:&#x22;latest&#x22;,&#x22;toBlock&#x22;:&#x22;latest&#x22;}]" required>
  Parameters for eth\_subscribe: \[subscriptionType, options]. The second parameter is required only for "logs".

  Positional parameters for <code>eth\_subscribe</code>:

  <ul>
    <li><code>params\[0]</code>: Subscription type. Must be either "newHeads" or "logs".</li>
    <li><code>params\[1]</code>: Filter options for "logs" subscription, or empty object for "newHeads".</li>
  </ul>
</ParamField>

### Returns

<ResponseField name="result" type="string">
  Assigned subscription ID Example: <code>"0xb53c4832f1dca4a5"</code>.
</ResponseField>

<RequestExample>
  ```bash Curl theme={null}
  curl --request POST \
    --url https://api.uniblock.dev/uni/v1/json-rpc?chainId=10200 \
    --header 'content-type: application/json' \
    --data '{
      "id": 1,
      "jsonrpc": "2.0",
      "method": "eth_subscribe",
      "params": [
        "logs",
        {
          "fromBlock": "latest",
          "toBlock": "latest"
        }
      ]
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json Success theme={null}
  {
    "jsonrpc": "2.0",
    "id": 1,
    "result": "0xb53c4832f1dca4a5"
  }
  ```
</ResponseExample>