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.

Social sentiment app

Here you can find the documentation for all the social sentiment endpoints available in this API. You can check the current social senitment for any stock or cryptocurrency, discover the latest trends or get historical data.

Stock Social Overview

GET /api/social/stocks/overview/

Social sentiment data is updated every 10 minutes

Parameters:

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

The Overview object

current_sentiment object
Current sentiment object

sentiment string
Current sentiment on social media. It can be "positive", "neutral" or "negative".

value number
Averaged value of the current sentiment. This value can go from -1 to 1, being -1 full negative and 1 full positive.

volume object
Volume object.

change_24h number
Percentage change of the social media volume in the last 24 hours.

change_7d number
Percentage change of the social media volume in the last 7 days.

sentiments object
Sentiments object.

positive object
Positive sentiment object.

change_24h number
Percentage change of the positive sentiment on social media in the last 24 hours.

change_7d number
Percentage change of the positive sentiment on social media in the last 7 days.

neutral object
Neutral sentiment object.

change_24h number
Percentage change of the neutral sentiment on social media in the last 24 hours.

change_7d number
Percentage change of the neutral sentiment on social media in the last 7 days.

negative object
Negative sentiment object.

change_24h number
Percentage change of the negative sentiment on social media in the last 24 hours.

change_7d number
Percentage change of the negative sentiment on social media in the last 7 days.

metadata object
General information about the request.

symbol string
The symbol requested.

date string
Timestamp of the response.

Request:

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

Response:

{
        "current_sentiment":{
            "sentiment":"positive",
            "value":0.64
        },
        "volume":{
            "change_24h":-60.72,
            "change_7d":-73.81
        },
        "sentiments":{
            "positive":{
                "change_24h":25.86,
                "change_7d":7.35
            },
            "neutral":{
                "change_24h":-48.57,
                "change_7d":20.0
            },
            "negative":{
                "change_24h":12.5,
                "change_7d":-50.0
            }
        },
        "metadata":{
            "symbol":"TSLA",
            "updated_at":"2021-09-24 09:52:28"
        }
    }

Stock Social Sentiment

GET /api/stocks/social-sentiment/{stock_symbol}/

Social sentiment data is updated every 10 minutes

Parameters:

since: Start date to make the fetch. Valid date format is %Y-%m-%d (2021-06-30). The historical data limit depends on your plan, check your plan features here.
until: End date to make the fetch. Valid date format is %Y-%m-%d (2021-06-30)

The Overview object

sentiment object
Contains all the dates requested with real sentiment data

date string
Sentiment object for that date

neutral number
Real number of posts and comments with neutral sentiment.

negative number
Real number of posts and comments with negative sentiment.

positive number
Real number of posts and comments with positive sentiment.

scaled_sentiment object
Contains all the dates requested with scaled sentiment data

date string
Scaled sentiment object for that date. Sentiment data is scaled in range 0 to 100.

neutral number
Scaled number of posts and comments with neutral sentiment.

negative number
Scaled number of posts and comments with negative sentiment.

positive number
Scaled number of posts and comments with positive sentiment.

metadata object
General information about the request.

symbol string
The symbol requested.

date string
Timestamp of the response.

market string
Market of the symbol requested. Market can be "stocks" or "crypto".

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"
    }
}
This endpoint reponse may vary based on your plan. Check your plan features here

Errors

{'Error':'Symbol __x__ is not available'}: The requested symbol is not available in our servers.
{'Error': "Can't fetch social sentiment for date older than x days"}: The requested date range is older than your plan historical data limit.
{"Error":"Invalid date format"}: Since or until dates don't have valid format (%Y-%m-%d).

Stock Social Volume

GET /api/stocks/social-volume/{stock_symbol}/

Social sentiment data is updated every 10 minutes

Parameters:

since: Start date to make the fetch. Valid date format is %Y-%m-%d (2021-06-30). The historical data limit depends on your plan, check your plan features here.
until: End date to make the fetch. Valid date format is %Y-%m-%d (2021-06-30)

volume object
Contains all the dates requested with real volume data

date string
Volume for that date

value number
Real volume in social media.

scaled_volume object
Contains all the dates requested with scaled volume data

date string
Scaled volume for that date. Volume data is scaled in range 0 to 100.

value number
Scaled volume in social media.

metadata object
General information about the request.

symbol string
The symbol requested.

date string
Timestamp of the response.

market string
Market of the symbol requested. Market can be "stocks" or "crypto".

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'}: The requested symbol is not available in our servers.
{'Error': "Can't fetch social volume for date older than __x__ days"}: The requested date range is older than your plan historical data limit.
{"Error":"Invalid date format"}: Since or until dates don't have valid format (%Y-%m-%d).

Crypto Social Overview

GET /api/social/crypto/overview/

Social sentiment data is updated every 10 minutes

Parameters:

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

current_sentiment object
Current sentiment object

sentiment string
Current sentiment on social media. It can be "positive", "neutral" or "negative".

value number
Averaged value of the current sentiment. This value can go from -1 to 1, being -1 full negative and 1 full positive.

volume object
Volume object.

change_24h number
Percentage change of the social media volume in the last 24 hours.

change_7d number
Percentage change of the social media volume in the last 7 days.

sentiments object
Sentiments object.

positive object
Positive sentiment object.

change_24h number
Percentage change of the positive sentiment on social media in the last 24 hours.

change_7d number
Percentage change of the positive sentiment on social media in the last 7 days.

neutral object
Neutral sentiment object.

change_24h number
Percentage change of the neutral sentiment on social media in the last 24 hours.

change_7d number
Percentage change of the neutral sentiment on social media in the last 7 days.

negative object
Negative sentiment object.

change_24h number
Percentage change of the negative sentiment on social media in the last 24 hours.

change_7d number
Percentage change of the negative sentiment on social media in the last 7 days.

Request:

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

Response:

{
    "current_sentiment":{
        "sentiment":"negative",
        "value":0
    },
    "volume":{
        "change_24h":100.0,
        "change_7d":300.0
    },
    "sentiments":{
        "positive":{
            "change_24h":105.0,
            "change_7d":37.0
        },
        "neutral":{
            "change_24h":100.0,
            "change_7d":15.9,
        },
        "negative":{
            "change_24h":12.0,
            "change_7d":200.0
        }
    },
    "metadata":{
        "symbol":"LTC",
        "updated_at":"2021-09-24 09:54:15"
    }
}

Crypto Social Sentiment

GET /api/crypto/social-sentiment/{crypto_symbol}/

Social sentiment data is updated every 10 minutes

Parameters:

since: Start date to make the fetch. Valid date format is %Y-%m-%d (2021-06-30). The historical data limit depends on your plan, check your plan features here.
until: End date to make the fetch. Valid date format is %Y-%m-%d (2021-06-30)

sentiment object
Contains all the dates requested with real sentiment data

date string
Sentiment object for that date

neutral number
Real number of posts and comments with neutral sentiment.

negative number
Real number of posts and comments with negative sentiment.

positive number
Real number of posts and comments with positive sentiment.

scaled_sentiment object
Contains all the dates requested with scaled sentiment data

date string
Scaled sentiment object for that date. Sentiment data is scaled in range 0 to 100.

neutral number
Scaled number of posts and comments with neutral sentiment.

negative number
Scaled number of posts and comments with negative sentiment.

positive number
Scaled number of posts and comments with positive sentiment.

metadata object
General information about the request.

symbol string
The symbol requested.

date string
Timestamp of the response.

market string
Market of the symbol requested. Market can be "stocks" or "crypto".

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'}: The requested symbol is not available in our servers.
{'Error': "Can't fetch social sentiment for date older than __x__ days"}: The requested date range is older than your plan historical data limit.
{"Error":"Invalid date format"}: Since or until dates don't have valid format (%Y-%m-%d).

Crypto Social Volume

GET /api/crypto/social-volume/{crypto_symbol}/

Social sentiment data is updated every 10 minutes

Parameters:

since: Start date to make the fetch. Valid date format is %Y-%m-%d (2021-06-30). The historical data limit depends on your plan, check your plan features here.
until: End date to make the fetch. Valid date format is %Y-%m-%d (2021-06-30)

volume object
Contains all the dates requested with real volume data

date string
Volume for that date

value number
Real volume in social media.

scaled_volume object
Contains all the dates requested with scaled volume data

date string
Scaled volume for that date. Volume data is scaled in range 0 to 100.

value number
Scaled volume in social media.

metadata object
General information about the request.

symbol string
The symbol requested.

date string
Timestamp of the response.

market string
Market of the symbol requested. Market can be "stocks" or "crypto".

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'}: The requested symbol is not available in our servers.
{'Error': "Can't fetch social volume for date older than __x__ days"}: The requested date range is older than your plan historical data limit.
{"Error":"Invalid date format"}: Since or until dates don't have valid format (%Y-%m-%d).

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
    }
}

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