Overview

Details about how to obtain access tokens using OAuth 2.0

Fetch positions, balances and other account related details.

Place equity and complex option trades including advanced orders.

Fetch quotes, chains and historical data via REST and streaming APIs.

Stream market data and account events in real-time.

Create and update custom watchlists.

Examples, response types, property details and explanations.

Get Ratios

  • Available in Paper Trading
  • Available in Production
  • Available to Advisors
  • Supported
Note: This API is presently in Beta. It is only available to Tradier Brokerage account holders and should only be used in production applications with caution.

Get standard financial ratios for a company.

GET

Headers

Header Required Values/Example Default
Accept Optional application/xml, application/json application/xml
Authorization Required Bearer {token}

Parameters

Parameter Type Param Type Required Values/Example Default
symbols Query String Required MSFT
Comma-delimited list of symbols

Code Example

If you're developing using a paper trading account, change the hostname to https://sandbox.tradier.com
curl -X GET "https://api.tradier.com/beta/markets/fundamentals/ratios?symbols=MSFT" \
     -H 'Authorization: Bearer <TOKEN>' \
     -H 'Accept: application/json'
// Version 1.8.0_31    
import com.fasterxml.jackson.databind.JsonNode;
import com.fasterxml.jackson.databind.ObjectMapper;
import org.apache.http.HttpEntity;
import org.apache.http.HttpResponse;
import org.apache.http.client.methods.HttpUriRequest;
import org.apache.http.client.methods.RequestBuilder;
import org.apache.http.impl.client.HttpClientBuilder;
import org.apache.http.util.EntityUtils;

import java.io.IOException;

public class MainClass {
  public static void main(String[] args) throws IOException {
    final HttpUriRequest request = RequestBuilder
        .get("https://api.tradier.com/beta/markets/fundamentals/ratios")
        .addHeader("Authorization", "Bearer <TOKEN>")
        .addHeader("Accept", "application/json")
        .addParameter("symbols", "MSFT")
        .build();

    final HttpResponse response = HttpClientBuilder.create().build().execute(request);
    final String jsonString = EntityUtils.toString(response.getEntity());
    final JsonNode json = new ObjectMapper().readTree(jsonString);
    
    System.out.println(response.getStatusLine().getStatusCode());
    System.out.println(json);
  }
}
# Version 2.5.0p0    
require 'uri'
require 'net/http'

url = URI("https://api.tradier.com/beta/markets/fundamentals/ratios?symbols=MSFT")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <TOKEN>'
request["Accept"] = 'application/json'

response = http.request(request)
puts response.code
puts response.read_body
// Version go1.12      
package main

import (
    "fmt"
    "net/http"
    "net/url"
    "io/ioutil"
    "log"
)

func main() {
    apiUrl := "https://api.tradier.com/beta/markets/fundamentals/ratios?symbols=MSFT"

    u, _ := url.ParseRequestURI(apiUrl)
    urlStr := u.String()

    client := &http.Client{}
    r, _ := http.NewRequest("GET", urlStr, nil)
    r.Header.Add("Authorization", "Bearer <TOKEN>")
    r.Header.Add("Accept", "application/json")

    resp, _ := client.Do(r)
    responseData, err := ioutil.ReadAll(resp.Body)

    if err != nil {
      log.Fatal(err)
    }

    fmt.Println(resp.Status)
    fmt.Println(string(responseData))
}
// Version 4.6.2.0    
using System;
using System.Net;  
using System.IO;
using System.Text;

public class MainClass {
  public static void Main (string[] args) {
    var request = (HttpWebRequest)WebRequest.Create("https://api.tradier.com/beta/markets/fundamentals/ratios?symbols=MSFT");
    request.Method = "GET";
    request.Headers["Authorization"] = "Bearer <TOKEN>";
    request.Accept = "application/json";

    var response = (HttpWebResponse)request.GetResponse();

    Console.WriteLine (response.StatusCode);
    var responseString = new StreamReader(response.GetResponseStream()).ReadToEnd();
    Console.WriteLine (responseString);
  }
}
// Version 10.15.2    
const request = require('request');

request({
    method: 'get',
    url: 'https://api.tradier.com/beta/markets/fundamentals/ratios',
    qs: {
       'symbols': 'MSFT'
    },
    headers: {
      'Authorization': 'Bearer <TOKEN>',
      'Accept': 'application/json'
    }
  }, (error, response, body) => {
      console.log(response.statusCode);
      console.log(body);
  });
# Version 3.6.1    
import requests

response = requests.get('https://api.tradier.com/beta/markets/fundamentals/ratios',
    params={'symbols': 'MSFT'},
    headers={'Authorization': 'Bearer <TOKEN>', 'Accept': 'application/json'}
)
json_response = response.json()
print(response.status_code)
print(json_response)
<?php
// Version 7.2.17-0ubuntu0.18.04.1
$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, 'https://api.tradier.com/beta/markets/fundamentals/ratios?symbols=MSFT');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');

$headers = array();
$headers[] = 'Authorization: Bearer <TOKEN>';
$headers[] = 'Accept: application/json';

curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$result = curl_exec($ch);
$http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
if (curl_errno($ch)) {
    echo 'Error:' . curl_error($ch);
}
curl_close ($ch);
echo $http_code;
echo $result;

Response

[
  {
    "request": "MSFT",
    "type": "Symbol",
    "results": [
      {
        "type": "Company",
        "id": "0C000008EC",
        "tables": {
          "operation_ratios_restate": [
            {
              "period_1y": {
                "company_id": "0C000008EC",
                "as_of_date": "2019-03-31",
                "fiscal_year_end": "6",
                "period": "1Y",
                "report_type": "TTM",
                "assets_turnover": 0.48041,
                "cap_ex_sales_ratio": 0.113361,
                "capital_expenditureto_e_b_i_t_d_a": -0.248569,
                "cash_conversion_cycle": 6.375441,
                "days_in_inventory": 17.433416,
                "days_in_payment": 65.52977,
                "days_in_sales": 54.471795,
                "e_b_i_t_d_a_margin": 0.456056,
                "e_b_i_t_margin": 0.363805,
                "f_c_f_net_income_ratio": 0.963208,
                "f_c_f_sales_ratio": 0.27527,
                "f_c_fto_c_f_o": 0.708306,
                "fix_assets_turonver": 3.969372,
                "gross_margin": 0.654368,
                "interest_coverage": 16.534399,
                "inventory_turnover": 20.936803,
                "net_incomes_per_employee": 266610.687023,
                "net_margin": 0.285784,
                "normalized_net_profit_margin": 0.261668,
                "normalized_r_o_i_c": 0.211043,
                "operation_margin": 0.334937,
                "payment_turnover": 5.569987,
                "pretax_margin": 0.341802,
                "receivable_turnover": 6.700716,
                "r_o_a": 0.137294,
                "r_o_e": 0.401211,
                "r_o_i_c": 0.229216,
                "sales_per_employee": 932908.396947,
                "tax_rate": 0.16389,
                "working_capital_turnover_ratio": 1.128699
              }
            },
            {
              "period_3m": {
                "company_id": "0C000008EC",
                "as_of_date": "2019-03-31",
                "fiscal_year_end": "6",
                "period": "3M",
                "report_type": "P",
                "cash_ratio": 2.443661,
                "cashto_total_assets": 0.499915,
                "common_equity_to_assets": 0.360315,
                "current_ratio": 2.968512,
                "debtto_assets": 0.27765,
                "e_b_i_t_d_a_margin": 0.433973,
                "e_b_i_t_margin": 0.338262,
                "financial_leverage": 2.775352,
                "gross_margin": 0.667332,
                "long_term_debt_equity_ratio": 0.7019,
                "long_term_debt_total_capital_ratio": 0.412421,
                "net_incomes_per_employee": 67244.274809,
                "net_margin": 0.288149,
                "normalized_net_profit_margin": 0.288149,
                "operation_margin": 0.338262,
                "pretax_margin": 0.343005,
                "quick_ratio": 2.801415,
                "sales_per_employee": 233366.412214,
                "tax_rate": 0.159928,
                "total_debt_equity_ratio": 0.770577
              },
              "period_9m": {
                "company_id": "0C000008EC",
                "as_of_date": "2019-03-31",
                "fiscal_year_end": "6",
                "period": "9M",
                "report_type": "P",
                "e_b_i_t_d_a_margin": 0.42672,
                "e_b_i_t_margin": 0.331654,
                "gross_margin": 0.647244,
                "net_incomes_per_employee": 198877.862595,
                "net_margin": 0.282797,
                "normalized_net_profit_margin": 0.282797,
                "operation_margin": 0.331654,
                "pretax_margin": 0.337494,
                "sales_per_employee": 703251.908397,
                "tax_rate": 0.162067
              }
            },
            {
              "period_3m": {
                "company_id": "0C000008EC",
                "as_of_date": "2019-03-31",
                "fiscal_year_end": "6",
                "period": "3M",
                "report_type": "R",
                "assets_turnover": 0.117099,
                "cash_conversion_cycle": 7.905167,
                "cash_ratio": 2.443661,
                "cashto_total_assets": 0.499915,
                "common_equity_to_assets": 0.360315,
                "current_ratio": 2.968512,
                "days_in_inventory": 17.550147,
                "days_in_payment": 67.773537,
                "days_in_sales": 58.128557,
                "debtto_assets": 0.27765,
                "e_b_i_t_d_a_margin": 0.460665,
                "e_b_i_t_margin": 0.364954,
                "financial_leverage": 2.775352,
                "fix_assets_turonver": 0.921299,
                "gross_margin": 0.667332,
                "interest_coverage": 16.627422,
                "inventory_turnover": 5.199387,
                "long_term_debt_equity_ratio": 0.7019,
                "long_term_debt_total_capital_ratio": 0.412421,
                "net_income_cont_ops_growth": 0.186557,
                "net_income_growth": 0.186557,
                "net_incomes_per_employee": 67244.274809,
                "net_margin": 0.288149,
                "normalized_net_profit_margin": 0.266167,
                "normalized_r_o_i_c": 0.052215,
                "operation_income_growth": 0.247106,
                "operation_margin": 0.338262,
                "operation_revenue_growth3_month_avg": 0.139901,
                "payment_turnover": 1.346396,
                "pretax_margin": 0.343005,
                "quick_ratio": 2.801415,
                "receivable_turnover": 1.569796,
                "revenue_growth": 0.139901,
                "r_o_a": 0.033742,
                "r_o_e": 0.094218,
                "r_o_i_c": 0.056248,
                "sales_per_employee": 233366.412214,
                "tax_rate": 0.159928,
                "total_debt_equity_ratio": 0.770577,
                "working_capital_turnover_ratio": 0.287616
              },
              "period_9m": {
                "company_id": "0C000008EC",
                "as_of_date": "2019-03-31",
                "fiscal_year_end": "6",
                "period": "9M",
                "report_type": "R",
                "e_b_i_t_d_a_margin": 0.454454,
                "e_b_i_t_margin": 0.359388,
                "gross_margin": 0.647244,
                "interest_coverage": 16.414973,
                "net_income_cont_ops_growth": 2.384386,
                "net_income_growth": 2.384386,
                "net_incomes_per_employee": 198877.862595,
                "net_margin": 0.282797,
                "normalized_net_profit_margin": 0.260085,
                "operation_income_growth": 0.238057,
                "operation_margin": 0.331654,
                "operation_revenue_growth3_month_avg": 0.14763,
                "pretax_margin": 0.337494,
                "revenue_growth": 0.14763,
                "sales_per_employee": 703251.908397,
                "tax_rate": 0.162067
              }
            }
          ],
          "operation_ratios_a_o_r": [
            {
              "period_1y": {
                "company_id": "0C000008EC",
                "as_of_date": "2019-03-31",
                "fiscal_year_end": "6",
                "period": "1Y",
                "report_type": "TTM",
                "assets_turnover": 0.48041,
                "cap_ex_sales_ratio": 0.113361,
                "capital_expenditureto_e_b_i_t_d_a": -0.248569,
                "cash_conversion_cycle": 6.375441,
                "days_in_inventory": 17.433416,
                "days_in_payment": 65.52977,
                "days_in_sales": 54.471795,
                "e_b_i_t_d_a_margin": 0.456056,
                "e_b_i_t_margin": 0.363805,
                "f_c_f_net_income_ratio": 0.963208,
                "f_c_f_sales_ratio": 0.27527,
                "f_c_fto_c_f_o": 0.708306,
                "fix_assets_turonver": 3.969372,
                "gross_margin": 0.654368,
                "interest_coverage": 16.534399,
                "inventory_turnover": 20.936803,
                "net_incomes_per_employee": 266610.687023,
                "net_margin": 0.285784,
                "normalized_net_profit_margin": 0.261668,
                "normalized_r_o_i_c": 0.211043,
                "operation_margin": 0.334937,
                "payment_turnover": 5.569987,
                "pretax_margin": 0.341802,
                "receivable_turnover": 6.700716,
                "r_o_a": 0.137294,
                "r_o_e": 0.401211,
                "r_o_i_c": 0.229216,
                "sales_per_employee": 932908.396947,
                "tax_rate": 0.16389,
                "working_capital_turnover_ratio": 1.128699
              }
            },
            {
              "period_3m": {
                "company_id": "0C000008EC",
                "as_of_date": "2019-03-31",
                "fiscal_year_end": "6",
                "period": "3M",
                "report_type": "P",
                "cash_ratio": 2.443661,
                "cashto_total_assets": 0.499915,
                "common_equity_to_assets": 0.360315,
                "current_ratio": 2.968512,
                "debtto_assets": 0.27765,
                "e_b_i_t_d_a_margin": 0.433973,
                "e_b_i_t_margin": 0.338262,
                "financial_leverage": 2.775352,
                "gross_margin": 0.667332,
                "long_term_debt_equity_ratio": 0.7019,
                "long_term_debt_total_capital_ratio": 0.412421,
                "net_incomes_per_employee": 67244.274809,
                "net_margin": 0.288149,
                "normalized_net_profit_margin": 0.288149,
                "operation_margin": 0.338262,
                "pretax_margin": 0.343005,
                "quick_ratio": 2.801415,
                "sales_per_employee": 233366.412214,
                "tax_rate": 0.159928,
                "total_debt_equity_ratio": 0.770577
              },
              "period_9m": {
                "company_id": "0C000008EC",
                "as_of_date": "2019-03-31",
                "fiscal_year_end": "6",
                "period": "9M",
                "report_type": "P",
                "e_b_i_t_d_a_margin": 0.42672,
                "e_b_i_t_margin": 0.331654,
                "gross_margin": 0.647244,
                "net_incomes_per_employee": 198877.862595,
                "net_margin": 0.282797,
                "normalized_net_profit_margin": 0.282797,
                "operation_margin": 0.331654,
                "pretax_margin": 0.337494,
                "sales_per_employee": 703251.908397,
                "tax_rate": 0.162067
              }
            },
            {
              "period_3m": {
                "company_id": "0C000008EC",
                "as_of_date": "2019-03-31",
                "fiscal_year_end": "6",
                "period": "3M",
                "report_type": "A",
                "assets_turnover": 0.117099,
                "cash_conversion_cycle": 7.905167,
                "cash_ratio": 2.443661,
                "cashto_total_assets": 0.499915,
                "common_equity_to_assets": 0.360315,
                "current_ratio": 2.968512,
                "days_in_inventory": 17.550147,
                "days_in_payment": 67.773537,
                "days_in_sales": 58.128557,
                "debtto_assets": 0.27765,
                "e_b_i_t_d_a_margin": 0.460665,
                "e_b_i_t_margin": 0.364954,
                "financial_leverage": 2.775352,
                "fix_assets_turonver": 0.921299,
                "gross_margin": 0.667332,
                "interest_coverage": 16.627422,
                "inventory_turnover": 5.199387,
                "long_term_debt_equity_ratio": 0.7019,
                "long_term_debt_total_capital_ratio": 0.412421,
                "net_income_cont_ops_growth": 0.0462,
                "net_income_growth": 0.0462,
                "net_incomes_per_employee": 67244.274809,
                "net_margin": 0.288149,
                "normalized_net_profit_margin": 0.266167,
                "normalized_r_o_i_c": 0.052215,
                "operation_income_growth": 0.008091,
                "operation_margin": 0.338262,
                "operation_revenue_growth3_month_avg": -0.058514,
                "payment_turnover": 1.346396,
                "pretax_margin": 0.343005,
                "quick_ratio": 2.801415,
                "receivable_turnover": 1.569796,
                "revenue_growth": -0.058514,
                "r_o_a": 0.033742,
                "r_o_e": 0.094218,
                "r_o_i_c": 0.056248,
                "sales_per_employee": 233366.412214,
                "tax_rate": 0.159928,
                "total_debt_equity_ratio": 0.770577,
                "working_capital_turnover_ratio": 0.287616
              },
              "period_9m": {
                "company_id": "0C000008EC",
                "as_of_date": "2019-03-31",
                "fiscal_year_end": "6",
                "period": "9M",
                "report_type": "A",
                "e_b_i_t_d_a_margin": 0.454454,
                "e_b_i_t_margin": 0.359388,
                "gross_margin": 0.647244,
                "interest_coverage": 16.414973,
                "net_incomes_per_employee": 198877.862595,
                "net_margin": 0.282797,
                "normalized_net_profit_margin": 0.260085,
                "operation_margin": 0.331654,
                "pretax_margin": 0.337494,
                "sales_per_employee": 703251.908397,
                "tax_rate": 0.162067
              },
              "period_5y": {
                "company_id": "0C000008EC",
                "as_of_date": "2019-03-31",
                "fiscal_year_end": "6",
                "period": "5Y",
                "report_type": "A",
                "regression_growth_operating_revenue5_years": 0.060558
              }
            }
          ]
        }
      },
      {
        "type": "Stock",
        "id": "0P000003MH",
        "tables": {
          "earning_ratios_restate": {
            "period_3m": {
              "share_class_id": "0P000003MH",
              "as_of_date": "2019-03-31",
              "fiscal_year_end": "6",
              "period": "3M",
              "report_type": "R",
              "diluted_cont_e_p_s_growth": 0.2,
              "diluted_e_p_s_growth": 0.2,
              "d_p_s_growth": 0.095238,
              "normalized_basic_e_p_s_growth": 0.25789,
              "normalized_diluted_e_p_s_growth": 0.25981
            },
            "period_9m": {
              "share_class_id": "0P000003MH",
              "as_of_date": "2019-03-31",
              "fiscal_year_end": "6",
              "period": "9M",
              "report_type": "R",
              "diluted_cont_e_p_s_growth": 2.393939,
              "diluted_e_p_s_growth": 2.393939,
              "d_p_s_growth": 0.089431,
              "normalized_basic_e_p_s_growth": 2.557041,
              "normalized_diluted_e_p_s_growth": 2.560722
            }
          },
          "valuation_ratios": {
            "share_class_id": "0P000003MH",
            "as_of_date": "2019-05-09",
            "1st_year_estimated_e_p_s_growth": 0.2365,
            "2nd_year_estimated_e_p_s_growth": 0.1639,
            "2_years_forward_earning_yield": 0.0473,
            "2_years_forward_p_e_ratio": 21.1636,
            "2_yrs_e_v_to_forward_e_b_i_t": 15.5282,
            "2_yrs_e_v_to_forward_e_b_i_t_d_a": 12.0161,
            "book_value_per_share": 12.3798,
            "book_value_yield": 0.0986,
            "buy_back_yield": 0.0168,
            "c_a_p_e_ratio": 47.362,
            "cash_return": 0.0372,
            "c_f_o_per_share": 6.1167,
            "c_f_yield": 0.0487,
            "dividend_rate": 1.84,
            "dividend_yield": 0.014,
            "div_yield5_year": 0.0221,
            "earning_yield": 0.0359,
            "e_vto_e_b_i_t": 21.5522,
            "e_v_to_e_b_i_t_d_a": 16.9832,
            "e_vto_f_c_f": 26.8472,
            "e_v_to_forward_e_b_i_t": 18.6879,
            "e_v_to_forward_e_b_i_t_d_a": 14.6195,
            "e_v_to_forward_revenue": 6.5328,
            "e_vto_pre_tax_income": 21.6213,
            "e_vto_revenue": 7.3902,
            "e_vto_total_assets": 3.4304,
            "expected_dividend_growth_rate": 0.0455,
            "f_c_f_per_share": 4.3325,
            "f_c_f_ratio": 28.966919,
            "f_c_f_yield": 0.0345,
            "forward_calculation_style": "Annual",
            "forward_dividend_yield": 0.0147,
            "forward_earning_yield": 0.0406,
            "forward_p_e_ratio": 24.6305,
            "forward_r_o_a": 0.1483,
            "forward_r_o_e": 0.4116,
            "normalized_p_e_ratio": 27.888889,
            "payout_ratio": 0.3911,
            "p_b_ratio": 10.137498,
            "p_b_ratio10_year_growth": 0.080398,
            "p_b_ratio3_yr_avg": 10.31312,
            "p_cash_ratio3_yr_avg": 7.433207,
            "p_c_f_ratio": 20.517447,
            "p_e_g_payback": 11.4072,
            "p_e_g_ratio": 2.1702,
            "p_e_ratio": 27.888889,
            "p_e_ratio10_year_average": 16.56723,
            "p_e_ratio10_year_growth": 0.095906,
            "p_e_ratio10_year_high": 29.022222,
            "p_e_ratio10_year_low": 11.103448,
            "p_e_ratio1_year_average": 28.372037,
            "p_e_ratio1_year_high": 29.022222,
            "p_e_ratio1_year_low": 27.78,
            "p_e_ratio3_yr_avg": 28.372037,
            "p_e_ratio5_year_average": 28.372037,
            "p_e_ratio5_year_high": 29.022222,
            "p_e_ratio5_year_low": 27.78,
            "p_f_c_f_ratio10_year_growth": 0.099825,
            "p_f_c_f_ratio3_yr_avg": 29.496171,
            "price_change1_m": 0.960949,
            "priceto_cash_ratio": 7.306627,
            "priceto_e_b_i_t_d_a": 17.484097,
            "p_s_ratio": 7.973719,
            "p_s_ratio10_year_growth": 0.106779,
            "p_s_ratio3_yr_avg": 8.111855,
            "ratio_p_e5_year_average": 28.372037,
            "sales_per_share": 15.7392,
            "sales_yield": 0.1254,
            "sustainable_growth_rate": 0.2443,
            "tangible_book_value_per_share": 5.8595,
            "tangible_b_v_per_share3_yr_avg": 5.8879,
            "tangible_b_v_per_share5_yr_avg": 6.4777,
            "total_asset_per_share": 34.3582,
            "total_yield": 0.0308,
            "working_capital_per_share": 13.8364,
            "working_capital_per_share3_yr_avg": 13.689,
            "working_capital_per_share5_yr_avg": 11.6856
          },
          "alpha_beta": {
            "period_36m": {
              "share_class_id": "0P000003MH",
              "as_of_date": "2019-04-30",
              "period": "36M",
              "alpha": 0.019051,
              "beta": 1.032369,
              "non_div_alpha": -0.005522,
              "non_div_beta": 1.023017,
              "non_div_r_square": 48.598183,
              "r_square": 49.437756
            },
            "period_48m": {
              "share_class_id": "0P000003MH",
              "as_of_date": "2019-04-30",
              "period": "48M",
              "alpha": 0.015008,
              "beta": 1.170915,
              "non_div_alpha": -0.159606,
              "non_div_beta": 1.172809,
              "non_div_r_square": 49.950576,
              "r_square": 50.531957
            },
            "period_60m": {
              "share_class_id": "0P000003MH",
              "as_of_date": "2019-04-30",
              "period": "60M",
              "alpha": 0.013512,
              "beta": 1.243847,
              "non_div_alpha": -0.221989,
              "non_div_beta": 1.233689,
              "non_div_r_square": 42.687331,
              "r_square": 43.536083
            },
            "period_120m": {
              "share_class_id": "0P000003MH",
              "as_of_date": "2019-04-30",
              "period": "120M",
              "alpha": 0.008512,
              "beta": 1.02019,
              "non_div_alpha": -0.016477,
              "non_div_beta": 1.022949,
              "non_div_r_square": 34.885912,
              "r_square": 35.021821
            }
          }
        }
      }
    ]
  }
]