> For the complete documentation index, see [llms.txt](https://docs.ndax.in/v3/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ndax.in/v3/private-socket-feed/prices.md).

# Prices

The price feed provides real-time Bid/Ask price levels of up to a depth of 10 for the available symbols.

#### Listing available symbols <a href="#listing-available-symbols" id="listing-available-symbols"></a>

The symbols available for subscription can be fetched by sending a message of type `info` and with the topic set to `available-symbols`.

```
{
  "messageType": "info",
  "topic": "available-symbols",
  "key": "API_PUBLIC_KEY",
  "passphrase": "PASSPHRASE",
  "timestamp": "TIMESTAMP",
  "signature": "SIGNATURE"
}
```

> Available symbols response

```
{
  "messageType": "info",
  "topic": "available-symbols",
  "body": {
    "message": [
      "BTC/e₹",
      "ETH/e₹",
      "LTC/e₹",
      ...
    ]
  }
}
```

#### Subscribing to a Symbol <a href="#subscribing-to-a-symbol" id="subscribing-to-a-symbol"></a>

In order to subscribe to the price feed, a message of type `subscribe` must be sent.

```
{
  "messageType": "subscribe",
  "topic": "prices",
  "body": {
    "filter": {
      "symbol": "BTC/e₹"
    }
  },
  "key": "API_PUBLIC_KEY",
  "passphrase": "PASSPHRASE",
  "timestamp": "TIMESTAMP",
  "signature": "SIGNATURE"
}
```

<table><thead><tr><th width="175">Parameter</th><th width="395.3333333333333">Description</th><th>Type</th></tr></thead><tbody><tr><td>body{}</td><td>An object used to filter which symbol will be subscribed to. This is a required field for the price feed.</td><td>object</td></tr><tr><td>messageType</td><td>Subscription message type - <code>subscribe</code></td><td>string</td></tr><tr><td>topic</td><td>Topic to subscribe to - <code>prices</code> for the price feed</td><td>string</td></tr><tr><td>key</td><td>Your public key</td><td>string</td></tr><tr><td>passphrase</td><td>Your passphrase</td><td>string</td></tr><tr><td>timestamp</td><td>Time in seconds since Unix Epoch</td><td>string</td></tr><tr><td>signature</td><td>your hmac signature</td><td>string</td></tr></tbody></table>

> Subscription response

```
{
  "body": "Successfully subscribed to the BTC/e₹ feed",
  "messageType": "Subscribe"
}
```

#### Price update <a href="#price-update" id="price-update"></a>

After successfully subscribing to a symbol, you will be sent `price-updated` messages whenever the price is updated.

<table><thead><tr><th width="172.33333333333331">Parameter</th><th width="411">Description</th><th>Type</th></tr></thead><tbody><tr><td>bid_levels[]</td><td>Array of Bid price levels (up to a depth of 10)</td><td>string</td></tr><tr><td>ask_levels[]</td><td>Array of Ask price levels (up to a depth of 10)</td><td>string</td></tr><tr><td>symbol</td><td>The symbol which was subscribed to</td><td>string</td></tr><tr><td>messageType</td><td>Price update message type - <code>price-update</code></td><td>string</td></tr></tbody></table>

The price level object comprises these fields:

<table><thead><tr><th width="150.33333333333331">Parameter</th><th width="358">Description</th><th>Type</th></tr></thead><tbody><tr><td>price</td><td>The level price</td><td>string</td></tr><tr><td>quantity</td><td>The level quantity</td><td>string</td></tr><tr><td>side</td><td>The level side - <code>buy</code> or <code>sell</code></td><td>string</td></tr></tbody></table>

```
{
  "messageType": "price-update",
  "body": {
    "symbol": "BTC/e₹",
    "bid_levels": [
      {
        "price": "17260.4677",
        "quantity": "4.50",
        "side": "buy"
      },
      {
        "price": "17255.445175",
        "quantity": "2.77",
        "side": "buy"
      },
      {
        "price": "17251.475275",
        "quantity": "2.55",
        "side": "buy"
      },
      {
        "price": "17245.941475",
        "quantity": "3.34",
        "side": "buy"
      }
    ],
    "ask_levels": [
      {
        "price": "17317.16195",
        "quantity": "14.59",
        "side": "sell"
      },
      {
        "price": "17320.83275",
        "quantity": "65.77",
        "side": "sell"
      },
      {
        "price": "17324.872625",
        "quantity": "15.54",
        "side": "sell"
      },
      {
        "price": "17330.139425",
        "quantity": "9.09",
        "side": "sell"
      }
    ]
  }
}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ndax.in/v3/private-socket-feed/prices.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.