# Relative volume

The Relative Volume endpoint (/rvol) provides a ratio comparing a security's current trading volume to its average volume over a specified period. This data helps users detect unusual trading activity and assess the strength of price movements, offering insights into potential market breakouts.

**API credits cost:** `1` per symbol

> **Note:** This API endpoint is available starting with the [Grow](https://twelvedata.com/pricing) plan.

## Parameters

- `symbol` (string, optional, see notes)
  Symbol ticker of the instrument. E.g. `AAPL`, `EUR/USD`, `ETH/BTC`, ...


- `figi` (string, optional, see notes)
  The FIGI of an instrument for which data is requested. This request parameter is available starting with the Ultra plan


- `isin` (string, optional, see notes)
  Filter by international securities identification number (ISIN). ISIN access is activating in the Data add-ons section


- `cusip` (string, optional, see notes)
  The CUSIP of an instrument for which data is requested. CUSIP access is activating in the Data add-ons section


- `interval` (string, required)
  Interval between two consecutive points in time series


- `exchange` (string, optional)
  Exchange where instrument is traded


- `mic_code` (string, optional)
  Market Identifier Code (MIC) under ISO 10383 standard


- `country` (string, optional)
  The country where the instrument is traded, e.g., `United States` or `US`


- `time_period` (integer, optional)
  Number of periods to average over. Takes values in the range from `1` to `800`


- `type` (string, optional)
  The asset class to which the instrument belongs


- `outputsize` (integer, optional)
  Number of data points to retrieve. Supports values in the range from `1` to `5000`. Default `30` when no date parameters are set, otherwise set to maximum


- `format` (string, optional)
  The format of the response data


- `delimiter` (string, optional)
  The separator used in the CSV response data


- `prepost` (boolean, optional)
  Returns quotes that include pre-market and post-market data. Only for `Pro` and above plans.
Available at the `1min`, `5min`, `15min`, and `30min` intervals for US equities.
Open, high, low, close values are supplied without volume


- `dp` (integer, optional)
  Specifies the number of decimal places for floating values.
Should be in range [0, 11] inclusive.
By default, the number of decimal places is automatically determined based on the values provided


- `order` (string, optional)
  Sorting order of the output


- `include_ohlc` (boolean, optional)
  Specify if OHLC values should be added in the output


- `timezone` (string, optional)
  Timezone at which output datetime will be displayed. Supports:

1. Exchange for local exchange time
2. UTC for datetime at universal UTC standard
3. Timezone name according to the IANA Time Zone Database. E.g. America/New_York, Asia/Singapore. Full list of timezones can be found here

Take note that the IANA Timezone name is case-sensitive


- `date` (string, optional)
  Specifies the exact date to get the data for. Could be the exact date, e.g. `2021-10-27`, or in human language `today` or `yesterday`


- `start_date` (string, optional)
  Can be used separately and together with `end_date`. Format `2006-01-02` or `2006-01-02T15:04:05`

Default location:

Forex and Cryptocurrencies - UTC
Stocks - where exchange is located (e.g. for AAPL it will be America/New_York)

Both parameters take into account if timezone parameter is provided.
If timezone is given then, start_date and end_date will be used in the specified location

Examples:

1. &symbol=AAPL&start_date=2019-08-09T15:50:00&…
Returns all records starting from 2019-08-09T15:50:00 New York time up to current date
2. &symbol=EUR/USD&timezone=Asia/Singapore&start_date=2019-08-09T15:50:00&…
Returns all records starting from 2019-08-09T15:50:00 Singapore time up to current date
3. &symbol=ETH/BTC&timezone=Europe/Zurich&start_date=2019-08-09T15:50:00&end_date=2019-08-09T15:55:00&...
Returns all records starting from 2019-08-09T15:50:00 Zurich time up to 2019-08-09T15:55:00



- `end_date` (string, optional)
  The ending date and time for data selection, see `start_date` description for details.


- `previous_close` (boolean, optional)
  A boolean parameter to include the previous closing price in the time_series data. If true, adds previous bar close price value to the current object


- `adjust` (string, optional)
  Adjusting mode for prices


**Notes:**

 - At least one of the following parameters is required: `symbol`, `isin`, `figi`, `cusip`.

## Response

- `meta` (object)
  Json object with request general information
  - `symbol` (string)
    The ticker symbol of an instrument for which data was requested.
  - `interval` (string)
    The time gap between consecutive data points.
  - `currency` (string)
    The currency of a traded instrument.
  - `exchange_timezone` (string)
    The timezone of the exchange where the instrument is traded.
  - `exchange` (string)
    The exchange name where the instrument is traded.
  - `mic_code` (string)
    The Market Identifier Code (MIC) of the exchange where the instrument is traded.
  - `type` (string)
    The asset class to which the instrument belongs.
  - `indicator` (object)
    Technical indicator information
    - `name` (string)
      Name of the technical indicator
    - `time_period` (integer)
      The time period used for calculation in the indicator

- `values` (array of object)
  Array of time series data points
  - `datetime` (string)
    Datetime in local market time for equities and in UTC for forex and cryptocurrencies referring to when the bar with specified interval was opened
  - `rvol` (string)
    RVOL value

- `status` (string)
  Response status


## Example Request

```bash
curl "https://api.twelvedata.com/rvol?symbol=AAPL&interval=1min&apikey=demo"
```

## Example Response

```json
{
    "meta": {
        "symbol": "AAPL",
        "interval": "1min",
        "currency": "USD",
        "exchange_timezone": "America/New_York",
        "exchange": "NASDAQ",
        "mic_code": "XNAS",
        "type": "Common Stock",
        "indicator": {
            "name": "RVOL - Relative Volume Indicator",
            "time_period": 14
        }
    },
    "values": [
        {
            "datetime": "2019-08-09 15:59:00",
            "rvol": "2.9054"
        }
    ],
    "status": "ok"
}
```