# Intrinio::HistoricalDataApi All URIs are relative to *https://api-v2.intrinio.com* Method | HTTP request | Description ------------- | ------------- | ------------- [**get_historical_data**](HistoricalDataApi.md#get_historical_data) | **GET** /historical_data/{identifier}/{tag} | Historical Data [//]: # (START_OPERATION) [//]: # (CLASS:Intrinio::HistoricalDataApi) [//]: # (METHOD:get_historical_data) [//]: # (RETURN_TYPE:Intrinio::ApiResponseHistoricalData) [//]: # (RETURN_TYPE_KIND:object) [//]: # (RETURN_TYPE_DOC:ApiResponseHistoricalData.md) [//]: # (OPERATION:get_historical_data_v2) [//]: # (ENDPOINT:/historical_data/{identifier}/{tag}) [//]: # (DOCUMENT_LINK:HistoricalDataApi.md#get_historical_data) ## **get_historical_data** [**View Intrinio API Documentation**](https://docs.intrinio.com/documentation/ruby/get_historical_data_v2) [//]: # (START_OVERVIEW) > ApiResponseHistoricalData get_historical_data(identifier, tag, opts) #### Historical Data Returns historical values for the given `tag` and the entity represented by the given `identifier` [//]: # (END_OVERVIEW) ### Example [//]: # (START_CODE_EXAMPLE) ```ruby # Load the gem require 'intrinio-sdk' require 'pp' # Setup authorization Intrinio.configure do |config| config.api_key['api_key'] = 'YOUR_API_KEY' end historicalData_api = Intrinio::HistoricalDataApi.new identifier = "AAPL" # String | An identifier for an entity such as a Company, Security, Index, etc (Ticker, FIGI, ISIN, CUSIP, CIK, LEI, Intrinio ID) tag = "marketcap" # String | An Intrinio data tag ID or code (reference) opts = { frequency: "daily", # String | Return historical data in the given frequency type: nil, # String | Filter by type, when applicable start_date: Date.parse("2015-01-01"), # Date | Get historical data on or after this date end_date: nil, # Date | Get historical date on or before this date sort_order: "desc", # String | Sort by date `asc` or `desc` page_size: 100, # Integer | The number of results to return next_page: nil # String | Gets the next page of data from a previous API call } begin result = historicalData_api.get_historical_data(identifier, tag, opts) pp result rescue Intrinio::ApiError => e puts "Exception when calling HistoricalDataApi->get_historical_data: #{e}" end ``` [//]: # (END_CODE_EXAMPLE) [//]: # (START_DEFINITION) ### Parameters [//]: # (START_PARAMETERS) Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **identifier** | String| An identifier for an entity such as a Company, Security, Index, etc (Ticker, FIGI, ISIN, CUSIP, CIK, LEI, Intrinio ID) |   **tag** | String| An Intrinio data tag ID or code (<a href='https://data.intrinio.com/data-tags'>reference</a>) |   **frequency** | String| Return historical data in the given frequency | [optional] [default to daily]   **type** | String| Filter by type, when applicable | [optional]   **start_date** | Date| Get historical data on or after this date | [optional]   **end_date** | Date| Get historical date on or before this date | [optional]   **sort_order** | String| Sort by date `asc` or `desc` | [optional] [default to desc]   **page_size** | Integer| The number of results to return | [optional] [default to 100]   **next_page** | String| Gets the next page of data from a previous API call | [optional]  
[//]: # (END_PARAMETERS) ### Return type [**ApiResponseHistoricalData**](ApiResponseHistoricalData.md) [//]: # (END_OPERATION)