API Tutorial

Making your first API call

Welcome to the Intrinio API. Through our Intrinio 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 primary application of the Intrinio API is for use in third-party applications and integrations or for end-users utilizing the Excel add-in and Google Sheets add-on.

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.

Now, let's get started on making your first API call.

Via Browser

The easiest way to test out the Intrinio API is by using your browser.

1. Paste your request into the address bar. For example:
   https://api.intrinio.com/companies?ticker=AAPL
2. Your browser should prompt you for a username and password. Use your Access Keys (which can also be found in your Account page):
   To view your access key, click here to log in.
3. The request response (in JSON) format should appear in your browser viewport.

Via Command Line

You can also test the Intrinio API using the cURL command line utility.

Via Code

Authentication

The Intrinio API uses Basic Authentication over HTTPS. The username and password components are contained in your Intrinio Access Keys.

Response Formats

All Intrinio API responses are in JSON format. The HTTP Response Status Code of 200 indicates that a request is well formed and valid. A Status Code of 401 indicates that API Authorization is not authenticated, due to being invalid. The Response Status Code of 403 indicates that you have reached a usage limit, such as your subscription’s 10 minute call limit or daily call limit. The Response message will give further indication to the reason for the error.

Ruby Example

require "http"
require "json"

username = "USERNAME"
password = "PASSWORD"
request_url = "https://api.intrinio.com/companies?ticker=AAPL"

response = HTTP.basic_auth(:user => username, :pass => password)
               .get(request_url)
               .body

company = JSON.parse(response)
puts company

JavaScript (Node) Example

var https = require("https");

var username = "USERNAME";
var password = "PASSWORD";
var auth = "Basic " + new Buffer(username + ':' + password).toString('base64');

var request = https.request({
    method: "GET",
    host: "api.intrinio.com",
    path: "/companies?ticker=AAPL",
    headers: {
        "Authorization": auth
    }
}, function(response) {
    var json = "";
    response.on('data', function (chunk) {
        json += chunk;
    });
    response.on('end', function() {
        var company = JSON.parse(json);
        console.log(company);
    });
});

request.end();

Go Forth and Build

We can't wait to see what you will build using the Intrinio API.

Documentation

For a detailed reference, see our Documentation site.

Developer Program

If you are interested in getting 6 months of extended access to all of our data feeds, take a look at the Developer Program.

We Are Here to Help

If you run into any trouble feel free to chat with us.

Go to my Account