haverview

Create HaverView cloud connection

Since R2024a

Description

The haverview function creates an object that represents a connection to the HaverView™ cloud platform. After you create a haverview object, you can retrieve historical data for a specified range as well as information about database lists, variables, recessions, and currencies.

Accessing the HaverView platform requires an authentication token from Haver Analytics^®. For details on obtaining a token, see https://haverproducts.com/.

From MATLAB^®, you can retrieve HaverView data by following these steps:

1. Create a HaverView connection by using the haverview function.

2. List available databases by using the databases function.

3. List database variables by using the info function.

4. Retrieve data by using the fetch function.

Creation

Syntax

c = haverview(token,databasename)

c = haverview(token,databasename,timeout,url,mediatype,debugmodevalue)

Description

c = haverview(token,databasename) creates a connection to a database on the HaverView cloud platform using a valid authentication token.

c = haverview(token,databasename,timeout,url,mediatype,debugmodevalue) sets the timeout value, the HaverView base endpoint URL, the REST API call media type, and the MATLAB HTTP library debug value.

Input Arguments

token — HaverView authentication token

character vector | string scalar

HaverView authentication token, specified as a character vector or string scalar. This argument sets the Token property.

Example: "681b61cf-dc7d-4698-a168-74c79b0c1a04"

databasename — HaverView database name

character vector | string scalar

HaverView database name, specified as a character vector or string scalar. This argument sets the DatabaseName property.

Example: "USECON"

timeout — Timeout value

200 (default) | positive numeric scalar (seconds)

Timeout value for HaverView REST API call responses, specified as a positive numeric scalar. This argument sets the TimeOut property.

url — HaverView base endpoint URL

https://api.haverview/v2/data.com (default) | character vector | string scalar

HaverView base endpoint URL, specified as a character vector or string scalar. This argument sets the URL property.

mediatype — REST API call media type

applications/json; charset=UTF-8 (default) | character vector | string scalar

REST API call media type, specified as a character vector or string scalar. This argument sets the MediaType property.

debugmodevalue — MATLAB HTTP library debug mode

0 (default) | 1 | 2

MATLAB HTTP library debug mode, specified as a numeric scalar. You can control the amount of diagnostic information that returns when making data requests by setting this argument as follows:

• 0 returns no output.

• 1 returns partial output.

• 2 returns complete output.

This argument sets the DebugModeValue property.

Properties

DatabaseName — HaverView database name

character vector | string scalar

HaverView database name, specified as a character vector or string scalar. This property is set by the databasename argument.

Public

TimeOut — Timeout value

positive numeric scalar (seconds)

Timeout value for HaverView REST API call responses, specified as a positive numeric scalar. This property is set by the timeout argument.

Private

Token — HaverView authentication token

character vector | string scalar

HaverView authentication token, specified as a character vector or string scalar. This property is set by the token argument.

Hidden

DebugModeValue — MATLAB HTTP library debug mode

0 (default) | 1 | 2

MATLAB HTTP library debug mode, specified as a numeric scalar. You can control the amount of diagnostic information that returns when making data requests by setting this property as follows:

• 0 returns no output.

• 1 returns partial output.

• 2 returns complete output.

This property is set by the debugmodevalue argument.

MediaType — REST API call media type

character vector | string scalar

REST API call media type, specified as a character vector or string scalar. This property is set by the mediatype argument.

URL — HaverView base endpoint URL

character vector | string scalar

HaverView base endpoint URL, specified as a character vector or string scalar. This property is set by the url argument.

Object Functions

databases	Retrieve HaverView database information
fetch	Request data from Haver Analytics database
info	Retrieve information about Haver Analytics variables
search	Search for HaverView variables
series	Retrieve HaverView series information
recessions	Retrieve HaverView recession information
currencies	Retrieve HaverView currency information

Examples

Create HaverView Connection

Create a HaverView connection by using a valid authentication token and database name. In this example, replace 681b61cf-dc7d-4698-a168-74c79b0c1a04 with your authentication token and replace USECON with the name of your database.

token = "681b61cf-dc7d-4698-a168-74c79b0c1a04";
databasename = "USECON";
c = haverview(token,databasename)

c = 
    
  haverview with properties:
    
    DatabaseName: "USECON"
         TimeOut: 200.00

Version History

Introduced in R2024a