Welcome to Intrinio!
Intrinio is an a-la-carte financial data platform, allowing you to pick and choose only and exactly the data you require with over 300 different data feeds to select from. You can browse our entire product offering anytime in our data marketplace, here.
The majority of the data feeds we offer are integrated through our single REST API and Excel add-in, all connected via our global security master. This makes for incredibly easy integration of new data types into your existing implementation for a truly unique, customizable and flexible solution. We also offer live chat support on our site, extensive documentation, pre-made Excel templates, and official SDKs in numerous languages to help get you and your team up and running right away.
I signed up. Now what?
As soon as you create a free account (if you haven't yet, you can do so here), you immediately receive two API keys: A Sandbox Key and a Production Key. You can find both in the API Keys section of your account page here.
What is the Sandbox?
Your Sandbox Key is live and ready to use right away. It provides access to full data and history for the majority of the data feeds we offer, on a limited universe for each feed (primarily the Dow 30 universe).
This access does not expire and is meant as a test environment to evaluate our platform and build out your proof of concept.
How Do I Get Started With the Sandbox?
To start using your Sandbox access, begin on the Sandbox section of our documentation, here. This provides more information on your Sandbox access, including all data feeds available with the specific universe included next to each (located at the very bottom of that page):
At the top of that documentation page, you'll see several access methods to toggle between: Excel, CSV, and two API Versions (v1 and v2).
- Excel provides specific documentation for our Excel add-in
- CSV is our CSV-based API
- API Version v1 is our old API, which is being replaced by v2
- API Version v2 is our latest API version (use this one)
The rest of this article will use examples/walk-through our API Version v2 platform specifically. However, this will be almost identical to all other access methods, with slight variations in verbiage/results returned, so it will be applicable and helpful across the board.
Once you select your preferred access method, you'll find the general documentation at the top left under the "Overview" section. This section includes initial getting started information, authentication help, info on limits and response codes, etc. It is recommend you go through each section beginning at the top and working your way down, to build up your base knowledge on the API.
How Do I Find The API Endpoints You Cover?
Skip the “SDKs” section for now and move down to the “API Endpoints” section. This branch of the documentation lists out all endpoints available to you via our platform, categorized by data type and/or function.
Within each specific endpoint, you’ll find information on the input parameters with explanations, output fields with definitions, and a Sample Data section showing you an example response in JSON.
How Do I Use These API Endpoints?
Also included is a live formula builder, allowing you to craft your endpoints with guided parameter fields and helpful lookups. To access this, click “Switch to Live Data” in the Sample Data section:
You’ll be greeted with an interface showing all possible parameters, with text fields allowing you to easily insert/update the inputs for the endpoint.
You’ll notice the “URL” box below will also update in real time as you add/remove parameters from the call, showing you the exact Web API syntax created based on your inputs.
You’re also able to run the endpoint directly in this interface, allowing you to test out your syntax before running it elsewhere. To do so, first make sure the formula builder is using your Sandbox API Key by clicking the gear icon directly below the URL box and selecting API Key Sandbox:
Once set, hit the “Execute” button to the right (also seen above) to return the data requested directly in the formula builder window.
To now run the endpoint in your browser, make sure that the “Include API_KEY parameter when copying” is selected (also seen above), click the URL text box to copy, "Ctrl-V" paste in the URL section of a new browser window, and hit enter to run. This will return the data requested directly in your browser, in raw format. To format this data into a more easily digestible output in Chrome specifically, we recommend the JSON Formatter Chrome Extension.
Applying Your Knowledge: A Test Run with the Sandbox, API v2, and API Endpoints.
- Step 1. As a quick example/practice, use the All Companies Endpoint to return the list of US companies accessible in the Sandbox environment (Dow 30):
https://api-v2.intrinio.com/companies?api_key=Your Sandbox API Key
- Step 2. Take one of the companies returned there, and run it through the Stock Prices by Security Endpoint, to return the end of day adjusted and unadjusted pricing data time series for that specific company:
https://api-v2.intrinio.com/securities/AAPL/prices?&page_size=1000&api_key=Your Sandbox API Key
- Step 3. Try the Latest Earnings Record for Security Endpoint, to return the latest/upcoming earnings date information for a specific company:
https://api-v2.intrinio.com/securities/AAPL/earnings/latest?api_key=Your Sandbox API Key
- Step 4. Test out a completely different security type, by running the Forex Currency Pairs Endpoint, to return the list of currency pairs you have access to with your Sandbox environment:
https://api-v2.intrinio.com/forex/pairs?api_key=Your Sandbox API Key
- Step 5. Run one of those pairs through the Forex Currency Prices Endpoint, to return the historical pricing data time series for that specific pair:
https://api-v2.intrinio.com/forex/prices/EURUSD/H1?timezone=UTC&api_key=Your Sandbox API Key
- Step 6. Once familiarized with our documentation for the Web API, we recommend utilizing one of our official SDKs for easy integration/implementation in numerous programming languages. You can find the list, with links to their respective GitHub pages, on the same documentation page directly under the top “Overview” section on the left side of the page:
I’d Like to Access the Entire Universe, What do I do Next? How do I Move to a Production Environment?
Discover Which Data Feeds You've Been Using in The Sandbox.
In order to move from the Sandbox environment to a production level subscription, with higher API limits and access to the full universe available, you’ll first need to determine which data feeds you’ve been utilizing in the Sandbox.
In order to do that, navigate to the Usage section of your Account page, here.
On this page, you’ll find an “API Usage” box, with an “Environment” toggle allowing you to choose “Sandbox” or “Production”:
Make sure you’ve specified “Sandbox” and you’ll see a list of individual data feed products you’ve been accessing during your time in the Sandbox, with your respective usage on each.
Determine Which Data Feeds You'd Like to Subscribe to for Production Level Access.
Decide which data feed(s) you’re interested in based on usage, and click the data feed name to land on that individual data feed’s product page. Below for example, is the US Fundamentals & Stock Prices data feed product page:
You will be brought to that product's "Info" page. If you like what you see and want to purchase a subscription for production level access, click on the "Pricing" tab:
Pick The Best Pricing Plan and Subscription For You.
Here you’ll find a pricing calculator, allowing you to select a license, use case, and billing preference according to your needs.
Most of our plans are completely self sign--up, so simply make your selections, hit “Subscribe” to the far right, and follow the prompts to subscribe to the feed. If you are unable to subscribe based on the options you’ve selected, click the “Request Quote” button instead, and fill out the form to be sent to a member of our sales staff to review and prepare a proposal for you.
You Now Have A Production API Key.
Once subscribed, you’ll immediately receive production level access to the specific feed you chose. All documentation and current integrations you have will continue to work for you, you simply need to switch out the Sandbox Key you’ve been using, for your Production Key (both seen on your account page here).
Your Sandbox Key will remain active for all of our feeds, so for any of those you still wish to test, continue to use the Sandbox Key. However, for any data feed products you are subscribed, make sure to use that Production Key to take advantage of your subscription.
Do You Have Any Additional Resources or Guidance?
If you ever need any assistance or have any questions at all, please don’t hesitate to reach out to our support team either at firstname.lastname@example.org, or via our live chat service located at the bottom right-hand corner of the screen. We are available on chat live between the hours of 9:30 AM and 5:30 PM EST Monday-Friday.
For additional resources/information, please see the below helpful links: