Glossary#

The new data infrastructure product uses the following terms, ordered alphabetically.

API#

Stands for Application Programming Interface. You can interact with software programmatically via its API. IEX Cloud provides the Apperate API Docs site and API tutorials. The tutorials are here in the Apperate Guides site.

CSV#

Stands for Comma Separated Value. It is a text format for specifying data using rows and columns. The first row’s values describe each column. Each subsequent row represents an instance of the data, including values (in some cases empty values) for each column.

See also

Load Data from a File demonstrates importing data from a CSV file.

Data Bundle#

A permissioned aggregation of datasets, focused around a common topic. You can purchase a license for the data bundles that suit your needs.

See also

The Data Bundles section introduces each data bundle.

Data Source#

DEPRECATED

Apperate and its features (including this feature) are deprecated.

A source from which data is ingested into Apperate.

The following tutorials demonstrate using data sources:

Data Timing#

The typical frequency of new data being produced for an entity (e.g., stock price, company dividends, etc.). An IEX Cloud Financial Data endpoint doc’s Data Timing section describes the new data frequency for the respective entity. For examples, see the Data Timing section of any endpoint listed in IEX Cloud Data navigation in the API reference.

Dataset#

DEPRECATED

Apperate and its features (including this feature) are deprecated.

A modifiable data collection (or table) that is defined by a schema, stored in IEX Cloud Apperate, and delivered via permissioned, auto-generated APIs.

See these articles to understand datasets and learn how to use them:

Date Index#

Designates the time series index portion of a dataset’s Unique Index.

Ingest (Ingest data)#

DEPRECATED

Apperate and its features (including this feature) are deprecated.

To load data into a dataset.

Ingestion Schedule#

DEPRECATED

Apperate and its features (including this feature) are deprecated.

A timetable, set by the user, to automatically ingest data from a given data source into IEX Cloud.

Job (Data Job)#

DEPRECATED

Apperate and its features (including this feature) are deprecated.

A data-processing instance.  There are jobs for ingesting, modifying, and deleting data.

JSON#

Stands for JavaScript Object Notation. It is a text format for specifying objects.

Primary index#

A property that serves as a record’s main identifier.

Publishable Token (Publishable Key)#

Publishable tokens are API tokens that authorize access to IEX Cloud Data endpoints of purchased Data Bundles, access to workspace endpoints, and access to resource APIs.

Paid account admin users can create and manage publishable tokens in the Console.

Tip

The console Home page’s API Tokens section lists the current user’s publishable token and the team’s secret token.

Note

Calling example requests in the API Docs requires applying an API Token.

See also

Token and Access and Security.

Secondary index#

A property that serves as an identifier that’s used in addition to the Primary index.

Secret Token (Secret Key)#

All organizations have a secret token (aka secret key). It is an API token that authorizes access to all IEX Cloud Data endpoints of purchased Data Bundles, access to all the organization’s workspace endpoints, and access to all the resource APIs. NEVER share your secret token publicly.

Paid account admin users can create publishable tokens to grant specific access to IEX Cloud Data endpoints, workspace endpoints, and resource APIs. Your secret token is available in the Console.

Tip

The console Home page’s API Tokens section lists the current user’s publishable token and the team’s secret token.

Note

Calling example requests in the API Docs requires applying an API Token.

See also

Token and Access and Security.

Storage Amount (Plan Storage Amount)#

The amount of data an Apperate plan includes.

Storage credit usage is based on your plan’s Storage Amount and is calculated and reported hourly as the STORAGE_ON_DISK endpoint’s Credits Used.

Important

You cannot exceed your plan’s Storage Amount. Apperate blocks any attempt to exceed the Storage Amount. You must upgrade your plan (see your Manage Plan page) to store more data.

Token (API Token)#

API tokens (aka API keys) authorize access to IEX Cloud Data endpoints, workspace endpoints, and resource APIs. Tokens can have data endpoint read access and read, write, and/or delete permissions for resources.

Each organization (team) has a secret token and can have one or more publishable tokens. The secret token authorizes access to all all IEX Cloud Data endpoints of purchased Data Bundles, access to all the organization’s workspace endpoints, and access to all the resource APIs. NEVER share your secret token publicly.

Paid account admin users can create and manage publishable tokens in the Console.

There are several ways you can apply an API Token to your API Docs session. The animation below demonstrates using the Apply Token page.

Note

All team users can view their team’s tokens in the Console.

Tip

The console Home page’s API Tokens section contains the current user’s publishable token and the team’s secret token.

See also

See Access and Security to learn how to create and administer API tokens.

Unique Index#

DEPRECATED

Apperate and its features (including this feature) are deprecated.

A dataset’s main key composed of the Primary index, Secondary index (optional), and Date index.

Update Schedules#

The regular times Apperate publishes new data to an IEX Cloud Financial Data dataset. A dataset endpoint doc’s Update Schedule section describes the publishing times. For examples, see the Update Schedule section of any endpoint listed in IEX Cloud Data navigation in the API reference.

View#

DEPRECATED

Apperate and its features (including this feature) are deprecated.

A virtual dataset created from a SQL query that joins multiple datasets.

See also

Create a View.

Workspace#

DEPRECATED

Apperate and its features (including this feature) are deprecated.

Your unique domain for building and publishing datasets. The URL format and example below show workspace names and dataset names in bold.

URL Format: https://workspace.iex.cloud/v1/data/WORKSPACE/DATASET

Example: https://my.iex.cloud/v1/data/MY/CARS

Note

Apperate displays your workspace name in the Console at the top left in your Home and at the top of Datasets navigation.

See also

Create a Workspace.