icecta

Create Intercontinental Exchange (ICE) Climate Transaction Analytics (CTA) connection

Since R2024a

Description

The icecta function creates an object that represents a connection to the Intercontinental Exchange^® (ICE^®) data server. After you create an icecta object, you can retrieve Climate Transaction Analytics (CTA) data for use in your climate data workflows.

Creation

Syntax

c = icecta(token)

c = icecta(token,timeout,url,mediatype,debugmodevalue)

Description

c = icecta(token) creates a connection to the ICE data server that allows you to access CTA data using a valid authentication token.

c = icecta(token,timeout,url,mediatype,debugmodevalue) additionally sets the timeout value, the ICE base endpoint URL, the REST API call media type, and the MATLAB^® HTTP library debug value for the connection to the ICE data server.

Input Arguments

token — ICE authentication token

character vector | string scalar

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

Example:

"7eAVoodVJjHXydBrb_OkYJd3tQyv6qviuDw"

timeout — Timeout value

200 (default) | positive numeric scalar

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

url — ICE base endpoint URL

https://clientapi.urgentem.net/download/ (default) | character vector | string scalar

ICE 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 (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 0, 1, or 2. The value of this argument controls the amount of diagnostic information returned.

• 0 returns no diagnostic information.

• 1 returns partial diagnostic information.

• 2 returns complete diagnostic information.

This argument sets the DebugModeValue property.

Properties

Public

TimeOut — Timeout value

positive numeric scalar

Timeout value for ICE REST API call responses. This property is set by the timeout argument.

Private

Token — ICE authentication token

character vector | string scalar

ICE authentication token. This property is set by the token argument.

Hidden

DebugModeValue — MATLAB HTTP library debug mode

0 (default) | 1 | 2

MATLAB HTTP library debug value. This property is set by the debugmodevalue argument.

MediaType — REST API call media type

character vector | string scalar

REST API call media type. This property is set by the mediatype argument.

URL — ICE base endpoint URL

character vector | string scalar

ICE base endpoint URL. This property is set by the url argument.

Object Functions

getData

Intercontinental Exchange (ICE) Climate Transition Analytics (CTA) data request

Examples

Create Intercontinental Exchange Connection

Create an icecta connection using a valid authentication token. In this example, replace 7eAVoodVJjHXydBrb_OkYJd3tQyv6qviuDw with your authentication token.

token = "7eAVoodVJjHXydBrb_OkYJd3tQyv6qviuDw";
c = icecta(token)

c = 
    
      icecta with properties:
    
             TimeOut: 200.00

Version History

Introduced in R2024a