> For the complete documentation index, see [llms.txt](https://docs.openalgo.in/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.openalgo.in/api-documentation/v1/data-api/multiquotes.md).

# MultiQuotes

Get real-time quotes for multiple symbols in a single API call.

## Endpoint URL

```http
Local Host   :  POST http://127.0.0.1:5000/api/v1/multiquotes
Ngrok Domain :  POST https://<your-ngrok-domain>.ngrok-free.app/api/v1/multiquotes
Custom Domain:  POST https://<your-custom-domain>/api/v1/multiquotes
```

## Sample API Request

```json
{
  "apikey": "<your_app_apikey>",
  "symbols": [
    {"symbol": "RELIANCE", "exchange": "NSE"},
    {"symbol": "TCS", "exchange": "NSE"},
    {"symbol": "INFY", "exchange": "NSE"}
  ]
}
```

## Sample cURL Request

```bash
curl -X POST http://127.0.0.1:5000/api/v1/multiquotes \
  -H 'Content-Type: application/json' \
  -d '{
  "apikey": "<your_app_apikey>",
  "symbols": [
    {"symbol": "RELIANCE", "exchange": "NSE"},
    {"symbol": "TCS", "exchange": "NSE"},
    {"symbol": "INFY", "exchange": "NSE"}
  ]
}'
```

## Sample API Response

```json
{
  "status": "success",
  "results": [
    {
      "symbol": "RELIANCE",
      "exchange": "NSE",
      "data": {
        "open": 1542.3,
        "high": 1571.6,
        "low": 1540.5,
        "ltp": 1569.9,
        "prev_close": 1539.7,
        "ask": 1569.9,
        "bid": 0,
        "oi": 0,
        "volume": 14054299
      }
    },
    {
      "symbol": "TCS",
      "exchange": "NSE",
      "data": {
        "open": 3118.8,
        "high": 3178,
        "low": 3117,
        "ltp": 3162.9,
        "prev_close": 3119.2,
        "ask": 0,
        "bid": 3162.9,
        "oi": 0,
        "volume": 2508527
      }
    },
    {
      "symbol": "INFY",
      "exchange": "NSE",
      "data": {
        "open": 1532.1,
        "high": 1560.3,
        "low": 1532.1,
        "ltp": 1557.9,
        "prev_close": 1530.6,
        "ask": 0,
        "bid": 1557.9,
        "oi": 0,
        "volume": 7575038
      }
    }
  ]
}
```

## Request Body

| Parameter | Description             | Mandatory/Optional | Default Value |
| --------- | ----------------------- | ------------------ | ------------- |
| apikey    | Your OpenAlgo API key   | Mandatory          | -             |
| symbols   | Array of symbol objects | Mandatory          | -             |

### Symbol Object Fields

| Field    | Description                                      |
| -------- | ------------------------------------------------ |
| symbol   | Trading symbol                                   |
| exchange | Exchange code: NSE, BSE, NFO, BFO, CDS, BCD, MCX |

## Response Fields

| Field   | Type   | Description            |
| ------- | ------ | ---------------------- |
| status  | string | "success" or "error"   |
| results | array  | Array of quote results |

### Results Array Fields

| Field    | Type   | Description                           |
| -------- | ------ | ------------------------------------- |
| symbol   | string | Trading symbol                        |
| exchange | string | Exchange code                         |
| data     | object | Quote data (same as Quotes endpoint)  |
| error    | string | Error message if symbol lookup failed |

### Data Object Fields

| Field       | Type   | Description              |
| ----------- | ------ | ------------------------ |
| open        | number | Day's open price         |
| high        | number | Day's high price         |
| low         | number | Day's low price          |
| ltp         | number | Last traded price        |
| ask         | number | Best ask price           |
| bid         | number | Best bid price           |
| prev\_close | number | Previous day's close     |
| oi          | number | Open interest (for F\&O) |
| volume      | number | Total traded volume      |

## Notes

* More efficient than making multiple [Quotes](/api-documentation/v1/data-api/quotes.md) calls
* Invalid symbols are returned with an error field
* Maximum symbols per request depends on broker limits
* If broker doesn't support multiquotes natively, the API fetches quotes individually
* For F\&O symbols, **oi** (open interest) field is populated

## Use Cases

* **Watchlist updates**: Refresh quotes for all watchlist symbols
* **Portfolio valuation**: Get LTP for all holdings
* **Multi-symbol strategies**: Monitor multiple correlated symbols

***

**Back to**: [API Documentation](/api-documentation/v1.md)