Need to take a test drive?
3 days, 250 API calls
Free Trial
Insiders are required to disclose the securities they are buying and selling but until now it has been expensive and time consuming to keep tabs on this lucrative information. The Transactions & Ownership Data Feed lets you keep track of insider activity for US securities in an efficient manner in Excel or API format. View the transactions for a specific company or a specific owner with a breakdown of shares and the value of those shares for all direct holdings.
Use the API or Excel to monitor insider movements in the format that works for you. Affordable redistribution options allow your applications and reports to build value for your own end users and customers. Lightening quick, automated processing means middlemen don't slow down the data as it makes its way to your systems- this puts you ahead of the competition when insiders disclose their purchases.
Intrinio offers a variety of ways to access this data feed. Choose your preferred access method below:
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 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.
If you need additional help in using the API, chat with us.
For a quick guide to getting started with our API, please see the Tutorial.
For private/trusted environments, use Basic Authentication over HTTPS.
You can find your API Username and API Password on your Account page. You must include these credentials with every request in order to receive access to the API.
To include the credentials in your HTTPS request, specify an Authorization header, with the value Basic (key) , replacing (key) with the Base-64 encoded string API_USERNAME:API_PASSWORD .
If your credentials are not authorized, a status code of 401 will be returned.
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 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.
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. |
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:
The Intrinio API employs several reasonable limits to ensure that stable, reliable service is provided to all users. These limits can vary based on which data feeds you are subscribed to, as well as which API call you are making. The limits are grouped as: daily calls, 10-minute calls, paging, throttling, and timeouts. If you hit an API limit, the response will contain a 429 code and an explanation of the limit.
Most data feed subscriptions have limited daily usage. This means that you can make up to a certain number of API calls 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.
Some data feed subscriptions have limited 10-minute usage. This means that you can make up to a certain number of API calls in a 10-minute period.
As an alternative to Daily Call Limits, some data feeds employ a 1-minute call limit. This means that you can make up to a certain number of API calls in a 1-minute period.
API endpoints that employ paging are limited by the maximum page size that you may request. This varies by endpoint:
| Endpoint | Maximum Page Size |
|---|---|
| /historical_data | 1,000 |
| All others | 100 |
Users enjoying free data feed subscriptions only are limited to 100 requests-per-second.
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 calls, we leave it to the users to fashion requests which can be satisfied in a reasonable time.
The following endpoints will help you to check your API access, limits, and usage:
Note: this is limited to data feeds with daily API call limits.
Below are all of the API endpoints available for this data feed:
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.
For a quick guide to getting started with our CSV Download functionality, please see the Tutorial.
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.
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
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=1https://api.intrinio.com/indices.csv?type=economic&page_number=2https://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
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.csvhttps://api.intrinio.com/indices.csv?type=economichttps://api.intrinio.com/indices.csv?type=economic&query=GDPhttps://api.intrinio.com/data_point.csv?identifier=AAPL&item=marketcap,beta
Here are examples of incorrect URLs:
https://api.intrinio.com/indices.csv&type=economichttps://api.intrinio.com/indices.csv?type=economic?query=GDPhttps://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 |
Below are all of the CSV file downloads available for this data feed:
Returns owners list and information for all insider and institutional owners of securities covered by Intrinio.
| Name | Description | Example |
|---|---|---|
| query | A string query search of owner name or cik id with the returned results being the relevant owners in compacted list format. | Abbott |
| identifier | The Central Index Key issued by the SEC, which is the unique identifier all owner filings are issued under. | owner |
| institutional |
A boolean to include only insider owners who have filed forms 3, 4, or 5 with the SEC.
Options:
Yes
No
|
Yes |
| page_number | An integer greater than or equal to 1 for specifying the page number for the return values. | 5 |
| page_size | An integer greater than or equal to 1 for specifying the number of results on each page. | 10 |
| hide_paging |
Hide first row of paging information.
Options:
true
|
true |
| Name | Description | Example |
|---|---|---|
| owner_cik | the Central Index Key issued by the SEC, which is the unique identifier all owner filings | 0000001800 |
| owner_name | the name of the owner, either an institutional owner or an insider owner | ABBOTT LABORATORIES |
Not available for this access method
Returns a list of all insider transactions in a company. Criteria for being an insider include being a director, officer, or 10%+ owner in the company. Transactions are detailed for both non-derivative and derivative transactions by the insider.
| Name | Description | Example |
|---|---|---|
| identifier | The stock market ticker symbol associated with the companies common stock securities or the Central Index Key issued by the SEC, which is the unique identifier all company filings are issued under. | AAPL |
| page_number | An integer greater than or equal to 1 for specifying the page number for the return values. | 1 |
| page_size | An integer greater than or equal to 1 for specifying the number of results on each page. | 10 |
| hide_paging |
Hide first row of paging information.
Options:
true
|
true |
| Name | Description | Example |
|---|---|---|
| owner_cik | the owner’s Central Index Key (CIK) unique identifier with the SEC | 0001650649 |
| owner_name | the name of the owner | FIELD JOHN DOUGLAS |
| filing_date | the date of the filing with the SEC made by the owner | 2016-09-07 |
| filing_url | the URL of the filing with the SEC | https://www.sec.gov/Archives/edgar/data/1318605/000167051216000006/xslF345X03/primary_doc.xml |
| director | (true/false) a boolean indicating whether or not the owner is a director in the company | - |
| officer | (true/false) a boolean indicating whether or not the owner is a officer in the company | true |
| ten_percent_owner | (true/false) a boolean indicating whether or not the owner has a ten percent or greater interest in the company | - |
| other_relation | (true/false) a boolean indicating whether or not the owner has another relationship with the company beside, direct, officer, or significant owner in the company | - |
| officer_title | the officer title of the owner in the company | VP, Engineering |
| derivative_transaction | a boolean indicating the transaction is not a derivative transaction and instead is dealings in the common stock of the company | - |
| security_title | the name of the security transacted | Common Stock |
| transaction_date | the date of the transaction by the owner | 2016-09-05 |
| deemed_execution_date | the date of the transaction by the owner had it not a directly identifiable date | 2016-10-05 |
| transaction_type_code | a symbol representing the transaction type; P = Purchase | S = Sale | A = Award | M = Conversion | F = Payment of Exercise or Tax Withholding | G = Gift More Transaction Codes amount_of_shares = the number of shares involved in the subject transaction | S |
| acquisition_disposition_code | a symbol representing whether or not the securities are Acquired or Disposed; A = Acquisition | D = Disposition | A |
| transaction_price | the price (or weighted average price) of the transaction | 0.0 |
| total_shares_owned | immediately after the transaction, the total number of shares owned by the owner | 12055.0 |
| ownership_type_code | a symbol representing the ownership of the securities transacted; D = Direct Ownership | I = Indirect Ownership | D |
| nature_of_ownership | if the ownership type is indirect, an indication of who is the owner of the securities; usually a trust, foundation, or spouse | - |
| report_line_number | the line number of the transaction from the filing document | 1 |
Not available for this access method
Returns a list of all insider ownership interests in a company.
| Name | Description | Example |
|---|---|---|
| identifier | The stock market ticker symbol associated with the companies common stock securities or the Central Index Key issued by the SEC, which is the unique identifier all company filings are issued under. | AAPL |
| page_number | An integer greater than or equal to 1 for specifying the page number for the return values. | - |
| page_size | An integer greater than or equal to 1 for specifying the number of results on each page. | 10 |
| hide_paging |
Hide first row of paging information.
Options:
true
|
true |
| Name | Description | Example |
|---|---|---|
| owner_cik | the Central Index Key issued by the SEC, which is the unique identifier all owner filings | 0001494730 |
| owner_name | the name of the owner, either an institutional owner or an insider owner | Musk Elon |
| last_reported_date | the last insider transaction date where indicated ownership | 2016-05-26 |
| value | the value of the owners direct and indirect interests in the company based on the price from the previous day’s price. | 6451844000.0 |
| amount | the total number of the owners direct and indirect interests in the company - direct interests are in the insiders name, while indirect interests may be in a trust, foundation, or spouses name but the owner still has some control over the securities | 31100719.0 |
Not available for this access method
Returns a list of all insider transactions by an owner in as many companies as the owner may be considered an insider. Criteria for being an insider include being a director, officer, or 10%+ owner in the company. Transactions are detailed for both non-derivative and derivative transactions by the insider.
| Name | Description | Example |
|---|---|---|
| identifier | The Central Index Key issued by the SEC, which is the unique identifier all owner filings are issued under. | 0001494730 |
| page_number | An integer greater than or equal to 1 for specifying the page number for the return values. | 4 |
| page_size | An integer greater than or equal to 1 for specifying the number of results on each page. | 10 |
| hide_paging |
Hide first row of paging information.
Options:
true
|
true |
| Name | Description | Example |
|---|---|---|
| ticker | the ticker symbol for the company’s common stock | TSLA |
| company_cik | the company’s Central Index Key (CIK) unique identifier with the SEC | 0001494730 |
| company_name | the name of the company | Tesla Motors Inc |
| filing_date | the date of the filing with the SEC made by the owner | 2016-05-26 |
| filing_url | the URL of the filing with the SEC | https://www.sec.gov/Archives/edgar/data/1318605/000149473016000008/xslF345X03/edgardoc.xml |
| director | (true/false) a boolean indicating whether or not the owner is a director in the company | true |
| officer | (true/false) a boolean indicating whether or not the owner is a officer in the company | true |
| ten_percent_owner | (true/false) a boolean indicating whether or not the owner has a ten percent or greater interest in the company | true |
| other_relation | (true/false) a boolean indicating whether or not the owner has another relationship with the company beside, direct, officer, or significant owner in the company | - |
| officer_title | the officer title of the owner in the company | CEO |
| derivative_transaction | (true) a boolean indicating the transaction is a derivative transaction, which may or may not become common stock due to various possible exercise or conversion requirements | true |
| security_title | the name of the derivative security transacted | Common Stock |
| conversion_exercise_price | the conversion or exercise price of the derivative security transacted | 6.63 |
| transaction_date | the date of the transaction | 2016-05-19 |
| deemed_execution_date | the date of the transaction had it not a directly identifiable date | 2016-05-19 |
| transaction_type_code | a symbol representing the transaction type; P = Purchase | S = Sale | A = Award | M = Conversion to Common | C = Conversion | X = Exercise of Derivative More Transaction Codes | C |
| acquisition_disposition_code | a symbol representing whether or not the derivative securities are Acquired or Disposed; A = Acquisition | D = Disposition | 2016-05-19 |
| amount_of_shares | the number of derivative securities involved in the subject transaction | 2147986.0 |
| exercise_date | the exercise date of the derivative securities | 2017-02-19 |
| expiration_date | the expiration date of the derivative securities | 2018-05-19 |
| underlying_security_title | the name of the underlying non-derivative security related to this derivative transaction | Common Stock |
| underlying_shares | the number of non-derivative shares involved in the subject transaction | 1727328.0 |
| transaction_price | the price of the derivative securities | 6.63 |
| total_shares_owned | the total number of derivative securities owned following the subject transaction | 31727328.0 |
| ownership_type_code | a symbol representing the ownership of the securities transacted; D = Direct Ownership | I = Indirect Ownership | D |
Not available for this access method
Returns a list of all ownership interests and the value of their interests by a single insider owner. A single owner may own insider interests in a number of companies.
| Name | Description | Example |
|---|---|---|
| identifier | The Central Index Key issued by the SEC, which is the unique identifier all owner filings. | 0001494730 |
| page_number | An integer greater than or equal to 1 for specifying the page number for the return values. | 4 |
| page_size | An integer greater than or equal to 1 for specifying the number of results on each page. | 10 |
| hide_paging |
Hide first row of paging information.
Options:
true
|
true |
| Name | Description | Example |
|---|---|---|
| ticker | the stock market ticker symbol associated with the companies common stock securities | TSLA |
| company_cik | the Central Index Key issued by the SEC, which is the unique identifier all company filings are issued under | 0001318605 |
| company_name | the company name in shorter form | Tesla Motors Inc |
| last_reported_date | the last insider transaction date where indicated ownership | 2016-05-26 |
| value | the value of the owners direct and indirect interests in the company based on the price from the previous day’s price. | 6451844000.0 |
| amount | the total number of the owners direct and indirect interests in the company- direct interests are in the insiders name, while indirect interests may be in a trust, foundation, or spouses name but the owner still has some control over the securities | 31100719.0 |
Not available for this access method