Documentation | Intrinio

Documentation

Intrinio offers a variety of ways to access financial data. Choose your preferred access method below:

API
Excel
CSV

API Documentation

{{ docSectionTitle }} Documentation

Welcome to the Intrinio Financial Data Platform! Through our Financial Data Marketplace, we offer a wide selection of financial data feeds sourced by our own proprietary processes as well as from many data vendors. The Intrinio API uses HTTPS verbs and a RESTful endpoint structure, which makes it easy to request data from Intrinio. Basic Authentication is administered over HTTPS. Responses are delivered in JSON format.

Getting Started

First, you'll need an Intrinio account for your API access credentials.

Sign Up for API Access

If you have an Intrinio account you can view your Account API Access Keys here.

For a quick-start guide to our API, please see the tutorial.

If you need additional help using the API, chat with us.

Authentication

Private

You can find your API Key(s) on your Account API Access Keys page.

You must include a valid API Key with every request in-order to access to the API.

If your API Key is not authorized, a status code of 401 will be returned.

URL Parameter Authentication

Simply include your API Key in the HTTPS request by specifying an api_key URL parameter set to the value of your API Key.

For example:

https://api.intrinio.com/prices?identifier=AAPL&api_key={{base64_encoded_api_key}} https://api.intrinio.com/prices?identifier=AAPL&api_key=OjA1ZTFiNGZiN2U4Y2JlNjAwNzE0OGQ4YjM2YTFmNjRk

* Showing your API Key.
* Example API Key is not valid.



Authorization Header Authentication

Include your API Key in the HTTPS request by specifying an Authorization header with the value:

Bearer [API_KEY]

Simply replace [API_KEY] with your valid API Key.

For example:

Authorization: Bearer {{base64_encoded_api_key}} Authorization: Bearer OjA1ZTFiNGZiN2U4Y2JlNjAwNzE0OGQ4YjM2YTFmNjRk

* Showing your API Key.
* Example API Key is not valid.



Public

For public/untrusted environments (such as client-side JavaScript), use our public key authentication over HTTPS.

You can create a Public Access Key on your Account Access Keys page. Make sure to specify all domains from which this key may be used. Any domain not listed will be rejected by the API. For development purposes, localhost is listed as a domain by default. Make sure to delete this domain before going to production.

To include a public key in your HTTPS request, specify it as the value of an X-Authorization-Public-Key header.

If your public key is not authorized, a status code of 401 will be returned.

Response Codes

Intrinio uses normal HTTP response codes to indicate the success or failure of an API request. A response code of 200 indicates success and codes in the 4xx range indicate an error that failed given the information provided, and codes in the 5xx range indicate an error with Intrinio’s servers (these are rare).

The Intrinio API uses the following error codes:

Code Meaning
200 OK – Everything worked as expected
401 Unauthorized – Your User/Password API Keys are incorrect
403 Forbidden – You are not subscribed to the data feed requested
404 Not Found – The endpoint requested does not exist
429 Too Many Requests – You have hit a limit. See limits
500 Internal Server Error – We had a problem with our server. Try again later.
503 Service Unavailable – You have hit your throttle limit or Intrinio may be experiencing high system load.

Paging

Often there is too much information in our system to serve in a single request of reasonable size. Therefore we limit results to a certain number per request and provide you with paging information which can be used to retrieve the remaining pages of data.

In the Web API, you will notice that most requests contain paging information.

File Downloads may have paging information as well, listed in the first row.

In order to request the next page of data, append a page_number parameter to your request:

https://api.intrinio.com/companies
https://api.intrinio.com/companies?page_number=2
https://api.intrinio.com/companies?page_number=3

Limits

The Intrinio API employs several reasonable limits to ensure that stable, reliable service is provided to all users. These limits can vary based on the type of API request you are making. If you hit an API limit, the response will contain a 429 code and an explanation of the limit.

Daily Request Limits

Most data feed subscriptions have limited daily usage. This means that you can make up to a certain number of API requests in a 24-hour period (resetting at midnight Eastern). To view the limits for a data feed subscription, go to your Account page, click on Subscriptions, click on the subscription in question, and click on Limits.

Per-Minute Request Limits

Some data feed subscriptions have limited usage per x minutes. This means that you can make up to a certain number of API requests in x minutes. Common timeframes are 10 minutes and 1 minute.

Per-Second Request Limits

Certain high-workload API request are limited by the second. This means that you can make up to a certain number of API requests per second.

Paging Limits

API endpoints that return a list of data often employ paging to allow users to retrieve the rest of the data. Below are the default and maximum page sizes for various endpoints:

Endpoint Default Page Size Maximum Page Size
historical_data 1,000 10,000
All others 100 10,000

Certain requests are considered "high-paging" and are subject to additional limits:

  • Requests with a page size that is higher than the Default Page Size
  • Requests with a page offset greater than or equal to the Maximum Page Size

These request are limited by:

User Type High-Paging Request Limit
Free 1 per minute
Paid 1 per second
Custom Contact Sales

Bulk Request Limits

Certain API endpoints allow you to make "bulk" requests that return all of the available data. These requests are limited by:

User Type Bulk Request Limit
Free 1 per minute
Paid 1 per second
Custom Contact Sales

Throttle Limits

Users enjoying free data feed subscriptions only are limited to 100 requests per second.

Timeout Limits

Each request must be fulfilled within 25 seconds, otherwise it will be dropped with a 503 error. Given the flexibility of our endpoints and the complexity of potential API requests, we leave it to the users to fashion requests which can be satisfied in a reasonable time.

Usage & Limits

The following endpoints will help you to check your API access, limits, and usage:

Note: this is limited to data feeds with daily API requests limits.

Welcome to the Intrinio Financial Data Platform! Through our Data Marketplace, we offer a wide selection of financial data feeds sourced by our own proprietary processes as well as from many data vendors. The Intrinio Excel Add-In allows you to access a variety of datasets right in Excel, using simple, intuitive functions.

The Excel Add-in works on both Mac OS X and Microsoft Windows versions of Excel.

If you need additional help, chat with us.

Getting Started

For a quick guide to getting started with our Excel Add-In, please see the Tutorial.

Welcome to the Intrinio Financial Data Platform! Through our Data Marketplace, we offer a wide selection of financial data feeds sourced by our own proprietary processes as well as from many data vendors. All of our data is available for download in the CSV (comma-separated values) format.

If you need additional help, chat with us.

Getting Started

For a quick guide to getting started with our CSV Download functionality, please see the Tutorial.

Authentication

When using the download links, your browser will prompt you for a username and password. These credentials correspond to your access keys, which can be found in your Account page.

Limits

CSV Downloads are limited according to the matrix below. If you exceed the limit, the system will return a 429 error. If you need to download a larger dataset, we recommend browsing our Financial Data Downloads , which allow you to download massive datasets for a flat fee.

User Type CSV Download Limit
Free 1 per minute
Paid 1 per second
Custom Contact Sales

Paging

Sometimes there is too much information in our system to put into a single file of reasonable size. Therefore we limit file downloads to 10,000 rows. In order to retrieve the rest of the rows, you will have to request the second "page" of results. The first row of each file will contain paging information: RESULT_COUNT: 6342 , PAGE_SIZE: 10000 , CURRENT_PAGE: 1, TOTAL_PAGES: 1 , API_CALL_CREDITS: 1

  • RESULT_COUNT tells you how many total rows there are in our system
  • PAGE_SIZE tells you how many records you are fetching per page
  • CURRENT_PAGE tells you which page you are currently viewing
  • TOTAL_PAGES tells you how many total pages there are
  • API_CALL_CREDITS tells you how many API calls credits your request consumed

If the TOTAL_PAGES field in your file is greater than 1 and you want to see the other pages, append a page_number parameter to the URL:

https://api.intrinio.com/indices.csv?type=economic&page_number=1
https://api.intrinio.com/indices.csv?type=economic&page_number=2
https://api.intrinio.com/indices.csv?type=economic&page_number=3

To exclude the paging information from your file, include a hide_paging parameter in the URL:

https://api.intrinio.com/indices.csv?type=economic&page_number=1&hide_paging=true

URL Formatting

URLs must be formatted correctly in order for file downloads to be processed successfully. Here are examples of correct URLs:

https://api.intrinio.com/indices.csv
https://api.intrinio.com/indices.csv?type=economic
https://api.intrinio.com/indices.csv?type=economic&query=GDP
https://api.intrinio.com/data_point.csv?identifier=AAPL&item=marketcap,beta

Here are examples of incorrect URLs:

https://api.intrinio.com/indices.csv&type=economic
https://api.intrinio.com/indices.csv?type=economic?query=GDP
https://api.intrinio.com/data_point.csv?identifier=AAPL&item=marketcap/beta

Here is a key to the different parts of a URL:

https://api.intrinio.com /data_point.csv ? identifier = AAPL & item = marketcap,beta
1 2 3 4 5 6 7 8 9 10

  1. Intrinio's API web address.
  2. The location of the data you are trying to access.
  3. The separator between the URL address and the URL parameters.
  4. The name of the URL parameter.
  5. The separator between the name of the URL parameter and the value of the URL parameter.
  6. The value of the URL parameter.
  7. The separator between URL parameters.
  8. The name of the URL parameter.
  9. The separator between the name of the URL parameter and the value of the URL parameter.
  10. The value of the URL parameter. Note some parameters allow multiple values - separate them with a comma.

Data Point

Returns the most recent data point for a selected identifier (ticker symbol, stock market index symbol, CIK ID, etc.) for a selected tag. Income statement, cash flow statement, and ratios are returned as trailing twelve months values. All other data points are returned as their most recent value, either as of the last release financial statement or the most recent reported value.

Parameters

Name Description Example
identifier
* required
An identifier, which can be a security ticker, SEC CIK ID, FRED Series ID, etc. AAPL
item
* required
An item, which can be a data tag or a special code. marketcap
hide_paging
* required
Hide first row of paging information.
Options:
true
-

Output Fields

Name Description Type Example
identifier the ticker or identifier for the data point string AAPL
item the requested standardized tag or series ID string name

Historical Data

Returns the historical data for for a selected identifier (ticker symbol or index symbol) for a selected tag. Income statement, cash flow statement, and ratios are returned as trailing twelve months values by default, but can be changed with the type parameter. All other historical data points are returned as their value on a certain day based on filings reported as of that date.

Parameters

Name Description Example
identifier
* required
An identifier, which can be a security ticker, SEC CIK ID, FRED Series ID, etc. AAPL
item
* required
An item, which can be a data tag or a special code. marketcap
start_date
* required
The earliest date for which to return data. 2018-04-02
end_date
* required
The latest date for which to return data. 2018-5-03
frequency
* required
The frequency of the historical prices & valuation data.
Options:
daily
weekly
monthly
quarterly
yearly
yearly
type
* required
The type of historical data to fetch. For financial statements, the type reflects the type of financial statement. For Sector data, the type reflect the aggretation (mean, median, max, min) type of the data.
Options:
FY
QTR
TTM
YTD
count
sum
max
75thpctl
mean
median
25thpctl
min
FY
sequence
* required
An integer 0 or greater for calling a single historical data point from the first entry, based on sort order. 0
show_date
* required
If true, the function will return the date value, and if false the function will return the data point value for a given query.
Options:
Yes
Yes
page_number
* required
An integer greater than or equal to 1 for specifying the page number for the return values. 4
page_size
* required
An integer greater than or equal to 1 for specifying the number of results on each page. 10
hide_paging
* required
Hide first row of paging information.
Options:
true
true

Output Fields

Name Description Type Example
identifier the ticker or identifier for the data point - AAPL
item the requested standardized tag or series ID - marketcap
date the date associated with the value of the data tag - 2016-12-31
value the value of the Intrinio tag of the financial data point - 45936

Securities

Returns security list and information for all securities covered by Intrinio.

Parameters

Name Description Example
query
* required
A string query search of security name or ticker symbol with the returned results being the relevant securities in compacted list format. AAPL
identifier
* required
The identifier for the legal entity or a security associated with the security. A
exch_symbol
* required
The Intrinio Stock Market Symbol, to specify the exchange for the list of securities. NYSE
last_crsp_adj_date
* required
A date value that returns the list of securities that have had adjusted stock prices due to a corporate event after this date. 2017-12-29
us_only
* required
Return only US-based securities.
Options:
Yes
Yes
page_number
* required
An integer greater than or equal to 1 for specifying the page number for the return values. 3
page_size
* required
An integer greater than or equal to 1 for specifying the number of results on each page. 15
hide_paging
* required
Hide first row of paging information.
Options:
true
-

Output Fields

Name Description Type Example
ticker the stock market ticker symbol associated with the companies common stock securities string A
figi_ticker the OpenFIGI ticker symbol string A:UN
figi the OpenFIGI identifier string BBG000C2V541
composite_figi the OpenFIGI composite-level identifier string BBG000C2V3D6
composite_figi_ticker the OpenFIGI composite-level ticker string BBG00B3T3HD3
security_name the security description as provided by the exchange string Alcoa Corp
market_sector the type of market for the security string Equity
security_type the type of security, such as Common Stock, Preferred Stock, Warrants, Limited Partnership Interests, etc. string Ordinary Shares
stock_exchange the Stock Exchange (and market category) where the company’s common stock is primarily traded string NYSE
last_crsp_adj_date the last recorded date (“YYYY-MM-DD”) of an CRSP adjustment made to prior prices due to a stock split or dividend event. date 2017-12-29
figi_uniqueid the security’s unique FIGI identifier string EQ0000000045469815
share_class_figi the security’s share class FIGI identifier string BBG00B3T3HF1
figi_exch_cntry the security’s FIGI country of the exchange string US
currency the security’s traded currency on the listed exchange string USD
mic the Market Identification Code for the Stock Exchange where the security is listed. string XNYS
exch_symbol the Intrinio Stock Exchange Symbol used as an identifier on the Intrinio API. string ^XNYS
etf a boolean to represent whether the security is an ETF or otherwise boolean false
delisted_security if the security is no longer traded on public exchanges, the security will be considered delisted and the security no longer will report pricing data. boolean false
primary_listing a boolean to represent whether the security is the primary issue or a secondary issue of the security on a different stock exchange. boolean true
previous_tickers An array of ticker symbols that this security previously traded under array -

Stock Exchanges

Returns stock exchange list and information for all stock exchanges covered by Intrinio.

Parameters

Name Description Example
identifier
* required
An identifer for a stock exchange, which can be the MIC, symbol, or acronym. XLON
query
* required
A string query search of stock exchange name or MIC with the returned results being the relevant stock exchanges in compacted list format. London
page_number
* required
An integer greater than or equal to 1 for specifying the page number for the return values. 2
page_size
* required
An integer greater than or equal to 1 for specifying the number of results on each page. 10
hide_paging
* required
Hide first row of paging information.
Options:
true
true

Output Fields

Name Description Type Example
symbol the Intrinio symbol associated with the stock exchange string ^BMEX
mic the MIC identifier for the stock exchange string BMEX
institution_name the name of the stock exchange string BME - BOLSAS Y MERCADOS ESPANOLES
acronym the stock exchanges short form identifier string BME
city the city where the stock exchange is located string MADRID
country the country where the stock exchange is located string SPAIN
country_code the country code for the country where the stock exchange is located string ES
website the website for the stock exchange string HTTP://WWW.BOLSASYMERCADOS.ES

Prices

Returns professional-grade historical stock prices for a security or stock market index. Historical prices are available back to 1996 or the IPO date, with some companies with data back to the 1970s. Stock market index historical price data is available back to the 1950s at the earliest.

Parameters

Name Description Example
identifier
* required
The stock market ticker symbol associated with the companies common stock securities or the stock market index. AAPL
item
* required
The selected observation of the historical prices.
Options:
date
open
high
low
close
volume
ex_dividend
split_ratio
adj_open
adj_high
adj_low
adj_close
adj_volume
close
start_date
* required
The first date in which historical stock prices are delivered- historical daily prices go back to 1996 for most companies, but some go back further to the 1970s or to the date of the IPO. 2014-09-28
end_date
* required
The last date in which historical stock prices are delivered- end of day prices are available around 5 p.m. EST and real-time prices are updated every minute throughout the trading day. 2015-09-28
frequency
* required
The frequency of the historical prices.
Options:
daily
weekly
monthly
quarterly
yearly
daily
sequence
* required
An integer 0 or greater for calling a single historical data point from the first entry, based on sort order. 0
bulk
* required
When true, returns all available prices in the same response. Cannot be used with any other parameters besides ticker/identifier.
Options:
true
true
page_number
* required
An integer greater than or equal to 1 for specifying the page number for the return values. 3
page_size
* required
An integer greater than or equal to 1 for specifying the number of results on each page. 20
sort_order
* required
The order of the historical stock price dates.
Options:
asc
desc
asc
hide_paging
* required
Hide first row of paging information.
Options:
true
true

Output Fields

Name Description Type Example
date the date of the stock price historical data date 2016-09-23
open the actual observed first traded stock price on the trading date number 114.42
high the actual observed highest traded stock price on the trading date number 114.79
low the actual observed lowest traded stock price on the trading date number 111.55
close the actual observed last trade stock price on the trading date number 112.71
volume the actual observed number of shares of stock traded between market participants on the trading date number 52481151.0
ex_dividend the nonsplit adjusted dividend per share on the ex-dividend date; not available on index historical prices number 0.0
split_ratio the split factor on the split date - not available on index historical prices number 1.0
adj_open the dividend and split adjusted open price; not available on index historical prices number 114.42
adj_high the dividend and split adjusted high price; not available on index historical prices number 114.79
adj_low the dividend and split adjusted low price; not available on index historical prices number 111.55
adj_close the dividend and split adjusted close price; not available on index historical prices number 112.71
adj_volume the dividend and split adjusted volume; not available on index historical prices number 52481151.0

Price Adjustments

Returns adjustments to stock prices, derived from dividends and splits.

Parameters

Name Description Example
identifier
* required
The stock market ticker symbol associated with the company's common stock. AAPL
start_date
* required
The earliest date for which to return adjustments. 2014-09-28
end_date
* required
The latest date for which to return adjustments. 2015-09-28
page_number
* required
An integer greater than or equal to 1 for specifying the page number for the return values. 3
page_size
* required
An integer greater than or equal to 1 for specifying the number of results on each page. 20
hide_paging
* required
Hide first row of paging information.
Options:
true
true

Output Fields

Name Description Type Example
date the date of the stock price adjustment date 2016-09-23
factor the total adjustment factor by which earlier prices should be divided, including both dividends and splits number 0.5
dividend the non-split-adjusted dividend per share on the ex-dividend date number 0.3
dividend_currency the currency that the dividend was paid in number USD
split_ratio the factor by which shares were divided number 0.5

Exchange Prices

Returns professional-grade historical stock prices for all securities traded on a stock exchange for a single specified day. Historical prices are available back to 1996 or the IPO date, with some companies with data back to the 1970s.

Please note: Specifying XNAS (NASDAQ) or XNYS (New York Stock Exchange) identifiers will return all securities listed on US exchanges (USCOMP).

Parameters

Name Description Example
identifier
* required
The stock market ticker symbol associated with the companies common stock securities or the stock market index. USCOMP
price_date
* required
The specified date in which historical stock prices are returned for a stock exchange. 2016-12-30
page_number
* required
An integer greater than or equal to 1 for specifying the page number for the return values. 3
page_size
* required
An integer greater than or equal to 1 for specifying the number of results on each page. 10
hide_paging
* required
Hide first row of paging information.
Options:
true
true

Output Fields

Name Description Type Example
ticker the stock exchange ticker symbol as listed on the stock exchange string AAB
figi_ticker the OpenFIGI Ticker Symbol string AAB:CT
figi the FIGI identifier string BBG000D2T2D0
date the date of the stock price historical data date 2016-12-30
open the actual observed first traded stock price on the trading date number 0.16
high the actual observed highest traded stock price on the trading date number 0.16
low the actual observed lowest traded stock price on the trading date number 0.155
close the actual observed last trade stock price on the trading date number 0.155
volume the actual observed number of shares of stock traded between market participants on the trading date number 39000
ex_dividend the non-split adjusted dividend per share on the ex-dividend date number 0
split_ratio the split factor on the split date number 1
adj_open the dividend and split adjusted open price number 0.16
adj_high the dividend and split adjusted high price number 0.16
adj_low the dividend and split adjusted low price number 0.155
adj_close the dividend and split adjusted close price number 0.155

Securities Search/Screener

Returns security list and information all securities that match the given conditions. The API call credits required for each call is equal to the number of conditions specified.

Parameters

Name Description Example
screener_conditions
* required
A list of conditions used to filter the resulting securities. See screener documentation for details on how to construct conditions. pricetoearnings~lt~15
logic
* required
The logic of how the conditions are applied. See screener documentation for details on how to use logic with conditions. low_pe AND high_roi
order_column
* required
A data tag by which to order the results. -
order_direction
* required
The direction in which to order the results (“asc” for Ascending or “desc” for descending).
Options:
asc
desc
asc
primary_only
* required
Return only primary securities (excluding special securities such as preferred shares)
Options:
true
true
actively_traded
* required
Return only securities that have a stock price in the past 7 days
Options:
true
true
page_number
* required
An integer greater than or equal to 1 for specifying the page number for the return values. 3
page_size
* required
An integer greater than or equal to 1 for specifying the number of results on each page. 20
hide_paging
* required
Hide first row of paging information.
Options:
true
true

Standardized Financials

Returns professional-grade historical financial data. This data is standardized, cleansed and verified to ensure the highest quality data sourced directly from the XBRL financial statements. The primary purpose of standardized financials are to facilitate comparability across a single company’s fundamentals and across all companiesfundamentals. For example, it is possible to compare total revenues between two companies as of a certain point in time, or within a single company across multiple time periods. This is not possible using the as reported financial statements because of the inherent complexity of reporting standards.

Parameters

Name Description Example
identifier
* required
The stock market ticker symbol associated with the companies common stock securities. AAPL
statement
* required
The financial statement requested, options include the income statement, balance sheet, statement of cash flows and calculated metrics and ratios.
Options:
income_statement
balance_sheet
cash_flow_statement
calculations
income_statement
type
* required
The type of periods requested - includes fiscal years for annual data, quarters for quarterly data and trailing twelve months for annual data on a quarterly basis.
Options:
FY
QTR
TTM
YTD
FY
fiscal_year
* required
The fiscal year associated with the fundamental. 2017
fiscal_period
* required
The fiscal period associated with the fundamental.
Options:
FY
Q1
Q2
Q3
Q4
Q1TTM
Q2TTM
Q3TTM
Q2YTD
Q3YTD
Q2
date
* required
The first fundamental will be the latest as of this specified date. 2018-01-01
tag
* required
The specified standardized tag. operatingrevenue
sequence
* required
The sequence of the requested fundamental (i.e. 0 is the first available fundamental associated with the fiscal period type. 0
rounding
* required
Round the returned value (actuals, thousands, millions, billions).
Options:
A
K
M
B
A
hide_paging
* required
Hide first row of paging information.
Options:
true
true

Output Fields

Name Description Type Example
tag the Intrinio standardized tag of the financial data point string operatingrevenue
value the value of the Intrinio tag of the financial data point number 233715000000.0

Standardized Fundamentals

Returns a list of available standardized fundamentals (fiscal year and fiscal period) for a given ticker and statement.

Parameters

Name Description Example
identifier
* required
The stock market ticker symbol associated with the companies common stock ecurities. AAPL
statement
* required
The financial statement requested, options include the income statement, balance sheet, statement of cash flows and calculated metrics and ratios.
Options:
income_statement
balance_sheet
cash_flow_statement
calculations
income_statement
type
* required
The type of periods requested - includes fiscal years for annual data, quarters for quarterly data and trailing twelve months for annual data on a quarterly basis.
Options:
FY
QTR
TTM
YTD
FY
date
* required
The first fundamental will be the latest as of this specified date. 2017-03-02
item
* required
The return value for the fundamental.
Options:
fiscal_year
end_date
start_date
fiscal_period
filing_date
fiscal_year
sequence
* required
An integer 0 or greater for calling a single fundamental from the first entry, most recent first. 0
page_number
* required
An integer greater than or equal to 1 for specifying the page number for the return values. -
page_size
* required
An integer greater than or equal to 1 for specifying the number of results on each page. 10
hide_paging
* required
Hide first row of paging information.
Options:
true
true

Output Fields

Name Description Type Example
fiscal_year the fiscal year of the fundamental number 2018
fiscal_period the fiscal period of the fundamental string Q1
end_date the last date of the fundamental date 2018-07-30
start_date the first date of the fundamental (not available for balance sheets) date 2018-09-01

Standardized Tags

Returns the standardized tags and labels for a given ticker, statement, and date or fiscal year/fiscal quarter.

Parameters

Name Description Example
statement
* required
The financial statement requested, options include the income statement, balance sheet, statement of cash flows, calculated metrics and ratios, and current data points.
Options:
income_statement
balance_sheet
cash_flow_statement
calculations
current
income_statement
template
* required
The financial statement tag template.
Options:
industrial
financial
industrial
identifier
* required
The stock market ticker symbol associated with the companies common stock securities. AAPL
item
* required
The return value for the tag.
Options:
name
tag
parent
factor
balance
type
units
name
sequence
* required
An integer 0 or greater for calling a single tag from the first entry, based on order. 0
page_number
* required
An integer greater than or equal to 1 for specifying the page number for the return values. -
page_size
* required
An integer greater than or equal to 1 for specifying the number of results on each page. 20
hide_paging
* required
Hide first row of paging information.
Options:
true
true

Output Fields

Name Description Type Example
name the readable name of the tag string Operating Revenue
tag the Intrinio standardized tag string operatingrevenue
parent the parent Intrinio standardized tag forming the statement relationship with the factor. number totalrevenue
factor the operator forming the statement relationship between the child tag (or tags) and the parent. string +
balance the accounting balance (debit or credit) of the tag amount credit
type the nature of the tag, operating or nonoperating string operating
units the unit of the tag string usd

Reported Financials

Returns the As Reported Financials directly from the financial statements of the XBRL filings from the company.

Parameters

Name Description Example
identifier
* required
The stock market ticker symbol associated with the companies common stock securities. AAPL
statement
* required
The financial statement requested, options include the income statement, balance sheet, statement of cash flows and calculated metrics and ratios.
Options:
income_statement
balance_sheet
cash_flow_statement
calculations
income_statement
type
* required
The type of periods requested - includes fiscal years for annual data, quarters for quarterly data and trailing twelve months for annual data on a quarterly basis.
Options:
FY
QTR
TTM
YTD
FY
xbrl_tag
* required
The specified XBRL tag. SalesRevenueNet
domain_tag
* required
The specified domain XBRL tag, associated with certain data points on the financial statements that have a dimension associated with the data point. excel
fiscal_year
* required
The fiscal year associated with the fundamental. 2015
fiscal_period
* required
The fiscal period associated with the fundamental.
Options:
FY
Q1
Q2
Q3
Q4
Q1TTM
Q2TTM
Q3TTM
Q2YTD
Q3YTD
FY
date
* required
The first fundamental will be the latest as of this specified date. 2017-03-02
sequence
* required
An integer 0 or greater for calling a single price from the first entry, based on sort order. 0
hide_paging
* required
Hide first row of paging information.
Options:
true
true

Output Fields

Name Description Type Example
xbrl_tag the reported XBRL tag of the financial data point string -
domain_tag the reported domain XBRL tag string -
value the value of the XBRL tag of the financial data point number -

Reported Fundamentals

Returns a list of available as reported fundamentals (fiscal year, fiscal period, start date, and end date) for a given ticker and statement.

Parameters

Name Description Example
identifier
* required
The stock market ticker symbol associated with the companies common stock securities. AAPL
statement
* required
The financial statement requested, options include the income statement, balance sheet and statement of cash flows.
Options:
income_statement
balance_sheet
cash_flow_statement
income_statement
type
* required
The type of periods requested - includes fiscal years for annual data, quarters for quarterly data.
Options:
FY
QTR
FY
date
* required
The first fundamental will be the latest as of this specified date. 2014-09-28
item
* required
The return value for the fundamental.
Options:
fiscal_year
end_date
start_date
fiscal_period
filing_date
fiscal_year
sequence
* required
An integer 0 or greater for calling a single fundamental from the first entry. 0
page_number
* required
An integer greater than or equal to 1 for specifying the page number for the return values. -
page_size
* required
An integer greater than or equal to 1 for specifying the number of results on each page. 10
hide_paging
* required
Hide first row of paging information.
Options:
true
true

Output Fields

Name Description Type Example
fiscal_year the fiscal year of the fundamental nuber 2017
end_date the last date of the fundamental date 2018-07-15
start_date (not available on the balance sheet) the first date of the fundamental date 2011-09-15
fiscal_period the fiscal period of the fundamental string FY
filing_date datetime 2017-11-03 08:01:37 +0000

Reported XBRL Tags

Returns the As Reported XBRL tags and labels for a given ticker, statement, and date or fiscal year/fiscal quarter.

Parameters

Name Description Example
identifier
* required
The stock market ticker symbol associated with the companies common stock securities. AAPL
statement
* required
The financial statement requested.
Options:
income_statement
balance_sheet
cash_flow_statement
income_statement
type
* required
The type of periods requested - includes fiscal years for annual data, quarters for quarterly data and trailing twelve months for annual data on a quarterly basis.
Options:
FY
QTR
FY
fiscal_year
* required
The fiscal year associated with the fundamental. 2016
fiscal_period
* required
The fiscal period associated with the fundamental.
Options:
FY
Q1
Q2
Q3
FY
date
* required
The first fundamental will be the latest as of this specified date. 2018-03-03
item
* required
The return value for the tag.
Options:
name
tag
balance
unit
domain_tag
abstract
sequence
depth
factor
name
sequence
* required
An integer 0 or greater for calling a single tag from the first entry, based on order. 0
page_number
* required
An integer greater than or equal to 1 for specifying the page number for the return values. -
page_size
* required
An integer greater than or equal to 1 for specifying the number of results on each page. 10
hide_paging
* required
Hide first row of paging information.
Options:
true
-

Output Fields

Name Description Type Example
name the label of the XBRL tag as reported of the financial statement string Net sales
tag the XBRL tag of the associated financial data point string SalesRevenueNet
balance the accounting balance (debit or credit) of the tag string credit
unit the unit type of the XBRL tag string usd
domain_tag the specified domain XBRL tag, associated with certain data points on the financial statements that have a dimension associated with the data point string -
abstract the type of value; true indicates that the value is a header label and has no associated data value, whereas false indicates that the XBRL tag has an associated value. boolean -
sequence an integer 0 or greater indicating the presentation order of the XBRL tag and label in the financial statement number 0
depth an integer 0 or greater indicating the presentation indentation depth of the XBRL tag and label in the financial statement number 1

Companies

Returns company list and information for all companies covered by Intrinio.

Parameters

Name Description Example
query
* required
Used to search for a ticker or bank name to return relevant banks. Apple
identifier
* required
The stock market ticker symbol associated with the company’s common stock. If the company is foreign, use the stock exchange code, followed by a colon, then the ticker. AAPL
latest_filing_date
* required
a date value that returns the list of companies whose latest SEC filing was filed on or after this date 2011-07-15
page_number
* required
An integer greater than or equal to 1 for specifying the page number for the return values. 3
page_size
* required
An integer greater than or equal to 1 for specifying the number of results on each page. 10
hide_paging
* required
Hide first row of paging information.
Options:
true
-

Output Fields

Name Description Type Example
ticker the stock market ticker symbol associated with the companies common stock securities string AAPL
cik the Central Index Key issued by the SEC, which is the unique identifier all company filings are issued under string 0000004281
name the company name in shorter form string Alcoa Inc
legal_name the company’s official legal name string Alcoa Inc.
lei the Legal Entity Identifier for the company string ABPN11VOHLHX6QR7XQ48
hq_address1 the company’s headquarters address line 1 string 390 Park Avenue
hq_address2 the company’s headquarters address line 2 string Suite 200
hq_address_city the company’s headquarters city string New York
hq_address_postal_code the company’s headquarters postal code string 10022
entity_legal_form the company’s legal organization form string INCORPORATED
inc_state the state (US & Canada Only) where the company is incorporated string Pennsylvania
inc_country the country where the company is incorporated string United States of America
sic the Standard Industrial Classification (SIC) determined by the company filed with the SEC number 3350
stock_exchange the Stock Exchange where the company’s common stock is primarily traded string NYSE
template the financial statement template used by Intrinio to standardize the as reported data string industrial
short_description a one or two sentence description of the company’s operations string Alcoa Inc. engages in engineering and manufacturing lightweight metals worldwide.
long_description a one paragraph description of the company’s operations and other corporate actions string -
ceo the Chief Executive Officer of the company string Klaus-Christian Kleinfeld
company_url the url to the company’s primary corporate website or primary internet property string http://www.alcoa.com
business_address the company’s headquarters address string 390 PARK AVENUE, NEW YORK, NY 10022-4608
mailing_address the mailing address reported by the company string 390 PARK AVENUE, NEW YORK, NY 10022-4608
business_phone_no the phone number reported by the company string 2128362732
employees the number of employees working for the company number 60000
sector the company’s operating sector string Basic Materials
industry_category the company’s operating industry category string Metals & Mining
industry_group the company’s operating industry group string Aluminum
standardized_active if true, the company has standardized and as reported fundamental data via the Intrinio API; if false, the company has as reported data only. boolean true
securities the securities belonging to this company array -

Company News

Returns the most recent news stories for a company.

Parameters

Name Description Example
identifier
* required
The stock market ticker symbol associated with the company’s common stock. If the company is foreign, use the stock exchange code, followed by a colon, then the ticker. You may request up to 10 tickers at once by separating them with a comma. AAPL
item
* required
The return value for the row.
Options:
ticker
figi_ticker
figi
title
publication_date
summary
url
title
page_number
* required
An integer greater than or equal to 1 for specifying the page number for the return values. Note: using a page number is only allowed when specifying an identifier. If no identifier is specified, use start_date and end_date instead. -
page_size
* required
An integer greater than or equal to 1 for specifying the number of results on each page. -
start_date
* required
The earliest publication date of the news reports. 2015-12-31
start_time
* required
Return quotes at or after this time (24-hour, UTC). 09:30:00
end_date
* required
The latest publication date of the news reports. 2015-12-1
end_time
* required
Return quotes at or before this time (24-hour, UTC). 17:00:00
sequence
* required
An integer 0 or greater for calling a single news article from the first entry, most recent first. 0
hide_paging
* required
Hide first row of paging information.
Options:
true
true

Output Fields

Name Description Type Example
ticker the stock market ticker symbol associated with the companies common stock securities string AAPL
figi_ticker The OpenFIGI Ticker Symbol string ABC:CN
figi The FIGI identifier string BBG000C961K5
title the title of the article string How will Twitter's suitors reap its value?
publication_date the date the article was published timestamp 2016-09-25 12:12:33 +0000
url the hyperlink to the article string http://www.ft.com/cms/s/8d81a6da-82e6-11e6-8897-2359a58ac7a5,s01=1.html?ftcamp=traffic/partner/feed_headline/us_yahoo/auddev
summary a brief summary of the article string Twitter may finally be running out of time. News at the end of last week that Google and cloud software company Salesforce have both held preliminary discussions about a possible acquisition have underlined ...

Company SEC Filings

Returns the complete list of SEC filings for a company.

Parameters

Name Description Example
identifier
* required
The stock market ticker symbol associated with the company’s common stock. If the company is foreign, use the stock exchange code, followed by a colon, then the ticker. AAPL
report_type
* required
The report type of the filing requested. 8-K
start_date
* required
The earliest filing date for which to return filings, in the format. 2017-04-20
end_date
* required
The last filing date for which to return filings, in the format. 2017-07-20
page_number
* required
An integer greater than or equal to 1 for specifying the page number for the return values. -
page_size
* required
An integer greater than or equal to 1 for specifying the number of results on each page. 10
hide_paging
* required
Hide first row of paging information.
Options:
true
true

Output Fields

Name Description Type Example
filing_date the date the filing was submitted to the SEC by the company date 2016-09-23
accepted_date the date and time when the filing was submitted to the SEC by the company timestamp 2016-09-23 18:33:57 +0000
period_ended the date of the period end for the filing date 2016-09-21
accno the SEC unique number for the filing string 0001628280-16-019756
report_type the filing report type string 4
filing_url the URL to the filing page on the SEC site string https://www.sec.gov/Archives/edgar/data/320193/000162828016019756/0001628280-16-019756-index.htm
report_url the URL to the actual report on the SEC site string https://www.sec.gov/Archives/edgar/data/320193/000162828016019756/xslF345X03/wf-form4_147467002403491.xml
instance_url the URL for the XBRL filing for the report string -

Latest SEC Filings

Returns a list of all SEC filings recorded within the past 30 days.

Parameters

Name Description Example
page_number
* required
An integer greater than or equal to 1 for specifying the page number for the return values. 4
page_size
* required
An integer greater than or equal to 1 for specifying the number of results on each page. 100
hide_paging
* required
Hide first row of paging information.
Options:
true
true

Output Fields

Name Description Type Example
filing_date the date the filing was submitted to the SEC by the company date 2017-04-20
accepted_date the date and time when the filing was submitted to the SEC by the company timestamp 2017-04-20 18:24:23 -0700
period_ended the date of the period end for the filing date 2017-04-19
accno the SEC unique number for the filing string 0001077771-17-000077
report_type the filing report type string 4
filing_url the URL to the filing page on the SEC site string https://www.sec.gov/Archives/edgar/data/1077771/000107777117000077/0001077771-17-000077-index.htm
report_url the URL to the actual report on the SEC site string https://www.sec.gov/Archives/edgar/data/1077771/000107777117000077/xslF345X03/edgardoc.xml
instance_url the URL for the XBRL filing for the report string -
ticker the stock market ticker symbol associated with the company’s common stock securities string UMPQ
lei the Legal Entity Identifier for the company string 549300QGC3EY3EV0NS72
cik the Central Index Key issued by the SEC, which is the unique identifier all company filings are issued under string 0000811589

Bank Branches

Returns a list of bank branches covered by Intrinio.

Parameters

Name Description Example
ticker
* required
The stock market ticker symbol associated with the companies common stock securities. AAPL
rssd_id
* required
The bank/bank holding company RSSD ID issued by the Federal Reserve. 480228
uninumber
* required
The uninumber is the unique identifier for each bank branch office assigned by the Federal Reserve & the FDIC. 3
page_number
* required
An integer greater than or equal to 1 for specifying the page number for the return values. 2
page_size
* required
An integer greater than or equal to 1 for specifying the number of results on each page. 100
hide_paging
* required
Hide first row of paging information.
Options:
true
-

Output Fields

Name Description Type Example
rssd_id The unique number assigned by the Federal Reserve Board (FRB) to the institution. number 480228
bank_name Institution name string Bank of America, National Association
uninumber The unique number associated with a specific physical location of a branch. This number remains with this location over time, regardless of ownership. number 3
branch_number Numerical reference to identify a branch office within one institution number 7636
branch_name Branch name string Southington Main Branch
address Physical location of the branch string 100 5th Street South
city Reported city in which the branch is located string Saint Petersburg"
state The state abbreviation of the location in which the branch is physically located. string FL
zip_code The ZIP code associated with the physical address of the branch. string 33701
county County name in which the branch is located. string United States
state_no The FIPS number of the state in which the branch is physically located. number 12
state_and_county_no The state and county FIPS code associated with the specific branch location. number 103
central_city Central city based on the reported ZIP code of the branch string Saint Petersburg
latitude The lattitude of the branch’s physical location. number 27.770275932
longitude The longitude of the branch’s physical location number -82.64009368
location_quality The quality of the match of the branch’s physical location to a latitude and longitude with a given projection. string M
location_method The method used to arrive at the latitude and longitude of the branch’s physical location. string US_Streets
place_num The FIPS MCD (Minor Civil Division) code refers to a subsection of the U.S. Census county subdivision statistics. The county subdivision FIPS includes census data for county divisions, census subareas, minor civil divisions, unorganized territories, and incorporated areas number 93042
branch_service_type Code that defines the type of service the branch office provides number 11
main_office Main office / branch identifier; true=Main office, false=branch boolean true
msa_no The Metropolitan Statistical Areas (MSABR) are based on the 2010 Census - these areas correspond to the state/county/CBSA relationships as defined by the Census Bureau number 45300
msa The Metropolitan Statistical Area name in which the branch is physically located string Tampa-St. Petersburg-Clearwater, FL
csa_no The identifying code of a geographic entity consisting of two or more adjacent Core Based Statistical Areas (CBSAs) with employment interchange measures of at least 15 number 198
csa The name of a geographic entity consisting of two or more adjacent Core Based Statistical Areas (CBSAs) with employment interchange measures of at least 15 string -
cbsa_division_no A county or group of counties within a Core Based Statistical Area that contains a core with a population of at least 2.5 million number -
cbsa_division The name that corresponds to a code for a county or group of counties within a Core Based Statistical Area that contains a core with a population of at least 2.5 million string -
established_on The date that the branch location was established. string 1995-11-17
acquired_on The date that a branch was last acquired by another institution string -
reported_date The date the bank reported deposits for this branch string 2015-06-30
year The year the bank reported deposits for this branch number 2015
total_deposits Branch office deposits for the reported date number 390047000.0
deposits All recorded deposits for this bank branch array -

Bank Financials

Returns the Bank Financials directly from the financial statements of the call report, UBPR report, and Y-9C XBRL filings from the bank issued with the FDIC.

Parameters

Name Description Example
identifier
* required
The stock market ticker symbol associated with the companies common stock securities, or the bank/bank holding company RSSD ID issued by the Federal Reserve. 2362074
statement
* required
The financial statement requested from the call report, the UBPR report, or the Y-9C report, which can be found from the bank fundamentals end point. RI
date
* required
The first fundamental will be the latest as of this specified date. 2018-01-01
sequence
* required
The sequence of the requested fundamental (i.e. 0 is the first available fundamental associated with the fiscal period type. 0
type
* required
The type of periods requested - includes fiscal years for annual data, quarters for quarterly data and trailing twelve months for annual data on a quarterly basis.
Options:
FY
QTR
TTM
YTD
FY
tag
* required
The specified bank call report, UBPR report, or Y-9C report XBRL tag. RIADA518
fiscal_year
* required
The fiscal year associated with the fundamental. 2018
fiscal_period
* required
The fiscal period associated with the fundamental.
Options:
FY
Q1
Q2
Q3
Q4
Q1TTM
Q2TTM
Q3TTM
Q2YTD
Q3YTD
Q4
rounding
* required
Round the returned value (actuals, thousands, millions, billions).
Options:
A
K
M
B
A
page_number
* required
An integer greater than or equal to 1 for specifying the page number for the return values. 22
page_size
* required
An integer greater than or equal to 1 for specifying the number of results on each page. 58
hide_paging
* required
Hide first row of paging information.
Options:
true
true

Output Fields

Name Description Type Example
tag the bank call report, UBPR report, or Y-9C report XBRL tag of the financial data point string RIAD4056
value the value of the XBRL tag of the financial data point number 1503000.0

Bank Fundamentals

Returns a list of available bank fundamentals (fiscal year, fiscal period, start date, and end date) for a given ticker/rssd_id and statement. Statements are from the bank call reports, UBPR reports, and Y-9C reports filed with the FDIC & Federal Reserve.

Parameters

Name Description Example
identifier
* required
The stock market ticker symbol associated with the companies common stock securities, or the bank/bank holding company RSSD ID issued by the Federal Reserve. 2362074
statement
* required
The call report/UBPR/Y-9C financial statement requested. RI
type
* required
The type of periods requested - includes fiscal years for annual data, quarters for quarterly data.
Options:
FY
QTR
YTD
FY
report
* required
Select report for all fundamentals.
Options:
call_report
ubpr
Y9C
Y9C
date
* required
The first fundamental will be the latest as of this specified date. 2014-12-31
item
* required
The return value for the fundamental.
Options:
statement_code
end_date
start_date
months
fiscal_year
fiscal_period
report
fiscal_year
sequence
* required
An integer 0 or greater for calling a single fundamental from the first entry. 0
page_number
* required
An integer greater than or equal to 1 for specifying the page number for the return values. -
page_size
* required
An integer greater than or equal to 1 for specifying the number of results on each page. 10
hide_paging
* required
Hide first row of paging information.
Options:
true
true

Output Fields

Name Description Type Example
statement_code the statement code for the financial statement from the report string RI
fiscal_year the fiscal year of the fundamental date 2015
fiscal_period the fiscal period of the fundamental date FY
end_date the last date of the fundamental date 2015-12-1
start_date (not available on the balance sheet) the first date of the fundamental date 2015-12-31
report the report the financial statement is sourced from, corresponding with the statement_code string call_report

Bank Holding Companies

Returns a list of bank holding companies covered by Intrinio.

Parameters

Name Description Example
query
* required
Used to search for a ticker or bank name to return relevant banks. Morgan
ticker
* required
The stock market ticker symbol associated with the companies common stock securities. TSLA
rssd_id
* required
The bank/bank holding company RSSD ID issued by the Federal Reserve. 1139523
page_number
* required
An integer greater than or equal to 1 for specifying the page number for the return values. 1
page_size
* required
An integer greater than or equal to 1 for specifying the number of results on each page. 10
hide_paging
* required
Hide first row of paging information.
Options:
true
true

Output Fields

Name Description Type Example
rssd_id High Regulatory Holder, The unique number assigned by the Federal Reserve Board to the regulatory high holding company of the institution. number 1139523
name Bank Holding Company (Regulatory Top Holder), Regulatory top holder is assigned by the Federal Reserve Board based on ownership and control percentages. string JP Morgan Chase & Co.
city City of High Holder, City in which the headquarters of the institution’s regulatory high holder are physically located. string New York
state Regulatory holding company state location, State location of the regulatory high holding company (either direct or indirect owner). string NY
banks List of banks under this holding company. array -

Bank XBRL Tags

Returns the Bank XBRL tags and labels for a given ticker/RSSD ID, statement, and date or fiscal year/fiscal quarter.

Parameters

Name Description Example
identifier
* required
The stock market ticker symbol associated with the companies common stock securities, or the bank/bank holding company RSSD ID issued by the Federal Reserve. 2362074
statement
* required
The financial statement requested from the call report, the UBPR report or Y-9C report, which can be found from the bank fundamentals end point. RI
fiscal_year
* required
The fiscal year associated with the fundamental. 2015
fiscal_period
* required
The fiscal period associated with the fundamental.
Options:
FY
Q1
Q2
Q3
Q4
Q1TTM
Q2TTM
Q3TTM
Q2YTD
Q3YTD
FY
item
* required
The return value for the tag.
Options:
name
tag
unit
sequence
depth
abstract
name
sequence
* required
An integer 0 or greater for calling a single tag from the first entry. 0
page_number
* required
An integer greater than or equal to 1 for specifying the page number or the return values. 1
page_size
* required
An integer greater than or equal to 1 for specifying the number of results on each page. 10
hide_paging
* required
Hide first row of paging information.
Options:
true
true

Output Fields

Name Description Type Example
name the label of the XBRL tag as reported of the financial statement string Schedule RI - Income Statement
tag the XBRL tag of the associated financial data point string RI
unit the unit type of the XBRL tag string String
abstract the type of value - true indicates that the value is a header label and has no associated data value, whereas false indicates that the XBRL tag has an associated value. boolean true
sequence an integer 0 or greater indicating the presentation order of the XBRL tag and label in the financial statement number 1
depth an integer 0 or greater indicating the presentation indentation depth of the XBRL tag and label in the financial statement number 1

Banks

Returns a list of banks covered by Intrinio.

Parameters

Name Description Example
query
* required
Used to search for a ticker or bank name to return relevant banks. Morgan
ticker
* required
The stock market ticker symbol associated with the companies common stock securities. TSLA
rssd_id
* required
The bank/bank holding company RSSD ID issued by the Federal Reserve. -
page_number
* required
An integer greater than or equal to 1 for specifying the page number for the return values. -
page_size
* required
An integer greater than or equal to 1 for specifying the number of results on each page. 10
hide_paging
* required
Hide first row of paging information.
Options:
true
true

Output Fields

Name Description Type Example
rssd_id Federal Reserve ID Number, A unique number assigned by the Federal Reserve board as the entity’s unique identifier - 480228
name Institution name, The legal name of the institution number C1 Bank
fdic_certificate_number FDIC Certificate Number, A unique NUMBER assigned by the FDIC used to identify institutions and for the issuance of insurance certificates number 34092
form31_filer FFIEC Call Report 31 Filer, A flag (true,false) that indicates whether and institution filed an FFIEC 031 Call Report. Commercial banks with domestic and foreign offices are required to file such a report. boolean true
address Physical Street Address, Street address at which the institution or one of its branches is physically located string 1111 Polaris Parkway
city City, City in which an institution’s headquarters or one of its branches is physically located. Either the entire name or part of the name of a specific city may be entered to produce an Institution List string Columbus
state State Name, State in which the the institution is physically located. The FDIC Act defines state as any State of the United States, the District of Columbia, and any territory of the United States, Puerto Rico, Guam, American Samoa, the Trust Territory of the Pacific Islands, the Virgin Island, and the Northern Mariana Islands string Ohio
zip_code Zip Code,The first three, four, or five digits of the full postal zip code representing physical location of the institution or its branch office string 43240
county County, County where the institution is physically located (abbreviated if the county name exceeds 16 characters) string Delaware
state_and_county_no State and county number, A five digit number representing the state and county in which the institution is physically located. The first two digits represent the FIPS state numeric code and the last three digits represent the FIPS county numeric code number 39041
state_no State Alpha code, State in which the the headquarters are physically located. number 39
url Primary Internet Web Address, The primary internet web address is the public internet site obtained from the most recent FFIEC Call Report string http://www.jpmorganchase.com
total_branches Offices, A branch/office is any location, or facility, of a financial institution, including its main office, where deposit accounts are opened, deposits are accepted, checks paid, and loans granted number 5446
domestic_branches Number of Domestic Offices, The number of domestic offices (including headquarters) operated by active institutions in the 50 states of the U.S.A. number 5344
foreign_branches Number of Foreign Offices, The number of foreign offices (outside the U.S.) operated by the institution. number 197
asset_concentration Name associated with the numeric indicator (SPECGRP) of an institution’s primary specialization in terms of asset concentration string International Specialization
asset_concentration_no Asset Concentration Hierarchy, An indicator of an institution’s primary specialization in terms of asset concentration number 3
occ_charter_number OCC Charter Number, A unique number assigned by the Office of the Comptroller of the Currency (OCC) used to identify institutions that it has chartered and regulates (i.e. national banks). number 8
fdic_geo_region_no FDIC Geographic Region, The FDIC Office assigned to the geographic area. number 9
fdic_supervisory_region FDIC Supervisory Region, The supervisory FDIC office assigned to the institution. string Chicago
fdic_supervisory_region_no A numeric value associated with the name of an FDIC supervisory region number 16
frb_district FDICSUPV, Federal Reserve District, “The supervisory FDIC office assigned to the institution. There are twelve Federal Reserve Districts, with two Districts serving one state in some instances. string 4
frb_district_no Federal Reserve ID Number, A number used to identify the Federal Reserve district in which the institution is located. number 3
ots_district_no OTS District, Office of Thrift Supervision (OTS) District number 3
ots_district Office of Thrift Supervision Region, Prior to 7/21/11, the Office of Thrift Supervision (OTS) Region in which the institution is physically located. string Washington
occ_district_no Office of the Comptroller, The Office of the Comptroller of the Currency (OCC) District in which the institution is physically located. number 3
regulator Regulator, There are three Federal regulators of banks and savings and loan institutions- FDI, FRB, OCC string OCC
state_charter State Charter, A flag (true;false) that indicates if an institution is state chartered. boolean -
federal_charter Federal charter flag, A flag used to indicate whether the institution is chartered by an agent of the federal government. boolean true
fdic_field_office FDIC Field Office, The FDIC Field Office where an institution is physically located. string Columbus
bank_class Bank Charter Class, A classification code assigned by the FDIC based on the institution’s charter type (commercial bank or savings institution), charter agent (state or federal), Federal Reserve membership status (Fed member, Fed nonmember) and its primary federal regulator (state chartered institutions are subject to both federal and state supervision) string N
chartering_agency Chartering Agency, All Chartering Agencies - State and Federal Comptroller of the Currency. string OCC
conservatorship CONSERVE, Conservatorship, A flag (1=yes;0=no) that indicates if an institution is being operated in government conservatorship. boolean -
interstate_branches Interstate Branches, A “yes” indicates that an institution has branches that can accept FDIC-insured deposits in more than one state. The FDIC Act defines state as any State of the United States, the District of Columbia, and any territory of the United States, Puerto Rico, Guam, American Samoa, the Trust Territory of the Pacific Islands, the Virgin Island, and the Northern Mariana Islands. boolean true
s_corp Subchapter S Corporations, Banks are required to indicate on the Call Report whether there is currently in effect an election to file under Subchapter S. boolean -
trust_fiduciary_services Trust Powers, A flag used to indicate an institution’s Trust Powers Granted status. False = No Trust Power Granted True = Trust Power Granted boolean true
community_bank FDIC community banks are identified based on criteria defined in the FDIC Community Banking Study boolean -
cmsa_no Consolidated Metropolitan Statistical Division Number, The numeric code given by the US Census Bureau office of Management and Budget number -
cmsa Consolidated Metropolitan Statistical Area, The Federal Information Processing Standards (FIPS) Consolidated Metropolitan Statistical Area (CMSA) code is a number representing the institution location string -
msa_no Metropolitan Statistical Area Number, The Metropolitan Statistical Area Number (MSA_NO) in which the institution is physically located number 1840
msa Metropolitan Statistical Area (MSA), The Metropolitan Statistical Areas based on Census Bureau data, as defined by the US Office of Management (OMB) prior to the year 2000 string Columbus, OH
csa_no Numeric Code for the Combined Statistical Area, The numeric code that the U.S. Census Bureau Office of Management and Budget assigns for the combined statistical area (CSA) per the 2000 standards number 198
csa Name of the Combined Statistical Area, The name associated with the numeric code that the U.S. Census Bureau Office of Management and Budget assigns for the combined statistical area (CSA) per the 2000 standards string Columbus-Marion-Zanesville, OH
cbsa_no Numeric Code for the Core Based Statistical Area, The numeric code that the U.S. Census Bureaus Office of Management and Budget assigns for the CBSA number 18140
cbsa Name of the Core Based Statistical Area, The name associated with the numeric code that the U.S. Census Bureau Office of Management and Budget assigns for the CBSA string Columbus, OH
cbsa_metro_no Numeric code assigned by the U.S. Census Bureau’s Office of Management and Budget for a metropolitan area within a CBSA number 18140
cbsa_metro Name associated with the numeric code that the U.S. Census Bureau’s Office of Management and Budget assigns for the metropolitan areas within a CBSA; are now also the basis for Metropolitan Statistical Areas (MSAs) string Columbus, OH
cbsa_division_no Core Based Statistical Division Number, The numeric code given by the US Census Bureau office of Management and Budget number -
cbsa_division Name of the Core Based Statistical Division, The name associated with the numeric code given by the US Census Bureau office of Management and Budget (2000 standards) that represents the core based statistical division (CBSADIV) string -
last_update Last update, The date of the last data update date 2015-09-24
last_structural_change Last Structure Change Process Date, A date field indicating the date that a change to this record was processed date 2015-08-31
established_on Established Date, The date on which the institution began operations date 1824-01-01
deposit_insurance_date Date of Deposit Insurance, The date that an institution obtained federal deposit insurance date 1934-01-01
active Active, True=Institutions who remain open currently, False=Institutions that are currently closed but were once insured by the FDIC boolean true

Security Corporate Actions

Returns all corporate actions for a security. Events 45+ types of corporate actions such as: Announcements and Annual Shareholder Meetings, Ex-date, Dividend pay date, Splits, Buy Backs, M&A and Takeovers, Bankruptcies and much more.

For in-depth documentation of each corporate action event-type please refer to the:

Corporate Action Events Reference

Parameters

Name Description Example
identifier
* required
The identifier for the specified security. AAPL
page_number
* required
An integer greater than or equal to 1 for specifying the page number for the return values. 3
page_size
* required
An integer greater than or equal to 1 for specifying the number of results on each page. 10

Output Fields

Name Description Type Example
event_id A unique event identifier string 1030388
event_code The event code string DIV
data_data Dynamic values relating to dates in the event object -
rate_date Dynamic values relating to rates in the event object -
field_data Dynamic values relating to fields in the event object -

Stock Exchange Corporate Actions

Returns all corporate actions for all securities listed on a specified stock exchange. A subscription to the EDI Corporate Actions Data Feed for a specific country will permit access to all stock exchanges in that country (ie, US includes NASDAQ, NYSE, BATS). Events 45+ types of corporate actions such as: Announcements and Annual Shareholder Meetings, Ex-date, Dividend pay date, Splits, Buy Backs, M&A and Takeovers, Bankruptcies and much more.

For in-depth documentation of each corporate action event-type please refer to the:

Corporate Action Events Reference

Parameters

Name Description Example
identifier
* required
The stock market ticker symbol associated with the companies common stock securities or the stock market index. ^XNYS
page_number
* required
An integer greater than or equal to 1 for specifying the page number for the return values. 3
page_size
* required
An integer greater than or equal to 1 for specifying the number of results on each page. 5

Output Fields

Name Description Type Example
ticker The stock exchange ticker symbol as listed on the stock exchange string TSLA
figi_ticker The OpenFIGI Ticker Symbol string ABC:CN
figi The FIGI identifier string BBG000C961K5
event_id A unique event identifier string 1030388
event_code The event code string DIV
data_data Dynamic values relating to dates in the event object -
rate_date Dynamic values relating to rates in the event object -
field_data Dynamic values relating to fields in the event object -

Crypto Book Asks

Returns the entire ask order book for a given currency pair and exchange.

Parameters

Name Description Example
pair
* required
Return the order book asks for the given crypto currency pair. btcusd
exchange
* required
Return the order book asks for a crypto currency on the given crypto exchange. gemini
currency
* required
Return the order book asks for the given crypto currency. BTC
page_number
* required
An integer greater than or equal to 1 for specifying the page number for the return values. 3
page_size
* required
An integer greater than or equal to 1 for specifying the number of results on each page. 10
hide_paging
* required
Hide first row of paging information.
Options:
true
true

Output Fields

Name Description Type Example
pair
Data for the provided crypto currency pair. object -
name
Crypto currency pair name. string BTCUSD
code
Crypto currency pair code. string btcusd
exchange
Data for the provided crypto exchange. object -
name
Crypto exchange name. string Binance
code
Crypto exchange code. string binance
last_updated UTC timestamp of when the prices were last updated. string 2018-07-19 21:00:00 UTC
asks
The ask prices and their respective sizes, in ascending order of price. array -
price
The ask price of the book entry. float 6492.88
size
The size for the ask price of the book entry. float 1

Crypto Book Bids

Returns the entire bid order book for a given currency pair and exchange.

Parameters

Name Description Example
pair
* required
Return the order book bids for the given crypto currency pair. btcusd
exchange
* required
Return the order book bids for a crypto currency on the given crypto exchange. gemini
currency
* required
Return the order book bids for the given crypto currency. BTC
page_number
* required
An integer greater than or equal to 1 for specifying the page number for the return values. 3
page_size
* required
An integer greater than or equal to 1 for specifying the number of results on each page. 10
hide_paging
* required
Hide first row of paging information.
Options:
true
true

Output Fields

Name Description Type Example
pair
Data for the provided crypto currency pair. object -
name
Crypto currency pair name. string BTCUSD
code
Crypto currency pair code. string btcusd
exchange
Data for the provided crypto exchange. object -
name
Crypto exchange name. string Binance
code
Crypto exchange code. string binance
last_updated UTC timestamp of when the prices were last updated. string 2018-07-19 21:00:00 UTC
bids
The bid prices and their respective sizes, in descending order of price. array -
price
The bid price of the book entry. float 6539.58
size
The size for the bid price of the book entry. float 0.03777

Crypto Book Summary

Returns the order book summary (bid/ask prices and size) for a given currency pair and exchange.

Parameters

Name Description Example
levels
* required
The number of prices/levels to return on each side. For example, the max of 50 levels will return up to 50 bid prices and 50 ask prices. 50
pair
* required
Return the order book summary for the given crypto currency pair. btcusd
exchange
* required
Return the order book summary for a crypto currency on the given crypto exchange. gemini
currency
* required
Return the order book summary for the given crypto currency. BTC

Output Fields

Name Description Type Example
pair
Data for the provided crypto currency pair. object -
name
Crypto currency pair name. string BTCUSD
code
Crypto currency pair code. string btcusd
exchange
Data for the provided crypto exchange. object -
name
Crypto exchange name. string Binance
code
Crypto exchange code. string binance
last_updated UTC timestamp of when the order book was last updated. string 2018-07-19 21:00:00 UTC
bids
The bid prices and their respective sizes, in descending order of price. array -
price
The bid price of the book entry. float 6539.58
size
The size for the bid price of the book entry. float 0.03777
asks
The ask prices and their respective sizes, in ascending order of price. array -
price
The ask price of the book entry. float 6492.88
size
The size for the ask price of the book entry. float 1

Crypto Currencies

Returns a list of crypto currencies for which data is available.

Parameters

Name Description Example
exchange
* required
The crypto exchange code. gemini

Output Fields

Name Description Type Example
currencies
A list of crypto currencies for the given crypto exchange sorted by alphabetically by symbol. array -
name
Crypto currency name string Bitcoin
code
Crypto currency code string bitcoin
symbol
Crypto currency symbol string BTC
first_price_date
The earliest date that daily historical pricing is available for. string 2017-01-01
last_price_date
The most recent date that daily historical pricing is available for. string 2018-08-30

Crypto Exchanges

Returns a list of crypto exchanges for which data is available.

Parameters

Name Description Example
pair
* required
Return exchanges that trade the specified crypto currency pair. btcusd

Output Fields

Name Description Type Example
exchanges
A list of exchanges for the given crypto currency pair sorted alphabetically by code. array -
name
Crypto exchange name. string Binance
code
Crypto exchange code. string binance
history_available
A boolean, representing whether historical data is provided by this exchange or not. boolean true
book_depth_available
A boolean, representing whether book depth data is provided by this exchange or not. boolean true
trades_available
A boolean, representing whether trade data is provided by this exchange or not. boolean true
snapshot_available
A boolean, representing whether snpashot data is provided by this exchange or not. boolean true
pairs
List of crypto currency pair codes, sorted alphabetically, that trade on this exchange. array

Crypto Pairs

Returns a list of crypto currency pairs for which data is available.

Parameters

Name Description Example
exchange
* required
Return pairs traded on the given crypto exchange. gemini
currency
* required
Return pairs with one side being the given crypto currency. BTC

Output Fields

Name Description Type Example
currency_pairs
A list of crypto currency pairs for the given crypto exchange and crypto currency sorted alphabetically by code. array -
name
Crypto currency pair name. string BTCUSD
code
Crypto currency pair code. string btcusd
first_price_date
The earliest date that daily historical pricing is available for. string 2017-01-01
last_price_date
The most recent date that daily historical pricing is available for. string 2018-08-30
book_depth_available
a boolean, representing whether this pair has book depth data available or not. boolean true
history_available
a boolean, representing whether this pair has historical price data available or not. boolean true
snapshot_available
a boolean, representing whether this pair has snapshot data available or not. boolean true
trades_available
a boolean, representing whether this pair has trade data available or not. boolean false
currencies
List of crypto currency symbols, sorted alphabetically, that are in this pair. array
exchanges
List of crypto exchange codes, sorted alphabetically, that this pair trades on. array

Crypto Prices

Returns a list of crypto currency prices for which data is available.

Parameters

Name Description Example
pair
* required
Return prices for the given crypto currency pair. btcusd
exchange
* required
Return prices for a crypto currency on the given crypto exchange. gemini
currency
* required
Return prices for the given crypto currency. BTC
timeframe
* required
The time interval for the prices.
Options:
d1
h8
h6
h4
h3
h2
h1
m30
m15
m5
m1
h1
timezone
* required
Return price date/times in this timezone, also interpret start/end date/time parameters in this timezone
Options:
Africa/Algiers
Africa/Cairo
Africa/Casablanca
Africa/Harare
Africa/Johannesburg
Africa/Monrovia
Africa/Nairobi
America/Argentina/Buenos_Aires
America/Bogota
America/Caracas
America/Chicago
America/Chihuahua
America/Denver
America/Godthab
America/Guatemala
America/Guyana
America/Halifax
America/Indiana/Indianapolis
America/Juneau
America/La_Paz
America/Lima
America/Lima
America/Los_Angeles
America/Mazatlan
America/Mexico_City
America/Mexico_City
America/Monterrey
America/Montevideo
America/New_York
America/Phoenix
America/Regina
America/Santiago
America/Sao_Paulo
America/St_Johns
America/Tijuana
Asia/Almaty
Asia/Baghdad
Asia/Baku
Asia/Bangkok
Asia/Bangkok
Asia/Chongqing
Asia/Colombo
Asia/Dhaka
Asia/Dhaka
Asia/Hong_Kong
Asia/Irkutsk
Asia/Jakarta
Asia/Jerusalem
Asia/Kabul
Asia/Kamchatka
Asia/Karachi
Asia/Karachi
Asia/Kathmandu
Asia/Kolkata
Asia/Kolkata
Asia/Kolkata
Asia/Kolkata
Asia/Krasnoyarsk
Asia/Kuala_Lumpur
Asia/Kuwait
Asia/Magadan
Asia/Muscat
Asia/Muscat
Asia/Novosibirsk
Asia/Rangoon
Asia/Riyadh
Asia/Seoul
Asia/Shanghai
Asia/Singapore
Asia/Srednekolymsk
Asia/Taipei
Asia/Tashkent
Asia/Tbilisi
Asia/Tehran
Asia/Tokyo
Asia/Tokyo
Asia/Tokyo
Asia/Ulaanbaatar
Asia/Urumqi
Asia/Vladivostok
Asia/Yakutsk
Asia/Yekaterinburg
Asia/Yerevan
Atlantic/Azores
Atlantic/Cape_Verde
Atlantic/South_Georgia
Australia/Adelaide
Australia/Brisbane
Australia/Darwin
Australia/Hobart
Australia/Melbourne
Australia/Melbourne
Australia/Perth
Australia/Sydney
Etc/UTC
UTC
Europe/Amsterdam
Europe/Athens
Europe/Belgrade
Europe/Berlin
Europe/Berlin
Europe/Bratislava
Europe/Brussels
Europe/Bucharest
Europe/Budapest
Europe/Copenhagen
Europe/Dublin
Europe/Helsinki
Europe/Istanbul
Europe/Kaliningrad
Europe/Kiev
Europe/Lisbon
Europe/Ljubljana
Europe/London
Europe/London
Europe/Madrid
Europe/Minsk
Europe/Moscow
Europe/Moscow
Europe/Paris
Europe/Prague
Europe/Riga
Europe/Rome
Europe/Samara
Europe/Sarajevo