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 sentiment 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). You can fetch up to 365 days of historical data.
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). You can fetch up to 365 days of historical data.
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). You can fetch up to 365 days of historical data.
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). You can fetch up to 365 days of historical data.
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).

Insiders app

Here you can find the documentation for all the insider endpoints available in this API. You can check the latest insider transactions for any stock symbol, discover the latest trends or get historical data.

All Insiders

GET /api/insiders/

Parameters

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

The Insider object

ticker string
Company stock symbol.
owner string
Owner of the stock.
relationship string
Relationship with the company.
date string
Date of the transaction.
transaction string
Transaction type
shares string
Number of shares in the transaction.
value string
Value of the shares in the transaction.
total_shares string
Total shares of the owner.
sec_form string
Date of the SEC form.
timestamp string
Timestamp of the request.
cost string
Transaction cost.

Request:

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

Response:

{
"insiders":[
    {
        "ticker":"GAN",
        "owner":"Smurfit Dermot S.",
        "relationship":"President, CEO",
        "date":"Oct 20",
        "transaction":"Option Exercise",
        "shares":"250",
        "value":"4,125",
        "total_shares":"1,899,782",
        "sec_form":"Oct 22 09:55 PM",
        "timestamp":"2021-10-23 00:00:00",
        "cost":"16.50"
    },
    ...
    {
        "ticker":"SITM",
        "owner":"VASHIST RAJESH",
        "relationship":"Chief Executive Officer",
        "date":"Oct 20",
        "transaction":"Sale",
        "shares":"5,000",
        "value":"1,110,750",
        "total_shares":"573,892",
        "sec_form":"Oct 22 04:16 PM",
        "timestamp":"2021-10-23 00:00:00",
        "cost":"222.15"
    }
]}

Company Insiders

GET /api/insiders/{stock_symbol}/

Parameters

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

The Insider object

ticker string
Company stock symbol.
owner string
Owner of the stock.
relationship string
Relationship with the company.
date string
Date of the transaction.
transaction string
Transaction type
shares string
Number of shares in the transaction.
value string
Value of the shares in the transaction.
total_shares string
Total shares of the owner.
sec_form string
Date of the SEC form.
timestamp string
Timestamp of the request.
cost string
Transaction cost.

Request:

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

Response:

{
"insiders":[
    {
        "ticker":"FB",
        "owner":"Zuckerberg Mark",
        "relationship":"COB and CEO",
        "date":"Jun 16",
        "transaction":"Sale",
        "shares":"77,300",
        "value":"25,785,054",
        "total_shares":"0",
        "sec_form":"Jun 16 09:38 PM",
        "timestamp":"2021-06-17 00:00:00",
        "cost":"334"
    },
    ...
    {
        "ticker":"FB",
        "owner":"Zuckerberg Mark",
        "relationship":"COB and CEO",
        "date":"Jun 14",
        "transaction":"Sale",
        "shares":"7,300",
        "value":"2,578,505",
        "total_shares":"0",
        "sec_form":"Jun 14 08:55 PM",
        "timestamp":"2021-06-15 00:00:00",
        "cost":"334"
    }
]}

Summary all insiders

GET /api/insiders/summary/

Parameters

timestamp optional
Period of the summary, valid values are '24h' (latest 24h), '7d' (one week) and '1m' (one month). Defaul to '24h'
buy number
Total amount bought in dollars.
sell number
Total amount sold in dollars.
buy_sell_ratio number
Buy sell ratio of insider transactions.
top object
Top insider transactions.
largest_buy object
Largest buy transaction.
ticker string
Company stock symbol.
owner string
Owner of the stock.
relationship string
Relationship with the company.
date string
Date of the transaction.
transaction string
Transaction type
shares string
Number of shares in the transaction.
value string
Value of the shares in the transaction.
total_shares string
Total shares of the owner.
sec_form string
Date of the SEC form.
timestamp string
Timestamp of the request.
cost string
Transaction cost.
largest_sell object
Largest sell transaction.
ticker string
Company stock symbol.
owner string
Owner of the stock.
relationship string
Relationship with the company.
date string
Date of the transaction.
transaction string
Transaction type
shares string
Number of shares in the transaction.
value string
Value of the shares in the transaction.
total_shares string
Total shares of the owner.
sec_form string
Date of the SEC form.
timestamp string
Timestamp of the request.
cost string
Transaction cost.

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":"CTO",
        "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

GET /api/insiders/{stock_symbol}/summary/

buy number
Total amount bought in dollars.
sell number
Total amount sold in dollars.
buy_sell_ratio number
Buy sell ratio of insider transactions.

Request:

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

Response:

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

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

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