---
title: "On balance volume"
method: GET
path: "/obv"
tags: ["technical_indicator"]
---

# On balance volume

`GET /obv`

The On Balance Volume (OBV) endpoint provides a time series of the OBV indicator, which calculates cumulative volume to reflect buying and selling pressure over time. This endpoint returns data that helps users track volume trends in relation to price movements, aiding in the identification of potential trend continuations or reversals in a security's price.

## Query parameters

- `symbol` string
- `isin` string
- `figi` string
- `cusip` string
- `interval` '1min' | '5min' | '15min' | '30min' | '45min' | '1h' | '2h' | '4h' | '8h' | '1day' | '1week' | '1month', required
- `outputsize` integer
- `exchange` string
- `mic_code` string
- `country` string
- `type` 'American Depositary Receipt' | 'Bond' | 'Bond Fund' | 'Closed-end Fund' | 'Common Stock' | 'Depositary Receipt' | 'Digital Currency' | 'ETF' | 'Exchange-Traded Note' | 'Global Depositary Receipt' | 'Limited Partnership' | 'Mutual Fund' | 'Physical Currency' | 'Preferred Stock' | 'REIT' | 'Right' | 'Structured Product' | 'Trust' | 'Unit' | 'Warrant'
- `timezone` string
- `start_date` string
- `end_date` string
- `date` string
- `order` 'asc' | 'desc'
- `prepost` boolean
- `format` 'JSON' | 'CSV'
- `delimiter` string
- `dp` integer
- `previous_close` boolean
- `adjust` 'all' | 'splits' | 'dividends' | 'none'
- `series_type` 'close' | 'open' | 'high' | 'low' | 'volume'
- `include_ohlc` true | false

## Response `200`

- object
  - `meta` object, required — Json object with request general information
    - `symbol` string, required — The ticker symbol of an instrument for which data was requested.
    - `interval` string, required — 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, required — The asset class to which the instrument belongs.
    - `indicator` object, required — Technical indicator information
      - `name` string, required — Name of the technical indicator
      - `series_type` string, required — Price type on which technical indicator is calculated
  - `values` object[], required — Array of time series data points
    - `datetime` string, required — Datetime in local market time for equities and in UTC for forex and cryptocurrencies referring to when the bar with specified interval was opened
    - `obv` string, required — obv value
    - `open` string — Price at the opening of current bar. Returned when `include_ohlc` is `true`.
    - `high` string — Highest price which occurred during the current bar. Returned when `include_ohlc` is `true`.
    - `low` string — Lowest price which occurred during the current bar. Returned when `include_ohlc` is `true`.
    - `close` string — Close price at the end of the bar. Returned when `include_ohlc` is `true`.
    - `volume` string — Trading volume which occurred during the current bar. Returned when `include_ohlc` is `true`.
  - `status` string, required — Response status

## Other responses

- `400`
- `401`
- `403`
- `404`
- `414`
- `429`
- `500`

---

[API](https://skmtc.net/twelvedata/apis/twelve-data-api.md) · [All operations](https://skmtc.net/twelvedata/apis/twelve-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/twelvedata/twelve-data-api/revisions/c4a12725cdb5/schema)
