Lantern API Documentation
You're not logged in so demo API Key is used.
Options Chains
GET
JSON
Get all the options chains and the relevant data for a supplied company
Query
{
    "symbol": "IBM"
}
Response
{
    "data": {
        "2021-08-27": {
            "call": [
                {
                    "ask_price": 24.149999618530273,
                    "bid_price": 23.899999618530273,
                    "change": 12.910798584514449,
                    "direction": "call",
                    "expiry": "2021-08-27",
                    "last_order_dt": "2021-08-06 18:23",
                    "prev_price": 21.3,
                    "price": 24.049999237060547,
                    "strike": 120,
                    "symbol": "IBM",
                    "volume": 25
                },
                {
                    "ask_price": 21.850000381469727,
                    "bid_price": 19.700000762939453,
                    "change": 22.41379140248334,
                    "direction": "call",
                    "expiry": "2021-08-27",
                    "last_order_dt": "2021-07-20 16:37",
                    "prev_price": 17.4,
                    "price": 21.299999237060547,
                    "strike": 120,
                    "symbol": "IBM",
                    "volume": 10
                },
                {
                    "ask_price": 12,
                    "bid_price": 11.899999618530273,
                    "change": -11.764708357286224,
                    "direction": "call",
                    "expiry": "2021-08-27",
                    "last_order_dt": "2021-08-17 16:14",
                    "prev_price": 13.6,
                    "price": 12,
                    "strike": 130,
                    "symbol": "IBM",
                    "volume": 1
                }
            ]
        }
    }
}
Option Prices
GET
JSON
Get the NBBO, prices of a contract over time.
Query
{
    "symbol": "IBM",
    "strike": 211,
    "expiry": "2022-01-21",
    "direction": "call"
}
Response
[
    {
        "ask": 8.399999618530273,
        "bid": 8.25,
        "direction": "call",
        "expiry": "2022-01-21",
        "first": 8.35,
        "high": 8.35,
        "last": 8.35,
        "low": 8.35,
        "mid": 8.350000381469727,
        "minute": "2021-08-02 15:00",
        "strike": 137,
        "symbol": "IBM",
        "volume": 2
    }
]
Company Prices
GET
JSON
Get the stock prices of a listed symbol
Query
{
    "symbol": "IBM",
    "period": "day"
}
Response
{
    "prev_day_close": {
        "prev_underlying_price": 3331.4883
    },
    "prices": [
        {
            "mid": 3337.824951171875,
            "minute": "2021-08-03 13:00",
            "symbol": "AMZN"
        },
        {
            "mid": 3336.25,
            "minute": "2021-08-03 13:05",
            "symbol": "AMZN"
        }
    ]
}
Options Quotes
GET
JSON
Get the options quotes for a contract
Query
{
    "symbol": "IBM",
    "strike": 210,
    "expiry": "2022-01-21",
    "direction": "call"
}
Response
{
    "quotes": [
        {
            "symbol": "IBM",
            "expiry": "2021-08-13",
            "direction": "call",
            "strike": 137,
            "minute": "2021-08-05 17:40",
            "high": 3.4,
            "low": 3.25,
            "mid": 3.33,
            "first": 3.3,
            "last": 3.4,
            "bid_high": 3.3,
            "bid_low": 3.2,
            "bid_mid": 3.25,
            "bid_first": 3.25,
            "bid_last": 3.4,
            "bid_volume": 10,
            "ask_high": 3.35,
            "ask_low": 3.2,
            "ask_mid": 3.25,
            "ask_first": 3.25,
            "ask_last": 3.4,
            "ask_volume": 5
        }
    ]
}
Put-Call Ratio
GET
JSON
Get the put/call ratio of a company over time
Query
{
    "symbol": "IBM"
}
Response
{
    "calls": 107844,
    "calls_amt_paid": 9011893.64581633,
    "dt": "2021-08-03",
    "put_call_money_ratio": 0.6215872398113298,
    "put_call_ratio": 0.48514520974741293,
    "puts": 52320,
    "puts_amt_paid": 5601678.096776234
}
Company List
GET
JSON
Get a list of all the companies and their name in our database
Query
{}
Response
[
    "CFRpB",
    "CFSKF",
    "CFST",
    "CFSU",
    "CFTLF",
    "CFTN"
]
Company News
GET
JSON
Get news articles sorted by recency. If you don't supply a company in the query, it'll give general market news sorted by recency. If no symbol is provided, it'll provide the most recent stock news.
Query
{
    "symbol": "IBM"
}
Response
[
    {
        "image": "https://cdn.snapi.rest/images/v1/f/l/flipping-a-quarter-final-days-of-q1-could-be-choppy-as-jobs-manufacturing-data-awaited-742998-891957-943415.jpg",
        "publishedDate": "2021-08-03 14:01:06",
        "site": "Seeking Alpha",
        "symbol": "IBM",
        "text": "This article updates one published by David Van Knapp in June 2020.",
        "title": "The Highest Quality Dividend Growth Stocks",
        "url": "https://seekingalpha.com/article/4444407-the-highest-quality-dividend-growth-stocks"
    },
    {
        "image": "https://cdn.snapi.rest/images/v1/o/l/computer-electronic36-943219.jpg",
        "publishedDate": "2021-08-03 12:52:18",
        "site": "InvestorPlace",
        "symbol": "IBM",
        "text": "Despite the recent weakness arising from regulatory headwinds, these Chinese stocks deserve consideration for long-term portfolios. The post 4 Chinese Stocks to Buy While Everyone Else Is Selling appeared first on InvestorPlace.",
        "title": "4 Chinese Stocks to Buy While Everyone Else Is Selling",
        "url": "https://investorplace.com/2021/08/4-chinese-stocks-to-buy-while-everyone-else-is-selling/"
    }
]
Company Details
GET
JSON
Get company details
Query
{
    "symbol": "IBM"
}
Response
[
    {
        "description": "Amazon.com, Inc. is an American multinational technology company which focuses on e-commerce, cloud computing, digital streaming, and artificial intelligence. It is one of the Big Five companies in the U.S. information technology industry, along with Google, Apple, Microsoft, and Facebook.",
        "industry": "Internet Retail",
        "industry_group": "Retail—Cyclical",
        "name": "Amazon.com, Inc. - Common Stock",
        "opol": null,
        "sector": "Consumer Cyclical"
    }
]
Company Fundamentals
GET
JSON
Get company fundamentals information.
Query
{
    "symbol": "IBM"
}
Response
{
    "fundamentals": [
        {
            "eps": 1.91241,
            "net_income": 303500000,
            "operating_cash_flow": 522300000,
            "reporting_date": "2016-02-27",
            "return_on_assets": 0.046763532,
            "revenue": 3417900000,
            "symbol": "IBM"
        }
    ],
    "metrics": {
        "beta": 1.950358,
        "last_dividend": 0.17,
        "market_cap": 2710590500,
        "shares_outstanding": 95679155.35826828,
        "symbol": "IBM",
        "vol_avg": 4132634,
        "year_high": 53.9,
        "year_low": 5.78
    }
}
Company Estimates
GET
JSON
Get company estimates and EPS ratings.
Query
{
    "symbol": "IBM"
}
Response
{
    "created_at": "2021-06-09 11:28:06",
    "eps_forecasts_estimates": [
        {
            "eps": 0,
            "forecast": 0.079,
            "quarter": "2021-03-31",
            "reporting_date": "2021-06-24"
        },
        {
            "eps": 0.077,
            "forecast": 0.31,
            "quarter": "2020-12-31",
            "reporting_date": "2021-04-14"
        },
        {
            "eps": -0.614,
            "forecast": 0.189,
            "quarter": "2020-09-30",
            "reporting_date": "2021-01-07"
        },
        {
            "eps": 1.75,
            "forecast": -0.304,
            "quarter": "2020-06-30",
            "reporting_date": "2020-10-01"
        },
        {
            "eps": -2.444,
            "forecast": -1.266,
            "quarter": "2020-03-31",
            "reporting_date": "2020-07-08"
        },
        {
            "eps": -0.53,
            "forecast": 0.203,
            "quarter": "2019-12-31",
            "reporting_date": "2020-04-15"
        },
        {
            "eps": -0.313,
            "forecast": 0.019,
            "quarter": "2019-09-30",
            "reporting_date": "2020-01-08"
        },
        {
            "eps": -1.125,
            "forecast": 0.268,
            "quarter": "2019-06-30",
            "reporting_date": "2019-10-02"
        },
        {
            "eps": -2.908,
            "forecast": 0.076,
            "quarter": "2019-03-31",
            "reporting_date": "2019-07-10"
        },
        {
            "eps": -1.923,
            "forecast": 1.11,
            "quarter": "2018-12-31",
            "reporting_date": "2019-04-10"
        }
    ],
    "estimates": {
        "average": 26.22,
        "high": 38,
        "low": 19
    },
    "recommendations": {
        "buy": 1,
        "hold": 8,
        "sell": 2
    },
    "score": 9,
    "symbol": "IBM"
}
Company Filings
GET
JSON
Get news articles sorted by recency. If you don't supply a company in the query, it'll give general market news sorted by recency.
Query
{
    "symbol": "IBM"
}
Response
{
    "data": [
        {
            "dt": "2006-01-25",
            "form": "8-K",
            "link": "https://www.sec.gov/Archives/edgar/data/0000886158/000110465906003860/a06-3583_18k.htm",
            "symbol": "IBM"
        },
        {
            "dt": "2006-02-28",
            "form": "UPLOAD",
            "link": "https://www.sec.gov/Archives/edgar/data/0000886158/000000000006010018/filename1.txt",
            "symbol": "IBM"
        },
        {
            "dt": "2006-03-03",
            "form": "4",
            "link": "https://www.sec.gov/Archives/edgar/data/0000886158/000101297506000121/xslF345X02/edgar.xml",
            "symbol": "IBM"
        }
    ]
}
Options Greeks
GET
JSON
Get the greeks of the supplied options contract
Query
{
    "symbol": "IBM",
    "strike": 211,
    "expiry": "2022-01-21",
    "direction": "call"
}
Response
[
    {
        "delta": 0.977,
        "gamma": 0.01,
        "rho": 0.008,
        "theta": -0.01,
        "ts": "2021-07-23 14:00",
        "vega": 0.003,
        "volatility": 0.949
    }
]
Options Theoretical Prices
GET
JSON
Get the estimate vs real comparison of an options contract
Query
{
    "symbol": "IBM"
}
Response
{
    "data": {
        "2021-08-06": {
            "call": [
                {
                    "symbol": "IBM",
                    "expiry": "2021-08-06",
                    "direction": "call",
                    "strike": 140,
                    "theoretical_price": 5.6,
                    "actual_vs_estimate": 0.0543
                }
            ]
        }
    }
}
Option Prices Stream
GET
JSON
Get the latest prices of a socket with a socket stream. Currently aggregated by 5 second increments but contact us if you want access to tick level stream.
Query
{
    "symbols": "IBM210903C137.0"
}
Response
[
    {
        "ask": 8.399999618530273,
        "bid": 8.25,
        "direction": "call",
        "expiry": "2021-08-06",
        "first": 8.35,
        "high": 8.35,
        "last": 8.35,
        "low": 8.35,
        "mid": 8.350000381469727,
        "minute": "2021-08-02 15:00",
        "strike": 137,
        "symbol": "IBM",
        "volume": 2
    }
]
Company Prices Stream
GET
JSON
Get the stock prices of a listed symbol
Query
{
    "symbols": "IBM"
}
Response
{
    "prices": [
        {
            "mid": 3337.824951171875,
            "minute": "2021-08-03 13:00",
            "symbol": "AMZN"
        },
        {
            "mid": 3336.25,
            "minute": "2021-08-03 13:05",
            "symbol": "AMZN"
        }
    ]
}