Acuity Market Insights API

Article Types

We currently support three article types in the Market Insights API service

Equities Insights
Macroeconomic Event Insights
Macroeconomic Asset-Specific Insights

Equities Insights

This content offers in-depth stock market analysis, utilizing various analytical perspectives. It covers corporate news, including executive decisions, compensation changes, and legal or financial strategies. The primary goal is to emphasize sector performance, company approaches, market interdependencies, and key business occurrences impacting particular assets and industries.

Macroeconomic Event Insights

The content offers previews and market sentiment analyses for upcoming economic data releases across various sectors and countries. Each summary details key economic events, scheduled release dates, consensus forecasts, and the prevailing market mood prior to the announcements. A defining feature of these summaries is their focus on interconnected economic factors and geopolitical developments.

Macroeconomic Asset-Specific Insights

This content offers summaries of market-related insights, focusing on macroeconomic events and their impact on broader markets such as indices or commodities. These summaries aim to highlight movements and relationships between securities within specific contexts. Primarily, this content is useful for market monitoring, portfolio analysis, or thematic investment research. It also serves as an effective filtering tool for identifying market movements or correlations that may require further investigation.

Article Format

Equities Insights

Field	Type	Description
market_date	string	The date of the market data in YYYY-MM-DD format.
symbol	string	The stock ticker symbol of the equity.
period	string	The reporting period for the summary (e.g., 'Daily').
time_utc_publication	datetime	The UTC timestamp when the summary was published.
summary_status	string	The status of the summary, indicating if it's a new entry or an update (e.g., 'NEW', 'UPDATE').
summary	string	A detailed narrative summary of the stock's performance and related market events.
headline	string	A concise headline summarizing the key information from the summary.
summary_meta	object	Container for metadata related to the summary content.
summary_meta.tags	array of strings	A list of tags categorizing the summary content.
summary_meta.keywords	array of strings	A list of keywords relevant to the summary content.
summary_meta.categories	array of strings	A list of categories the summary belongs to (e.g., 'Correlated Moves', 'News').
summary_meta.associated_assets	array of strings	A list of other assets whose performance is associated with or influencing the current asset.
summary_meta.information_score	object	A sub-object detailing the information score or relevance of the summary.
summary_meta.information_score.raw	number	The raw numerical value of the information score.
summary_meta.information_score.label	string	A textual label for the information score (e.g., 'VERY LOW', 'MEDIUM', 'VERY HIGH').
summary_meta.information_score.level	number	The numerical level of the information score.
performance	object	Container for performance metrics of the stock.
performance.return_percent	number	The percentage return of the stock.
performance.return_vol_adj	number	The volatility-adjusted percentage return of the stock.
performance.performance_as_of	datetime	The UTC timestamp as of which the performance metrics are calculated.
performance.performance_since	datetime	The UTC timestamp from which the performance metrics are calculated.
performance.return_percentile	number	The percentile rank of the stock's return.
performance.vs_spy_percentile	number	The percentile rank of the stock's return compared to the S&P 500 index.
performance.vs_sector_percentile	number	The percentile rank of the stock's return compared to its sector.
time_utc_applicable_start	datetime	The UTC start time of the period to which the summary's information is applicable.
time_utc_applicable_end	datetime	The UTC end time of the period to which the summary's information is applicable.
symbol_meta	object	Container for static metadata about the company/symbol.
symbol_meta.lei	string	Legal Entity Identifier for the company.
symbol_meta.mic	string	Market Identifier Code for the exchange where the stock is traded.
symbol_meta.figi	string	Financial Instrument Global Identifier for the stock.
symbol_meta.gind	string	The GICS Industry of the company.
symbol_meta.isin	string	International Securities Identification Number for the stock.
symbol_meta.name	string	The full name of the company.
symbol_meta.type	string	The type of security (e.g., 'Common Stock', 'ADR').
symbol_meta.class	string	The asset class (e.g., 'equity').
symbol_meta.country	string	The country where the company is based or listed.
symbol_meta.gsector	string	The GICS Sector of the company.
symbol_meta.gsubind	string	The GICS Sub-Industry of the company.
language	string	The language of the summary content (e.g., 'en' for English).
asset_type	string	The general type of asset being discussed (e.g., 'equities').
acuity_id	number	A unique identifier for the Acuity asset.
image	string or null	A URL to an associated image, if available.
id	string	A unique identifier for the specific equities summary entry.

Macroeconomic Event Insights

Field	Type	Description
event_date	string	The date of the economic event in YYYY-MM-DD format.
symbol	string	The symbol representing the macro economic event.
event_time_utc	datetime	The UTC timestamp of when the event is scheduled or occurred.
time_utc_publication	datetime	The UTC timestamp when the summary for the event was published.
summary_status	string	The status of the summary, indicating if it's a new entry or an update (e.g., 'NEW', 'UPDATE').
summary	string	A detailed narrative summary of the economic event and related market sentiment.
headline	string	A concise headline summarizing the key information from the summary.
summary_meta	object	Container for metadata related to the summary content.
summary_meta.tags	array of strings	A list of tags categorizing the summary content (e.g., 'Economic Indicators', 'Market Sentiment').
summary_meta.unit	string	The unit of measurement for the economic indicator (e.g., '%', 'M', 'K').
summary_meta.event	string	The name of the economic event.
summary_meta.actual	number or null	The actual reported value of the economic indicator, if available.
summary_meta.source	string	The source of the economic data.
summary_meta.symbol	string	The symbol representing the macro economic event.
summary_meta.country	string	The country or region to which the economic event pertains.
summary_meta.category	string	The category of the economic indicator (e.g., 'Consumer Confidence', 'Inflation Rate').
summary_meta.keywords	array of strings	A list of keywords relevant to the summary content.
summary_meta.importance	number	A numerical value indicating the importance of the economic event.
summary_meta.is_preview	boolean	Indicates if the summary is a preview of an upcoming event (true) or an update after the event (false).
summary_meta.country_code	string	The two-letter country code for the country or region.
summary_meta.event_time_utc	datetime	The UTC timestamp of when the event is scheduled or occurred, replicated from the top-level field.
summary_meta.categories	array of strings	A list of categories the summary belongs to.
summary_meta.forecast	number or null	The forecasted value of the economic indicator, if available.
symbol_meta	object	Container for static metadata about the economic event/symbol.
symbol_meta.type	string	The type of event, always 'MACRO EVENT'.
symbol_meta.event	string	The name of the economic event, replicated from summary_meta.
symbol_meta.source	string	The source of the economic data, replicated from summary_meta.
symbol_meta.country	string	The country or region to which the economic event pertains, replicated from summary_meta.
symbol_meta.category	string	The category of the economic indicator, replicated from summary_meta.
symbol_meta.country_code	string	The two-letter country code for the country or region, replicated from summary_meta.
symbol_meta.tradingeconomics_symbol	string	The Trading Economics symbol for the event.
symbol_meta.tradingeconomics_importance	number	The importance level of the event as per Trading Economics.
language	string	The language of the summary content (e.g., 'en' for English).
asset_type	string	The general type of asset being discussed, always 'macro' for this content set.
acuity_id	number or null	A unique identifier for the Acuity asset covered in the article.
image	string or null	A URL to an associated image, if available.
id	string	A unique identifier for the specific macro event summary entry.

Macroeconomic Asset-Specific Insights

Field	Type	Description
market_date	string	The date of the market data in YYYY-MM-DD format.
symbol	string	The ticker symbol or code for the macro asset (e.g., currency pair, index, ETF, commodity).
period	string	The reporting period for the summary (e.g., 'Daily').
time_utc_publication	datetime	The UTC timestamp when the summary was published.
summary_status	string	The status of the summary, indicating if it's a new entry or an update (e.g., 'NEW', 'UPDATE').
summary	string	A detailed narrative summary of the asset's performance and related market/macroeconomic events.
headline	string	A concise headline summarizing the key information from the summary.
summary_meta	object	Container for metadata related to the summary content.
summary_meta.tags	array of strings	A list of tags categorizing the summary content (e.g., 'Economic Indicators', 'Market Sentiment').
summary_meta.keywords	array of strings	A list of keywords relevant to the summary content.
summary_meta.categories	array of strings	A list of categories the summary belongs to (e.g., 'Macro News', 'Correlated Moves', 'ETF Constituents').
summary_meta.associated_assets	array of strings	A list of other assets whose performance is associated with or influencing the current asset.
summary_meta.information_score	object	A sub-object detailing the information score or relevance of the summary.
summary_meta.information_score.raw	number	The raw numerical value of the information score.
summary_meta.information_score.label	string	A textual label for the information score (e.g., 'VERY LOW', 'LOW', 'MEDIUM', 'HIGH', 'VERY HIGH').
summary_meta.information_score.level	number	The numerical level of the information score.
performance	object	Container for performance metrics of the asset.
performance.return_percent	number	The percentage return of the asset.
performance.return_vol_adj	number	The volatility-adjusted percentage return of the asset.
performance.performance_as_of	datetime	The UTC timestamp as of which the performance metrics are calculated.
performance.performance_since	datetime	The UTC timestamp from which the performance metrics are calculated.
performance.return_percentile	number	The percentile rank of the asset's return.
performance.vs_spy_percentile	number	The percentile rank of the asset's return compared to the S&P 500 index.
performance.vs_sector_percentile	number	The percentile rank of the asset's return compared to its sector (if applicable).
time_utc_applicable_start	datetime	The UTC start time of the period to which the summary's information is applicable.
time_utc_applicable_end	datetime	The UTC end time of the period to which the summary's information is applicable.
symbol_meta	object	Container for static metadata about the macro asset.
symbol_meta.name	string	The full name of the macro asset (e.g., 'STI 30 Index (Singapore)', 'iShares MSCI Brazil ETF').
symbol_meta.class	string	The class of the asset (e.g., 'index_cfd', 'currency_fiat', 'commodity', 'equity', 'currency_digital').
symbol_meta.mic	string	Market Identifier Code for the exchange where the asset is traded (if applicable).
symbol_meta.figi	string	Financial Instrument Global Identifier for the asset (if applicable).
symbol_meta.gind	string	The GICS Industry of the asset (for ETFs, it might be 'Sector' or 'Broad Equity').
symbol_meta.isin	string	International Securities Identification Number for the asset (if applicable).
symbol_meta.type	string	The type of security (e.g., 'ETP').
symbol_meta.gsector	string	The GICS Sector of the asset (for ETFs, it might be 'Equity' or 'Commodities').
symbol_meta.gsubind	string	The GICS Sub-Industry of the asset (for ETFs, it might be 'Basic Materials', 'Technology', etc.).
language	string	The language of the summary content (e.g., 'en' for English).
asset_type	string	The general type of asset being discussed, always 'macro' for this content set.
acuity_id	number or null	A unique identifier for the Acuity asset.
image	string or null	A URL to an associated image, if available.
id	string	A unique identifier for the specific macro asset summary entry.

REST API

Documentation

Overview: https://api.acuitytrading.com/

Swagger URL: https://api.acuitytrading.com/swagger/index.html

Endpoint: POST /api/MarketInsights

Authentication

Documentation URL: https://api.acuitytrading.com/Security

Exchange your username and password for a Bearer token that you can pass with any request. The token is valid for 14 days.

Sample Request

curl -L -X POST "https://api.acuitytrading.com/token" ^
-H "Content-Type: application/x-www-form-urlencoded" ^
--data-urlencode "grant_type=password" ^
--data-urlencode "username=YOUR_USERNAME" ^
--data-urlencode "password=YOUR_PASSWORD"

Sample Response

{  

    "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJwcm9kdWN0MiIsImh0dHA6Ly9zY2hlbWFzLmFjdWl0eXRyYWRpbmcuY29tL3dzLzIwMTMvMDgvaWRlbnRpdHkvY2xhaW1zL3VzZXJpZCI6IjU3OSIsImh0dHA6Ly9zY2hlbWFzLmFjdWl0eXRyYWRpbmcuY29tL3dzLzIwMTMvMDgvaWRlbnRpdHkvY2xhaW1zL2FwaWtleasdasdasdYWRpbmcuY29tL3dzLzIwMTMvMDgvaWRlbnRpdHkvY2xhaW1zL2lzYWRtaW5pc3RyYXRvciI6IkZhbHNlIiwianRpIjoiZjNjZGMzOTctMjY3Yy00YzMwLWFhNjMtODM1NzZhMjY1YjgyIiwiaWF0IjoxNjM0MzExNDI0LCJuYmYiOjE2MzQzMTE0MjQsImV4cCI6MTYzNTUyMTAyNCwiaXNzIjoiQWN1aXR5IiwiYXVkIjoiQWN1aXR5QXVkaWVuY2UifQ.-kMs-D4XoVOZSvjmSPVpjdiF3_IWflQU6Z27bPg2D3Q",  
    "token_type": "bearer",  
    "expires_in": 1209600,  
    "userName": "YOUR_USERNAME"  
}

Common Requests

Retrieve All News For a Specific Period

Sample Request

curl -L 'https://api.acuitytrading.com/api/marketinsights' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer YOUR_BEARER_TOKEN' \
-d '{
  "StartDate": "2025-08-01",
  "EndDate": "2025-08-20",
  "LanguageCode": "en-gb",
  "Count": 100
}'

Retrieve Specific Article Types

Each Article Type has a particular ID that it can be retrieved with.

Parameter Value	Article Type
equities	Equities Insights
macroeconomicEvent	Macroeconomic Insights
macroeconomicAsset	Macroeconomic Asset-Specific Insights

Sample Request

curl -L 'https://api.acuitytrading.com/api/marketinsights' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer YOUR_BEARER_TOKEN' \
-d '{
  "StartDate": "2025-08-01",
  "EndDate": "2025-08-20",
  "LanguageCode": "en-gb",
  "ArticleTypes": ["equities"],
  "Count": 100
}'

Retrieve Specific Languages

The following languages are supported in the news feed

Language Code	Language Name	ISO2 Language Code
English	en-gb	en
Simplified Chinese	zh-cn	zh-cn
Traditional Chinese	zh-hk	zh-hk
Indonesian	id-id	id
Arabic	ar-ae	ar
Spanish	es-es	es
German	de-de	de
Russian	ru-ru	ru
Turkish	tr-tr	tr
Vietnamese	vi-vn	vi
Japanese	ja-jp	ja
French	fr-fr	fr
Portuguese	pt-pt	pt
Thai	th-th	th
Dutch	nl-nl	nl
Italian	it-it	it
Farsi	fa-ir	fa

Sample Request

curl -L 'https://api.acuitytrading.com/api/marketinsights' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer YOUR_BEARER_TOKEN' \
-d '{
  "StartDate": "2025-08-01",
  "EndDate": "2025-08-20",
  "LanguageCode": "es-es",
  "ArticleTypes": ["equities"],
  "Count": 100
}'

Sample Response

[

    {

        "market_date": "2025-08-20",
        "symbol": "WYNN",
        "period": "Daily",
        "time_utc_publication": "2025-08-19T23:05:00.038554+00:00",
        "summary_status": "UPDATE",
        "summary": "Wynn Resorts Ltd (WYNN) experienced a slight decline of 0.2% in after-hours trading on Tuesday. This movement coincides with a decrease in the Russell 2000 Index, which fell marginally, reflecting broader market sentiment that may be influencing Wynn's stock performance. The correlation between WYNN and the index suggests that fluctuations in the index could be contributing to the observed price movement in Wynn Resorts.",
        "headline": "Wynn Resorts' after-hours decline reflects broader market sentiment. Its stock performance is influenced by the Russell 2000 Index fluctuations.",
        "summary_meta": {
            "tags": [],
            "keywords": [],
            "categories": [
                "Correlated Moves"
            ],
            "associated_assets": [
                "US2000/USD"
            ],
            "information_score": {
                "raw":0.05,
                "label": "VERY LOW",
                "level": 1
            }
        },
        "performance": {
            "return_percent": -0.2,
            "return_vol_adj": -0.2,
            "performance_as_of": "2025-08-19T23:00:00+00:00",
            "performance_since": "2025-08-19T20:00:00+00:00",
            "return_percentile": 32.3,
            "vs_spy_percentile": 45.8,
            "vs_sector_percentile": 48.1
        },
        "time_utc_applicable_start": "2025-08-19T20:00:00+00:00",
        "time_utc_applicable_end": "2025-08-19T23:00:00+00:00",
        "symbol_meta": {
            "lei": "254900CEKKWIHTEAB172",
            "mic": "XNAS",
            "figi": "BBG000LD9JQ8",
            "gind": "Hotels, Restaurants & Leisure",
            "isin": "US9831341071",
            "name": "Wynn Resorts Ltd",
            "type": "Common Stock",
            "class": "equity",
            "country": "US",
            "gsector": "Consumer Discretionary",
            "gsubind": "Casinos & Gaming"
        },
        "language": "en",
        "asset_type": "equities",
        "acuity_id": 112888,
        "image": "images/23aa38fa-599e-4754-b676-153edc7edf58/3106d507-da73-4504-8a58-dc4040c34fa2/{size}.jpg",
        "id": "20250819WYNN"
    }
]

Streaming API

This API provides real-time delivery of Market Insights articles as they are published or modified.

Documentation

Overview: https://api.acuitytrading.com/

Streaming API: https://api.acuitytrading.com/Streaming

Signal Stream: https://api.acuitytrading.com/Streaming#market-insights-parameters

Authentication

Authenticate by including your API key in the server URL when connecting to the Acuity API. For example: wss://api.acuitytrading.com/api/streaming?apiKey=YOUR_API_KEY

Common Subscription Parameters

Each subscription in the Streaming API has the following parameters:

action (string) - could be either subscribe or unsubscribe
topic (string) - for this service it should be set to “marketinsights”

Subscribe to all Market Insights articles.

To subscribe to all insights, simply do not specify any article types.

{
    "action": "subscribe",
    "topic": "marketinsights",
    "lang": "en-gb"
}

Note: the lang parameter is optional. If you omit it, you will receive market insights in all available languages at the same time. This will be useful if you are planning to display multilingual content on your platform.

Subscribe to a filtered set of Market Insights

It’s possible to filter the subscription by the following parameters:

articleTypes - these are the same article types as in the REST API.
- equities
- macroeconomicAsset
- macroeconomicEvent
assetIds - these are the Acuity Asset IDs. If you need to get a list, please reach out to Acuity support via support@acuitytrading.com
assetClassId - these identifiers correspond to the Acuity asset classes. You can only pass one per request.
- 6 - equities
- 8 - indices
- 27 - commodities
- 10027 - FX
- 10032 - Cryptocurrencies
isins - this parameter can contain a list of ISIN codes to retrieve the content with.

A filtered subscription could therefore look like this:

{

    "action": "subscribe",
    "topic": "marketinsights",
    "lang": "en-gb",
    "articleTypes": [
        "equities",
        "macroeconomicEvent"
    ],
    "assetIds": [3, 50]
}

Subscribe to a filtered list of Signal Stream reports using the assets subscription

If you have access to other services, in addition to Market Insights, you might want to explore the possibility of subscribing to all of them in a single subscription. This will provide conveniences with regards to processing and managing the subscriptions.

Subscription documentation: https://api.acuitytrading.com/Streaming#assets-parameter

Here, the includeMarketInsights parameter indicates which service to include.

An example of such a subscription would be this:

{

    "action": "subscribe",
    "topic": "assets",
    "format": 0,
    "lang": "en-gb",
    "includeMarketInsights": true,
    "includeSignalCentreReports": true,
    "assetIds": [3, 50]
}

This subscription includes Market Insights and also the Signal Centre Reports. All of the returned items will be relevant for Apple Inc (assetId: 3) and EURUSD (assetId: 50).

Acuity Market Insights API

This article provides information about the REST API and the Streaming API for the Acuity Market Insights Service.

Article Types

Equities Insights

Macroeconomic Event Insights

Macroeconomic Asset-Specific Insights

Article Format

Equities Insights

Macroeconomic Event Insights

Macroeconomic Asset-Specific Insights

REST API

Documentation

Authentication

Sample Request

Sample Response

Common Requests

Retrieve All News For a Specific Period

Sample Request

Retrieve Specific Article Types

Sample Request

Retrieve Specific Languages

Sample Request

Sample Response

Streaming API

Documentation

Authentication

Common Subscription Parameters

Subscribe to all Market Insights articles.

Subscribe to a filtered set of Market Insights

Subscribe to a filtered list of Signal Stream reports using the assets subscription