Getting Started

Introduction

Our API provides global stock market data including real-time, intraday and historical data, plus near real-time and historical crypto and forex data.

Business + stock market news and analysis APIs are also available which can be used to create news feeds. News feed APIs can be filtered with numerous criteria, including symbol, type, exchange, industry, country and much more.

Our news data allow us to identify which stocks are trending (i.e. mentioned more frequently than normal) and identify best and worst performing stocks based on sentiment, all of which is available from our market news analysis endpoints.

We support over 5,000 news sources globally in over 30 languages, tracking over 150,000 entities every minute from over 70 markets worldwide.

To get started simply sign up and use your API token in any of the available API endpoints documented below for instant access.

If you have any questions or concerns, feel free to contact us.

Authentication

When you sign up for free you will find your API token on your dashboard. Simply add this to any of our API endpoints as a GET parameter to gain access. Examples of how this is done can be found below.

API Endpoints

Stock Data

Real-time stock quotes Available on: All plans

Endpoint

            
                GET https://api.stockdata.org/v1/data/quote HTTP/1.1
            
        

Get the latest quotes for all US stocks using this endpoint, updated live from trade reports. Also includes pre and post market data (see extended_hours parameter).

HTTP GET Parameters

name required description
api_token true Your API token which can be found on your account dashboard.
symbols true Specify symbol(s) to return data for. See limits on symbols per request on our pricing page.
Example: symbols=AAPL,TSLA,MSFT
extended_hours false Include pre and post market data when set to true.
key_by_ticker false Key each quote by the ticker/symbol.
include_metadata false Optionally include/exclude metadata with each quote. Setting this to false may slightly improve response times.
Default: true

Response Objects

name description
meta > requested The number of symbols requested.
meta > returned The number of symbols returned.
data > ticker The symbol/ticker of the quote.
data > name The name of the stock.
data > exchange_short The listing exchange of the stock (short code).
data > exchange_long The listing exchange of the stock (full name).
data > mic_code The exchanges ISO 10383 market identifier code.
data > currency Currency of the stock.
data > price Last trade price.
data > day_high Highest trade price that day.
data > day_low Lowest trade price that day.
data > day_open Opening price.
data > 52_week_high Highest trade price in the past 52 weeks.
data > 52_week_low Lowest trade price in the past 52 weeks.
data > market_cap Market cap of the stock.
data > previous_close_price Previous close price.
data > previous_close_price_time Time of the previous close price (local time).
data > day_change Percentage difference between price and previous_close_price.
data > volume Total of all trades for the stock.
data > is_extended_hours_price Boolean to identify if the quote is provided from extended hours data.
data > last_trade_time The time the last trade was identified (local time).

If no results are found, the data object will be empty.

Example Request

            
                GET https://api.stockdata.org/v1/data/quote?symbols=AAPL%2CTSLA%2CMSFT&api_token=YOUR_API_TOKEN
            
        

Example Response

            
                {
    "meta": {
        "requested": 3,
        "returned": 3
    },
    "data": [
        {
            "ticker": "TSLA",
            "name": "Tesla Inc",
            "exchange_short": "NASDAQ",
            "exchange_long": "NASDAQ Stock Exchange",
            "mic_code": "XNAS",
            "currency": "USD",
            "price": 681.9,
            "day_high": 690.48,
            "day_low": 666.49,
            "day_open": 681,
            "52_week_high": 1243.49,
            "52_week_low": 620.46,
            "market_cap": 684694372352,
            "previous_close_price": 673.99,
            "previous_close_price_time": "2022-06-30T16:00:00.000000",
            "day_change": 1.16,
            "volume": 655631,
            "is_extended_hours_price": false,
            "last_trade_time": "2022-07-01T15:59:59.000000"
        },
        {
            "ticker": "AAPL",
            "name": "Apple Inc",
            "exchange_short": "NASDAQ",
            "exchange_long": "NASDAQ Stock Exchange",
            "mic_code": "XNAS",
            "currency": "USD",
            "price": 138.9,
            "day_high": 139.02,
            "day_low": 135.7,
            "day_open": 136.05,
            "52_week_high": 182.94,
            "52_week_low": 129.04,
            "market_cap": 2279341031424,
            "previous_close_price": 137,
            "previous_close_price_time": "2022-06-30T15:59:59.000000",
            "day_change": 1.37,
            "volume": 1373007,
            "is_extended_hours_price": false,
            "last_trade_time": "2022-07-01T15:59:59.000000"
        },
        {
            "ticker": "V",
            "name": "Visa Inc",
            "exchange_short": "NYSE",
            "exchange_long": "New York Stock Exchange",
            "mic_code": "XNYS",
            "currency": "USD",
            "price": 199.39,
            "day_high": 199.77,
            "day_low": 194.75,
            "day_open": 196.62,
            "52_week_high": 252.67,
            "52_week_low": 185.91,
            "market_cap": null,
            "previous_close_price": 197.07,
            "previous_close_price_time": "2022-06-30T15:59:59.000000",
            "day_change": 1.16,
            "volume": 179962,
            "is_extended_hours_price": false,
            "last_trade_time": "2022-07-01T15:59:58.000000"
        }
    ]
}
            
        

Intraday data Available on: All plans

Endpoint

            
                GET https://api.stockdata.org/v1/data/intraday HTTP/1.1
            
        

Get the latest intraday data for all US stocks using this endpoint, updated live from trade reports. Also includes pre and post market data (see extended_hours parameter). You can also obtain 5+ years of historical intraday data using this endpoint. Note that historical intraday data is not currently split or dividend adjusted.

HTTP GET Parameters

name required description
api_token true Your API token which can be found on your account dashboard.
symbols true Specify symbol(s) to return data for. See limits on symbols per request on our pricing page.
Example: symbols=AAPL
interval false Specify the interval at which you want to retrieve data.
Options: minute | hour | day | week | month | quarter | year
Default interval=minute

IMPORTANT: the max range for minute interval is 7 days and 180 days for the hour interval due to these intervals retrieving a lot of data. If the range from the date_from and date_to parameters is larger than these limits, the max interval will be applied starting at the date_from parameter. If the date parameters are omitted the max range will be applied.
sort false Specify the sort order by date.
Options: asc | desc
Default desc
date_from false Find all data after the specified date. Supported formats include: Y-m-d | Y-m | Y.
Examples: 2022-07-03 | 2022-07 | 2022
date_to false Find all data before the specified date. Supported formats include: Y-m-d | Y-m | Y.
Examples: 2022-07-03 | 2022-07 | 2022
date false Find all data on the specified date. Supported formats include: Y-m-d.
Example: 2022-07-03
extended_hours false Include pre and post market data when set to true.
key_by_date false Key each result by date/time.
key_by_ticker false Key each quote by the ticker/symbol.

Response Objects

name description
meta > date_from Date that data was collected from.
meta > date_to Date that data was collected to. This will be overridden if the interval max period is exceeded.
meta > max_period_days Max period in days depending on the interval. Will return null if no max period is specified for the interval.
data > date Date of the related data (local time).
data > ticker The symbol/ticker of the quote.
data > data > open Open price for the specified date/time range.
data > data > high Highest price for the specified date/time range.
data > data > low Lowest price for the specified date/time range.
data > data > close Close price for the specified date/time range.
data > data > volume Trading volume for the specified date/time range.
data > data > is_extended_hours Specifies if the open price in the time frame is a pre/post trading hours price. Mainly useful for the minute interval.

If no results are found, the data object will be empty.

Example Request

            
                GET https://api.stockdata.org/v1/data/intraday?symbols=AAPL&api_token=YOUR_API_TOKEN
            
        

Example Response

            
                {
    "meta": {
        "date_from": "2022-06-30",
        "date_to": "2022-07-03",
        "max_period_days": 7
    },
    "data": [
        {
            "date": "2022-07-01T15:59:00.000Z",
            "ticker": "AAPL",
            "data": {
                "open": 138.92,
                "high": 139.02,
                "low": 138.84,
                "close": 138.91,
                "volume": 46724,
                "is_extended_hours": false
            }
        },
        {
            "date": "2022-07-01T15:58:00.000Z",
            "ticker": "AAPL",
            "data": {
                "open": 138.78,
                "high": 138.95,
                "low": 138.78,
                "close": 138.87,
                "volume": 14341,
                "is_extended_hours": false
            }
        },
        {
            "date": "2022-07-01T15:57:00.000Z",
            "ticker": "AAPL",
            "data": {
                "open": 138.7,
                "high": 138.8,
                "low": 138.68,
                "close": 138.79,
                "volume": 10003,
                "is_extended_hours": false
            }
        },
        {
            "date": "2022-07-01T15:56:00.000Z",
            "ticker": "AAPL",
            "data": {
                "open": 138.64,
                "high": 138.77,
                "low": 138.63,
                "close": 138.68,
                "volume": 13643,
                "is_extended_hours": false
            }
        },
        {
            "date": "2022-07-01T15:55:00.000Z",
            "ticker": "AAPL",
            "data": {
                "open": 138.57,
                "high": 138.73,
                "low": 138.5,
                "close": 138.61,
                "volume": 9691,
                "is_extended_hours": false
            }
        },
        ...
    ]
}
            
        

End-of-day historical data Available on: All plans

Endpoint

            
                GET https://api.stockdata.org/v1/data/eod HTTP/1.1
            
        

Get 40+ years of historical end of day data for 70+ exchanges, adjusted for splits.
This endpoint also supports crypto and forex history.

HTTP GET Parameters

name required description
api_token true Your API token which can be found on your account dashboard.
symbols true Specify symbol to return data for.
Example: symbols=AAPL
sort false Specify the sort order by date.
Options: asc | desc
Default desc
date_from false Find all data after the specified date. Supported formats include: Y-m-d | Y-m | Y.
Examples: 2022-07-03 | 2022-07 | 2022
date_to false Find all data before the specified date. Supported formats include: Y-m-d | Y-m | Y.
Examples: 2022-07-03 | 2022-07 | 2022
date false Find all data on the specified date. Supported formats include: Y-m-d.
Example: 2022-07-03
key_by_date false Key each result by date/time.

Response Objects

name description
meta > ticker The symbol/ticker of the history data.
meta > name The symbol/ticker of the history data.
meta > exchange > exchange_short The listing exchange of the stock (short code).
meta > exchange > exchange_long The listing exchange of the stock (full name).
meta > exchange > mic_code The exchanges ISO 10383 market identifier code.
meta > exchange > country Country of the symbol/ticker listing exchange.
meta > exchange > timezone_name Timezone of the symbol/ticker listing exchange.
data > date Date of the related data.
data > open Open price for the specified date/time range.
data > high Highest price for the specified date/time range.
data > low Lowest price for the specified date/time range.
data > close Close price for the specified date/time range.
data > volume Trading volume for the specified date/time range.

If no results are found, the data object will be empty.

Example Request

            
                GET https://api.stockdata.org/v1/data/eod?symbols=AAPL&api_token=YOUR_API_TOKEN
            
        

Example Response

            
                {
    "meta": {
        "ticker": "AAPL",
        "name": "Apple Inc",
        "exchange": {
            "exchange_short": "NASDAQ",
            "exchange_long": "NASDAQ Stock Exchange",
            "mic_code": "XNAS",
            "country": "us",
            "timezone_name": "America/New_York"
        },
        "found": 10479,
        "returned": 10479
    },
    "data": [
        {
            "date": "2022-07-01T16:00:00.000000Z",
            "open": 136.04,
            "high": 139.04,
            "low": 135.66,
            "close": 138.93,
            "volume": 71051552
        },
        {
            "date": "2022-06-30T16:00:00.000000Z",
            "open": 137.25,
            "high": 138.37,
            "low": 133.77,
            "close": 136.72,
            "volume": 98964467
        },
        {
            "date": "2022-06-29T16:00:00.000000Z",
            "open": 137.46,
            "high": 140.67,
            "low": 136.67,
            "close": 139.23,
            "volume": 66242411
        },
        {
            "date": "2022-06-28T16:00:00.000000Z",
            "open": 142.13,
            "high": 143.42,
            "low": 137.32,
            "close": 137.44,
            "volume": 67315328
        },
        {
            "date": "2022-06-27T16:00:00.000000Z",
            "open": 142.7,
            "high": 143.49,
            "low": 140.97,
            "close": 141.66,
            "volume": 70207908
        },
        ...
    ]
}
            
        

End-of-day multiple Available on: All plans

Endpoint

            
                GET https://api.stockdata.org/v1/data/eod/multiple HTTP/1.1
            
        

Get end-of-day data based on a specific date, or omit the date parameter to get the latest value available.
This endpoint also supports crypto and forex history.

The symbol limits for this endpoint are the same as the real-time quote endpoint.

HTTP GET Parameters

name required description
api_token true Your API token which can be found on your account dashboard.
symbols true Specify symbols to return data for.
Example: symbols=AAPL,TSLA,MSFT
date false Find data on the specified date. Supported formats include: Y-m-d.
Example: 2022-07-03

Response Objects

name description
meta > requested The number of symbols requested.
meta > returned The number of symbols requested.
data > ticker Ticker of the related data.
data > date Date of the related data.
data > open Open price for the specified date/time range.
data > high Highest price for the specified date/time range.
data > low Lowest price for the specified date/time range.
data > close Close price for the specified date/time range.
data > volume Trading volume for the specified date/time range.

If no results are found, the data object will be empty.

Example Request

            
                GET https://api.stockdata.org/v1/data/eod/multiple?symbols=AAPL%2CTSLA%2CMSFT&api_token=YOUR_API_TOKEN
            
        

Example Response

            
                {
    "meta": {
        "found": 3,
        "returned": 3
    },
    "data": [
        {
            "symbol": "TSLA",
            "date": "2022-07-01T16:00:00.000000Z",
            "open": 681,
            "high": 690.69,
            "low": 666.36,
            "close": 681.79,
            "volume": 24820148
        },
        {
            "symbol": "MSFT",
            "date": "2022-07-01T16:00:00.000000Z",
            "open": 256.39,
            "high": 259.77,
            "low": 254.61,
            "close": 259.58,
            "volume": 22837692
        },
        {
            "symbol": "AAPL",
            "date": "2022-07-01T16:00:00.000000Z",
            "open": 136.04,
            "high": 139.04,
            "low": 135.66,
            "close": 138.93,
            "volume": 71051552
        }
    ]
}
            
        

Crypto and Forex Data

Real-time crypto and forex quotes Available on: All plans

Endpoint

            
                GET https://api.stockdata.org/v1/data/currency/latest HTTP/1.1
            
        

Get the latest crypto and forex quotes, near real time.

HTTP GET Parameters

name required description
api_token true Your API token which can be found on your account dashboard.
symbols true Specify symbol(s) to return data for. See limits on symbols per request on our pricing page.
Example: symbols=BTCUSD,USDGBP

Response Objects

name description
meta > requested The number of symbols requested.
meta > returned The number of symbols returned.
data > symbol The symbol of the currency quote.
data > price Last trade price.
data > day_open Opening price.
data > day_high Highest trade price that day.
data > day_low Lowest trade price that day.
data > 52_week_high Highest trade price in the past 52 weeks.
data > 52_week_low Lowest trade price in the past 52 weeks.
data > change_percent Percentage difference between price and previous_close_price.
data > previous_close_price Previous close price.
data > volume Total of all trades for the currency (crypto only).
data > market_cap Market cap of the currency (crypto only).
data > last_update The time the last time the quote was updated.

If no results are found, the data object will be empty.

Example Request

            
                GET https://api.stockdata.org/v1/data/currency/latest?symbols=BTCUSD%2CUSDGBP&api_token=YOUR_API_TOKEN
            
        

Example Response

            
                {
    "meta": {
        "requested": 2,
        "returned": 2
    },
    "data": [
        [
            {
                "symbol": "BTCUSD",
                "price": 19097.52,
                "day_open": 19246.56,
                "day_high": 19288.025,
                "day_low": 18975.354,
                "52_week_high": 68789.625,
                "52_week_low": 17708.623,
                "change_percent": -0.771783,
                "previous_close_price": 19246.56,
                "volume": 16498146304,
                "market_cap": 364455886848,
                "last_update": "2022-07-03T12:18:00.000000Z"
            }
        ],
        [
            {
                "symbol": "USDGBP",
                "price": 0.82624,
                "day_open": 0.82137,
                "day_high": 0.835,
                "day_low": 0.82126,
                "52_week_high": 0.835,
                "52_week_low": 0.7151,
                "change_percent": 0.596583,
                "previous_close_price": 0.82134,
                "volume": 0,
                "market_cap": 0,
                "last_update": "2022-07-01T21:29:25.000000Z"
            }
        ]
    ]
}
            
        

EOD crypto and forex data Available on: All plans

End of day crypto and forex data is available from the stock end-of-day data endpoint.

News Feeds

Finance & Market News Available on: All plans

Endpoint

            
                GET https://api.stockdata.org/v1/news/all HTTP/1.1
            
        

Get all the latest global financial news and filter by entities identified within articles to build concise news feeds. Also provided is analysis of each entity identified in articles. Note that not every article may have entities identified. To retrieve all news for articles with identified entities, use the parameter must_have_entities, or specify any of the entity params such as symbols or exchanges as defined below to produce more concise results.

All news dates are returned as UTC +0.

HTTP GET Parameters

name required description
api_token true Your API token which can be found on your account dashboard.
symbols false Specify entity symbol(s) which have been identified within the article. Find entity symbols in our entity search endpoint.
Example: symbols=TSLA,AMZN,MSFT
exchanges false Specify exchange(s) of entities which have been identified within the article. Find exchanges in our exchanges metadata endpoint.
Example: exchanges=NASDAQ,NYSE
entity_types false Specify the type of entities which have been identified within the article. Find entity types in our entity type metadata endpoint.
Example: entity_types=index,equity
industries false Specify the industries of entities which have been identified within the article. Find entity types in our entity industry metadata endpoint.
Example: industries=Technology,Industrials
countries false Specify the country of the exchange of which entities have been identified within the article. Find countries as part of our entity exchanges metadata endpoint.
Example: countries=us,ca
sentiment_gte false Use this to find all articles with entities with a sentiment_score of greater than or equal to x.
Example: sentiment_gte=0 - this will find all articles which are neutral or positive

Sentiment is between -1 and +1. Anything 0 = neutral, above 0 = positive, below 0 = negative. The higher or lower the sentiment score the more positive or negative it is identified as.
sentiment_lte false Use this to find all articles with entities with a sentiment_score of less than or equal to x.
Example: sentiment_lte=0 - this will find all articles which are neutral or negative
min_match_score false Use this to find all articles with entities with a match_score of geater than or equal to min_match_score.
filter_entities false By default all entities for each article are returned - by setting this to true, only the relevant entities to your query will be returned with each article. For example, if you set symbols=TSLA and filter_entities=true, only "TSLA" entities will be returned with the articles.
Default: false
must_have_entities false By default all articles are returned, set this to true to ensure that at least one entity has been identified within the article.
Default: false
group_similar false Group similar articles to avoid displaying multiple articles on the same topic/subject.
Default: true
search false Use the search as a basic search tool by entering regular search terms or it has more advanced usage to build search queries:
+ signifies AND operation
| signifies OR operation
- negates a single token
" wraps a number of tokens to signify a phrase for searching
* at the end of a term signifies a prefix query
( and ) signify precedence
To use one of these characters literally, escape it with a preceding backslash (\).
This searches the full body of the text and the title.

Example: "ipo" -nasdaq (searches for articles which must include the string "ipo" but articles must NOT mention Nasdaq.)

For more advanced query examples, see our API Examples section.
domains false Comma separated list of domains to include. List of domains can be obtained through our Sources endpoint, found further down this page.
Example: adweek.com,adage.com
exclude_domains false Comma separated list of domains to exclude
source_ids false Comma separated list of source_ids to include. List of source_ids can be obtained through our Sources endpoint, found further down this page.
Example: adweek.com-1,adage.com-1
exclude_source_ids false Comma separated list of source_ids to exclude.
language false Comma separated list of languages to include. Default is all.
Click here for a list of supported languages.
Examples: en,es (English + Spanish)
published_before false Find all articles published before the specified date. Supported formats include: Y-m-d\TH:i:s | Y-m-d\TH:i | Y-m-d\TH | Y-m-d | Y-m | Y.
Examples: 2022-07-03T12:21:19 | 2022-07-03T12:21 | 2022-07-03T12 | 2022-07-03 | 2022-07 | 2022
published_after false Find all articles published after the specified date. Supported formats include: Y-m-d\TH:i:s | Y-m-d\TH:i | Y-m-d\TH | Y-m-d | Y-m | Y.
Examples: 2022-07-03T12:21:19 | 2022-07-03T12:21 | 2022-07-03T12 | 2022-07-03 | 2022-07 | 2022
published_on false Find all articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2022-07-03
sort false Sort by published_on, entity_match_score, entity_sentiment_score or relevance_score (only available when used in conjunction with search). Default is published_at unless search is used and sorting by published_at is not included, in which case relevance_score is used.
When using entity_match_score, entity_sentiment_score this will sort by the average of the filtered entities (filter_entities does not need to be applied for this).
sort_order false Sort order of the sort parameter. NOTE: this can only be used with sort = entity_match_score or entity_sentiment_score.
Options: desc | asc
Default: desc
limit false Specify the number of articles you want to return in the request. The maximum limit is based on your plan. The default limit is the maximum specified for your plan.
page false Use this to paginate through the result set. Default is 1. Note that the max result set can't exceed 20,000. For example if your limit is 50, the max page you can have is 400 (50 * 400 = 20,000).
Example: page=2

Response Objects

name description
meta > found The number of articles found for the request.
meta > returned The number of articles returned on the page. This is useful to determine the end of the result set as if this is lower than limit, there are no more articles after this page.
meta > limit The limit based on the limit parameter.
meta > page The page number based on the page parameter.
data > uuid The unique identifier for an article in our system. Store this and use it to find specific articles using our single article endpoint.
data > title The article title.
data > description The article meta description.
data > keywords The article meta keywords.
data > snippet A short snippet of the article body.
data > url The URL to the article.
data > image_url The URL to the article image.
data > language The language of the source.
data > published_at The datetime the article was published.
data > source The domain of the source.
data > relevance_score Relevance score based on the search parameter. If the search parameter is not used, this will be null.
data > entities > symbol Symbol of the identified entity.
data > entities > name Name of the identified entity.
data > entities > exchange Exchange identifier of the identified entity.
data > entities > exchange_long Exchange name of the identified entity.
data > entities > country Exchange country of the identified entity.
data > entities > type Type of the identified entity.
data > entities > industry Industry of the identified entity.
data > entities > match_score The overall strength of the matching for the identified entity.
data > entities > sentiment_score Average sentiment of all highlighted text found for the identified entity.
data > entities > highlights > highlight Snippet of text from the article where the entity has been identified.
data > entities > highlights > sentiment The sentiment of the highlighed text.
data > entities > highlights > highlighted_in Where the highlight was found (title | main_text).
data > similar Array of news articles which are very similar to the main article.

If no results are found, the data object will be empty.

Example Request

            
                GET https://api.stockdata.org/v1/news/all?symbols=TSLA%2CAMZN%2CMSFT&filter_entities=true&language=en&api_token=YOUR_API_TOKEN
            
        

Example Response

            
                {
    "meta": {
        "found": 59641,
        "returned": 3,
        "limit": 3,
        "page": 1
    },
    "data": [
        {
            "uuid": "255041f1-848b-40fa-8253-cb8dc3d4acbd",
            "title": "KCS Wealth Advisory Purchases 120 Shares of Amazon.com, Inc. (NASDAQ:AMZN)",
            "description": "Read KCS Wealth Advisory Purchases 120 Shares of Amazon.com, Inc. (NASDAQ:AMZN) at ETF Daily News",
            "keywords": "Amazon.com, NASDAQ:AMZN, AMZN, Retail/Wholesale, 02313510, SEC Filings, 13F, Hedge Fund Holdings, Institutional Investor Holdings",
            "snippet": "KCS Wealth Advisory increased its position in shares of Amazon.com, Inc. (NASDAQ:AMZN) by 96.0% in the 1st quarter, according to the company in its most recent ...",
            "url": "https://www.etfdailynews.com/2022/07/03/kcs-wealth-advisory-purchases-120-shares-of-amazon-com-inc-nasdaqamzn/",
            "image_url": "https://www.americanbankingnews.com/wp-content/timthumb/timthumb.php?src=https://www.marketbeat.com/logos/amazoncom-inc-logo.jpg&w=240&h=240&zc=2",
            "language": "en",
            "published_at": "2022-07-03T09:58:44.000000Z",
            "source": "etfdailynews.com",
            "relevance_score": null,
            "entities": [
                {
                    "symbol": "AMZN",
                    "name": "Amazon.com, Inc.",
                    "exchange": "NASDAQ",
                    "exchange_long": "NASDAQ Stock Exchange",
                    "country": "us",
                    "type": "equity",
                    "industry": "Consumer Cyclical",
                    "match_score": 129.75214,
                    "sentiment_score": 0.470664,
                    "highlights": [
                        {
                            "highlight": "KCS Wealth Advisory increased its position in shares of Amazon.com, Inc. (NASDAQ:AMZN) by 96.0% in the 1st quarter, according to the company in its most recent filing with the Securities and Exchange Commission. The firm owned 245 shares of the e-commerce giant’s stock after buying an additional 120 shares during the period.",
                            "sentiment": 0.9022,
                            "highlighted_in": "main_text"
                        },
                        {
                            "highlight": "Finally, Gilman Hill Asset Management LLC raised its stake in Amazon.com by 10.5% during the 4th quarter.",
                            "sentiment": 0.3612,
                            "highlighted_in": "main_text"
                        },
                        {
                            "highlight": "Get Amazon.com alerts:\n\nShares of NASDAQ AMZN opened at $109.56 on Friday. The firm has a market capitalization of $1.11 trillion, a PE ratio of 52.89, a price-to-earnings-growth ratio of 3.56 and a beta of 1.23. The firm’s 50-day moving average is $115.11 and its 200-day moving average is $142.18.",
                            "sentiment": 0.296,
                            "highlighted_in": "main_text"
                        },
                        {
                            "highlight": "Amazon.com, Inc. has a 1 year low of $101.26 and a 1 year high of $188.65.\n\nAmazon.com ( NASDAQ:AMZN Get Rating ) last announced its quarterly earnings results on Thursday, April 28th. The e-commerce giant reported $0.21 earnings per share for the quarter, missing analysts’ consensus estimates of $0.44 by ($0.23).",
                            "sentiment": -0.2732,
                            "highlighted_in": "main_text"
                        },
                        {
                            "highlight": "As a group, equities research analysts anticipate that Amazon.com, Inc. will post 1.22 earnings per share for the current fiscal year.\n\nSeveral equities analysts recently commented on AMZN shares. BNP Paribas started coverage on shares of Amazon.com in a research note on Tuesday, March 29th.",
                            "sentiment": 0.6808,
                            "highlighted_in": "main_text"
                        },
                        {
                            "highlight": "UBS Group dropped their price objective on shares of Amazon.com from $209.00 to $167.00 and set a “buy” rating for the company in a research note on Tuesday, June 28th. Susquehanna dropped their price objective on shares of Amazon.com from $250.00 to $190.00 in a research note on Friday, April 29th.",
                            "sentiment": 0.5267,
                            "highlighted_in": "main_text"
                        },
                        {
                            "highlight": "Citigroup began coverage on shares of Amazon.com in a research note on Wednesday. They issued a “buy” rating for the company. Finally, TheStreet cut shares of Amazon.com from a “b” rating to a “c+” rating in a research note on Thursday, April 28th.",
                            "sentiment": 0.3182,
                            "highlighted_in": "main_text"
                        },
                        {
                            "highlight": "Amazon.com Company Profile (Get Rating)\n\nAmazon.com, Inc engages in the retail sale of consumer products and subscriptions in North America and internationally. The company operates through three segments: North America, International, and Amazon Web Services (AWS).",
                            "sentiment": 0.4019,
                            "highlighted_in": "main_text"
                        },
                        {
                            "highlight": "Visit HoldingsChannel.com to get the latest 13F filings and insider trades for Amazon.com, Inc. (NASDAQ:AMZN – Get Rating).\n\nWant More Great Investing Ideas?",
                            "sentiment": 0.6872,
                            "highlighted_in": "main_text"
                        },
                        {
                            "highlight": "Receive News & Ratings for Amazon.com Daily - Enter your email address below to receive a concise daily summary of the latest news and analysts' ratings for Amazon.com and related companies with MarketBeat.com's FREE daily email newsletter.",
                            "sentiment": 0.6166,
                            "highlighted_in": "main_text"
                        },
                        {
                            "highlight": "KCS Wealth Advisory Purchases 120 Shares of Amazon.com, Inc. (NASDAQ:AMZN)",
                            "sentiment": 0.6597,
                            "highlighted_in": "title"
                        }
                    ]
                }
            ],
            "similar": [
                {
                    "uuid": "dae30a07-16d7-4fd4-a21c-007d9dee84df",
                    "title": "Amazon.com, Inc. (NASDAQ:AMZN) Shares Purchased by Creative Financial Designs Inc. ADV",
                    "description": "Read Amazon.com, Inc. (NASDAQ:AMZN) Shares Purchased by Creative Financial Designs Inc. ADV at ETF Daily News",
                    "keywords": "Amazon.com, NASDAQ:AMZN, AMZN, Retail/Wholesale, 02313510, SEC Filings, 13F, Hedge Fund Holdings, Institutional Investor Holdings",
                    "snippet": "Creative Financial Designs Inc. ADV increased its stake in shares of Amazon.com, Inc. (NASDAQ:AMZN – Get Rating) by 6.1% in the 1st quarter, according to the ...",
                    "url": "https://www.etfdailynews.com/2022/07/03/amazon-com-inc-nasdaqamzn-shares-purchased-by-creative-financial-designs-inc-adv/",
                    "image_url": "https://www.americanbankingnews.com/wp-content/timthumb/timthumb.php?src=https://www.marketbeat.com/logos/amazoncom-inc-logo.jpg&w=240&h=240&zc=2",
                    "language": "en",
                    "published_at": "2022-07-03T09:58:43.000000Z",
                    "source": "etfdailynews.com",
                    "relevance_score": null,
                    "entities": [
                        {
                            "symbol": "AMZN",
                            "name": "Amazon.com, Inc.",
                            "exchange": "NASDAQ",
                            "exchange_long": "NASDAQ Stock Exchange",
                            "country": "us",
                            "type": "equity",
                            "industry": "Consumer Cyclical",
                            "match_score": 113.89201,
                            "sentiment_score": 0.515818,
                            "highlights": [
                                {
                                    "highlight": "ADV increased its stake in shares of Amazon.com, Inc. (NASDAQ:AMZN – Get Rating) by 6.1% in the 1st quarter, according to the company in its most recent disclosure with the Securities and Exchange Commission (SEC). The firm owned 3,324 shares of the e-commerce giant’s stock after purchasing an additional 190 shares during the quarter.",
                                    "sentiment": 0.836,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Amazon.com accounts for approximately 1.6% of Creative Financial Designs Inc. ADV’s holdings, making the stock its 15th biggest position. Creative Financial Designs Inc. ADV’s holdings in Amazon.com were worth $10,836,000 at the end of the most recent reporting period.",
                                    "sentiment": 0.7717,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Cottage Street Advisors LLC increased its position in shares of Amazon.com by 5.3% in the fourth quarter. Cottage Street Advisors LLC now owns 999 shares of the e-commerce giant’s stock valued at $3,331,000 after buying an additional 50 shares in the last quarter.",
                                    "sentiment": 0.8625,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Diversified Trust Co increased its position in shares of Amazon.com by 1.6% in the fourth quarter. Diversified Trust Co now owns 9,055 shares of the e-commerce giant’s stock valued at $30,192,000 after buying an additional 143 shares in the last quarter.",
                                    "sentiment": 0.9657,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Get Amazon.com alerts:\n\nA number of analysts recently commented on AMZN shares. Rosenblatt Securities started coverage on Amazon.com in a research report on Tuesday, April 19th. They set a “neutral” rating and a $150.00 price objective for the company. Exane BNP Paribas initiated coverage on Amazon.com in a research note on Tuesday, March 29th.",
                                    "sentiment": 0.5719,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "The Goldman Sachs Group decreased their price target on Amazon.com from $185.00 to $170.00 and set a “buy” rating on the stock in a research note on Thursday, June 9th. Jefferies Financial Group decreased their price target on Amazon.com from $185.00 to $162.50 in a research note on Tuesday, May 31st.",
                                    "sentiment": 0,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Amazon.com, Inc. has a fifty-two week low of $101.26 and a fifty-two week high of $188.65.\n\nAmazon.com (NASDAQ:AMZN – Get Rating) last announced its quarterly earnings data on Thursday, April 28th. The e-commerce giant reported $0.21 earnings per share for the quarter, missing the consensus estimate of $0.44 by ($0.23).",
                                    "sentiment": -0.2732,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Amazon.com had a net margin of 4.48% and a return on equity of 21.60%. The company’s quarterly revenue was up 7.3% compared to the same quarter last year. During the same quarter last year, the company earned $0.79 EPS. Analysts anticipate that Amazon.com, Inc. will post 1.22 earnings per share for the current fiscal year.",
                                    "sentiment": 0.296,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Amazon.com Company Profile (Get Rating)\n\nAmazon.com, Inc engages in the retail sale of consumer products and subscriptions in North America and internationally. The company operates through three segments: North America, International, and Amazon Web Services (AWS).",
                                    "sentiment": 0.4019,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Receive News & Ratings for Amazon.com Daily - Enter your email address below to receive a concise daily summary of the latest news and analysts' ratings for Amazon.com and related companies with MarketBeat.com's FREE daily email newsletter.",
                                    "sentiment": 0.6166,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Amazon.com, Inc. (NASDAQ:AMZN) Shares Purchased by Creative Financial Designs Inc. ADV",
                                    "sentiment": 0.6249,
                                    "highlighted_in": "title"
                                }
                            ]
                        },
                        {
                            "symbol": "AMZN.SN",
                            "name": "Amazon.com, Inc.",
                            "exchange": "SSE",
                            "exchange_long": "Santiago Stock Exchange",
                            "country": "cl",
                            "type": "equity",
                            "industry": "Consumer Cyclical",
                            "match_score": 77.388855,
                            "sentiment_score": 0.515818,
                            "highlights": [
                                {
                                    "highlight": "ADV increased its stake in shares of Amazon.com, Inc. (NASDAQ:AMZN – Get Rating) by 6.1% in the 1st quarter, according to the company in its most recent disclosure with the Securities and Exchange Commission (SEC). The firm owned 3,324 shares of the e-commerce giant’s stock after purchasing an additional 190 shares during the quarter.",
                                    "sentiment": 0.836,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Amazon.com accounts for approximately 1.6% of Creative Financial Designs Inc. ADV’s holdings, making the stock its 15th biggest position. Creative Financial Designs Inc. ADV’s holdings in Amazon.com were worth $10,836,000 at the end of the most recent reporting period.",
                                    "sentiment": 0.7717,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Cottage Street Advisors LLC increased its position in shares of Amazon.com by 5.3% in the fourth quarter. Cottage Street Advisors LLC now owns 999 shares of the e-commerce giant’s stock valued at $3,331,000 after buying an additional 50 shares in the last quarter.",
                                    "sentiment": 0.8625,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Diversified Trust Co increased its position in shares of Amazon.com by 1.6% in the fourth quarter. Diversified Trust Co now owns 9,055 shares of the e-commerce giant’s stock valued at $30,192,000 after buying an additional 143 shares in the last quarter.",
                                    "sentiment": 0.9657,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Get Amazon.com alerts:\n\nA number of analysts recently commented on AMZN shares. Rosenblatt Securities started coverage on Amazon.com in a research report on Tuesday, April 19th. They set a “neutral” rating and a $150.00 price objective for the company. Exane BNP Paribas initiated coverage on Amazon.com in a research note on Tuesday, March 29th.",
                                    "sentiment": 0.5719,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "The Goldman Sachs Group decreased their price target on Amazon.com from $185.00 to $170.00 and set a “buy” rating on the stock in a research note on Thursday, June 9th. Jefferies Financial Group decreased their price target on Amazon.com from $185.00 to $162.50 in a research note on Tuesday, May 31st.",
                                    "sentiment": 0,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Amazon.com, Inc. has a fifty-two week low of $101.26 and a fifty-two week high of $188.65.\n\nAmazon.com (NASDAQ:AMZN – Get Rating) last announced its quarterly earnings data on Thursday, April 28th. The e-commerce giant reported $0.21 earnings per share for the quarter, missing the consensus estimate of $0.44 by ($0.23).",
                                    "sentiment": -0.2732,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Amazon.com had a net margin of 4.48% and a return on equity of 21.60%. The company’s quarterly revenue was up 7.3% compared to the same quarter last year. During the same quarter last year, the company earned $0.79 EPS. Analysts anticipate that Amazon.com, Inc. will post 1.22 earnings per share for the current fiscal year.",
                                    "sentiment": 0.296,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Amazon.com Company Profile (Get Rating)\n\nAmazon.com, Inc engages in the retail sale of consumer products and subscriptions in North America and internationally. The company operates through three segments: North America, International, and Amazon Web Services (AWS).",
                                    "sentiment": 0.4019,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Receive News & Ratings for Amazon.com Daily - Enter your email address below to receive a concise daily summary of the latest news and analysts' ratings for Amazon.com and related companies with MarketBeat.com's FREE daily email newsletter.",
                                    "sentiment": 0.6166,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Amazon.com, Inc. (NASDAQ:AMZN) Shares Purchased by Creative Financial Designs Inc. ADV",
                                    "sentiment": 0.6249,
                                    "highlighted_in": "title"
                                }
                            ]
                        },
                        {
                            "symbol": "AMZNCL.SN",
                            "name": "Amazon.com, Inc.",
                            "exchange": "SSE",
                            "exchange_long": "Santiago Stock Exchange",
                            "country": "cl",
                            "type": "equity",
                            "industry": "N/A",
                            "match_score": 77.386986,
                            "sentiment_score": 0.515818,
                            "highlights": [
                                {
                                    "highlight": "ADV increased its stake in shares of Amazon.com, Inc. (NASDAQ:AMZN – Get Rating) by 6.1% in the 1st quarter, according to the company in its most recent disclosure with the Securities and Exchange Commission (SEC). The firm owned 3,324 shares of the e-commerce giant’s stock after purchasing an additional 190 shares during the quarter.",
                                    "sentiment": 0.836,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Amazon.com accounts for approximately 1.6% of Creative Financial Designs Inc. ADV’s holdings, making the stock its 15th biggest position. Creative Financial Designs Inc. ADV’s holdings in Amazon.com were worth $10,836,000 at the end of the most recent reporting period.",
                                    "sentiment": 0.7717,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Cottage Street Advisors LLC increased its position in shares of Amazon.com by 5.3% in the fourth quarter. Cottage Street Advisors LLC now owns 999 shares of the e-commerce giant’s stock valued at $3,331,000 after buying an additional 50 shares in the last quarter.",
                                    "sentiment": 0.8625,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Diversified Trust Co increased its position in shares of Amazon.com by 1.6% in the fourth quarter. Diversified Trust Co now owns 9,055 shares of the e-commerce giant’s stock valued at $30,192,000 after buying an additional 143 shares in the last quarter.",
                                    "sentiment": 0.9657,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Get Amazon.com alerts:\n\nA number of analysts recently commented on AMZN shares. Rosenblatt Securities started coverage on Amazon.com in a research report on Tuesday, April 19th. They set a “neutral” rating and a $150.00 price objective for the company. Exane BNP Paribas initiated coverage on Amazon.com in a research note on Tuesday, March 29th.",
                                    "sentiment": 0.5719,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "The Goldman Sachs Group decreased their price target on Amazon.com from $185.00 to $170.00 and set a “buy” rating on the stock in a research note on Thursday, June 9th. Jefferies Financial Group decreased their price target on Amazon.com from $185.00 to $162.50 in a research note on Tuesday, May 31st.",
                                    "sentiment": 0,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Amazon.com, Inc. has a fifty-two week low of $101.26 and a fifty-two week high of $188.65.\n\nAmazon.com (NASDAQ:AMZN – Get Rating) last announced its quarterly earnings data on Thursday, April 28th. The e-commerce giant reported $0.21 earnings per share for the quarter, missing the consensus estimate of $0.44 by ($0.23).",
                                    "sentiment": -0.2732,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Amazon.com had a net margin of 4.48% and a return on equity of 21.60%. The company’s quarterly revenue was up 7.3% compared to the same quarter last year. During the same quarter last year, the company earned $0.79 EPS. Analysts anticipate that Amazon.com, Inc. will post 1.22 earnings per share for the current fiscal year.",
                                    "sentiment": 0.296,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Amazon.com Company Profile (Get Rating)\n\nAmazon.com, Inc engages in the retail sale of consumer products and subscriptions in North America and internationally. The company operates through three segments: North America, International, and Amazon Web Services (AWS).",
                                    "sentiment": 0.4019,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Receive News & Ratings for Amazon.com Daily - Enter your email address below to receive a concise daily summary of the latest news and analysts' ratings for Amazon.com and related companies with MarketBeat.com's FREE daily email newsletter.",
                                    "sentiment": 0.6166,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Amazon.com, Inc. (NASDAQ:AMZN) Shares Purchased by Creative Financial Designs Inc. ADV",
                                    "sentiment": 0.6249,
                                    "highlighted_in": "title"
                                }
                            ]
                        }
                    ]
                },
                {
                    "uuid": "3a6ca0b5-9442-4b73-b110-a1c08d82a432",
                    "title": "Amazon.com, Inc. (NASDAQ:AMZN) Shares Sold by G&S Capital LLC",
                    "description": "Read Amazon.com, Inc. (NASDAQ:AMZN) Shares Sold by G&S Capital LLC at ETF Daily News",
                    "keywords": "Amazon.com, NASDAQ:AMZN, AMZN, Retail/Wholesale, 02313510, SEC Filings, 13F, Hedge Fund Holdings, Institutional Investor Holdings",
                    "snippet": "G&S Capital LLC decreased its position in shares of Amazon.com, Inc. (NASDAQ:AMZN – Get Rating) by 22.8% during the 1st quarter, according to the company in i...",
                    "url": "https://www.etfdailynews.com/2022/07/03/amazon-com-inc-nasdaqamzn-shares-sold-by-gs-capital-llc/",
                    "image_url": "https://www.americanbankingnews.com/wp-content/timthumb/timthumb.php?src=https://www.marketbeat.com/logos/amazoncom-inc-logo.jpg&w=240&h=240&zc=2",
                    "language": "en",
                    "published_at": "2022-07-03T09:58:42.000000Z",
                    "source": "etfdailynews.com",
                    "relevance_score": null,
                    "entities": [
                        {
                            "symbol": "AMZN",
                            "name": "Amazon.com, Inc.",
                            "exchange": "NASDAQ",
                            "exchange_long": "NASDAQ Stock Exchange",
                            "country": "us",
                            "type": "equity",
                            "industry": "Consumer Cyclical",
                            "match_score": 130.25746,
                            "sentiment_score": 0.445409,
                            "highlights": [
                                {
                                    "highlight": "G&S Capital LLC decreased its position in shares of Amazon.com, Inc. (NASDAQ:AMZN – Get Rating) by 22.8% during the 1st quarter, according to the company in its most recent 13F filing with the Securities and Exchange Commission. The fund owned 312 shares of the e-commerce giant’s stock after selling 92 shares during the quarter.",
                                    "sentiment": 0.7783,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "G&S Capital LLC’s holdings in Amazon.com were worth $1,017,000 as of its most recent filing with the Securities and Exchange Commission.\n\nSeveral other hedge funds have also recently made changes to their positions in the company. Norges Bank acquired a new position in Amazon.com in the fourth quarter valued at about $14,053,756,000.",
                                    "sentiment": 0.7184,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Castleview Partners LLC acquired a new position in Amazon.com in the fourth quarter valued at about $1,143,000. Fairfield Bush & CO. lifted its position in Amazon.com by 28,715.3% in the fourth quarter.",
                                    "sentiment": 0.4404,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Finally, Allspring Global Investments Holdings LLC acquired a new stake in shares of Amazon.com during the fourth quarter worth about $2,059,691,000. 72.51% of the stock is currently owned by hedge funds and other institutional investors.\n\nGet Amazon.com alerts:\n\nIn other Amazon.com news, CEO Andrew R.",
                                    "sentiment": 0.4767,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "DA Davidson reduced their price target on shares of Amazon.com from $195.00 to $156.25 in a research report on Friday, April 29th. Royal Bank of Canada reduced their price target on shares of Amazon.com from $194.00 to $175.00 in a research report on Friday, April 29th.",
                                    "sentiment": 0.5267,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Loop Capital reduced their price target on shares of Amazon.com from $187.50 to $141.25 and set a “buy” rating on the stock in a research report on Friday, May 27th. Jefferies Financial Group reduced their price target on shares of Amazon.com from $185.00 to $162.50 in a research report on Tuesday, May 31st.",
                                    "sentiment": 0.5267,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Shares of NASDAQ AMZN opened at $109.56 on Friday. The company has a debt-to-equity ratio of 0.35, a current ratio of 0.96 and a quick ratio of 0.71. The stock has a fifty day moving average price of $115.11 and a 200 day moving average price of $142.18. Amazon.com, Inc. has a 1-year low of $101.26 and a 1-year high of $188.65.",
                                    "sentiment": 0.0258,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Amazon.com (NASDAQ:AMZN – Get Rating) last issued its quarterly earnings results on Thursday, April 28th. The e-commerce giant reported $0.21 earnings per share for the quarter, missing the consensus estimate of $0.44 by ($0.23). Amazon.com had a return on equity of 21.60% and a net margin of 4.48%.",
                                    "sentiment": 0,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Analysts anticipate that Amazon.com, Inc. will post 1.22 earnings per share for the current fiscal year.\n\nAbout Amazon.com (Get Rating)\n\nAmazon.com, Inc engages in the retail sale of consumer products and subscriptions in North America and internationally.",
                                    "sentiment": 0.4939,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Receive News & Ratings for Amazon.com Daily - Enter your email address below to receive a concise daily summary of the latest news and analysts' ratings for Amazon.com and related companies with MarketBeat.com's FREE daily email newsletter.",
                                    "sentiment": 0.6166,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Amazon.com, Inc. (NASDAQ:AMZN) Shares Sold by G&S Capital LLC",
                                    "sentiment": 0.296,
                                    "highlighted_in": "title"
                                }
                            ]
                        },
                        {
                            "symbol": "RY",
                            "name": "Royal Bank of Canada",
                            "exchange": "NYSE",
                            "exchange_long": "New York Stock Exchange",
                            "country": "us",
                            "type": "equity",
                            "industry": "Financial Services",
                            "match_score": 21.766945,
                            "sentiment_score": 0.5267,
                            "highlights": [
                                {
                                    "highlight": "Royal Bank of Canada reduced their price target on shares of Amazon.com from $194.00 to $175.00 in a research report on Friday, April 29th. Loop Capital reduced their price target on shares of Amazon.com from $187.50 to $141.25 and set a “buy” rating on the stock in a research report on Friday, May 27th.",
                                    "sentiment": 0.5267,
                                    "highlighted_in": "main_text"
                                }
                            ]
                        },
                        {
                            "symbol": "AMZN.SN",
                            "name": "Amazon.com, Inc.",
                            "exchange": "SSE",
                            "exchange_long": "Santiago Stock Exchange",
                            "country": "cl",
                            "type": "equity",
                            "industry": "Consumer Cyclical",
                            "match_score": 80.17833,
                            "sentiment_score": 0.487127,
                            "highlights": [
                                {
                                    "highlight": "G&S Capital LLC decreased its position in shares of Amazon.com, Inc. (NASDAQ:AMZN – Get Rating) by 22.8% during the 1st quarter, according to the company in its most recent 13F filing with the Securities and Exchange Commission. The fund owned 312 shares of the e-commerce giant’s stock after selling 92 shares during the quarter.",
                                    "sentiment": 0.7783,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "G&S Capital LLC’s holdings in Amazon.com were worth $1,017,000 as of its most recent filing with the Securities and Exchange Commission.\n\nSeveral other hedge funds have also recently made changes to their positions in the company. Norges Bank acquired a new position in Amazon.com in the fourth quarter valued at about $14,053,756,000.",
                                    "sentiment": 0.7184,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Castleview Partners LLC acquired a new position in Amazon.com in the fourth quarter valued at about $1,143,000. Fairfield Bush & CO. lifted its position in Amazon.com by 28,715.3% in the fourth quarter.",
                                    "sentiment": 0.4404,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "State Street Corp lifted its position in shares of Amazon.com by 4.3% during the fourth quarter. State Street Corp now owns 17,021,616 shares of the e-commerce giant’s stock worth $56,755,855,000 after purchasing an additional 698,970 shares in the last quarter.",
                                    "sentiment": 0.7579,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Finally, Allspring Global Investments Holdings LLC acquired a new stake in shares of Amazon.com during the fourth quarter worth about $2,059,691,000. 72.51% of the stock is currently owned by hedge funds and other institutional investors.\n\nGet Amazon.com alerts:\n\nIn other Amazon.com news, CEO Andrew R.",
                                    "sentiment": 0.4767,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "DA Davidson reduced their price target on shares of Amazon.com from $195.00 to $156.25 in a research report on Friday, April 29th. Royal Bank of Canada reduced their price target on shares of Amazon.com from $194.00 to $175.00 in a research report on Friday, April 29th.",
                                    "sentiment": 0.5267,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Loop Capital reduced their price target on shares of Amazon.com from $187.50 to $141.25 and set a “buy” rating on the stock in a research report on Friday, May 27th. Jefferies Financial Group reduced their price target on shares of Amazon.com from $185.00 to $162.50 in a research report on Tuesday, May 31st.",
                                    "sentiment": 0.5267,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Amazon.com, Inc. has a 1-year low of $101.26 and a 1-year high of $188.65. The company has a market cap of $1.11 trillion, a PE ratio of 52.89, a P/E/G ratio of 3.56 and a beta of 1.23.\n\nAmazon.com (NASDAQ:AMZN – Get Rating) last issued its quarterly earnings results on Thursday, April 28th.",
                                    "sentiment": -0.2732,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Analysts anticipate that Amazon.com, Inc. will post 1.22 earnings per share for the current fiscal year.\n\nAbout Amazon.com (Get Rating)\n\nAmazon.com, Inc engages in the retail sale of consumer products and subscriptions in North America and internationally.",
                                    "sentiment": 0.4939,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Receive News & Ratings for Amazon.com Daily - Enter your email address below to receive a concise daily summary of the latest news and analysts' ratings for Amazon.com and related companies with MarketBeat.com's FREE daily email newsletter.",
                                    "sentiment": 0.6166,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Amazon.com, Inc. (NASDAQ:AMZN) Shares Sold by G&S Capital LLC",
                                    "sentiment": 0.296,
                                    "highlighted_in": "title"
                                }
                            ]
                        },
                        {
                            "symbol": "AMZNCL.SN",
                            "name": "Amazon.com, Inc.",
                            "exchange": "SSE",
                            "exchange_long": "Santiago Stock Exchange",
                            "country": "cl",
                            "type": "equity",
                            "industry": "N/A",
                            "match_score": 80.17639,
                            "sentiment_score": 0.487127,
                            "highlights": [
                                {
                                    "highlight": "G&S Capital LLC decreased its position in shares of Amazon.com, Inc. (NASDAQ:AMZN – Get Rating) by 22.8% during the 1st quarter, according to the company in its most recent 13F filing with the Securities and Exchange Commission. The fund owned 312 shares of the e-commerce giant’s stock after selling 92 shares during the quarter.",
                                    "sentiment": 0.7783,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "G&S Capital LLC’s holdings in Amazon.com were worth $1,017,000 as of its most recent filing with the Securities and Exchange Commission.\n\nSeveral other hedge funds have also recently made changes to their positions in the company. Norges Bank acquired a new position in Amazon.com in the fourth quarter valued at about $14,053,756,000.",
                                    "sentiment": 0.7184,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Castleview Partners LLC acquired a new position in Amazon.com in the fourth quarter valued at about $1,143,000. Fairfield Bush & CO. lifted its position in Amazon.com by 28,715.3% in the fourth quarter.",
                                    "sentiment": 0.4404,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "State Street Corp lifted its position in shares of Amazon.com by 4.3% during the fourth quarter. State Street Corp now owns 17,021,616 shares of the e-commerce giant’s stock worth $56,755,855,000 after purchasing an additional 698,970 shares in the last quarter.",
                                    "sentiment": 0.7579,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Finally, Allspring Global Investments Holdings LLC acquired a new stake in shares of Amazon.com during the fourth quarter worth about $2,059,691,000. 72.51% of the stock is currently owned by hedge funds and other institutional investors.\n\nGet Amazon.com alerts:\n\nIn other Amazon.com news, CEO Andrew R.",
                                    "sentiment": 0.4767,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "DA Davidson reduced their price target on shares of Amazon.com from $195.00 to $156.25 in a research report on Friday, April 29th. Royal Bank of Canada reduced their price target on shares of Amazon.com from $194.00 to $175.00 in a research report on Friday, April 29th.",
                                    "sentiment": 0.5267,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Loop Capital reduced their price target on shares of Amazon.com from $187.50 to $141.25 and set a “buy” rating on the stock in a research report on Friday, May 27th. Jefferies Financial Group reduced their price target on shares of Amazon.com from $185.00 to $162.50 in a research report on Tuesday, May 31st.",
                                    "sentiment": 0.5267,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Amazon.com, Inc. has a 1-year low of $101.26 and a 1-year high of $188.65. The company has a market cap of $1.11 trillion, a PE ratio of 52.89, a P/E/G ratio of 3.56 and a beta of 1.23.\n\nAmazon.com (NASDAQ:AMZN – Get Rating) last issued its quarterly earnings results on Thursday, April 28th.",
                                    "sentiment": -0.2732,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Analysts anticipate that Amazon.com, Inc. will post 1.22 earnings per share for the current fiscal year.\n\nAbout Amazon.com (Get Rating)\n\nAmazon.com, Inc engages in the retail sale of consumer products and subscriptions in North America and internationally.",
                                    "sentiment": 0.4939,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Receive News & Ratings for Amazon.com Daily - Enter your email address below to receive a concise daily summary of the latest news and analysts' ratings for Amazon.com and related companies with MarketBeat.com's FREE daily email newsletter.",
                                    "sentiment": 0.6166,
                                    "highlighted_in": "main_text"
                                },
                                {
                                    "highlight": "Amazon.com, Inc. (NASDAQ:AMZN) Shares Sold by G&S Capital LLC",
                                    "sentiment": 0.296,
                                    "highlighted_in": "title"
                                }
                            ]
                        }
                    ]
                }
            ]
        },
        {
            "uuid": "b95f20b2-bbf0-4186-afcf-a9bbae5f587d",
            "title": "City Holding Co. Has $14.44 Million Stock Holdings in Amazon.com, Inc. (NASDAQ:AMZN)",
            "description": "Read City Holding Co. Has $14.44 Million Stock Holdings in Amazon.com, Inc. (NASDAQ:AMZN) at ETF Daily News",
            "keywords": "Amazon.com, NASDAQ:AMZN, AMZN, Retail/Wholesale, 02313510, SEC Filings, 13F, Hedge Fund Holdings, Institutional Investor Holdings",
            "snippet": "City Holding Co. increased its position in shares of Amazon.com, Inc. (NASDAQ:AMZN) by 2.5% in the 1st quarter, according to the company in its most recent 13F ...",
            "url": "https://www.etfdailynews.com/2022/07/03/city-holding-co-has-14-44-million-stock-holdings-in-amazon-com-inc-nasdaqamzn/",
            "image_url": "https://www.americanbankingnews.com/wp-content/timthumb/timthumb.php?src=https://www.marketbeat.com/logos/amazoncom-inc-logo.jpg&w=240&h=240&zc=2",
            "language": "en",
            "published_at": "2022-07-03T09:58:44.000000Z",
            "source": "etfdailynews.com",
            "relevance_score": null,
            "entities": [
                {
                    "symbol": "AMZN",
                    "name": "Amazon.com, Inc.",
                    "exchange": "NASDAQ",
                    "exchange_long": "NASDAQ Stock Exchange",
                    "country": "us",
                    "type": "equity",
                    "industry": "Consumer Cyclical",
                    "match_score": 122.2931,
                    "sentiment_score": 0.369973,
                    "highlights": [
                        {
                            "highlight": "City Holding Co. increased its position in shares of Amazon.com, Inc. (NASDAQ:AMZN) by 2.5% in the 1st quarter, according to the company in its most recent 13F filing with the Securities & Exchange Commission. The institutional investor owned 4,430 shares of the e-commerce giant’s stock after acquiring an additional 108 shares during the quarter.",
                            "sentiment": 0.836,
                            "highlighted_in": "main_text"
                        },
                        {
                            "highlight": "Stuart Chaussee & Associates Inc. bought a new position in shares of Amazon.com during the 4th quarter worth approximately $27,000. Econ Financial Services Corp acquired a new position in shares of Amazon.com in the 4th quarter valued at $33,000.",
                            "sentiment": 0.802,
                            "highlighted_in": "main_text"
                        },
                        {
                            "highlight": "Gibson Wealth Advisors LLC acquired a new position in shares of Amazon.com in the 4th quarter valued at $33,000. Leverty Financial Group LLC acquired a new position in shares of Amazon.com in the 4th quarter valued at $36,000. Finally, MBM Wealth Consultants LLC increased its position in shares of Amazon.com by 57.1% in the 4th quarter.",
                            "sentiment": 0.9578,
                            "highlighted_in": "main_text"
                        },
                        {
                            "highlight": "Get Amazon.com alerts:\n\nShares of NASDAQ AMZN opened at $109.56 on Friday. The company has a 50 day simple moving average of $115.11 and a 200-day simple moving average of $142.18. The company has a market capitalization of $1.11 trillion, a P/E ratio of 52.89, a P/E/G ratio of 3.56 and a beta of 1.23.",
                            "sentiment": 0.296,
                            "highlighted_in": "main_text"
                        },
                        {
                            "highlight": "Amazon.com, Inc. has a 1 year low of $101.26 and a 1 year high of $188.65.\n\nAmazon.com ( NASDAQ:AMZN Get Rating ) last posted its quarterly earnings data on Thursday, April 28th. The e-commerce giant reported $0.21 earnings per share for the quarter, missing analysts’ consensus estimates of $0.44 by ($0.23).",
                            "sentiment": -0.2732,
                            "highlighted_in": "main_text"
                        },
                        {
                            "highlight": "Amazon.com had a return on equity of 21.60% and a net margin of 4.48%. The business’s revenue for the quarter was up 7.3% on a year-over-year basis. During the same period in the previous year, the business posted $0.79 EPS. As a group, research analysts expect that Amazon.com, Inc. will post 1.22 EPS for the current year.",
                            "sentiment": 0,
                            "highlighted_in": "main_text"
                        },
                        {
                            "highlight": "Morgan Stanley cut their target price on Amazon.com from $210.00 to $190.00 in a research report on Friday, April 29th. JPMorgan Chase & Co. lowered their price target on shares of Amazon.com from $200.00 to $175.00 and set an “overweight” rating on the stock in a report on Wednesday.",
                            "sentiment": -0.1027,
                            "highlighted_in": "main_text"
                        },
                        {
                            "highlight": "According to MarketBeat.com, Amazon.com currently has an average rating of “Moderate Buy” and a consensus target price of $185.79.\n\nAbout Amazon.com (Get Rating)\n\nAmazon.com, Inc engages in the retail sale of consumer products and subscriptions in North America and internationally.",
                            "sentiment": 0.25,
                            "highlighted_in": "main_text"
                        },
                        {
                            "highlight": "Visit HoldingsChannel.com to get the latest 13F filings and insider trades for Amazon.com, Inc. (NASDAQ:AMZN – Get Rating).\n\nWant More Great Investing Ideas?",
                            "sentiment": 0.6872,
                            "highlighted_in": "main_text"
                        },
                        {
                            "highlight": "Receive News & Ratings for Amazon.com Daily - Enter your email address below to receive a concise daily summary of the latest news and analysts' ratings for Amazon.com and related companies with MarketBeat.com's FREE daily email newsletter.",
                            "sentiment": 0.6166,
                            "highlighted_in": "main_text"
                        },
                        {
                            "highlight": "Has $14.44 Million Stock Holdings in Amazon.com, Inc. (NASDAQ:AMZN)",
                            "sentiment": 0,
                            "highlighted_in": "title"
                        }
                    ]
                }
            ],
            "similar": []
        },
        ...
    ]
}
            
        

Similar News Available on: All plans

Endpoint

            
                GET https://api.stockdata.org/v1/news/similar/uuid HTTP/1.1
            
        

Use this endpoint to find similar stories to a specific article based on its UUID.

HTTP GET Parameters

name required description
api_token true Your API token which can be found on your account dashboard.
symbols false Specify entity symbol(s) which have been identified within the article. Find entity symbols in our entity search endpoint.
Example: symbols=TSLA,AMZN,MSFT
exchanges false Specify exchange(s) of entities which have been identified within the article. Find exchanges in our exchanges metadata endpoint.
Example: exchanges=NASDAQ,NYSE
entity_types false Specify the type of entities which have been identified within the article. Find entity types in our entity type metadata endpoint.
Example: entity_types=index,equity
industries false Specify the industries of entities which have been identified within the article. Find entity types in our entity industry metadata endpoint.
Example: industries=Technology,Industrials
countries false Specify the country of the exchange of which entities have been identified within the article. Find countries as part of our entity exchanges metadata endpoint.
Example: countries=us,ca
sentiment_gte false Use this to find all articles with entities with a sentiment_score of greater than or equal to x.
Example: sentiment_gte=0 - this will find all articles which are neutral or positive
sentiment_lte false Use this to find all articles with entities with a sentiment_score of less than or equal to x.
Example: sentiment_lte=0 - this will find all articles which are neutral or negative
filter_entities false By default all entities for each article are returned - by setting this to true, only the relevant entities to your query will be returned with each article. For example, if you set symbols=TSLA and filter_entities=true, only "TSLA" entities will be returned with the articles.
Default: false
must_have_entities false By default all articles are returned, set this to true to ensure that at least one entity has been identified within the article.
Default: false
group_similar false Group similar articles to avoid displaying multiple articles on the same topic/subject.
Default: true
domains false Comma separated list of domains to include. List of domains can be obtained through our Sources endpoint, found further down this page.
Example: adweek.com,adage.com
exclude_domains false Comma separated list of domains to exclude
source_ids false Comma separated list of source_ids to include. List of source_ids can be obtained through our Sources endpoint, found further down this page.
Example: adweek.com-1,adage.com-1
exclude_source_ids false Comma separated list of source_ids to exclude.
language false Comma separated list of languages to include. Default is all.
Click here for a list of supported languages.
Examples: en,es (English + Spanish)
published_before false Find all articles published before the specified date. Supported formats include: Y-m-d\TH:i:s | Y-m-d\TH:i | Y-m-d\TH | Y-m-d | Y-m | Y.
Examples: 2022-07-03T12:21:19 | 2022-07-03T12:21 | 2022-07-03T12 | 2022-07-03 | 2022-07 | 2022
published_after false Find all articles published after the specified date. Supported formats include: Y-m-d\TH:i:s | Y-m-d\TH:i | Y-m-d\TH | Y-m-d | Y-m | Y.
Examples: 2022-07-03T12:21:19 | 2022-07-03T12:21 | 2022-07-03T12 | 2022-07-03 | 2022-07 | 2022
published_on false Find all articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2022-07-03
limit false Specify the number of articles you want to return in the request. The maximum limit is based on your plan. The default limit is the maximum specified for your plan.
page false Use this to paginate through the result set. Default is 1. Note that the max result set can't exceed 20,000. For example if your limit is 50, the max page you can have is 400 (50 * 400 = 20,000).
Example: page=2

Response Objects

name description
meta > found The number of articles found for the request.
meta > returned The number of articles returned on the page. This is useful to determine the end of the result set as if this is lower than limit, there are no more articles after this page.
meta > limit The limit based on the limit parameter.
meta > page The page number based on the page parameter.
data > uuid The unique identifier for an article in our system. Store this and use it to find specific articles using our single article endpoint.
data > title The article title.
data > description The article meta description.
data > keywords The article meta keywords.
data > snippet The first 60 characters of the article body.
data > url The URL to the article.
data > image_url The URL to the article image.
data > language The language of the source.
data > published_at The datetime the article was published.
data > source The domain of the source.
data > relevance_score Relevance score based on the article provided.
data > entities > symbol Symbol of the identified entity.
data > entities > name Name of the identified entity.
data > entities > exchange Exchange identifier of the identified entity.
data > entities > exchange_long Exchange name of the identified entity.
data > entities > country Exchange country of the identified entity.
data > entities > type Type of the identified entity.
data > entities > industry Industry of the identified entity.
data > entities > match_score The overall strength of the matching for the identified entity.
data > entities > sentiment_score Average sentiment of all highlighted text found for the identified entity.
data > entities > highlights > highlight Snippet of text from the article where the entity has been identified.
data > entities > highlights > sentiment The sentiment of the highlighed text.
data > entities > highlights > highlighted_in Where the highlight was found (title | main_text).
data > similar Array of news articles which are very similar to the main article.

If no results are found, the data object will be empty.

Example Request

            
                GET https://api.stockdata.org/v1/news/similar/cc11e3ab-ced0-4a42-9146-e426505e2e67?api_token=YOUR_API_TOKEN&language=en&published_on=2020-12-01
            
        

Example Response

            
                
            {
                "meta": {
                    "found": 222,
                    "returned": 3,
                    "limit": 3,
                    "page": 1
                },
                "data": [
                    {
                        "uuid": "489e4ec4-84a9-4628-966c-95c3741c6dfc",
                        "title": "Bitcoin Drops below $47K: Is BTC in a Bear Market?",
                        "description": "Bitcoin's rally seems to have made a sharp U-turn. Is this a short-lived correction or a longer-term trend?",
                        "keywords": "",
                        "snippet": "The market correction that many crypto analysts have been predicting for weeks seems to have finally arrived. Indeed, crypto markets are seeing red across the ...",
                        "url": "https://www.financemagnates.com/cryptocurrency/news/bitcoin-drops-below-47k-is-btc-in-a-bear-market/",
                        "image_url": "https://www.financemagnates.com/wp-content/uploads/2020/02/bitcoin-tightrope.jpg",
                        "language": "en",
                        "published_at": "2021-02-23T11:00:40.000000Z",
                        "source": "financemagnates.com",
                        "relevance_score": 106.05874,
                        "entities": [ ],
                        "similar": [ ]
                    },
                    {
                        "uuid": "61be555e-3120-44b0-ad13-6f985ea92f63",
                        "title": "Bitcoin ETFs vs Spot BTC",
                        "description": "Bitcoin is now the largest and most well-known cryptocurrency. This cryptocurrency has a market cap of several hundred billion dollars and as a result, has ...",
                        "keywords": "",
                        "snippet": "Bitcoin is now the largest and most well-known cryptocurrency. This cryptocurrency has a market cap of several hundred billion dollars and as a result, has mass...",
                        "url": "https://www.benzinga.com/markets/cryptocurrency/21/02/19808328/bitcoin-etfs-vs-spot-btc",
                        "image_url": "https://cdn.benzinga.com/files/imagecache/og_image_social_share_1200x630/images/story/2012/investing.jpg",
                        "language": "en",
                        "published_at": "2021-02-23T21:11:34.000000Z",
                        "source": "benzinga.com",
                        "relevance_score": 95.900276,
                        "entities": [ ],
                        "similar": [ ]
                    },
                    ...
                ]
            }
        
            
        

News by UUID Available on: All plans

Endpoint

            
                GET https://api.stockdata.org/v1/news/uuid/uuid HTTP/1.1
            
        

Use this endpoint to find specific articles by the UUID which is returned on our search endpoints. This is useful if you wish to store the UUID to return the article later.

HTTP GET Parameters

name required description
api_token true Your API token which can be found on your account dashboard.

Response Objects

name description
uuid The unique identifier for an article in our system. Store this and use it to find specific articles using our single article endpoint.
title The article title.
description The article meta description.
keywords The article meta keywords.
snippet The first 60 characters of the article body.
url The URL to the article.
image_url The URL to the article image.
language The language of the source.
published_at The datetime the article was published.
source The domain of the source.
entities > symbol Symbol of the identified entity.
entities > name Name of the identified entity.
entities > exchange Exchange identifier of the identified entity.
entities > exchange_long Exchange name of the identified entity.
entities > country Exchange country of the identified entity.
entities > type Type of the identified entity.
entities > industry Industry of the identified entity.
entities > match_score The overall strength of the matching for the identified entity.
entities > sentiment_score Average sentiment of all highlighted text found for the identified entity.
entities > highlights > highlight Snippet of text from the article where the entity has been identified.
entities > highlights > sentiment The sentiment of the highlighed text.
entities > highlights > highlighted_in Where the highlight was found (title | main_text).

If no results are found, a resource_not_found error will be returned.

Example Request

            
                GET https://api.stockdata.org/v1/news/uuid/147013d8-6c2c-4d50-8bad-eb3c8b7f5740?api_token=YOUR_API_TOKEN
            
        

Example Response

            
                
            {
                "uuid": "9b9fb67e-9438-4263-815e-ef6a7d36af07",
                "title": "Bitcoin (BTC/USD), Ethereum (ETH/USD) Crushed as Cryptocurrency Market is Overrun by Sellers",
                "description": "The cryptocurrency market has been experiencing wild price swings over the last two days with sellers in complete control as prices slump across the board",
                "keywords": "",
                "snippet": "Bitcoin (BTC/USD) Price, Analysis and Chart: Bullish channel is broken in a two day sell-off...",
                "url": "https://www.dailyfx.com/forex/market_alert/2021/02/23/Bitcoin-BTCUSD-Ethereum-ETHUSD-Crushed-as-Cryptocurrency-Market-is-Overrun-by-Sellers.html",
                "image_url": "https://a.c-dn.net/b/2jPuVf/headline_shutterstock_365875643.jpg",
                "language": "en",
                "published_at": "2021-02-23T10:30:00.000000Z",
                "source": "dailyfx.com",
                "entities": [
                    {
                        "symbol": "BTCUSD",
                        "name": "Bitcoin USD",
                        "exchange": "CC",
                        "exchange_long": "Cryptocurrency",
                        "country": "global",
                        "type": "cryptocurrency",
                        "industry": "N/A",
                        "match_score": 82.04055,
                        "sentiment_score": -0.177075,
                        "highlights": [
                            {
                                "highlight": "Bitcoin (BTC/USD) Price, Analysis and Chart: Bullish channel is broken in a two day sell-off. No specific driver of price action.",
                                "sentiment": -0.6486,
                                "highlighted_in": "main_text"
                            },
                            ...
                        ]
                    },
                    {
                        "symbol": "ETHUSD",
                        "name": "Ethereum USD",
                        "exchange": "CC",
                        "exchange_long": "Cryptocurrency",
                        "country": "global",
                        "type": "cryptocurrency",
                        "industry": "N/A",
                        "match_score": 65.22654,
                        "sentiment_score": -0.4215,
                        "highlights": [
                            {
                                "highlight": "Bitcoin (BTC/USD), Ethereum (ETH/USD) Crushed as Cryptocurrency Market is Overrun by Sellers",
                                "sentiment": -0.4215,
                                "highlighted_in": "title"
                            }
                        ]
                    }
                ]
            }
        
            
        

Market News Analysis

Entity Stats (time series) Available on: Standard and above

Endpoint

            
                GET https://api.stockdata.org/v1/news/stats/intraday HTTP/1.1
            
        

Get an intraday view of how well entities performed over different intervals using this endpoint. Find the best or worst performing entities broken down to every minute, hour, day, week, month, quarter or year. Useful for comparing entities and creating graphs and charts

Adding symbols to the request is not necessary - by default all of the best performing stocks are returned. Filter entities by symbols, exchanges, industries, countries, entity types and more.

HTTP GET Parameters

name required description
api_token true Your API token which can be found on your account dashboard.
interval false The interval of the time series.

Options: minute | hour | day | week | month | quarter | year
Default: day
Example: interval=day

Note: there are restrictions on the maximum time frame for each interval. This is based on the published_before parameter. From the published_before date specified, the maximum time frame that can be retrieved is as following:

minute = 7 days
hour = 1 month
day = 3 years
week = 5 years
month = 5 years
quarter = 10 years
year = 10 years

By default the maximum allowed time frame will be applied. If the time frame is exceeded by the date parameters provided, the default will be applied - no error will be thrown.

For example, if interval=minute and published_before=2021-01-10, the max that can be returned will be back to 2021-01-03. You can specify a published_after value to reduce this time frame if necessary (e.g. published_after=2021-01-08).
group_by false Group results by symbol | exchange | industry | country
Default: symbol
min_doc_count false The minimum number of total_documents an entity should be identified within to be returned with the results.
Example: min_doc_count=10
symbols false Specify entity symbol(s) which have been identified within the article. Find entity symbols in our entity search endpoint.
Example: symbols=TSLA,AMZN,MSFT
exchanges false Specify exchange(s) of entities which have been identified within the article. Find exchanges in our exchanges metadata endpoint.
Example: exchanges=NASDAQ,NYSE
entity_types false Specify the type of entities which have been identified within the article. Find entity types in our entity type metadata endpoint.
Example: entity_types=index,equity
industries false Specify the industries of entities which have been identified within the article. Find entity types in our entity industry metadata endpoint.
Example: industries=Technology,Industrials
countries false Specify the country of the exchange of which entities have been identified within the article. Find countries as part of our entity exchanges metadata endpoint.
Example: countries=us,ca
sentiment_avg_gte false Use this to refine results to find all entities with an overall sentiment_avg greater than or equal to x.
Example: sentiment_avg_gte=0 - this will find all entities which are neutral or positive
sentiment_avg_lte false Use this to refine results to find all entities with an overall sentiment_avg less than or equal to x.
Example: sentiment_avg_lte=0 - this will find all entities which are neutral or negative
sentiment_gte false Use this to refine results to find all documents for entities with a sentiment_score greater than or equal to x.
Example: sentiment_gte=0 - this will find all document entities which are neutral or positive
sentiment_lte false Use this to refine results to find all documents for entities with a sentiment_score less than or equal to x.
Example: sentiment_lte=0 - this will find all document entities which are neutral or negative
search false Use the search as a basic search tool by entering regular search terms or it has more advanced usage to build search queries:
+ signifies AND operation
| signifies OR operation
- negates a single token
" wraps a number of tokens to signify a phrase for searching
* at the end of a term signifies a prefix query
( and ) signify precedence
To use one of these characters literally, escape it with a preceding backslash (\).
This searches the full body of the text and the title.

Example: "ipo" -nasdaq (searches for articles which must include the string "ipo" but articles must NOT mention Nasdaq.)

For more advanced query examples, see our API Examples section.
domains false Comma separated list of domains to include. List of domains can be obtained through our Sources endpoint, found further down this page.
Example: adweek.com,adage.com
exclude_domains false Comma separated list of domains to exclude
source_ids false Comma separated list of source_ids to include. List of source_ids can be obtained through our Sources endpoint, found further down this page.
Example: adweek.com-1,adage.com-1
exclude_source_ids false Comma separated list of source_ids to exclude.
language false Comma separated list of languages to include. Default is all.
Click here for a list of supported languages.
Examples: en,es (English + Spanish)
published_before false Refine results for articles before the specified date. Supported formats include: Y-m-d\TH:i:s | Y-m-d\TH:i | Y-m-d\TH | Y-m-d | Y-m | Y.
Examples: 2022-07-03T12:21:19 | 2022-07-03T12:21 | 2022-07-03T12 | 2022-07-03 | 2022-07 | 2022
published_after false Refine results for articles published after the specified date. Supported formats include: Y-m-d\TH:i:s | Y-m-d\TH:i | Y-m-d\TH | Y-m-d | Y-m | Y.
Examples: 2022-07-03T12:21:19 | 2022-07-03T12:21 | 2022-07-03T12 | 2022-07-03 | 2022-07 | 2022
published_on false Refine results for articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2022-07-03
sort false Sort by total_documents or sentiment_avg
Default: total_documents
sort_order false Sort order of the sort parameter.
Options: desc | asc
Default: desc
date_order false Ordering of the date keys.
Options: desc | asc
Default: desc
limit false Specify the number of entities you want to return in the request. The maximum limit is based on your plan. The default limit is the maximum specified for your plan.

Response Objects

name description
data > date Date of the time series data.
data > data > key The key based on the group_by parameter. For example, this could be symbol, exchange, industry or country.
data > data > total_documents Total number of documents identified for the key and also based on the query parameters provided.
data > data > sentiment_avg Average sentiment of the key and also based on the query parameters provided.

If no results are found, the data object will be empty.

Example Request

            
                GET https://api.stockdata.org/v1/news/stats/intraday?symbols=TSLA%2CAMZN%2CMSFT&interval=day&published_after=2022-07-02T12%3A21&language=en&api_token=YOUR_API_TOKEN
            
        

Example Response

            
                {
    "data": [
        {
            "date": "2022-07-03T00:00:00.000Z",
            "data": [
                {
                    "key": "AMZN",
                    "total_documents": 9,
                    "sentiment_avg": 0.4375384449958801
                },
                {
                    "key": "MSFT",
                    "total_documents": 7,
                    "sentiment_avg": 0.42001043047223774
                },
                {
                    "key": "TSLA",
                    "total_documents": 4,
                    "sentiment_avg": 0.1500262557528913
                }
            ]
        },
        {
            "date": "2022-07-02T00:00:00.000Z",
            "data": [
                {
                    "key": "TSLA",
                    "total_documents": 14,
                    "sentiment_avg": 0.05918528537066387
                },
                {
                    "key": "MSFT",
                    "total_documents": 2,
                    "sentiment_avg": 0.38671649992465973
                },
                {
                    "key": "AMZN",
                    "total_documents": 1,
                    "sentiment_avg": 0
                }
            ]
        }
    ]
}
            
        

Entity Stats (aggregation) Available on: Standard and above

Endpoint

            
                GET https://api.stockdata.org/v1/news/stats/aggregation HTTP/1.1
            
        

Similar to the entity stats time series endpoint, this returns an aggregation of entities for a single time frame, rather than being broken down by date. Useful to find the best or worst performing stocks.

HTTP GET Parameters

name required description
api_token true Your API token which can be found on your account dashboard.
group_by false Group results by symbol | exchange | industry | country
Default: symbol
min_doc_count false The minimum number of total_documents an entity should be identified within to be returned with the results.
Example: min_doc_count=10
symbols false Specify entity symbol(s) which have been identified within the article. Find entity symbols in our entity search endpoint.
Example: symbols=TSLA,AMZN,MSFT
exchanges false Specify exchange(s) of entities which have been identified within the article. Find exchanges in our exchanges metadata endpoint.
Example: exchanges=NASDAQ,NYSE
entity_types false Specify the type of entities which have been identified within the article. Find entity types in our entity type metadata endpoint.
Example: entity_types=index,equity
industries false Specify the industries of entities which have been identified within the article. Find entity types in our entity industry metadata endpoint.
Example: industries=Technology,Industrials
countries false Specify the country of the exchange of which entities have been identified within the article. Find countries as part of our entity exchanges metadata endpoint.
Example: countries=us,ca
sentiment_avg_gte false Use this to refine results to find all entities with an overall sentiment_avg greater than or equal to x.
Example: sentiment_avg_gte=0 - this will find all entities which are neutral or positive
sentiment_avg_lte false Use this to refine results to find all entities with an overall sentiment_avg less than or equal to x.
Example: sentiment_avg_lte=0 - this will find all entities which are neutral or negative
sentiment_gte false Use this to refine results to find all documents for entities with a sentiment_score greater than or equal to x.
Example: sentiment_gte=0 - this will find all document entities which are neutral or positive
sentiment_lte false Use this to refine results to find all documents for entities with a sentiment_score less than or equal to x.
Example: sentiment_lte=0 - this will find all document entities which are neutral or negative
search false Use the search as a basic search tool by entering regular search terms or it has more advanced usage to build search queries:
+ signifies AND operation
| signifies OR operation
- negates a single token
" wraps a number of tokens to signify a phrase for searching
* at the end of a term signifies a prefix query
( and ) signify precedence
To use one of these characters literally, escape it with a preceding backslash (\).
This searches the full body of the text and the title.

Example: "ipo" -nasdaq (searches for articles which must include the string "ipo" but articles must NOT mention Nasdaq.)

For more advanced query examples, see our API Examples section.
domains false Comma separated list of domains to include. List of domains can be obtained through our Sources endpoint, found further down this page.
Example: adweek.com,adage.com
exclude_domains false Comma separated list of domains to exclude
source_ids false Comma separated list of source_ids to include. List of source_ids can be obtained through our Sources endpoint, found further down this page.
Example: adweek.com-1,adage.com-1
exclude_source_ids false Comma separated list of source_ids to exclude.
language false Comma separated list of languages to include. Default is all.
Click here for a list of supported languages.
Examples: en,es (English + Spanish)
published_before false Refine results for articles published before the specified date. Supported formats include: Y-m-d\TH:i:s | Y-m-d\TH:i | Y-m-d\TH | Y-m-d | Y-m | Y.
Examples: 2022-07-03T12:21:19 | 2022-07-03T12:21 | 2022-07-03T12 | 2022-07-03 | 2022-07 | 2022
published_after false Refine results for articles published after the specified date. Supported formats include: Y-m-d\TH:i:s | Y-m-d\TH:i | Y-m-d\TH | Y-m-d | Y-m | Y.
Examples: 2022-07-03T12:21:19 | 2022-07-03T12:21 | 2022-07-03T12 | 2022-07-03 | 2022-07 | 2022
published_on false Refine results for articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2022-07-03
sort false Sort by total_documents or sentiment_avg
Default: total_documents
sort_order false Sort order of the sort parameter.
Options: desc | asc
Default: desc
limit false Specify the number of entities you want to return in the request. The maximum limit is based on your plan. The default limit is the maximum specified for your plan.

Response Objects

name description
meta > returned The number of entities returned.
meta > limit The limit based on the limit parameter.
data > key The key based on the group_by parameter. For example, this could be symbol, exchange, industry or country.
data > total_documents Total number of documents identified for the key and also based on the query parameters provided.
data > sentiment_avg Average sentiment of the key and also based on the query parameters provided.

If no results are found, the data object will be empty.

Example Request

            
                GET https://api.stockdata.org/v1/news/stats/aggregation?symbols=TSLA%2CAMZN%2CMSFT&published_after=2022-07-02T12%3A21&language=en&api_token=YOUR_API_TOKEN
            
        

Example Response

            
                {
    "meta": {
        "returned": 3,
        "limit": 100
    },
    "data": [
        {
            "key": "TSLA",
            "total_documents": 18,
            "sentiment_avg": 0.07937216767782553
        },
        {
            "key": "AMZN",
            "total_documents": 10,
            "sentiment_avg": 0.3937846004962921
        },
        {
            "key": "MSFT",
            "total_documents": 9,
            "sentiment_avg": 0.4126117792394426
        }
    ]
}
            
        

Endpoint

            
                GET https://api.stockdata.org/v1/news/stats/trending HTTP/1.1
            
        

Use this endpoint to identify trending entities. Filter by time frame and much more; e.g. find which stocks were trending on a specific day, within the past 24 hours, past 7 days, etc.

HTTP GET Parameters

name required description
api_token true Your API token which can be found on your account dashboard.
group_by false Group results by symbol | exchange | industry | country
Default: symbol
min_doc_count false The minimum number of total_documents an entity should be identified within to be returned with the results.
Example: min_doc_count=10
symbols false Specify entity symbol(s) which have been identified within the article. Find entity symbols in our entity search endpoint.
Example: symbols=TSLA,AMZN,MSFT
exchanges false Specify exchange(s) of entities which have been identified within the article. Find exchanges in our exchanges metadata endpoint.
Example: exchanges=NASDAQ,NYSE
entity_types false Specify the type of entities which have been identified within the article. Find entity types in our entity type metadata endpoint.
Example: entity_types=index,equity
industries false Specify the industries of entities which have been identified within the article. Find entity types in our entity industry metadata endpoint.
Example: industries=Technology,Industrials
countries false Specify the country of the exchange of which entities have been identified within the article. Find countries as part of our entity exchanges metadata endpoint.
Example: countries=us,ca
sentiment_avg_gte false Use this to refine results to find all entities with an overall sentiment_avg greater than or equal to x.
Example: sentiment_avg_gte=0 - this will find all entities which are neutral or positive
sentiment_avg_lte false Use this to refine results to find all entities with an overall sentiment_avg less than or equal to x.
Example: sentiment_avg_lte=0 - this will find all entities which are neutral or negative
sentiment_gte false Use this to refine results to find all documents for entities with a sentiment_score greater than or equal to x.
Example: sentiment_gte=0 - this will find all document entities which are neutral or positive
sentiment_lte false Use this to refine results to find all documents for entities with a sentiment_score less than or equal to x.
Example: sentiment_lte=0 - this will find all document entities which are neutral or negative
search false Use the search as a basic search tool by entering regular search terms or it has more advanced usage to build search queries:
+ signifies AND operation
| signifies OR operation
- negates a single token
" wraps a number of tokens to signify a phrase for searching
* at the end of a term signifies a prefix query
( and ) signify precedence
To use one of these characters literally, escape it with a preceding backslash (\).
This searches the full body of the text and the title.

Example: "ipo" -nasdaq (searches for articles which must include the string "ipo" but articles must NOT mention Nasdaq.)

For more advanced query examples, see our API Examples section.
domains false Comma separated list of domains to include. List of domains can be obtained through our Sources endpoint, found further down this page.
Example: adweek.com,adage.com
exclude_domains false Comma separated list of domains to exclude
source_ids false Comma separated list of source_ids to include. List of source_ids can be obtained through our Sources endpoint, found further down this page.
Example: adweek.com-1,adage.com-1
exclude_source_ids false Comma separated list of source_ids to exclude.
language false Comma separated list of languages to include. Default is all.
Click here for a list of supported languages.
Examples: en,es (English + Spanish)
published_before false Refine results for articles published before the specified date. Supported formats include: Y-m-d\TH:i:s | Y-m-d\TH:i | Y-m-d\TH | Y-m-d | Y-m | Y.
Examples: 2022-07-03T12:21:19 | 2022-07-03T12:21 | 2022-07-03T12 | 2022-07-03 | 2022-07 | 2022
published_after false Refine results for articles published after the specified date. Supported formats include: Y-m-d\TH:i:s | Y-m-d\TH:i | Y-m-d\TH | Y-m-d | Y-m | Y.
Examples: 2022-07-03T12:21:19 | 2022-07-03T12:21 | 2022-07-03T12 | 2022-07-03 | 2022-07 | 2022
published_on false Refine results for articles published on the specified date. Supported formats include: Y-m-d.
Examples: 2022-07-03
sort false Sort by total_documents or sentiment_avg
Default: total_documents
sort_order false Sort order of the sort parameter.
Options: desc | asc
Default: desc
limit false Specify the number of entities you want to return in the request. The maximum limit is based on your plan. The default limit is the maximum specified for your plan.

Response Objects

name description
meta > returned The number of entities returned.
meta > limit The limit based on the limit parameter.
data > key The key based on the group_by parameter. For example, this could be symbol, exchange, industry or country.
data > total_documents Total number of documents identified for the key and also based on the query parameters provided.
data > sentiment_avg Average sentiment of the key and also based on the query parameters provided.
data > score The relevance score for the trending entity.

If no results are found, the data object will be empty.

Example Request

            
                GET https://api.stockdata.org/v1/news/stats/trending?exchanges=nyse%2Cnasdaq&min_doc_count=10&published_after=2022-07-02T12%3A21&language=en&api_token=YOUR_API_TOKEN
            
        

Example Response

            
                {
    "meta": {
        "returned": 50,
        "limit": 100
    },
    "data": [
        {
            "key": "FITBP",
            "total_documents": 78,
            "sentiment_avg": 0.524337654407972,
            "score": 8.632896670871808
        },
        {
            "key": "FITBO",
            "total_documents": 78,
            "sentiment_avg": 0.524337654407972,
            "score": 8.445350226732266
        },
        {
            "key": "FITBI",
            "total_documents": 78,
            "sentiment_avg": 0.524337654407972,
            "score": 8.268205367145717
        },
        {
            "key": "FITB",
            "total_documents": 78,
            "sentiment_avg": 0.5207431928660625,
            "score": 7.839664869533496
        },
        {
            "key": "DB",
            "total_documents": 197,
            "sentiment_avg": 0.23445406198728508,
            "score": 6.832045319291512
        },
        ...
    ]
}
            
        

Stock Metadata

Endpoint

            
                GET https://api.stockdata.org/v1/entity/search HTTP/1.1
            
        

Use this endpoint to search for all entities we support. Note that the limit is 50 for all requests.

HTTP GET Parameters

name required description
api_token true Your API token which can be found on your account dashboard.
search false Dynamic search function to find entities.
symbols false Enter specific symbols to return.
exchanges false Filter results by specific exchanges. Comma separated list.
types false Filter results by entity types. Comma separated list.
industries false Filter results by industries. Comma separated list.
countries false Filter results by ISO 3166-1 two-letter country code of the exchange. Comma separated list.
page false Use this to paginate through the result set. Default is 1.
Example: page=2

Response Objects

name description
meta > found The number of entities found for the request.
meta > returned The number of entities returned on the page.
meta > limit The limit is 50. This currently can not be changed.
meta > page The page number based on the page parameter.
data > symbol Unique entity symbol (or ticker).
data > name Entity name.
data > type The entity type.
data > industry The entity industry.
data > exchange The exchange identifier.
data > exchange_long The exchange name.
data > mic_code The exchanges ISO 10383 market identifier code.
data > country The ISO 3166-1 two-letter country code of the exchange locale.

If no results are found, the data object will be empty.

Example Request

            
                GET https://api.stockdata.org/v1/entity/search?search=tsla&api_token=YOUR_API_TOKEN
            
        

Example Response

            
                {
    "meta": {
        "found": 1,
        "returned": 1,
        "limit": 50,
        "page": 1
    },
    "data": [
        {
            "symbol": "TSLA",
            "name": "Tesla Inc",
            "type": "equity",
            "industry": null,
            "exchange": "NASDAQ",
            "exchange_long": "NASDAQ Stock Exchange",
            "mic_code": "XNAS",
            "country": "us"
        }
    ]
}
            
        

Exchange List Available on: All plans

Endpoint

            
                GET https://api.stockdata.org/v1/entity/exchange/list HTTP/1.1
            
        

Use this endpoint to return a list of all supported exchanges.

HTTP GET Parameters

name required description
api_token true Your API token which can be found on your account dashboard.

Response Objects

name description
data > mic_code The exchanges ISO 10383 market identifier code.
data > exchange The unique identifier of the exchange.
data > exchange_long The name of the exchange.
data > country The ISO 3166-1 two-letter country code of the exchange locale.
data > append The appended characters for the exchange tickers.
data > timezone Non DST timezone of the exchange.
data > timezone_dst DST timezone (daylight saving time).
data > timezone_name The name of the timezone.
data > is_dst Specifies if the timezone is currently daylight saving time.

If no results are found, the data object will be empty.

Example Request

            
                GET https://api.stockdata.org/v1/entity/exchange/list?api_token=YOUR_API_TOKEN
            
        

Example Response

            
                {
    "data": [
        {
            "mic_code": "XLON",
            "exchange": "LSE",
            "stock_exchange_long": "London Stock Exchange",
            "country": "gb",
            "append": ".L",
            "timezone": "GMT",
            "timezone_dst": "BST",
            "timezone_name": "Europe/London",
            "is_dst": 1
        },
        {
            "mic_code": "INDX",
            "exchange": "INDEXASX",
            "stock_exchange_long": "",
            "country": "au",
            "append": "",
            "timezone": "AEDT",
            "timezone_dst": "AEST",
            "timezone_name": "Australia/Sydney",
            "is_dst": 0
        },
        {
            "mic_code": "BATS",
            "exchange": "CBOE",
            "stock_exchange_long": "BATS Global Markets",
            "country": "us",
            "append": "",
            "timezone": "EST",
            "timezone_dst": "EDT",
            "timezone_name": "America/New_York",
            "is_dst": 1
        },
        {
            "mic_code": "INDX",
            "exchange": "INDEXBIT",
            "stock_exchange_long": "",
            "country": "it",
            "append": "",
            "timezone": "CET",
            "timezone_dst": "CEST",
            "timezone_name": "Europe/Rome",
            "is_dst": 1
        },
        {
            "mic_code": "XHKG",
            "exchange": "HKSE",
            "stock_exchange_long": "Hong Kong Stock Exchange",
            "country": "hk",
            "append": ".HK",
            "timezone": "HKT",
            "timezone_dst": "HKT",
            "timezone_name": "Asia/Hong_Kong",
            "is_dst": 0
        },
        ...
    ]
}
            
        

Entity Type List Available on: All plans

Endpoint

            
                GET https://api.stockdata.org/v1/entity/type/list HTTP/1.1
            
        

Use this endpoint to return all supported entity types.

HTTP GET Parameters

name required description
api_token true Your API token which can be found on your account dashboard.

Response Objects

name description
data Array of entity types.

If no results are found, the data object will be empty.

Example Request

            
                GET https://api.stockdata.org/v1/entity/type/list?api_token=YOUR_API_TOKEN
            
        

Example Response

            
                {
    "data": [
        "equity",
        "index",
        "etf",
        "mutualfund",
        "currency",
        "cryptocurrency"
    ]
}
            
        

Industry List Available on: All plans

Endpoint

            
                GET https://api.stockdata.org/v1/entity/industry/list HTTP/1.1
            
        

Use this endpoint to return all supported entity industries.

HTTP GET Parameters

name required description
api_token true Your API token which can be found on your account dashboard.

Response Objects

name description
data Array of industries.

If no results are found, the data object will be empty.

Example Request

            
                GET https://api.stockdata.org/v1/entity/industry/list?api_token=YOUR_API_TOKEN
            
        

Example Response

            
                {
    "data": [
        "Technology",
        "Industrials",
        "N/A",
        "Consumer Cyclical",
        "Healthcare",
        "Communication Services",
        "Financial Services",
        "Consumer Defensive",
        "Basic Materials",
        "Real Estate",
        "Energy",
        "Utilities",
        "Financial",
        "Services",
        "Consumer Goods",
        "Industrial Goods"
    ]
}
            
        

Company Profiles Available on: All plans

Endpoint

            
                GET https://api.stockdata.org/v1/entity/profile HTTP/1.1
            
        

Use this endpoint to get a profile for a company based on its ticker.

HTTP GET Parameters

name required description
api_token true Your API token which can be found on your account dashboard.
symbols false Ticker of the stock you wish to retrieve the profile for.

Response Objects

name description
data > ticker Entity ticker
data > address1 Address line 1.
data > address2 Address line 2.
data > address3 Address line 3.
data > address4 Address line 4.
data > address5 Address line 5.
data > city City of the company.
data > state State of the company.
data > zip ZIP/postal code of the company.
data > country Country of the company.
data > phone Phone number of the company.
data > website Website of the company.
data > industry Comapny industry.
data > sector Company sector.
data > full_time_employees Number of company full time employees.
data > description Company description.

If no results are found, the data object will be empty.

Example Request

            
                GET https://api.stockdata.org/v1/entity/profile?symbols=AAPL&api_token=YOUR_API_TOKEN
            
        

Example Response

            
                {
    "data": [
        {
            "ticker": "AAPL",
            "address1": "One Apple Park Way",
            "address2": null,
            "address3": null,
            "address4": null,
            "address5": null,
            "city": "Cupertino",
            "state": "CA",
            "zip": "95014",
            "country": "United States",
            "phone": "408-996-1010",
            "website": "http://www.apple.com",
            "industry": "Consumer Electronics",
            "sector": "Technology",
            "full_time_employees": 147000,
            "description": "Apple Inc. designs, manufactures, and markets smartphones, personal computers, tablets, wearables, and accessories worldwide. It also sells various related services. The company offers iPhone, a line of smartphones; Mac, a line of personal computers; iPad, a line of multi-purpose tablets; and wearables, home, and accessories comprising AirPods, Apple TV, Apple Watch, Beats products, HomePod, iPod touch, and other Apple-branded and third-party accessories. It also provides AppleCare support services; cloud services store services; and operates various platforms, including the App Store, that allow customers to discover and download applications and digital content, such as books, music, video, games, and podcasts. In addition, the company offers various services, such as Apple Arcade, a game subscription service; Apple Music, which offers users a curated listening experience with on-demand radio stations; Apple News+, a subscription news and magazine service; Apple TV+, which offers exclusive original content; Apple Card, a co-branded credit card; and Apple Pay, a cashless payment service, as well as licenses its intellectual property. The company serves consumers, and small and mid-sized businesses; and the education, enterprise, and government markets. It sells and delivers third-party applications for its products through the App Store. The company also sells its products through its retail and online stores, and direct sales force; and third-party cellular network carriers, wholesalers, retailers, and resellers. Apple Inc. was founded in 1977 and is headquartered in Cupertino, California."
        }
    ]
}
            
        

News Metadata

Sources Available on: All plans

Endpoint

            
                GET https://api.stockdata.org/v1/news/sources HTTP/1.1
            
        

Use this endpoint to view sources which can be used in other API requests. Note that the limit is 50 for all requests.

HTTP GET Parameters

name required description
api_token true Your API token which can be found on your account dashboard.
distinct_domain false Use this to group distinct domains from sources. This will make source_id null.
Example: distinct_domain=true
language false Comma separated list of languages to include. Default is all.
Click here for a list of supported languages.
Examples: en,es (English + Spanish)
page false Use this to paginate through the result set. Default is 1.
Example: page=2

Response Objects

name description
meta > found The number of sources found for the request.
meta > returned The number of sources returned on the page.
meta > limit The limit is 50. This currently can not be changed.
meta > page The page number based on the page parameter.
data > source_id The unique ID of the source feed. Use this for the source_ids or exclude_source_ids parameters in the news endpoints. There may be many source_ids for each domain, therefore we would generally suggest using the domains filter instead the source_ids filter.
data > domain The domain of the source. You can use this for the domains or exclude_domains parameters in the news endpoints.
data > language The source language.

If no results are found, the data object will be empty.

Example Request

            
                GET https://api.stockdata.org/v1/news/sources?api_token=YOUR_API_TOKEN&language=en
            
        

Example Response

            
                
            {
                "meta": {
                    "found": 5327,
                    "returned": 50,
                    "limit": 50,
                    "page": 1
                },
                "data": [
                    {
                        "source_id": "adweek.com-1",
                        "domain": "adweek.com",
                        "language": "en"
                    },
                    {
                        "source_id": "adage.com-1",
                        "domain": "adage.com",
                        "language": "en"
                    },
                    {
                        "source_id": "avc.com-1",
                        "domain": "avc.com",
                        "language": "en"
                    },
                    ...
                ]
            }
        
            
        

Misc

US Trading Holidays Available on: All plans

Endpoint

            
                GET https://api.stockdata.org/v1/data/holidays HTTP/1.1
            
        

Use this endpoint to get a list of US trading holidays from the year 2000 to 2+ years into the future.

HTTP GET Parameters

name required description
api_token true Your API token which can be found on your account dashboard.

Response Objects

name description
data > date Date of the holiday

If no results are found, the data object will be empty.

Example Request

            
                GET https://api.stockdata.org/v1/data/holidays?api_token=YOUR_API_TOKEN
            
        

Example Response

            
                {
    "data": [
        {
            "date": "2024-12-25T00:00:00.000000Z"
        },
        ...
    ]
}
            
        

Errors

Errors

If your request was unsuccessful, you will receive a JSON formatted error. Below you will find the potential errors you may encounter when using the API.

Errors

error code HTTP status description
malformed_parameters 400 Validation of parameters failed. The failed parameters are usually shown in the error message.
invalid_api_token 401 Invalid API token.
usage_limit_reached 402 Usage limit of your plan has been reached. Usage limit and remaining requests can be found on the X-UsageLimit-Limit header.
endpoint_access_restricted 403 Access to the endpoint is not available on your current subscription plan.
resource_not_found 404 Resource could not be found.
invalid_api_endpoint 404 API route does not exist.
rate_limit_reached 429 Too many requests in the past 60 seconds. Rate limit and remaining requests can be found on the X-RateLimit-Limit header.
server_error 500 A server error occured.
maintenance_mode 503 The service is currently under maintenance.

Example Error Response

            
                
            {
                "error": {
                    "code": "malformed_parameters",
                    "message": "The published_before parameter(s) are incorrectly formatted."
                }
            }
        
            
        

Examples

API Examples

There are unlimited ways to filter and refine your results with our API, see a few examples below to help you get started.

If you need assistance creating the perfect query, feel free to contact us.

Retrieve all articles which have entities mentioned that exist in NASDAQ or NYSE exchanges

    
        GET https://api.stockdata.org/v1/news/all?exchanges=NYSE%2CNASDAQ&api_token=YOUR_API_TOKEN
    

Retrieve all articles which have mentioned AAPL and TSLA, and filter the entities array so ONLY these are displayed with articles

    
        GET https://api.stockdata.org/v1/news/all?symbols=AAPL%2CTSLA&filter_entities=true&api_token=YOUR_API_TOKEN
    

Find all articles with positive entity sentiment in English

    
        GET https://api.stockdata.org/v1/news/all?sentiment_gte=0.1&language=en&api_token=YOUR_API_TOKEN
    

Find all articles with neutral entity sentiment in English

    
        GET https://api.stockdata.org/v1/news/all?sentiment_gte=0&sentiment_lte=0&language=en&api_token=YOUR_API_TOKEN
    

Find all articles with negative entity sentiment in English

    
        GET https://api.stockdata.org/v1/news/all?sentiment_lte=-0.1&language=en&api_token=YOUR_API_TOKEN
    

Get a day-by-day breakdown of top mentioned entities for exchanges in the US for last month (June 2022)

    
        GET https://api.stockdata.org/v1/news/stats/intraday?interval=day&group_by=symbol&countries=us&published_after=2022-06-01T00%3A00&published_before=2022-06-30T23%3A59&api_token=YOUR_API_TOKEN
    

Get an aggregation for the top entities by sentiment yesterday (02 July 2022)

    
        GET https://api.stockdata.org/v1/news/stats/intraday?group_by=symbol&sort=sentiment_avg&sort_order=desc&published_on=2022-07-02&api_token=YOUR_API_TOKEN
    

Code Examples

See our prepared examples below to quickly get started implementing our API into your next project.

PHP

    
        $queryString = http_build_query([
            'api_token' => 'YOUR_API_TOKEN',
            'symbols' => 'AAPL,TSLA',
            'filter_entities' => 'true',
            'limit' => 50,
        ]);

        $ch = curl_init(sprintf('%s?%s', 'https://api.stockdata.org/v1/news/all', $queryString));
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

        $json = curl_exec($ch);

        curl_close($ch);

        $apiResult = json_decode($json, true);

        print_r($apiResult);
    

Python

    
        # Python 3
        import http.client, urllib.parse

        conn = http.client.HTTPSConnection('api.stockdata.org')

        params = urllib.parse.urlencode({
            'api_token': 'YOUR_API_TOKEN',
            'symbols': 'AAPL,TSLA',
            'limit': 50,
            })

        conn.request('GET', '/v1/news/all?{}'.format(params))

        res = conn.getresponse()
        data = res.read()

        print(data.decode('utf-8'))
    

Go

    
        package main

        import (
            "fmt"
            "io/ioutil"
            "net/http"
            "net/url"
        )

        func main() {
            baseURL, _ := url.Parse("https://api.stockdata.org")

            baseURL.Path += "v1/news/all"

            params := url.Values{}
            params.Add("api_token", "YOUR_API_TOKEN")
            params.Add("symbols", "aapl,tsla")
            params.Add("search", "ipo")
            params.Add("limit", "50")

            baseURL.RawQuery = params.Encode()

            req, _ := http.NewRequest("GET", baseURL.String(), nil)

            res, _ := http.DefaultClient.Do(req)

            defer res.Body.Close()

            body, _ := ioutil.ReadAll(res.Body)

            fmt.Println(string(body))
        }
    

JavaScript

    
        var requestOptions = {
            method: 'GET'
        };

        var params = {
            api_token: 'YOUR_API_TOKEN',
            symbols: 'msft,fb',
            limit: '50'
        };

        var esc = encodeURIComponent;
        var query = Object.keys(params)
            .map(function(k) {return esc(k) + '=' + esc(params[k]);})
            .join('&');

        fetch("https://api.stockdata.org/v1/news/all?" + query, requestOptions)
          .then(response => response.text())
          .then(result => console.log(result))
          .catch(error => console.log('error', error));
    

C#

    
        var client = new RestClient("https://api.stockdata.org/v1/news/all");
        client.Timeout = -1;

        var request = new RestRequest(Method.GET);

        request.AddQueryParameter("api_token", "YOUR_API_TOKEN");
        request.AddQueryParameter("symbols", "aapl,amzn");
        request.AddQueryParameter("limit", "50");

        IRestResponse response = client.Execute(request);
        Console.WriteLine(response.Content);
    

Java

    
        OkHttpClient client = new OkHttpClient().newBuilder()
          .build();

        HttpUrl.Builder httpBuilder = HttpUrl.parse("https://api.stockdata.org/v1/news/all").newBuilder();
        httpBuilder.addQueryParameter("api_token", "YOUR_API_TOKEN");
        httpBuilder.addQueryParameter("symbols", "aapl,msft");
        httpBuilder.addQueryParameter("limit", "50");

        Request request = new Request.Builder().url(httpBuilder.build()).build();

        Response response = client.newCall(request).execute();