Authenticating

Every API call to the endpoints below requires a valid API key to be provided. This API key verifies your permission to use the service. API keys are free! Get your own by registering for an account.

How to provide your key

Your key will look like this: 333acb16de254844ab64783232d2ba66

Include your API key as a header to your request with the label 'key'

Versioning

Some of the endpoints below will have multiple versions available for consumption. To specify which version you would like to consume, use the Accept-Version header. For example, specifying you want version 2:

Accept-Version: 2

Example in Postman:

Stock Data

Access data for any publicly traded security, including stock, bonds, options, and more.

Stock Data (v1) Deprecated, please use new version

Access summary or statistical data for stocks, bonds, options, crypto, and more.

A newer version of this endpoint is available, see Stock Data v2. If you still wish to use version 1 (for backwards compatability), please specify you would like version 1 via the Accept-Version header; for more information, please see the versioning instructions.

GET
https://api.aletheiaapi.com/StockData

Parameters

Required
symbol - the symbol of the security you are requesting data for.
Optional
summary - Specifies if you would like to have stock summary data returned in the payload. Either 'true' or 'false'.
Optional
statistics - Specifies if you would like to have stock statistical data returned in the payload. Either 'true' or 'false'.

Example Requests

https://api.aletheiaapi.com/StockData?symbol=msft&summary=true
https://api.aletheiaapi.com/StockData?symbol=msft&summary=true&statistics=true
https://api.aletheiaapi.com/StockData?symbol=aapl&summary=false&statistics=true
+ Example Response
{
"Symbol": "PG",
"Summary": {
"Name": "The Procter & Gamble Company",
"StockSymbol": "PG",
"Price": 123.53,
"DollarChange": -3.05,
"PercentChange": -0.0241,
"PreviousClose": 126.58,
"Open": 126.54,
"BidPrice": 123.36,
"BidQuantity": 900,
"AskPrice": 123.55,
"AskQuantity": 1200,
"DayRangeLow": 121.82,
"DayRangeHigh": 126.93,
"YearRangeLow": 94.34,
"YearRangeHigh": 146.92,
"Volume": 17718787,
"AverageVolume": 7562403,
"MarketCap": 304189997056.0,
"Beta": 0.41,
"PriceEarningsRatio": 23.34,
"EarningsPerShare": 5.29,
"EarningsDate": "2021-04-20T00:00:00",
"ForwardDividend": 3.16,
"ForwardDividendYield": 0.0256,
"ExDividendDate": "2021-01-21T00:00:00",
"YearTargetEstimate": 150.56,
"QueriedSymbol": "PG",
"DataCollectedOn": "2021-02-28T23:33:18.8109488+00:00"
},
"Statistics": {
"FiscalYearEnds": "2020-06-29T00:00:00",
"MostRecentQuarter": "2020-12-30T00:00:00",
"ProfitMargin": 0.1872,
"OperatingMargin": 0.24129999,
"ReturnOnAssets": 0.0962,
"ReturnOnEquity": 0.2951,
"Revenue": 73969999872,
"RevenuePerShare": 29.83,
"QuarterlyRevenueGrowth": 0.083000004,
"GrossProfit": 36309999616,
"EBITDA": 20800000000,
"NetIncomeAvailableToCommon": 13580000256,
"DilutedEps": 5.29,
"QuarterlyEarningsGrowth": 0.037,
"TotalCash": 11939999744,
"TotalCashPerShare": 4.85,
"TotalDebt": 31100000256,
"TotalDebtEquityRatio": 64.07,
"CurrentRatio": 0.78,
"BookValuePerShare": 19.21,
"OperatingCashFlow": 19030001664,
"LeveredFreeCashFlow": 13899999232,
"Beta": 0.41,
"YearChange": 0.0332,
"SP500YearChange": 0.2392,
"YearHigh": 146.92,
"YearLow": 94.34,
"MovingAverage50Day": 130.11,
"MovingAverage200Day": 136.83,
"AverageVolume3Month": 7560000,
"AverageVolume10Day": 9300000,
"SharesOutstanding": 2460000000,
"Float": 2460000000,
"PercentHeldByInsiders": 0.0011,
"PercentHeldByInstitutions": 0.66110003,
"SharesShort": 14840000,
"ShortRatio": 1.95,
"ShortPercentOfFloat": 0.0061000003,
"ShortPercentOfSharesOutstanding": 0.006,
"ForwardAnnualDividend": 3.16,
"ForwardAnnualDividendYield": 0.0256,
"TrailingAnnualDividend": 3.12,
"TrailingAnnualDividendYield": 0.024600001,
"FiveYearAverageDividendYield": 2.9,
"DividendPayoutRatio": 0.5894,
"DividendDate": "2021-02-15T00:00:00",
"ExDividendDate": "2021-01-20T00:00:00",
"LastSplitFactor": "2:1",
"LastSplitDate": "2004-06-20T00:00:00",
"QueriedSymbol": "PG",
"DataCollectedOn": "2021-02-28T23:33:19.287638+00:00"
}
}

Stock Data (v2)

Access summary or statistical data for stocks, bonds, options, crypto, and more. To specify you would like to consume version 2 of this endpoint, set the Accept-Version header to 2. See the versioning instructions for more information.

The advantage of using the v2 specification is drastically reduced response times for requests that would be requesting both summary data and statistical data (as seen in version 1).

GET
https://api.aletheiaapi.com/StockData

Parameters

Required
symbol - the symbol of the security you are requesting data for.
Optional
fields - If you would only like specific fields to be returned to you (i.e. to save bandwidth, set this to the field names separated by comma. If left blank, all available data fields will be returned by default. For a complete list of available data fields, please see the example response below.

Example Requests

https://api.aletheiaapi.com/StockData?symbol=msft
https://api.aletheiaapi.com/StockData?symbol=msft&fields=Price,MarketCap,DayHigh,DayLow
https://api.aletheiaapi.com/StockData?symbol=pg&fields=Price
+ Example Response
{
"Symbol": "PG",
"FullTimeEmployees": 101000,
"Sector": "Consumer Defensive",
"Industry": "Household & Personal Products",
"Open": 150.19,
"AverageVolume90Day": 6912683,
"Exchange": "NYQ",
"DayHigh": 152.385,
"ShortName": "Procter & Gamble Company (The)",
"LongName": "The Procter & Gamble Company",
"Change": 2.26999,
"PreviousClose": 149.88,
"Price": 152.15,
"Currency": "USD",
"Volume": 11935078,
"MarketCap": 368195400000.0,
"ChangePercent": 0.0151454,
"DayLow": 150.27,
"BidPrice": 152.2,
"BidQuantity": 900,
"AskPrice": 152.2,
"AskQuantity": 900.0,
"AverageVolume10Day": 8056980,
"YearLow": 121.54,
"YearHigh": 152.385,
"Beta": 0.422337,
"PriceEarningsRatio": 27.80519,
"EarningsPerShare": 5.472,
"EarningsDate": "2022-01-18T00:00:00",
"ForwardDividend": 3.48,
"ForwardDividendYield": 0.0232,
"ExDividendDate": "2021-10-21T00:00:00",
"YearTargetEstimate": 152.93,
"LastFiscalYearEnd": "2021-06-30T00:00:00",
"LastFiscalQuarterEnd": "2021-09-30T00:00:00",
"ProfitMargin": 0.18332,
"OperatingMargin": 0.23948,
"ReturnOnAssets": 0.09639,
"ReturnOnEquity": 0.29837,
"Revenue": 77138000000.0,
"RevenuePerShare": 31.468,
"QuarterlyRevenueGrowth": 0.053,
"GrossProfit": 39144000000.0,
"EDBITDA": 21248000000.0,
"NetIncomeAvailableToCommon": 13866000000.0,
"QuarterlyEarningsGrowth": -0.039,
"Cash": 10370000000.0,
"CashPerShare": 4.285,
"Debt": 32547000000.0,
"DebtToEquityRatio": 70.132,
"CurrentRatio": 0.665,
"BookValuePerShare": 18.7,
"OperatingCashFlow": 18275000000.0,
"LeveredFreeCashFlow": 12529750000.0,
"YearChangePercent": 0.0856936,
"SP500YearChangePercent": 0.22585726,
"MovingAverage50Day": 144.0168,
"MovingAverage200Day": 138.4587,
"SharesOutstanding": 2419950000.0,
"Float": 2417237500.0,
"PercentHeldByInsiders": 0.0010800001,
"PercentHeldByInstitutions": 0.65568,
"SharesShort": 15019257.0,
"ShortRatio": 2.28,
"ShortPercentOfFloat": 0.0062,
"ShortPercentOfSharesOutstanding": 0.0062,
"ForwardAnnualDividend": 3.48,
"ForwardAnnualDividendYield": 0.0232,
"TrailingAnnualDividend": 3.321,
"TrailingAnnualDividendYield": 0.022157727,
"FiveYearAverageDividendYield": 2.78,
"DividendPayoutRatio": 0.606,
"DividendDate": "2021-11-15T00:00:00",
"LastSplitFactor": "2:1",
"LastSplitDate": "2004-06-21T00:00:00"
}

Crypto

Use these endpoints to access real-time data about cryptocurrencies.

Crypto Quote

Access pricing and trading activity data for virtually any cryptocurrency. All quotes are in U.S. Dollars.

GET
https://api.aletheiaapi.com/Crypto

Parameters

Required
symbol - the trading symbol of the cryptocurrency. For example, "BTC" for Bitcoin.

Example Requests

https://api.aletheiaapi.com/Crypto?symbol=BTC
https://api.aletheiaapi.com/Crypto?symbol=DOGE
https://api.aletheiaapi.com/Crypto?symbol=XRP
+ Example Response
{
"Symbol": "BTC",
"Name": "Bitcoin",
"Price": 39799.31,
"DollarChange": 1357.82,
"PercentChange": 0.0353,
"DayLow": 39350.46,
"DayHigh": 39831.87,
"YearLow": 9916.49,
"YearHigh": 64863.1,
"MarketCap": 747286036480.0,
"Volume": 25329145856,
"DataCollected": "2021-08-05T01:20:47.2696749+00:00"
}

Insider Trading

Read and monitor insider transactions for any publicly traded company.

Insider Trading (Webhook)

You can subscribe your application or web service to be notified of new insider trading the moment it is reported to the SEC. You can even specify the companies, individuals, security types, or transactions you only wish to be notified of.

Step 1 - Subscribe Your Endpoint

First you must subscribe your endpoint to the insider trading webhook service. You can subscribe your endpoint by making a POST call to the URL specified below.

POST
https://api.aletheiaapi.com/SubscribeToInsiderTradingWebhook
The following is an example of the body of the POST call you will make:
{
"endpoint":"https://www.myservice.net/myendpoint",
"issuer": "MSFT",
"owner": 1513142,
"transactionType": 1,
"securityType": 0
}
  • The endpoint property is mandatory! This is where you will specify the endpoint of your API service that Aletheia will call.
  • The issuer property specifies the company you only want to receive insider trading notifications for. Microsoft is the specified company (CIK 789019) in this example. You can either provide the trading symbol of the company ("MSFT" in this example) or the CIK of the company. Provide the CIK for faster performance. This property is optional.
  • The owner property is the CIK of the person you only want to receive insider trading notifications on. In this example we have it set to 1513142 which is the CIK of Satya Nadella, the CEO of Microsoft This property is optional.
  • The transactionType property specifies the the transaction type you only want to be notified of. Please see the transaction type property from the Latest Transactions endpoint to see the list of transaction type ID's. This property is optional.
  • The securityType property specifies the security type that you only want to be notified on. This means that you will only be notified of transactions involving either non-derivative (equity) securities or derivative securities. 0 = non-derivative, 1 = derivative. This property is optional.

For any optional property that you do not specify in the POST body, the assumption will be made that you would like to subscribe your endpoint to all of the available selections. For example, if I did not specify the issuer property when subscribing my endpoint, this will in turn mean that my endpoint will be called for transactions involving any company.

The subscription endpoint will return a 201 created response. This response will include a "Location" header. The value of this header will be used to unsubscribe from this webhook, so save this for later.

Step 2 - Receive New Filings!

After subscribing your endpoint to the webhook with step 1, your endpoint will begin to receive HTTP POST requests when new qualifying insider trades become available.

The following is an example of the POST request that will be sent to your registered endpoint:

POST
(your registered endpoint)
{
"SecEntities":[
{
"Cik":789019,
"Name":"MICROSOFT CORP",
"TradingSymbol":"MSFT"
},
{
"Cik":1186249,
"Name":"WARRIOR PADMASREE",
"TradingSymbol":null
}
],
"SecFilings":[
{
"Id":"50b95bec-fd2e-4bb2-a95c-8b4bff95f736",
"FilingUrl":"https://www.sec.gov/Archives/edgar/data/789019/000106299321005588/0001062993-21-005588-index.htm",
"AccessionP1":1062993,
"AccessionP2":21,
"AccessionP3":5588,
"FilingType":0,
"ReportedOn":"2021-06-10T00:00:00",
"Issuer":789019,
"_Issuer":null,
"Owner":1186249,
"_Owner":null
}
],
"HeldOfficerPositions":[],
"SecurityTransactionHoldings":[
{
"Id":"a5d49aae-a72f-49b3-afdd-7672ee7f8481",
"FromFiling":"50b95bec-fd2e-4bb2-a95c-8b4bff95f736",
"_FromFiling":null,
"EntryType":1,
"QuantityOwnedFollowingTransaction":11880.0,
"DirectIndirect":0,
"SecurityTitle":"Common Stock",
"SecurityType":0,
"AcquiredDisposed":null,
"Quantity":null,
"PricePerSecurity":null,
"TransactionDate":null,
"TransactionCode":null,
"ConversionOrExercisePrice":null,
"ExercisableDate":null,
"ExpirationDate":null,
"UnderlyingSecurityTitle":null,
"UnderlyingSecurityQuantity":null
},
{
"Id":"ab2c09c9-e0b1-41f4-88f6-43992c966029",
"FromFiling":"50b95bec-fd2e-4bb2-a95c-8b4bff95f736",
"_FromFiling":null,
"EntryType":0,
"QuantityOwnedFollowingTransaction":3715.0,
"DirectIndirect":0,
"SecurityTitle":"Restricted Stock Units",
"SecurityType":1,
"AcquiredDisposed":0,
"Quantity":8.0,
"PricePerSecurity":0.0,
"TransactionDate":"2021-06-10T00:00:00",
"TransactionCode":null,
"ConversionOrExercisePrice":null,
"ExercisableDate":null,
"ExpirationDate":null,
"UnderlyingSecurityTitle":"Common Stock",
"UnderlyingSecurityQuantity":8.0
}
]
}

You can find thorough explanations for each component of each component above in other endpoint documentation.

Step 3 - Unsubscribe from the webhook when finished

When you wish to stop receiving posts from this webhook, be sure to formally unsubscribe your endpoint.

When you originally registered your endpoint in step 1, the returned 201 created response contained a "Location" header. The value of this header contains the endpoint that will unsubscribe your endpoint via a DELETE call. The unsubscribe endpoint will look something like this:

https://api.aletheiaapi.com/UnsubscribeWebhook?id=dd150c44-c42a-4cdd-92f5-b78a23b36c72

To unsubscribe your endpoint from this webhook, call this provided value via a DELETE call.

If you no longer have the provided unsubscribe URL (ID of your webhook to unsubscribe with) from the original subscription step, you can also unsubscribe by providing your registered endpoint URL. For example, see below:

DELETE
https://api.aletheiaapi.com/UnsubscribeWebhook?endpoint=https://www.myservice.net/myendpoint

Search Entities

Search the Aletheia database for an entity. An entity represents either a company (serving as an security issuer) or a person (serving as a security owner).

GET
https://api.aletheiaapi.com/SearchEntities

Parameters

Required
term - The search term
Optional
top - Limit the number of results returned. Fewer results will return faster.

Example Requests

https://api.aletheiaapi.com/SearchEntities?term=intc
https://api.aletheiaapi.com/SearchEntities?term=amazon
https://api.aletheiaapi.com/SearchEntities?term=cook&top=3
+ Example Response
[
{
"Cik":1168017, - The SEC assigned Central Index Key (CIK) of this person
"Name":"COOK J MICHAEL"
},
{
"Cik":1227246,
"Name":"COOK IAN M"
},
{
"Cik":1270438,
"Name":"COOK LINDA Z"
}
]

Get Entity

Get details of a company or insider from their Central Index Key (CIK), a unique ID assigned by the Securities Exchange Commission.

GET
https://api.aletheiaapi.com/GetEntity

Parameters

Required
id - Either the CIK or the trading symbol of the entity you are requesting. Provide the CIK for faster performance.

Example Requests

https://api.aletheiaapi.com/GetEntity?id=66740
https://api.aletheiaapi.com/GetEntity?id=mmm
https://api.aletheiaapi.com/GetEntity?id=msft
+ Example Response
{
"Cik":66740, - The SEC-assigned Central Index Key (CIK) of this company/person
"Name":"3M CO", - Company/person name
"TradingSymbol":"MMM" - If the entity is a company, the trading symbol. If a person, this will be null.
}

Get Filing

Get details of a particular SEC filing that has already been processed by our servers.

! Please note that this endpoint will not access any filing with the SEC, but rather only queries filings that have already been scanned and processed and thus exist in our database.

GET
https://api.aletheiaapi.com/GetFiling

Parameters

Optional
id - The Aletheia-assigned unique ID of the filing. Note that this ID does not correspond to an SEC filing, but is rather an ID that we assigned to the filing in our database.
Optional
url - If you instead want to find details of the filing via the filing URL, specify the full filing URL.

! While the above parameters are optional, you must specify at least one.

Example Requests

https://api.aletheiaapi.com/GetFiling?id=70ebab7c-af6e-47e2-963a-0000b688ca7e
https://api.aletheiaapi.com/GetFiling?id=123c236790fe4328b85800013a5f7491
https://api.aletheiaapi.com/GetFiling?url=https://www.sec.gov/Archives/edgar/data/885725/000122520815006628/0001225208-15-006628-index.htm
+ Example Response
{
"Id":"70ebab7c-af6e-47e2-963a-0000b688ca7e", - The unique ID of this filing in the Aletheia database
"FilingUrl":"https://www.sec.gov/Archives/edgar/data/885725/000122520815006628/0001225208-15-006628-index.htm", - URL to the filing with the SEC
"AccessionP1":1225208, - Part 1 of the accession number (SEC's ID for this filing)
"AccessionP2":15, - Part 2 of the accession number (SEC's ID for this filing)
"AccessionP3":6628, - Part 3 of the accession number (SEC's ID for this filing)
"FilingType":0, - 0 = Form 4, 1 = Form 3, 2 = Form 5, 3 = 10-K, 4 = 10-Q
"ReportedOn":"2015-02-27T00:00:00", - the date this filing was reported on
"Issuer":885725, - The CIK (SEC-assigned ID) of the issuing company
"Owner":1533022, - This field will only populate if applicable (it is a form 3, 4, or 5 and thus has an associated insider making the trade)
}

Latest Transactions

Download the latest insider transactions for a person or company.

GET
https://api.aletheiaapi.com/LatestTransactions

Parameters

Optional
issuer - Either the CIK or trading symbol of the securities issuer (company).
Optional
owner - The CIK of the owner (insider trader).

! The parameters 'issuer' and 'owner' are both optional, but you must provide at least one.

Optional
top - How many records you would like returned. Default is 20.
Optional
before - Filter to transactions only before a particular date.
  • Date supplied in format YYYYMMDD. For example, "20191231".
Optional
securitytype - Filter security type. 0 = non-derivative (equity), 1 = derivative.
Optional
transactiontype - Filter to a particular transaction type.
  • 0 = purchase
  • 1 = sale
  • 2 = transaction voluntarily reported earlier than required
  • 3 = grant or award
  • 4 = sale back to issuer
  • 5 = payment of exercise price or tax liability
  • 6 = discretionary transaction
  • 7 = exercise or conversion of derivative security
  • 8 = conversion of derivative security
  • 9 = expiration of short derivative position
  • 10 = expiration of long derivative position
  • 11 = exercise of out-of-the-money derivative
  • 12 = exercise of in-the-money derivative
  • 13 = bona fide gift
  • 14 = small acquisition
  • 15 = acquisition or disposition by will or laws
  • 16 = deposit into or withdrawal from voting trust
  • 17 = other acquisition or disposition
  • 18 = equity swap
  • 19 = disposition due to tender of shares
Optional
cascade - If you would also like data about the SEC filing the transaction came from and both of issuer and owner, specify this label in the URl. Only specify '&cascade' in the URL, no need to provide a value.

! Due to the larger quantity quantity of data being accessed, cascade querying may be noticeably slower.

Example Requests

https://api.aletheiaapi.com/LatestTransactions?issuer=1800&top=5
https://api.aletheiaapi.com/LatestTransactions?issuer=1800&owner=1783147&before=20181231&securitytype=0&transactiontype=3
https://api.aletheiaapi.com/LatestTransactions?owner=1783147&securitytype=1&transactiontype=0
+ Example Response
[
{
"Id":"e3fd7062-5190-43a5-9aa0-26ce8ce2ddea", - The unique ID of this transaction in the Aletheia database
"FromFiling":"c42b0232-45d3-48e6-8f27-b97621947d3b", - The unique ID of the SEC filing in the Aletheia database which this transaction stemmed from
"EntryType":0, - 0 = Transaction, 1 = Holding (no changes, just reporting a held asset)
"QuantityOwnedFollowingTransaction":0.0, - The quantity of securities the owner owns following this transaction
"DirectIndirect":1, - 0 = Direct ownership, 1 = Indirect ownership
"SecurityTitle":"Common Stock",
"SecurityType":0, - 0 = non-derivative (equity based), 1 = derivative (i.e. options contract)
"AcquiredDisposed":1, - 0 = acquired, 1 = disposed
"Quantity":50.0, - The quantity of securities acquired/disposed of
"PricePerSecurity":null, - if applicable, the average acquisition or disposition price of the security
"TransactionDate":"2021-02-17T00:00:00", - recorded transaction date
"TransactionCode":1, - (see the "transactiontype" parameter above)
"ConversionOrExercisePrice":null, - if a derivative security, the exercise price of this contract
"ExercisableDate":null, - if a derivative security, the exercisable date of this contract
"ExpirationDate":null, - if a derivative security, the expiration date of this contract
"UnderlyingSecurityTitle":null, - if a derivative security, the title of the contract's underlying security
"UnderlyingSecurityQuantity":null - if a derivative security, the quantity of the contract's underlying security
},
{
"Id":"bf6b3afc-2591-48e6-8dda-0b62903fd38d",
"FromFiling":"01bf4617-5f19-4319-b378-c16a9d12190a",
"EntryType":0,
"QuantityOwnedFollowingTransaction":1508.4543,
"DirectIndirect":0,
"SecurityTitle":"Common Stock",
"SecurityType":0,
"AcquiredDisposed":0,
"Quantity":289.0,
"PricePerSecurity":null,
"TransactionDate":"2021-02-05T00:00:00",
"TransactionCode":7,
"ConversionOrExercisePrice":null,
"ExercisableDate":null,
"ExpirationDate":null,
"UnderlyingSecurityTitle":null,
"UnderlyingSecurityQuantity":null
},
{
"Id":"d24bc278-dbc6-4d7f-a144-69bdcd81ad38",
"FromFiling":"d5ba901e-5002-413c-9358-b3445b66ccae",
"EntryType":0,
"QuantityOwnedFollowingTransaction":252.47,
"DirectIndirect":0,
"SecurityTitle":"Common Stock",
"SecurityType":0,
"AcquiredDisposed":0,
"Quantity":252.47,
"PricePerSecurity":null,
"TransactionDate":"2021-02-05T00:00:00",
"TransactionCode":3,
"ConversionOrExercisePrice":null,
"ExercisableDate":null,
"ExpirationDate":null,
"UnderlyingSecurityTitle":null,
"UnderlyingSecurityQuantity":null
},
]

Affiliated Owners

List the insiders who at some point in the time held or made transactions with a particular company.

GET
https://api.aletheiaapi.com/AffiliatedOwners

Parameters

Required
id - Either the CIK or the trading symbol of the company you are requesting. Provide the CIK for faster performance.

Example Requests

https://api.aletheiaapi.com/AffiliatedOwners?id=789019
https://api.aletheiaapi.com/AffiliatedOwners?id=msft
https://api.aletheiaapi.com/AffiliatedOwners?id=aapl
+ Example Response
[
{
"Cik":1007844, - The SEC-assigned Central Index Key (unique ID) of this person
"Name":"JOBS STEVEN P" - The person's name
},
{
"Cik":1051401,
"Name":"JUNG ANDREA"
},
{
"Cik":1059235,
"Name":"WAGNER SUSAN"
},
{
"Cik":1179864,
"Name":"LOZANO MONICA C"
},
{
"Cik":1182047,
"Name":"BELL JAMES A"
},
{
"Cik":1188888,
"Name":"CAMPBELL WILLIAM V"
},
{
"Cik":1196612,
"Name":"AHRENDTS ANGELA J"
},
{
"Cik":1198726,
"Name":"YORK JEROME B"
}
]

Fundamentals

These endpoints provide with you financial performance data for any publicly traded company. These endpoints span all three primary financial statements, including Income Statement, Balance Sheet, and State of Cash Flows.

Common Financials

Access a financial statement set for a particular company. The returned response will be a financial fact set that is presented in a commonly comparable form.

GET
https://api.aletheiaapi.com/CommonFinancials

Parameters

Required
id - The CIK or trading symbol of the company you are searching for.
Optional
period - Specify a period type.
  • 0 = Annual (from a 10-K filing)
  • 1 = Quarterly (from a 10-Q filing)
Optional
before - Get the most recent filing before this specified date. YYYYMMDD format.
  • If this parameter is not specified, the API will simply select the most recent financial filing that meets your criteria.

Example Requests

https://api.aletheiaapi.com/CommonFinancials?id=aapl
https://api.aletheiaapi.com/CommonFinancials?id=320193&period=1
https://api.aletheiaapi.com/CommonFinancials?id=320193&period=0&before=20150101
Example Response
+ Example Response
{
"PeriodStart": "2013-09-29T00:00:00",
"PeriodEnd": "2014-09-27T00:00:00",
"Facts": {
"RetainedEarnings": 87152000000.0,
"OperatingIncome": 52503000000.0,
"Revenue": 182795000000.0,
"SellingGeneralAndAdministrativeExpense": 11993000000.0,
"ResearchAndDevelopmentExpense": 6041000000.0,
"Assets": 231839000000.0,
"NetIncome": 39510000000.0,
"ProceedsFromIssuanceOfDebt": 11960001000.0,
"OperatingCashFlows": 59713000000.0,
"CurrentLiabilities": 63448000000.0,
"Equity": 111547000000.0,
"DividendsPaid": 11031000000.0,
"Liabilities": 120292000000.0,
"CommonStockSharesOutstanding": 5866161000.0,
"CurrentAssets": 68531000000.0,
"InvestingCashFlows": -22579000000.0,
"FinancingCashFlows": -37549000000.0,
"Cash": 13844000000.0
}
}

Financial Fact Trend

Examine the trend in a financial result data point for any major commonly-reported figure on an income statement, balance sheet, or statement of cash flows.

GET
https://api.aletheiaapi.com/FinancialFactTrend

Parameters

Required
id - The CIK or trading symbol of the company you are searching for.
Required
label - The label name of the data point you are requesting. Available data points:
  • Income Statement Facts
    • 0 = Revenue
    • 1 = Selling, General, and Administrative Expenses (SG&A)
    • 2 = Research and Development Expenses
    • 3 = Operating Income
    • 4 = Net Income/Loss
  • Balance Sheet Facts
    • 5 = Assets
    • 6 = Liabilities
    • 7 = Equity
    • 8 = Cash
    • 9 = Current Assets
    • 10 = Current Liabilities
    • 11 = Retained Earnings/Deficit
    • 12 = Number of common stock shares outstanding
  • Cash Flow Statement Facts
    • 13 = Operating Cash Flows
    • 14 = Investing Cash Flows
    • 15 = Financing Cash Flows
    • 16 = Proceeds from Issuance of Debt
    • 17 = Payments of Debt
    • 18 = Dividends Paid
Optional
period - Specify a period type.
  • 0 = Annual (from a 10-K filing)
  • 1 = Quarterly (from a 10-Q filing)
Optional
after - Only return data points after a specific date. YYYYMMDD format.
Optional
before - Only return data points before a specific date. YYYYMMDD format.

Example Requests

https://api.aletheiaapi.com/FinancialFactTrend?id=msft&label=0&period=0
https://api.aletheiaapi.com/FinancialFactTrend?id=msft&label=8&after=20140101
https://api.aletheiaapi.com/FinancialFactTrend?id=1800&label=4&before=20150101
Example Response
+ Example Response
[
{
"PeriodStart": "2012-07-01T00:00:00", - The start date for the period this fact occured in
"PeriodEnd": "2013-06-30T00:00:00", - The end date for the period this fact occured in
"Value": 77849000000.0 - the fact value
},
{
"PeriodStart": "2015-07-01T00:00:00",
"PeriodEnd": "2016-06-30T00:00:00",
"Value": 85320000000.0
},
{
"PeriodStart": "2009-07-01T00:00:00",
"PeriodEnd": "2010-06-30T00:00:00",
"Value": 62484000000.0
},
{
"PeriodStart": "2011-07-01T00:00:00",
"PeriodEnd": "2012-06-30T00:00:00",
"Value": 73723000000.0
},
{
"PeriodStart": "2019-07-01T00:00:00",
"PeriodEnd": "2020-06-30T00:00:00",
"Value": 143015000000.0
},
{
"PeriodStart": "2013-07-01T00:00:00",
"PeriodEnd": "2014-06-30T00:00:00",
"Value": 86833000000.0
},
{
"PeriodStart": "2016-07-01T00:00:00",
"PeriodEnd": "2017-06-30T00:00:00",
"Value": 89950000000.0
},
{
"PeriodStart": "2017-07-01T00:00:00",
"PeriodEnd": "2018-06-30T00:00:00",
"Value": 110360000000.0
},
{
"PeriodStart": "2014-07-01T00:00:00",
"PeriodEnd": "2015-06-30T00:00:00",
"Value": 93580000000.0
},
{
"PeriodStart": "2018-07-01T00:00:00",
"PeriodEnd": "2019-06-30T00:00:00",
"Value": 125843000000.0
},
{
"PeriodStart": "2010-07-01T00:00:00",
"PeriodEnd": "2011-06-30T00:00:00",
"Value": 69943000000.0
}
]

Earnings Calls

Aletheia continuously processes new earnings calls for many publicly traded companies on a daily basis. You can use these endpoints for accessing earnings call content and highlights from the call.

Search Earnings Calls

Search our database for available earnings call transcripts and highlights.

GET
https://api.aletheiaapi.com/SearchEarningsCalls

Parameters

Optional
company - The trading symbol of the of the company.
Optional
year - The fiscal year of the earnings call you are requesting.
Optional
quarter - What fiscal quarter you are requesting an earnings call for. Provide either 'q1', 'q2', 'q3', or 'q4'.
Optional
top - The maximum number of records to return. Max is 50, default is 15.
Optional
countremarks - either 'true' or 'false'. Specify 'true' to have the total number of remarks available for each call returned in the search results as property 'RemarksCount'.

Example Requests

https://api.aletheiaapi.com/SearchEarningsCalls?company=fb&year=2020
https://api.aletheiaapi.com/SearchEarningsCalls?year=2020&quarter=q3&top=8
https://api.aletheiaapi.com/SearchEarningsCalls?company=msft&year=2021&countremarks=true
Example Response
+ Example Response
[
{
"Id": "31a7e56c-d6bb-4224-81f6-a0c3400d690b", - the unique ID of this earnings call
"Company": {
"Id": "5372f27b-929c-45f6-8ae5-7404a59d307f", - the unique ID of the company
"Name": "Microsoft",
"TradingSymbol": "MSFT"
},
"Period": 2, - Fiscal quarter. 0 = Q1, 1 = Q2, 2 = Q3, 3 = Q4
"Year": 2021, - the fiscal year
"HeldAt": "2021-04-27T00:00:00" - date the call was held on
"RemarksCount": 144 - the number of spoken remarks in this earnings call transcript
},
{
"Id": "2cb52ca5-b8a2-4219-8cb3-7de95f40c75f",
"Company": {
"Id": "5372f27b-929c-45f6-8ae5-7404a59d307f",
"Name": "Microsoft",
"TradingSymbol": "MSFT"
},
"Period": 1,
"Year": 2021,
"HeldAt": "2021-01-26T00:00:00"
"RemarksCount": 123
},
{
"Id": "3da4547a-afbe-47c0-95c8-856b71692ca2",
"Company": {
"Id": "5372f27b-929c-45f6-8ae5-7404a59d307f",
"Name": "Microsoft",
"TradingSymbol": "MSFT"
},
"Period": 0,
"Year": 2021,
"HeldAt": "2020-10-27T00:00:00"
"RemarksCount": 133
},
{
"Id": "e2ee094f-e34f-48e8-ae02-332057ca6798",
"Company": {
"Id": "5372f27b-929c-45f6-8ae5-7404a59d307f",
"Name": "Microsoft",
"TradingSymbol": "MSFT"
},
"Period": 3,
"Year": 2020,
"HeldAt": "2020-07-22T00:00:00"
"RemarksCount": 171
},
{
"Id": "d3dbcc49-b774-4055-840b-51e7853d7a84",
"Company": {
"Id": "5372f27b-929c-45f6-8ae5-7404a59d307f",
"Name": "Microsoft",
"TradingSymbol": "MSFT"
},
"Period": 2,
"Year": 2020,
"HeldAt": "2020-04-29T00:00:00"
"RemarksCount": 104
},
{
"Id": "c1d2bba5-d502-44d5-b16d-a9bfb77cfafd",
"Company": {
"Id": "5372f27b-929c-45f6-8ae5-7404a59d307f",
"Name": "Microsoft",
"TradingSymbol": "MSFT"
},
"Period": 1,
"Year": 2020,
"HeldAt": "2020-01-29T00:00:00"
"RemarksCount": 119
},
{
"Id": "c3a97166-8881-4b4c-bf5d-21b0e24e2f56",
"Company": {
"Id": "5372f27b-929c-45f6-8ae5-7404a59d307f",
"Name": "Microsoft",
"TradingSymbol": "MSFT"
},
"Period": 0,
"Year": 2020,
"HeldAt": "2019-10-23T00:00:00"
"RemarksCount": 111
},
{
"Id": "9950dcc5-a3f8-4787-b4a2-fccf1afdd69b",
"Company": {
"Id": "5372f27b-929c-45f6-8ae5-7404a59d307f",
"Name": "Microsoft",
"TradingSymbol": "MSFT"
},
"Period": 3,
"Year": 2019,
"HeldAt": "2019-07-18T00:00:00"
"RemarksCount": 163
}
]

Earnings Call

Access contextual information and spoken content for a publicly traded company's earnings call.

GET
https://api.aletheiaapi.com/EarningsCall

Parameters

Optional
id - The ID of the earnings call transcript you are requesting (which you would find via the Search Earnings Call service).
Optional
company - The trading symbol of the of the company.

! While the company parameter is marked as optional above, it must be specified if the id parameter is NOT specified.

Optional
year - The fiscal year of the earnings call you are requesting. If the year and quarter parameter are not specified, the most recent earnings call will be selected by default.
Optional
quarter - What fiscal quarter you are requesting an earnings call for. Provide either 'q1', 'q2', 'q3', or 'q4'. If the year and quarter parameter are not specified, the most recent earnings call will be selected by default.
Optional
begin - The earnings call is arranged into a series of remarks in order of sequence spoken. With the begin and end parameter, you can select a series of remarks from the call to be returned.
Optional
end - The sequence number for the final spoken remark which you are requesting. Please note that the maximum number of remarks that can be requested in one call is 20.
Optional
include - A list of features you'd like to include in the returned response, separated by comma. See the available features below:
  • kpi - Retrun a list of detected, parsed, and documented key performance indicactors in each spoken remark.
Optional
countremarks - either 'true' or 'false'. Specify 'true' to have the total number of remarks available for this specific call returned in the response as property 'RemarksCount'.

Example Requests

https://api.aletheiaapi.com/EarningsCall?company=DLTR&year=2019&quarter=q4&begin=0&end=10
https://api.aletheiaapi.com/EarningsCall?company=DLTR&year=2019&quarter=q4&begin=11&end=20&include=kpi
https://api.aletheiaapi.com/EarningsCall?company=msft&year=2019&quarter=q3&countremarks=true&begin=0&end=5
Example Response
+ Example Response
{
"Id": "fc747d75-8ca7-45f1-882f-56f57989b15c",
"Year": 2022,
"Period": 2,
"HeldAt": "2022-04-26T00:00:00",
"Company": {
"Id": "5372f27b-929c-45f6-8ae5-7404a59d307f",
"Name": "Microsoft",
"TradingSymbol": "MSFT"
},
"Remarks": [
{
"SequenceNumber": 31,
"Remark": "This innovation and differentiation is driving our overall growth. All of the number of customers who trust our security solutions grew nearly 50% year over year to 785,000, including Citrix, Domino's Pizza, Fujitsu, Heineken, Petronas, who rely on us to protect their multi-cloud infrastructure. And we have over 15,000 partners in our security ecosystem, more than anyone else in the industry. Now on to gaming.",
"SpokenBy": {
"Id": "b5aab7ce-7503-4e01-8b52-3feaa72f6d94",
"Name": "Satya Nadella",
"Title": "Chairman and Chief Executive Officer",
"IsExternal": false
},
"KeyPerformanceIndicators": []
},
{
"SequenceNumber": 32,
"Remark": "Our ambition is to power gamers to play when and how and where they want. With our Xbox Series S and X consoles, we have taken share globally for two quarters in a row, and we are the market leader this quarter among the next-gen consoles in the United States, Canada, U.K., and Western Europe. And with Xbox Cloud Gaming, we are redefining how games are distributed, played and viewed. To date, more than 10 million people have streamed games.",
"SpokenBy": {
"Id": "b5aab7ce-7503-4e01-8b52-3feaa72f6d94",
"Name": "Satya Nadella",
"Title": "Chairman and Chief Executive Officer",
"IsExternal": false
},
"KeyPerformanceIndicators": []
},
{
"SequenceNumber": 33,
"Remark": "Many of our most popular titles, including Flight Simulator, are now accessible on phones, tablets, low-spec PCs for the first time. Our Game Pass library now includes hundreds of titles across PC and console, including more games from third-party publishers than ever before. Billions of hours have been played by subscribers over the past 12 months, up 45%. And with Azure, we are building the best cloud for game studios of all sizes to build, host, and grow their games, new capabilities, speed, time to development and to help connect players across platforms.",
"SpokenBy": {
"Id": "b5aab7ce-7503-4e01-8b52-3feaa72f6d94",
"Name": "Satya Nadella",
"Title": "Chairman and Chief Executive Officer",
"IsExternal": false
},
"KeyPerformanceIndicators": []
},
{
"SequenceNumber": 34,
"Remark": "Azure gaming revenue fiscal year-to-date increased 66%. In closing, we are entering a new era where every company will become a digital company. Our portfolio of durable digital businesses and diverse business models built on a common tech stack position us well to capture the massive opportunities ahead. With that, I'll hand it over to Amy.",
"SpokenBy": {
"Id": "b5aab7ce-7503-4e01-8b52-3feaa72f6d94",
"Name": "Satya Nadella",
"Title": "Chairman and Chief Executive Officer",
"IsExternal": false
},
"KeyPerformanceIndicators": []
},
{
"SequenceNumber": 35,
"Remark": "Thank you, Satya, and good afternoon, everyone. This quarter, revenue was $49.4 billion, up 18% and 21% in constant currency. Earnings per share was $2.22 and increased 14% and 18% in constant currency when adjusted for the tax benefit from the third quarter of fiscal year '21. Several items impacted our financial performance that were not included in the guidance provided on our January earnings call.",
"SpokenBy": {
"Id": "36d420f6-7924-4451-9735-4c2f7400afce",
"Name": "Amy Hood",
"Title": "Chief Financial Officer",
"IsExternal": false
},
"KeyPerformanceIndicators": [
{
"subject": "revenue",
"status": "0",
"value": 49400000000.0,
"valueIsPercent": false,
"subjectOffset": 62,
"subjectLength": 7,
"statusOffset": 70,
"statusLength": 3,
"valueOffset": 74,
"valueLength": 13
},
{
"subject": "earnings per share",
"status": "0",
"value": 2.22,
"valueIsPercent": false,
"subjectOffset": 126,
"subjectLength": 18,
"statusOffset": 145,
"statusLength": 3,
"valueOffset": 149,
"valueLength": 5
}
]
},
{
"SequenceNumber": 36,
"Remark": "First, Nuance. My comments today across Q3 results and Q4 outlook include the impact from the Nuance acquisition, which closed on March 4th. Our results include $111 million in revenue and a negative $0.01 impact to earnings per share, including purchase accounting, integration, and transaction-related expenses. Within our results, unless specifically noted otherwise, Nuance was not a material driver of growth rates.",
"SpokenBy": {
"Id": "36d420f6-7924-4451-9735-4c2f7400afce",
"Name": "Amy Hood",
"Title": "Chief Financial Officer",
"IsExternal": false
},
"KeyPerformanceIndicators": []
},
{
"SequenceNumber": 37,
"Remark": "We continue to expect the Nuance acquisition will be minimally dilutive in FY '22 and accretive in FY '23 to non-GAAP EPS. Second, FX. The U.S. dollar strengthened throughout the quarter and created an incremental one-point FX headwind to total company revenue compared to expectations.",
"SpokenBy": {
"Id": "36d420f6-7924-4451-9735-4c2f7400afce",
"Name": "Amy Hood",
"Title": "Chief Financial Officer",
"IsExternal": false
},
"KeyPerformanceIndicators": []
},
{
"SequenceNumber": 38,
"Remark": "As a result, revenue and EPS were negatively impacted by $302 million and $0.03 per share, respectively. Finally, the war in Ukraine. We suspended all new sales of our products and services in Russia. Revenue generated in Russia represents less than 1% of total company revenue, and we expect that it will decline significantly.",
"SpokenBy": {
"Id": "36d420f6-7924-4451-9735-4c2f7400afce",
"Name": "Amy Hood",
"Title": "Chief Financial Officer",
"IsExternal": false
},
"KeyPerformanceIndicators": []
},
{
"SequenceNumber": 39,
"Remark": "The impact to operating income this quarter was roughly $130 million split evenly between lower revenue and higher bad debt expense, resulting in a negative $0.01 impact to EPS. Our results for the quarter are better than we expected across revenue, operating income, and EPS as we again delivered another strong quarter of top and bottom-line growth. In our commercial business, healthy demand for our differentiated hybrid and cloud offerings, together with excellent execution by our sales teams and partners, drove increased commitment to our platform as well as higher usage of our services that Satya mentioned earlier. Commercial bookings increased 28% and 35% in constant currency, significantly ahead of expectations, driven by strong execution across our core annuity sales motions.",
"SpokenBy": {
"Id": "36d420f6-7924-4451-9735-4c2f7400afce",
"Name": "Amy Hood",
"Title": "Chief Financial Officer",
"IsExternal": false
},
"KeyPerformanceIndicators": []
},
{
"SequenceNumber": 40,
"Remark": "We also saw better-than-expected growth in large long-term Azure contracts against a very strong prior-year comparable. Nuance benefited bookings by roughly five points. Our on-premises transactional licensing revenue across both the Office and Server businesses was more negatively impacted than expected due to the transition from our open licensing program to our cloud solution provider program. Commercial remaining performance obligation increased 32% and 34% constant currency to $155 billion, with a roughly equivalent split which we that we'll recognize within and the portion beyond the next 12 months.",
"SpokenBy": {
"Id": "36d420f6-7924-4451-9735-4c2f7400afce",
"Name": "Amy Hood",
"Title": "Chief Financial Officer",
"IsExternal": false
},
"KeyPerformanceIndicators": [
{
"subject": "commercial remaining performance obligation",
"status": "1",
"value": 0.32,
"valueIsPercent": true,
"subjectOffset": 400,
"subjectLength": 43,
"statusOffset": 444,
"statusLength": 9,
"valueOffset": 454,
"valueLength": 3
},
{
"subject": "commercial remaining performance obligation",
"status": "1",
"value": 155000000000.0,
"valueIsPercent": false,
"subjectOffset": 400,
"subjectLength": 43,
"statusOffset": 444,
"statusLength": 9,
"valueOffset": 487,
"valueLength": 12
}
]
}
]
}

Earnings Call Highlights

Aletheia analyzes each earnings call and extracts the meaningful words, phrases, and financial figures from the calls. You can use the Earnings Call Highlights endpoint to directly request the most important remarks from the call. You can even filter this further and request the most important remarks involving a particular financial category (i.e. important remarks related to revenue, earnings per share, guidance, financial figures, etc).

GET
https://api.aletheiaapi.com/EarningsCallHighlights

Parameters

Required
company - The trading symbol of the of the company.
Required
year - The fiscal year of the earnings call you are requesting.
Required
quarter - What fiscal quarter you are requesting an earnings call for. Provide either 'q1', 'q2', 'q3', or 'q4'.
Optional
category - This parameter provides you the ability to request the highlights for a particular financial category. For example, by using this parameter you can request the highlight remarks that mention earnings per share.
  • 0 - Revenue
  • 1 - Earnings
  • 2 - Cash Flow
  • 3 - Other
  • 4 - Growth
  • 5 - Financial Figure
  • 6 - Volume
  • 7 - Guidance
  • 8 - Management Perception of the Situation
Optional
top - The number of highlights to return in the response. Default (if not specified) is 5, maxiumum is 12.

Example Requests

https://api.aletheiaapi.com/EarningsCallHighlights?company=DLTR&year=2019&quarter=q4
https://api.aletheiaapi.com/EarningsCallHighlights?company=DLTR&year=2019&quarter=q4&category=0
https://api.aletheiaapi.com/EarningsCallHighlights?company=AAPL&year=2020&quarter=q1&category=5&top=3
Example Response
+ Example Response
[
{
"Id": "423a379d-a22c-4340-b8f5-40abe350a301",
"Remark": "For the first quarter, we are forecasting total sales to range from $5.89 billion to $5.99 billion and diluted earnings per share in the range of $1.00 to $1.09. These estimates are based on a low-single digit increase in same-store sales and year-over-year square footage growth of 1.5%. For fiscal 2020, we are forecasting total sales to range between $24.21 billion and $24.66 billion based on a low-single digit same-store sales increase and approximately 3.1% selling square footage growth. The Company anticipates GAAP net income per diluted share for fiscal 2020 will range between $4.80 and $5.15.",
"SpokenBy": {
"Id": "1215ce14-86db-45de-b033-4bff1e0ea72b",
"Name": "Rick Matros",
"Title": "Chairman of the Board, President and Chief Executive Officer",
"IsExternal": false
},
"Highlights": [ The response will include the start position and end position of each keyword or phrase that was recognized being of interest
{
"BeginPosition": 85,
"EndPosition": 89,
"Category": 5,
"Rating": 4.0
},
{
"BeginPosition": 146,
"EndPosition": 150,
"Category": 5,
"Rating": 4.0
},
{
"BeginPosition": 460,
"EndPosition": 463,
"Category": 5,
"Rating": 4.0
},
{
"BeginPosition": 283,
"EndPosition": 286,
"Category": 5,
"Rating": 4.0
},
{
"BeginPosition": 373,
"EndPosition": 378,
"Category": 5,
"Rating": 4.0
}
]
},
{
"Id": "f5d98c26-e11c-4855-b655-38045f25350e",
"Remark": "And looking at our 2020 outlook when compared to 2019 performance, the upper end of our 2020 guidance is $5.15. Adding back the impact of $47 million or $0.15 per share in incremental tariffs in 2020 and $28.6 million or $0.12 per share for the equalization of tax rates for both years brings the adjusted EPS for 2020 at the high-end to $5.42. When compared to the 2019 adjusted earnings per share of $4.76, 2020 adjusted earnings of $5.42 would be a 14% increase year-over-year.",
"SpokenBy": {
"Id": "1215ce14-86db-45de-b033-4bff1e0ea72b",
"Name": "Rick Matros",
"Title": "Chairman of the Board, President and Chief Executive Officer",
"IsExternal": false
},
"Highlights": [
{
"BeginPosition": 93,
"EndPosition": 100,
"Category": 7,
"Rating": 6.0
},
{
"BeginPosition": 204,
"EndPosition": 208,
"Category": 5,
"Rating": 4.0
},
{
"BeginPosition": 338,
"EndPosition": 338,
"Category": 5,
"Rating": 4.0
},
{
"BeginPosition": 452,
"EndPosition": 454,
"Category": 5,
"Rating": 4.0
},
{
"BeginPosition": 105,
"EndPosition": 105,
"Category": 5,
"Rating": 4.0
}
]
},
{
"Id": "957bb7b1-dec2-4136-abfa-1e3e2beaf582",
"Remark": "For the fourth quarter on a GAAP basis, the Company had net income of $123 million or $0.52 per diluted share. This compared to a GAAP net loss of $2.3 billion or a loss of $9.69 per share in the prior year's quarter. On an adjusted basis, diluted earnings per share for Q4 2019 were $1.79. Please refer to the reconciliation of non-GAAP financial measures in today's press release.",
"SpokenBy": {
"Id": "1215ce14-86db-45de-b033-4bff1e0ea72b",
"Name": "Rick Matros",
"Title": "Chairman of the Board, President and Chief Executive Officer",
"IsExternal": false
},
"Highlights": [
{
"BeginPosition": 135,
"EndPosition": 142,
"Category": 1,
"Rating": 5.0
},
{
"BeginPosition": 86,
"EndPosition": 90,
"Category": 5,
"Rating": 4.0
},
{
"BeginPosition": 284,
"EndPosition": 284,
"Category": 5,
"Rating": 4.0
},
{
"BeginPosition": 147,
"EndPosition": 150,
"Category": 5,
"Rating": 4.0
},
{
"BeginPosition": 248,
"EndPosition": 265,
"Category": 1,
"Rating": 4.0
}
]
}
]

Death Cross

The "death cross" is a technical chart pattern indicating the potential for a major sell-off of a stock or security. The death cross appears on a chart when a stock's 50-day moving average crosses it's 200-day moving average. Use Aletheia's Death Cross service to be notified of or research historical death cross events.

Death Cross/Golden Cross (Webhook)

You can subscribe your application or web service to be notified of death cross and golden cross events via this webhook service. This service will notify you of both bearish events in which the 50-day moving average sinks below the 200-day moving average ("death cross"), and bullish events in which the 50-day moving average once again rose above the 200-day moving average ("golden cross").

Step 1 - Subscribe Your Endpoint

First you must subscribe your endpoint to the death cross webhook service.

POST
https://api.aletheiaapi.com/SubscribeToDeathCrossWebhook
The body of the post HTTP request must be in JSON format. For example:
{
"endpoint": "https://example.com/my-endpoint",
"stock": "TSLA",
"crossType": 0
}
The endpoint property is the only required property to include; this is your own endpoint which you would like to have called upon a death cross event occuring.
If you would only like to subscribe to death cross events of a specific stock, you can specify the stock's trading symbol via the stock property. The example above specifies Tesla (TSLA).
This service is capable of detecting both death cross and golden cross events. A bullish event is when the 50-day moving average sinks below the 200-day moving average. A bearish event occurs when the 50-day moving average rises above the 200-day moving average. Setting the crossType property to 0 means you will only be notified of death crosses, while a value of 1 filters to only golden crosses.
The subscription endpoint will return a 201 created response. This response will include a "Location" header. The value of this header will be used to unsubscribe from this webhook, so save this for later.

Step 2 - Receive death/golden cross events!

After subscribing your endpoint to the webhook with step 1, your endpoint will begin to receive HTTP POST requests when a qualifying death/golden cross event occurs.

The following is an example of the POST request that will be sent to your registered endpoint:

POST
(your registered endpoint)
{
"Stock": "ALLE",
"CrossType": 0
}
The Stock property of the payload indicates the stock which made the death cross. The CrossType indicates the cross type - 0 = death cross, 1 = golden cross (see above for what these mean).

Step 3 - Unsubscribe frim the webhook when finished

When you initially subscribed to the death cross webhook service, a header labeled Location should have been included in the 201 (Created) response. Simply send a DELETE request to this URL to unsubscribe your endpoint. Alternatively, you can follow the same unsubscribe instructions from the New Filings webhook to unsubscribe if you no longer have this value.

SEC Filings

Access and monitor filings with the Securities Exchange Commission's EDGAR database.

New SEC Filings (Webhook)

You can subscribe your application or web service to be notified of new SEC filings with this webhook.

Step 1 - Subscribe Your Endpoint

First you must subscribe your endpoint to the new filings webhook service.

POST
https://api.aletheiaapi.com/SubscribeToNewFilingsWebhook
The body must contain the URL endpoint of your API service. The body must be in JSON format with your endpoint stored in the "endpoint" property. Example:
{"endpoint": "https://www.myservice.net/myendpoint"}
The subscription endpoint will return a 201 created response. This response will include a "Location" header. The value of this header will be used to unsubscribe from this webhook, so save this for later.

Step 2 - Receive New Filings!

After subscribing your endpoint to the webhook with step 1, your endpoint will begin to receive HTTP POST requests when a new SEC filing is available.

The following is an example of the POST request that will be sent to your registered endpoint:

POST
(your registered endpoint)
{
    "EntityTitle":"BlackRock Capital Investment Corp",
    "EntityCik":1326003,
    "Filing":"4",
    "DocumentsUrl":"https://www.sec.gov/Archives/edgar/data/1326003/000120919121008361/0001209191-21-008361-index.htm",
    "Description":"Statement of changes in beneficial ownership of securities Accession Number: 0001209191-21-008361 Size: 9 KB\n",
    "FilingDate":"2021-02-05T00:00:00"
}

Step 3 - Unsubscribe from the webhook when finished

When you wish to stop receiving posts from this webhook, be sure to formally unsubscribe your endpoint.

When you originally registered your endpoint in step 1, the returned 201 created response contained a "Location" header. The value of this header contains the endpoint that will unsubscribe your endpoint via a DELETE call. The unsubscribe endpoint will look something like this:

https://api.aletheiaapi.com/UnsubscribeFromNewFilingsWebhookById?id=dd150c44-c42a-4cdd-92f5-b78a23b36c72

To unsubscribe your endpoint from this webhook, call this provided value via a DELETE call.

If you no longer have the provided unsubscribe URL from the original subscription step, you can also unsubscribe by providing your registered endpoint to the 'UnsubscribeFromNewFilingsWebhookByEndpoint' api. For example, see below:

DELETE
https://api.aletheiaapi.com/UnsubscribeFromNewFilingsWebhookByEndpoint?endpoint=https://www.myservice.net/myendpoint

Entity Filings

Query the latest SEC filings for a particular company or person.

GET
https://api.aletheiaapi.com/EntityFilings

Parameters

Required
id - The CIK or trading symbol of the company or person you are searching for
Optional
filing - Filing type filter. For example, 10-K or 10-Q
Optional
before - Filter to filings only before a particular date, in YYYYMMDD format

Example Requests

https://api.aletheiaapi.com/EntityFilings?id=msft&filing=10-k
https://api.aletheiaapi.com/EntityFilings?id=0000050863&before=20180101
https://api.aletheiaapi.com/EntityFilings?id=pg&filing=4&before=20160701
+ Example Response
[
{
"InteractiveDataUrl":"https://www.sec.gov/cgi-bin/viewer?action=view&cik=789019&accession_number=0001564590-20-034944&xbrl_type=v", - Quick view of extracted data
"Filing":"10-K", - filing type
"DocumentsUrl":"https://www.sec.gov/Archives/edgar/data/789019/000156459020034944/0001564590-20-034944-index.htm", - URL to filing
"Description":"Annual report [Section 13 and 15(d), not S-K Item 405] Acc-no: 0001564590-20-034944 (34 Act)  Size: 27 MB", - filing description
"FilingDate":"2020-07-30T00:00:00" - Date the SEC received the filing
},
{
"InteractiveDataUrl":"https://www.sec.gov/cgi-bin/viewer?action=view&cik=789019&accession_number=0001564590-19-027952&xbrl_type=v",
"Filing":"10-K",
"DocumentsUrl":"https://www.sec.gov/Archives/edgar/data/789019/000156459019027952/0001564590-19-027952-index.htm",
"Description":"Annual report [Section 13 and 15(d), not S-K Item 405] Acc-no: 0001564590-19-027952 (34 Act)  Size: 26 MB",
"FilingDate":"2019-08-01T00:00:00"
},
{
"InteractiveDataUrl":"https://www.sec.gov/cgi-bin/viewer?action=view&cik=789019&accession_number=0001564590-18-019062&xbrl_type=v",
"Filing":"10-K",
"DocumentsUrl":"https://www.sec.gov/Archives/edgar/data/789019/000156459018019062/0001564590-18-019062-index.htm",
"Description":"Annual report [Section 13 and 15(d), not S-K Item 405] Acc-no: 0001564590-18-019062 (34 Act)  Size: 29 MB",
"FilingDate":"2018-08-03T00:00:00"
},
{
"InteractiveDataUrl":"https://www.sec.gov/cgi-bin/viewer?action=view&cik=789019&accession_number=0001564590-17-014900&xbrl_type=v",
"Filing":"10-K",
"DocumentsUrl":"https://www.sec.gov/Archives/edgar/data/789019/000156459017014900/0001564590-17-014900-index.htm",
"Description":"Annual report [Section 13 and 15(d), not S-K Item 405] Acc-no: 0001564590-17-014900 (34 Act)  Size: 28 MB",
"FilingDate":"2017-08-02T00:00:00"
},
{
"InteractiveDataUrl":"https://www.sec.gov/cgi-bin/viewer?action=view&cik=789019&accession_number=0001193125-16-662209&xbrl_type=v",
"Filing":"10-K",
"DocumentsUrl":"https://www.sec.gov/Archives/edgar/data/789019/000119312516662209/0001193125-16-662209-index.htm",
"Description":"Annual report [Section 13 and 15(d), not S-K Item 405] Acc-no: 0001193125-16-662209 (34 Act)  Size: 13 MB",
"FilingDate":"2016-07-28T00:00:00"
},
{
"InteractiveDataUrl":"https://www.sec.gov/cgi-bin/viewer?action=view&cik=789019&accession_number=0001193125-15-272806&xbrl_type=v",
"Filing":"10-K",
"DocumentsUrl":"https://www.sec.gov/Archives/edgar/data/789019/000119312515272806/0001193125-15-272806-index.htm",
"Description":"Annual report [Section 13 and 15(d), not S-K Item 405] Acc-no: 0001193125-15-272806 (34 Act)  Size: 14 MB",
"FilingDate":"2015-07-31T00:00:00"
}
]

Open Form 4

Open a statement of change in beneficial ownership (form 4) to reveal details of insider trading

GET
https://api.aletheiaapi.com/OpenForm4

Parameters

Required
filingurl - the URL of the form 4 filing with the SEC
  • Tip: Use the filing url of a form 4 filing that was returned via the "EntityFilings" endpoint (see above)

Example Requests

https://api.aletheiaapi.com/OpenForm4?filingurl=https://www.sec.gov/Archives/edgar/data/50863/000112760221003952/0001127602-21-003952-index.htm
https://api.aletheiaapi.com/OpenForm4?filingurl=https://www.sec.gov/Archives/edgar/data/1318605/000179056521000001/0001790565-21-000001-index.htm
+ Example Response
{
"SchemaVersion":"X0306", - Schema of the XBRL used in this report
"PeriodOfReport":"2021-02-02T00:00:00",
"IssuerCik":"0000050863", - The Central Index Key (ID) of the issuing company
"IssuerName":"INTEL CORP", - Issuing company name
"IssuerTradingSymbol":"INTC", - Issuing company trading symbol
"OwnerName":"McBride Kevin Thomas", - Name of the insider making the trade
"OwnerCik":"0001723374", - The Central Index Key (ID) of the insider making the trade
"OwnerStreet1":"C/O INTEL CORPORATION",
"OwnerStreet2":"2200 MISSION COLLEGE BLVD",
"OwnerCity":"SANTA CLARA",
"OwnerStateCode":"CA",
"OwnerZipCode":"95054",
"OwnerIsOfficer":true,
"OwnerOfficerTitle":"VP Finance, Corp. Controller",
"NonDerivativeTransactions":[ - Equity (non-derivative) trades
{
"SecurityTitle":"Common Stock",
"SecuritiesOwnedFollowingTransaction":14214.0,
"DirectOrIndirectOwnership":0,
"TransactionDate":"2021-02-02T00:00:00",
"TransactionCode":1,
"TransactionQuantity":589.0,
"TransactionPricePerSecurity":57.17,
"AcquiredOrDisposed":1
}
],
"DerivativeTransactions":null - Derivative trades (similar format to above)
}

Open Common Financials

Open a financial report document (10-K or 10-Q) filing to a financial statement.

GET
https://api.aletheiaapi.com/OpenCommonFinancials

Parameters

Required
filingurl - the URL of the 10-K or 10-Q with the SEC. Note: This must be a 10-K or 10-Q.
  • Tip: Use the filing url of a 10-K/10-Q filing that was returned via the "EntityFilings" endpoint (see above)

Example Requests

https://api.aletheiaapi.com/OpenCommonFinancials?filingurl=https://www.sec.gov/Archives/edgar/data/789019/000156459020034944/0001564590-20-034944-index.htm
https://api.aletheiaapi.com/OpenCommonFinancials?filingurl=https://www.sec.gov/Archives/edgar/data/1326801/000132680120000084/0001326801-20-000084-index.htm
+ Example Response
{
"PeriodStart":"2019-07-01T00:00:00",
"PeriodEnd":"2020-06-30T00:00:00",
"Revenue":1.43015E+11,
"SellingGeneralAndAdministrativeExpense":null,
"ResearchAndDevelopmentExpense":1.9269E+10,
"OperatingIncome":5.2959E+10,
"NetIncome":4.4281E+10,
"Assets":3.01311E+11,
"Liabilities":1.83007E+11,
"Equity":1.18304E+11,
"Cash":1.3575999E+10,
"CurrentAssets":1.81915E+11,
"CurrentLiabilities":7.231E+10,
"RetainedEarnings":3.4566E+10,
"CommonStockSharesOutstanding":7570999808,
"OperatingCashFlows":6.0675E+10,
"InvestingCashFlows":-1.2223E+10,
"FinancingCashFlows":-4.6031E+10,
"ProceedsFromIssuanceOfDebt":0.0,
"PaymentsOfDebt":5.518E+09,
"DividendsPaid":1.5137E+10
}

Usage Metrics

You can use these endpoints to monitor your consumtion of the Aletheia API service.

Consumption

Count the number of API calls you have made or have been made to you (via webhook) for any time window or for a particular month.

GET
https://api.aletheiaapi.com/consumption

Parameters

Optional
begin - If requesting consumption during a window, the beginning date of the window you are requesting.
Optional
end - If requesting consumption during a window, the ending date of the window you are requesting.
Optional
year - If requesting consumption for a particular month, the year that contains the month you are requesting.
Optional
month - If requesting consumption for a particular month, the month you are requesting (1-12).

Example Requests

https://api.aletheiaapi.com/consumption?begin=20210101&end=20210501
https://api.aletheiaapi.com/consumption?begin=20210401&end=20210501
https://api.aletheiaapi.com/consumption?year=2021&month=5
Example Response
+ Example Response
4837

My Calls

Retrieve history of the most recent calls you have made.

GET
https://api.aletheiaapi.com/mycalls

Parameters

Optional
last - The number of transactions to retrieve. Minimum: 1, Maximum: 100

Example Requests

https://api.aletheiaapi.com/mycalls?last=5
https://api.aletheiaapi.com/mycalls?last=75
Example Response
+ Example Response
[
{
"Endpoint": "Financials", - the title of the endpoint you called
"CalledAtUtc": "2021-05-21T23:22:28", - the date and time you made the API call
"Direction": "Request" - If you called the service, "Request". If a webhook called your endpoint, "Push"
},
{
"Endpoint": "EntityFilings",
"CalledAtUtc": "2021-05-21T23:22:21",
"Direction": "Request"
},
{
"Endpoint": "Consumption",
"CalledAtUtc": "2021-05-21T23:11:47",
"Direction": "Request"
},
{
"Endpoint": "OpenForm4",
"CalledAtUtc": "2021-05-21T23:11:37",
"Direction": "Request"
},
{
"Endpoint": "OpenCommonFinancials",
"CalledAtUtc": "2021-05-21T23:03:54",
"Direction": "Request"
}
]

Service Information

These endpoints provide contextual information about the Aletheia service.

API Version

Get the actively deployed version of the Aletheia API service

GET
https://api.aletheiaapi.com/version

Count Entities

Count the number of SEC entities that have been processed and collected.

GET
https://api.aletheiaapi.com/CountSecEntities

Parameters

Optional
onlyco - Short for "only companies". Specify 'true' to count only entities that have a trading symbol and thus are security-issuing companies. Only valid values are 'true' and 'false'. Default is 'false'.

Count Filings

Count the number of SEC filings that have been processed and collected.

GET
https://api.aletheiaapi.com/CountSecFilings

Count Transactions

Count the number of transactions that have been processed and collected from from 3, 4, and 5's from the SEC.

GET
https://api.aletheiaapi.com/CountTransactions

Count Fact Contexts

Count the number of Fact Contexts that are available for consumption from the Fundamentals service category.

GET
https://api.aletheiaapi.com/CountFactContexts

Count Financial Facts

Count the number of financial data points that have been collected and are available for consumption from the Fundamentals service category. You can count the number of data points in overall or narrow down to data points belonging to a specific company.

GET
https://api.aletheiaapi.com/CountFinancialFacts

Parameters

Optional
id - Provide the CIK or trading symbol if you would like to only count the number of datapoints that exist for a particular company.

Example Requests

https://api.aletheiaapi.com/CountFinancialFacts
https://api.aletheiaapi.com/CountFinancialFacts?id=MSFT
https://api.aletheiaapi.com/CountFinancialFacts?id=789019