Getting Started

API endpoint: https://sennetai.com/api/

The Sennet API provides access to all the endpoints used for Sennet Dashboard. With Sennet API you can get historical prices, social media data or analized news for any symbol, from both stock and crypto markets.
To use this API, you need an API key. You can get your API key on your profile page.


Here you can find all the documentation and information related to Sennet AI API. Before using our API, make sure you have your authentication token, you can find it in your profile page. We are currently working on creating a better and more powerful API, so we recommend you to periodically check this docs to find new changes and updates.


How authentication works?


In order to authenticate your request to the API, you need to set the API key from your profile in the header "Authorization" in all your requests. For example, if my API key is 1234567890abcd, the authorization header should look like this:

"Authorization": "Token 1234567890abcd"

Stock Market Data

Endpoint: https://sennetai.com/api/stocks/market-data/{stock_symbol}/

To get the market data from a stock symbol you need to make a GET request.

Request:

https://sennetai.com/api/stocks/market-data/AAPL/

Response:

{
   "sector":"Technology",
   "fullTimeEmployees":100000,
   "longBusinessSummary":"Apple Inc. designs, manufactures, and markets smartphones, personal computers, ta...",
   "city":"Cupertino",
   "state":"CA",
   "country":"United States",
   "website":"http://www.apple.com",
   "industry":"Consumer Electronics",
   "trailingAnnualDividendYield":0.005987149,
   "regularMarketPreviousClose":136.96,
   "open":136.6,
   "marketCap":2276105125888,
   "averageVolume":82668211,
   "dayLow":136.26,
   "volume":17219474,
   "f\iftyTwoWeekHigh":145.09,
   "fiftyTwoWeekLow":89.145,
   "dividendYield":0.0064,
   "dayHigh":137.19,
   "longName":"Apple Inc.",
   "symbol":"AAPL",
   "shortRatio":1.52,
   "regularMarketPrice":136.6,
   "logo_url":"https://logo.clearbit.com/apple.com"
}

Errors

{'Error':'Symbol __x__ is not available'}: This error occurs when the requested symbol is not available in our servers.

Stock prices

Endpoint: https://sennetai.com/api/stocks/prices/{stock_symbol}/

Parameters:

interval: The interval of today prices. Valid intervals for this endpoints are ["1m", "2m", "5m", "15m", "30m", "60m", "90m", "1h", "1d", "5d", "1wk", "1mo", "3mo"]. Default is "1d".
since: Start date to make the fetch. Valid date format is %Y-%m-%d (2021-06-30).
until: End date to make the fetch. Valid date format is %Y-%m-%d (2021-06-30).

To get the prices between two dates of a stock symbol you need to make a GET request.

Request:

https://sennetai.com/api/stocks/prices/AAPL/

Response:

{
    "1625154840000":136.375,
    "1625154900000":136.375,
    "1625154960000":136.320098877,
    "1625155020000":136.3217926025,
    "1625155080000":136.3159942627,
    "1625155140000":136.3182983398,
    "1625155200000":136.3500061035,
    ...
}

Errors

{'Error':'Symbol __x__ is not available'}: This error occurs when the requested symbol is not available in our servers.
{"Error":"Invalid date format"}: Since or until dates don't have valid format (%Y-%m-%d).
{'Error':'Invalid interval'}: This error occurs when the requested interval is not a valid one.
{"Error":"Invalid dates"}: Until is older than since.
{'Error':'Since or until date not set'}: Until and since paramenters are required to make the request.

Stock today prices

Endpoint: https://sennetai.com/api/stocks/prices/today/{stock_symbol}/

Parameters:

interval: The interval of today prices. Valid intervals for this endpoints are ["1m", "2m", "5m", "15m", "30m", "60m", "90m", "1h", "1d", "5d", "1wk", "1mo", "3mo"]. Default is "1m"

To get the prices of today from a stock symbol you need to make a GET request.

Request:

https://sennetai.com/api/stocks/prices/today/AAPL/?interval=1m

Response:

{
    "1625154840000":136.375,
    "1625154900000":136.375,
    "1625154960000":136.320098877,
    "1625155020000":136.3217926025,
    "1625155080000":136.3159942627,
    "1625155140000":136.3182983398,
    "1625155200000":136.3500061035,
    ...
}

Errors

{'Error':'Symbol __x__ is not available'}: This error occurs when the requested symbol is not available in our servers.
{'Error':'Invalid interval'}: This error occurs when the requested interval is not a valid one.

Stock week prices

Endpoint: https://sennetai.com/api/stocks/prices/week/{stock_symbol}/

Parameters:

interval: The interval of week prices. Valid intervals for this endpoints are ["1m", "2m", "5m", "15m", "30m", "60m", "90m", "1h", "1d", "5d", "1wk", "1mo", "3mo"]. Default is "1m"

To get the prices of the week from a stock symbol you need to make a GET request.

Request:

https://sennetai.com/api/stocks/prices/week/AAPL/?interval=1m

Response:

{
    "1625154840000":136.37502173,
    "1625154900000":136.37500102,
    "1625154960000":136.32988773,
    "1625155020000":136.32926025,
    "1625155080000":136.31942627,
    "1625155140000":136.31983398,
    "1625155200000":136.35061035,
    ...
}

Errors

{'Error':'Symbol __x__ is not available'}: This error occurs when the requested symbol is not available in our servers.

{'Error':'Invalid interval'}: This error occurs when the requested interval is not a valid one.

Stock year prices

Endpoint: https://sennetai.com/api/stocks/prices/year/{stock_symbol}/

Parameters:

interval: The interval of year prices. Valid intervals for this endpoints are ["1h", "1d", "5d", "1wk", "1mo", "3mo"]. Default is "1d"

To get the prices of the year from a stock symbol you need to make a GET request.

Request:

https://sennetai.com/api/stocks/prices/year/AAPL/?interval=1d

Response:

{
    "1593561600000":90.4182510376,
    "1593648000000":90.4182510376,
    "1593993600000":92.8369598389,
    "1594080000000":92.5488891602,
    "1594166400000":94.7043685913
}

Errors

{'Error':'Symbol __x__ is not available'}: This error occurs when the requested symbol is not available in our servers.

{'Error':'Invalid interval'}: This error occurs when the requested interval is not a valid one.

Crypto Market Data

Endpoint: https://sennetai.com/api/crypto/market-data/{crypto_symbol}/

To get the market data from a crypto symbol you need to make a GET request.

Request:

https://sennetai.com/api/crypto/market-data/BTC/

Response:

{
    "symbol":"BTC",
    "name":"Bitcoin",
    "price":33405,
    "total_volume":27108247267,
    "market_cap":627599932344,
    "24h_change":-416.0407237911,
    "24h_change_percentage":-1.23013,
    "7d_change_percentage":-3.66453,
    "30d_change_percentage":-8.92941,
    "1y_change_percentage":261.88863
}

Errors

{'Error':'Symbol __x__ is not available'}: This error occurs when the requested symbol is not available in our servers.

Crypto prices

Endpoint: https://sennetai.com/api/crypto/prices/{crypto_symbol}/

Parameters:

since(required): Start date to make the fetch. Valid date format is %Y-%m-%d (2021-06-30).
until(required): End date to make the fetch. Valid date format is %Y-%m-%d (2021-06-30).

To get the prices between two dates of a crypto symbol you need to make a GET request.

Request:

https://sennetai.com/api/crypto/prices/BTC/?since=2021-06-29&until=2021-06-30

Response:

{
    "1624924921905":34556.8421269449,
    "1624928482953":35000.91995642084,
    "1624932044806":34731.1482753022,
    "1624935712460":34397.35580929206,
    "1624939379677":34646.860870141114,
    "1624942865216":34981.26402319882,
    "1624946533457":34776.437614360024,
    "1624950092261":35269.71335239218,
    ...
}

Errors

{'Error':'Symbol __x__ is not available'}: This error occurs when the requested symbol is not available in our servers.

Crypto today prices

Endpoint: https://sennetai.com/api/crypto/prices/today/{crypto_symbol}/

To get the prices of today from a crypto symbol you need to make a GET request. Returned prices have 5min interval.

Request:

https://sennetai.com/api/crypto/prices/today/BTC/

Response:

{
    "1625202039095":33090.17391,
    "1625202330423":33215.92297,
    "1625202587928":33278.06434,
    "1625202896951":33259.53721,
    "1625203164994":33219.68647,
    "1625203499798":33199.16581,
    "1625203811386":33162.43949,
    "1625204068402":33124.44693,
    "1625204397355":33072.15165,
    ...
}

Errors

{'Error':'Symbol __x__ is not available'}: This error occurs when the requested symbol is not available in our servers.

Crypto week prices

Endpoint: https://sennetai.com/api/crypto/prices/week/{crypto_symbol}/

To get the prices of the week from a crypto symbol you need to make a GET request. Returned prices have 1h interval.

Request:

https://sennetai.com/api/crypto/prices/week/BTC/

Response:

{
    "1625025727450":35273.74078,
    "1625029266165":34823.96282,
    "1625032905032":34933.13303,
    "1625036529796":35037.76004,
    "1625040068098":35339.11583,
    "1625043746276":34481.87227,
    "1625047303289":34675.97854,
    ...
}

Errors

{'Error':'Symbol __x__ is not available'}: This error occurs when the requested symbol is not available in our servers.

{'Error':'Invalid interval'}: This error occurs when the requested interval is not a valid one.

Crypto year prices

Endpoint: https://sennetai.com/api/crypto/prices/year/{crypto_symbol}/

Parameters:

To get the prices of the year from a crypto symbol you need to make a GET request. Returned prices have 1d interval.

Request:

https://sennetai.com/api/crypto/prices/year/BTC/

Response:

{
    "1624665600000":31943.13646,
    "1624752000000":32023.97390,
    "1624838400000":34607.29327,
    "1624924800000":34556.84212,
    "1625011200000":35968.99366,
    "1625097600000":35171.48630,
    "1625184000000":33677.56623,
    ...
}

Errors

{'Error':'Symbol __x__ is not available'}: This error occurs when the requested symbol is not available in our servers.

{'Error':'Invalid interval'}: This error occurs when the requested interval is not a valid one.

News app

The news app API endpoints contain all the endpoints used for the news platform. You can check the latest news for any stock or cryptocurrency, discover the latest news analysis tools and even analyze your own news.

Stock news

Endpoint: https://sennetai.com/api/stocks/news/{stock_symbol}/

Parameters:

media: List of valid media to take news from. To pass media on the request, add each media name separated by a comma (media=CNBC,Bloomberg). Default to all media.

Valid media: 
['elEconomista', 'Teslarati', 'Bloomberg', 'Business Insider', 'CNBC', 'Investing.com', 'MarketWatch', 
'Adweek', 'TNW', 'Motley Fool', 'Seeking Alpha', 'Reuters', 'Fortune', 'Yahoo Finance', 'TheStreet',
'TechCrunch', 'TheStreet.com', "Barron's", 'Wall Street Journal', 'Forbes', 'Yahoo Tech', 'Simply Wall St',
'Benzinga', 'HEXUS', 'CNNMoney', 'Investopedia', "Investor's Business Daily", 'Wccftech', 'MarketBeat',
'24/7 Wall St.', 'InvestorsObserver', 'ETF Trends', 'StreetInsider.com', 'Markets Insider', 'Hot Hardware',
'The Motley Fool Canada', 'StockNews.com', 'Guiding Tech', 'Silicon Valley Business Journal', 
'Fast Company', 'Business Wire', 'Market Realist', 'Stockopedia', 'Fintech Zoom', 'Coindesk', 
'Cointelegraph', 'Crypto News Flash', 'Bitcoin News', 'Decrypt', 'FX Empire', 'Coin Idol', 'CryptoPotato',
'CoinGeek', 'Financial Times', 'Telegraph.co.uk', 'AMBCrypto', 'Somag News', 'StockNews', 'Investorplace.com',
'Business Matters', 'CryptoSlate', 'The Daily Hodl']

since: Start date to make the fetch. Valid date format is %Y-%m-%d (2021-06-30). You can't fetch news older than 7 days
until: End date to make the fetch. Valid date format is %Y-%m-%d (2021-06-30)

To get the news from a stock symbol you need to make a GET request.

Request:

https://sennetai.com/api/stocks/news/AAPL/?media=Business Insider&since=2021-03-26&until=2021-03-27

Response:

[{
    "title":"Is Now The Time To Buy Stock In Microsoft, Disney, Apple Or...",
    "link":"https://markets.businessinsider.com/news/stocks/is-now-the...",
    "content":"Read More Apple Inc. (NASDAQ:AAPL) went on an acquisition...",
    "media":"Business Insider",
    "date":1616873784.0,
    "symbol":"Apple Inc.",
    "media_impact":{
        "impact":3,
        "daily_visitors":495868
    },
    "volatility":{
        "down":0.5991602,
        "up":0.40083984,
        "compound":0.5494182
    },
    "move":{
        "down":0.53089947,
        "up":0.4691005,
        "compound":0.5154448
    },
    "sentiment":{
        "neg":0.0,
        "neu":0.945,
        "pos":0.055,
        "compound":0.9228
    }
    "timestamp":"19:36 27-03-2021",
}]

Errors

{'Error':'Symbol __x__ is not available'}: This error occurs when the requested symbol is not available in our servers.
{'Error': "Can't fetch news for date older than 7 days"}: This error occurs when the requested date range is older than 7 days.
{"Error":"Invalid date format"}: Since or until dates don't have valid format (%Y-%m-%d).
{"Error":"Invalid media names"}: Media names aren't valid.
{"Error":"Invalid type of 'media' argument"}: Media argument in request doesn't have valid type (media=CNBC,Investing.com).

Crypto news

Endpoint: https://sennetai.com/api/crypto/news/{crypto_symbol}/

Parameters:

media: List of valid media to take news from. To pass media on the request, add each media name separated by a comma (media=CNBC,Bloomberg). Default to all media.

Valid media: 
['elEconomista', 'Teslarati', 'Bloomberg', 'Business Insider', 'CNBC', 'Investing.com', 'MarketWatch', 
'Adweek', 'TNW', 'Motley Fool', 'Seeking Alpha', 'Reuters', 'Fortune', 'Yahoo Finance', 'TheStreet',
'TechCrunch', 'TheStreet.com', "Barron's", 'Wall Street Journal', 'Forbes', 'Yahoo Tech', 'Simply Wall St',
'Benzinga', 'HEXUS', 'CNNMoney', 'Investopedia', "Investor's Business Daily", 'Wccftech', 'MarketBeat',
'24/7 Wall St.', 'InvestorsObserver', 'ETF Trends', 'StreetInsider.com', 'Markets Insider', 'Hot Hardware',
'The Motley Fool Canada', 'StockNews.com', 'Guiding Tech', 'Silicon Valley Business Journal', 
'Fast Company', 'Business Wire', 'Market Realist', 'Stockopedia', 'Fintech Zoom', 'Coindesk', 
'Cointelegraph', 'Crypto News Flash', 'Bitcoin News', 'Decrypt', 'FX Empire', 'Coin Idol', 'CryptoPotato',
'CoinGeek', 'Financial Times', 'Telegraph.co.uk', 'AMBCrypto', 'Somag News', 'StockNews', 'Investorplace.com',
'Business Matters', 'CryptoSlate', 'The Daily Hodl']

since: Start date to make the fetch. Valid date format is %Y-%m-%d (2021-06-30). You can't fetch news older than 7 days
until: End date to make the fetch. Valid date format is %Y-%m-%d (2021-06-30)

To get the news from a crypto symbol you need to make a GET request.

Request:

https://sennetai.com/api/crypto/news/BTC/?media=Forbes&since=2021-03-04&until=2021-03-05

Response:

[
    {
        "title":"What Is Bitcoin? The Discovery Of The First Digital Commodity",
        "link":"https://www.forbes.com/sites/philippsandner/2021/03/04/what ...",
        "content":"Bitcoin is much more than interconnected processors. Far ...",
        "media":"Forbes",
        "date":1614816000.0,
        "symbol":"Bitcoin",
        "media_impact":{
            "impact":2,
            "daily_visitors":430089
        },
        "volatility":{
            "down":0.63847774,
            "up":0.36152226,
            "compound":0.5687997
        },
        "move":{
            "down":0.51057214,
            "up":0.48942786,
            "compound":0.50528586
        },
        "sentiment":{
            "neg":0.0,
            "neu":1.0,
            "pos":0.0,
            "compound":0.0
        }
        "timestamp":"00:00 04-03-2021",
    }
]

Errors

{'Error':'Symbol __x__ is not available'}: This error occurs when the requested symbol is not available in our servers.
{'Error': "Can't fetch news for date older than 7 days"}: This error occurs when the requested date range is older than 7 days.
{"Error":"Invalid date format"}: Since or until dates don't have valid format (%Y-%m-%d).
{"Error":"Invalid media names"}: Media names aren't valid.
{"Error":"Invalid type of 'media' argument"}: Media argument in request doesn't have valid type (media=Bloomberg,Investing.com).

Analyze custom news

Endpoint: https://sennetai.com/api/news/custom-new/

Parameters:

url: Valid url to the article you want to analyze

To analyze a custom new you need to make a GET request.

Request:

https://sennetai.com/api/news/custom-new/?url=https://www.investing.com/blog/..../

Response:

{
    "title":"Beyond GameStop: survey reveals Reddit’s larger-than-expected influence on investing 
             By Investing.com Blog",
    "volatility":{
        "down":0.704316258430481,
        "up":0.29568374156951904,
        "compound":0.6007599367622989
    },
    "move":{
        "down":0.36798471212387085,
        "up":0.6320152282714844,
        "compound":0.5656268225555188
    },
    "sentiment":{
        "neg":0.0,
        "neu":0.775,
        "pos":0.225,
        "compound":0.4939
    }
}

Social app

The social app API endpoints contain all the endpoints used for the social sentiment platform. You can check the latest social sentiment and volume for any stock or cryptocurrency and discover the latest trends interest.

Stock Social Overview

Endpoint: https://sennetai.com/api/social/stocks/overview/

Parameters:

symbol (optional): Stock symbol to fetch the social overview. If empty it will return the overview of the stock market.

To get the social sentiment overview from a stock symbol you need to make a GET request.

Request:

https://sennetai.com/api/social/stocks/overview/?symbol=TSLA

Response:

{
    "volume":{
        "change_24h":122.22,
        "change_7d":160.89
    },
    "sentiments":{
        "positive":{
            "change_24h":28.0,
            "change_7d":93.94
        },
        "neutral":{
            "change_24h":100.0,
            "change_7d":10.71
        },
        "negative":{
            "change_24h":-73.68,
            "change_7d":-87.18
        }
    },
    "metadata":{
        "symbol":"TSLA",
        "date":"2021-09-04 13:14:21.529075"
    }
}

Stock Social Sentiment

Endpoint: https://sennetai.com/api/stocks/social-sentiment/{stock_symbol}/

Parameters:

since: Start date to make the fetch. Valid date format is %Y-%m-%d (2021-06-30). You can't fetch news older than 15 days
until: End date to make the fetch. Valid date format is %Y-%m-%d (2021-06-30)

To get the social sentiment from a stock symbol you need to make a GET request.

Request:

https://sennetai.com/api/stocks/social-sentiment/FB/since=2021-08-29&until=2021-09-08

Response:

{
    "sentiment":{
        "29-08-2021":{
            "neutral":14,
            "negative":4,
            "positive":13
        },
        ...
        "08-09-2021":{
            "neutral":2,
            "negative":1,
            "positive":4
        }
    },
    "scaled_sentiment":{
        "29-08-2021":{
            "neutral":45,
            "negative":13,
            "positive":42
        },
        ...
        "08-09-2021":{
            "neutral":29,
            "negative":14,
            "positive":57
        }
    },
    "metadata":{
        "symbol":"FB",
        "market":"stocks",
        "timestamp":"2021-09-08 04:45:01.153744"
    }
}
This endpoint reponse may vary based on your plan. Check your plan features here

Errors

{'Error':'Symbol __x__ is not available'}: This error occurs when the requested symbol is not available in our servers.
{'Error': "Can't fetch social sentiment for date older than 15 days"}: This error occurs when the requested date range is older than 15 days.
{"Error":"Invalid date format"}: Since or until dates don't have valid format (%Y-%m-%d).

Stock Social Volume

Endpoint: https://sennetai.com/api/stocks/social-volume/{stock_symbol}/

Parameters:

since: Start date to make the fetch. Valid date format is %Y-%m-%d (2021-06-30). You can't fetch news older than 15 days
until: End date to make the fetch. Valid date format is %Y-%m-%d (2021-06-30)

To get the social volume from a stock symbol you need to make a GET request.

Request:

https://sennetai.com/api/stocks/social-volume/AMZN/?since=2021-08-29&until=2021-09-08

Response:

{
    "volume":{
        "29-08-2021":39,
        "30-08-2021":148,
        "31-08-2021":55,
        "01-09-2021":122,
        "02-09-2021":100,
        "03-09-2021":99,
        "04-09-2021":94,
        "05-09-2021":73,
        "06-09-2021":38,
        "07-09-2021":8,
        "08-09-2021":7
    },
    "scaled_volume":{
        "29-08-2021":26.35,
        "30-08-2021":100.0,
        "31-08-2021":37.16,
        "01-09-2021":82.43,
        "02-09-2021":67.57,
        "03-09-2021":66.89,
        "04-09-2021":63.51,
        "05-09-2021":49.32,
        "06-09-2021":25.68,
        "07-09-2021":5.41,
        "08-09-2021":4.73
    },
    "metadata":{
        "symbol":"AMZN",
        "market":"stocks",
        "timestamp":"2021-09-08 04:44:36.840113"
    }
}
This endpoint reponse may vary based on your plan. Check your plan features here

Errors

{'Error':'Symbol __x__ is not available'}: This error occurs when the requested symbol is not available in our servers.
{'Error': "Can't fetch social volume for date older than 15 days"}: This error occurs when the requested date range is older than 15 days.
{"Error":"Invalid date format"}: Since or until dates don't have valid format (%Y-%m-%d).

Crypto Social Overview

Endpoint: https://sennetai.com/api/social/crypto/overview/

Parameters:

symbol (optional): Crypto symbol to fetch the social overview. If empty it will return the overview of the stock market.

To get the social sentiment overview for a crypto symbol you need to make a GET request.

Request:

https://sennetai.com/api/social/crypto/overview/?symbol=LTC

Response:

{
    "volume":{
        "change_24h":76.15,
        "change_7d":165.53
    },
    "sentiments":{
        "positive":{
            "change_24h":5.88,
            "change_7d":-5.26
        },
        "neutral":{
            "change_24h":-1.92,
            "change_7d":4.08
        },
        "negative":{
            "change_24h":-7.14,
            "change_7d":100.0
        }
    },
    "metadata":{
        "symbol":"LTC",
        "date":"2021-09-04 13:23:15.534685"
    }
}

Crypto Social Sentiment

Endpoint: https://sennetai.com/api/crypto/social-sentiment/{crypto_symbol}/

Parameters:

since: Start date to make the fetch. Valid date format is %Y-%m-%d (2021-06-30). You can't fetch news older than 15 days
until: End date to make the fetch. Valid date format is %Y-%m-%d (2021-06-30)

To get the social sentiment from a crypto symbol you need to make a GET request.

Request:

https://sennetai.com/api/crypto/social-sentiment/ETH/since=2021-08-29&until=2021-09-08

Response:

{
    "sentiment":{
        "29-08-2021":{
            "neutral":405,
            "negative":85,
            "positive":322
        },
        ...
        "08-09-2021":{
            "neutral":119,
            "negative":36,
            "positive":96
        }
    },
    "scaled_sentiment":{
        "29-08-2021":{
            "neutral":50,
            "negative":10,
            "positive":40
        },
        ...
        "08-09-2021":{
            "neutral":47,
            "negative":14,
            "positive":38
        }
    },
    "metadata":{
        "symbol":"ETH",
        "market":"crypto",
        "timestamp":"2021-09-08 04:47:30.281430"
    }
}
This endpoint reponse may vary based on your plan. Check your plan features here

Errors

{'Error':'Symbol __x__ is not available'}: This error occurs when the requested symbol is not available in our servers.
{'Error': "Can't fetch social sentiment for date older than 15 days"}: This error occurs when the requested date range is older than 15 days.
{"Error":"Invalid date format"}: Since or until dates don't have valid format (%Y-%m-%d).

Crypto Social Volume

Endpoint: https://sennetai.com/api/crypto/social-volume/{crypto_symbol}/

Parameters:

since: Start date to make the fetch. Valid date format is %Y-%m-%d (2021-06-30). You can't fetch news older than 15 days
until: End date to make the fetch. Valid date format is %Y-%m-%d (2021-06-30)

To get the social volume from a crypto symbol you need to make a GET request.

Request:

https://sennetai.com/api/crypto/social-volume/BTC/?since=2021-08-29&until=2021-09-08

Response:

{
    "volume":{
        "29-08-2021":11780,
        "30-08-2021":9680,
        "31-08-2021":11380,
        "01-09-2021":16880,
        "02-09-2021":15560,
        "03-09-2021":25230,
        "04-09-2021":20020,
        "05-09-2021":18760,
        "06-09-2021":17710,
        "07-09-2021":3110,
        "08-09-2021":2520
    },
    "scaled_volume":{
        "29-08-2021":46.69,
        "30-08-2021":38.37,
        "31-08-2021":45.11,
        "01-09-2021":66.9,
        "02-09-2021":61.67,
        "03-09-2021":100.0,
        "04-09-2021":79.35,
        "05-09-2021":74.36,
        "06-09-2021":70.19,
        "07-09-2021":12.33,
        "08-09-2021":9.99
    },
    "metadata":{
        "symbol":"BTC",
        "market":"crypto",
        "timestamp":"2021-09-08 04:46:48.002185"
    }
}
This endpoint reponse may vary based on your plan. Check your plan features here

Errors

{'Error':'Symbol __x__ is not available'}: This error occurs when the requested symbol is not available in our servers.
{'Error': "Can't fetch social volume for date older than 15 days"}: This error occurs when the requested date range is older than 15 days.
{"Error":"Invalid date format"}: Since or until dates don't have valid format (%Y-%m-%d).

Insiders app

The insiders app API endpoints contain all the endpoints used for the insiders platform. You can check the latest insiders for any company and discover insiders activity metrics.

All Insiders

Endpoint: https://sennetai.com/api/insiders/

Parameters:

since: Start date to make the fetch. Valid date format is %Y-%m-%d (2021-06-30). You can't fetch insiders older than 7 days. Default is today insiders.
until: End date to make the fetch. Valid date format is %Y-%m-%d (2021-06-30). Default is today insiders.

To get all the insiders for a given date you need to make a GET request.

Request:

https://sennetai.com/api/insiders/?since=2021-06-26&until=2021-06-27

Response:

{
    "insiders":[
        {
            "Ticker":"BIGC",
            "Owner":"Alvarez Robert",
            "Relationship":"Chief Financial Officer",
            "Date":"Jun 23",
            "Transaction":"Sale",
            "Cost":"None",
            "#Shares":"6,587",
            "Value ($)":"428,223",
            "#Shares Total":"116,310",
            "SEC Form 4":"Jun 25 05:05 PM",
            "Timestamp":"2021-06-27 00:00:00"
        },
        {
            "Ticker":"MDLA",
            "Owner":"Stretch Leslie",
            "Relationship":"President & CEO",
            "Date":"Jun 24",
            "Transaction":"Option Exercise",
            "Cost":"None",
            "#Shares":"100,000",
            "Value ($)":"673,000",
            "#Shares Total":"963,345",
            "SEC Form 4":"Jun 25 05:03 PM",
            "Timestamp":"2021-06-27 00:00:00"
        },
        {
            "Ticker":"TLYS",
            "Owner":"SHAKED HEZY",
            "Relationship":"See Remarks",
            "Date":"Jun 23",
            "Transaction":"Option Exercise",
            "Cost":"None",
            "#Shares":"41,750",
            "Value ($)":"0",
            "#Shares Total":"101,750",
            "SEC Form 4":"Jun 25 05:01 PM",
            "Timestamp":"2021-06-27 00:00:00"
        },
        ...
    ]
}

Errors

{'Error':'Symbol __x__ is not available'}: This error occurs when the requested symbol is not available in our servers.
{'Error': "Can't fetch stock insiders for date older than 7 days"}: This error occurs when the requested date range is older than 7 days.
{"Error":"Invalid date format"}: Since or until dates don't have valid format (%Y-%m-%d).

Company Insiders

Endpoint: https://sennetai.com/api/insiders/{stock_symbol}/

Parameters:

since: Start date to make the fetch. Valid date format is %Y-%m-%d (2021-06-30). You can't fetch insiders older than 15 days. Default is today insiders.
until: End date to make the fetch. Valid date format is %Y-%m-%d (2021-06-30). Default is today insiders.

To get the insiders from a stock symbol you need to make a GET request.

Request:

https://sennetai.com/api/insiders/?since=2021-06-17&until=2021-06-20

Response:

{
    "insiders":[
        {
            "Ticker":"FB",
            "Owner":"Zuckerberg Mark",
            "Relationship":"COB and CEO",
            "Date":"Jun 16",
            "Transaction":"Sale",
            "Cost":"None",
            "#Shares":"77,300",
            "Value ($)":"25,785,054",
            "#Shares Total":"0",
            "SEC Form 4":"Jun 16 09:38 PM",
            "Timestamp":"2021-06-17 00:00:00"
        },
        {
            "Ticker":"FB",
            "Owner":"Zuckerberg Mark",
            "Relationship":"COB and CEO",
            "Date":"Jun 15",
            "Transaction":"Sale",
            "Cost":"None",
            "#Shares":"77,300",
            "Value ($)":"26,045,687",
            "#Shares Total":"0",
            "SEC Form 4":"Jun 16 09:04 PM",
            "Timestamp":"2021-06-17 00:00:00"
        },
        {
            "Ticker":"FB",
            "Owner":"Zuckerberg Mark",
            "Relationship":"COB and CEO",
            "Date":"Jun 14",
            "Transaction":"Sale",
            "Cost":"None",
            "#Shares":"77,300",
            "Value ($)":"25,859,314",
            "#Shares Total":"0",
            "SEC Form 4":"Jun 16 08:55 PM",
            "Timestamp":"2021-06-17 00:00:00"
        },
        ...
    ]
}

Errors

{'Error':'Symbol __x__ is not available'}: This error occurs when the requested symbol is not available in our servers.
{'Error': "Can't fetch stock insiders for date older than 15 days"}: This error occurs when the requested date range is older than 15 days.
{"Error":"Invalid date format"}: Since or until dates don't have valid format (%Y-%m-%d).

Summary all insiders

Endpoint: https://sennetai.com/api/insiders/summary/

To get the insiders summary for all companies you need to make a GET request.

Request:

https://sennetai.com/api/insiders/summary/

Response:

{
    "buy":747581,
    "sell":163260091,
    "buy_sell_ratio":218.38,
    "top":{
        "largest_buy":{
            "ticker":"BWB",
            "owner":"Hokanson Mark E.",
            "relationship":"CHIEF TECHNOLOGY OFFICER",
            "date":"Aug 17",
            "transaction":"Buy",
            "shares":"6,000",
            "value":"150,000",
            "total_shares":"6,000",
            "sec_form":"Aug 17 05:53 PM",
            "cost":"25.00"
        },
        "largest_sell":{
            "ticker":"SNOW",
            "owner":"Dageville Benoit",
            "relationship":"President of Products",
            "date":"Aug 13",
            "transaction":"Sale",
            "shares":"85,909",
            "value":"24,748,667",
            "total_shares":"5,695,841",
            "sec_form":"Aug 17 09:20 PM",
            "cost":"288.08"
        }
    }
}

Summary company insiders

Endpoint: https://sennetai.com/api/insiders/{stock_symbol}/summary/

To get the insiders summary for a specific company you need to make a GET request.

Request:

https://sennetai.com/api/insiders/BWBb/summary/

Response:

{
    "buy":47560,
    "sell":24748667,
    "buy_sell_ratio":"520.37"
}

Superinvestors app

The superinvestors app API endpoints contain all the endpoints used for the superinvestors platform. You can check the latest superinvestors for any company and discover superinvestors activity metrics.

Today superinvestors

Endpoint: https://sennetai.com/api/super-investors/today/

To get all superinvestors for today you need to make a GET request.

Request:

https://sennetai.com/api/super-investors/today/

Response:

{
"super_investors":[
    {
        "ticker":"AAPL",
        "manager":"Warren Buffett - Berkshire Hathaway",
        "percentage":"41.46",
        "shares":"887,135,554",
        "activity":" ",
        "date":"2021-08-18 00:00:00"
    },
    {
        "ticker":"AAPL",
        "manager":"David Rolfe - Wedgewood Partners",
        "percentage":"7.53",
        "shares":"379,562",
        "activity":"Reduce 4.08%",
        "date":"2021-08-18 00:00:00"
    },
    {
        "ticker":"AMZN",
        "manager":"David Tepper - Appaloosa Management",
        "percentage":"8.90",
        "shares":"125,000",
        "activity":"Reduce 32.80%",
        "date":"2021-08-18 00:00:00"
    },
    ...
]
}

Company superinvestors

Endpoint: https://sennetai.com/api/super-investors/{stock_symbol}/

Parameters:

since: Start date to make the fetch. Valid date format is %Y-%m-%d (2021-06-30). You can't fetch super investors older than 15 days. Default is today insiders.
until: End date to make the fetch. Valid date format is %Y-%m-%d (2021-06-30). Default is today super investors.

To get the super investors from a stock symbol you need to make a GET request.

Request:

https://sennetai.com/api/stocks/super-investors/AAPL/?since=2021-06-20&until=2021-06-22

Response:

{
    "stock_superinvestors":[
        {
            "Ticker":"AAPL",
            "Portfolio Manager":"Warren Buffett - Berkshire Hathaway",
            "% of portfolio":"40.07",
            "Shares":"887,135,554",
            "Recent activity":" ",
            "Date":"2021-06-22 00:00:00"
        },
        {
            "Ticker":"AAPL",
            "Portfolio Manager":"David Rolfe - Wedgewood Partners",
            "% of portfolio":"7.44",
            "Shares":"395,692",
            "Recent activity":"Reduce 11.64%",
            "Date":"2021-06-22 00:00:00"
        },
        {
            "Ticker":"AAPL",
            "Portfolio Manager":"Li Lu - Himalaya Capital Management",
            "% of portfolio":"4.69",
            "Shares":"759,600",
            "Recent activity":" ",
            "Date":"2021-06-22 00:00:00"
        },
        ...
    ]
}

Errors

{'Error':'Symbol __x__ is not available'}: This error occurs when the requested symbol is not available in our servers.
{'Error': "Can't fetch stock super investors for date older than 15 days"}: This error occurs when the requested date range is older than 15 days.
{"Error":"Invalid date format"}: Since or until dates don't have valid format (%Y-%m-%d).

Summary today superinvestors

Endpoint: https://sennetai.com/api/super-investors/today/summary/

To get all superinvestors summary for today you need to make a GET request.

Request:

https://sennetai.com/api/super-investors/today/summary/

Response:

{
"summary":[
    {
        "AAPL":{
            "largest_holder":{
                "ticker":"AAPL",
                "manager":"Warren Buffett - Berkshire Hathaway",
                "percentage":"41.46",
                "shares":"887,135,554",
                "activity":" ",
                "date":"2021-08-18 00:00:00"
            },
            "total_shares_holded":893964078
        }
    },
    {
        "AMZN":{
            "largest_holder":{
                "ticker":"AMZN",
                "manager":"Polen Capital Management",
                "percentage":"4.59",
                "shares":"696,883",
                "activity":"Add 7.95%",
                "date":"2021-08-18 00:00:00"
            },
            "total_shares_holded":3717355
        }
    },
    {
        "FB":{
            "largest_holder":{
                "ticker":"FB",
                "manager":"Polen Capital Management",
                "percentage":"8.65",
                "shares":"12,987,444",
                "activity":"Add 3.92%",
                "date":"2021-08-18 00:00:00"
            },
            "total_shares_holded":48423809
        }
    }
]
}

Summary company superinvestors

Endpoint: https://sennetai.com/api/super-investors/{stock_symbol}/summary/

To get the superinvestors summary for a specific stock symbol you need to make a GET request.

Request:

https://sennetai.com/api/super-investors/FB/summary/

Response:

{
"FB":{
    "largest_holder":{
        "ticker":"FB",
        "manager":"Polen Capital Management",
        "percentage":"8.65",
        "shares":"12,987,444",
        "activity":"Add 3.92%",
        "date":"2021-08-18 00:00:00"
    },
    "total_shares_holded":48423809
}
}

Reports app

The reports app API endpoints contain all the endpoints used for the reports platform. You can discover the latest SEC filings for any company and check quick summaries for each report.

Latest filings

Endpoint: https://sennetai.com/api/company-filings/latest/

To get the the latest filings you need to make a GET request.

Request:

https://sennetai.com/api/company-filings/latest/

Response:

{
"latest_filings":[
    {
        "name":"SmartStop Self Storage REIT, Inc.",
        "form":"10-Q",
        "date":"2021-08-13",
        "url":"https://www.sec.gov/Archives/edgar/data/1585389/000156459021044259/ck1585389-ex311_7.htm"
    },
    {
        "name":"GUGGENHEIM CREDIT INCOME FUND 2019",
        "form":"10-Q",
        "date":"2021-08-13",
        "url":"https://www.sec.gov/Archives/edgar/data/1618696/000161869621000031/gcif2019q22021form10-q.htm"
    },
    {
        "name":"Altitude Acquisition Corp.",
        "form":"10-Q",
        "date":"2021-08-13",
        "url":"https://www.sec.gov/Archives/edgar/data/1822366/000119312521246166/d199122dex311.htm"
    },
    {
        "name":"NIE ZENON S",
        "form":"4",
        "date":"2021-08-13",
        "url":"https://www.sec.gov/Archives/edgar/data/25895/000120919121051454/xslF345X03/doc4.xml"
    },
    ...
]
}

Latest company filings

Endpoint: https://sennetai.com/api/company-filings/{stock_symbol}/

To get the the filings for a specific public company you need to make a GET request.

Request:

https://sennetai.com/api/company-filings/AAPL/

Response:

{
"company_filings":[
    {
        "name":"Apple Inc.",
        "form":"10-Q",
        "date":"2021-07-28",
        "url":"https://www.sec.gov/Archives/edgar/data/320193/000032019321000065/a10-qexhibit31106262021.htm"
    },
    {
        "name":"Apple Inc.",
        "form":"424B2",
        "date":"2021-07-29",
        "url":"https://www.sec.gov/Archives/edgar/data/320193/000119312521228285/d175814d424b2.htm"
    },
    {
        "name":"Apple Inc.",
        "form":"424B2",
        "date":"2021-07-30",
        "url":"https://www.sec.gov/Archives/edgar/data/320193/000119312521231584/d175814d424b2.htm"
    },
    ...
]
}

Copyright ©2021 | Sennet AI