Acuity News Service API Documentation

How to use the Acuity News Service API and make the most out of the used content types.

Article Types

There are currently three types of news articles available in the Acuity News Service.

Key Points
Summary
Snapshots

Snapshots

This is a series of short articles that summarise what is happening with a certain selection of assets (currency pairs in particular) that provide some actionable information with regards to possible direction of the price movements.

Key Points

Three bullet points featuring state-based urgency flags—single descriptive words like Critical, Favourable, Alarming, Expected, Deteriorating, Cautious, Positive, or Anticipated—paired with recommended actions for traders seeking fast, actionable insights.

Summary

A headline and concise overview for users seeking quick comprehension. Like other news types it is generated from content sourced from central and commercial banks such as the Federal Reserve, Bank of England, Goldman Sachs, Deutsche Bank, ING, and others.

Article Format

Snapshots

Field Name	Description
gen_time	The generation time of the output (UTC)
format	The News Type (e.g. tile)
language	The language of the content piece
source_id	Identifier of the content source (e.g., Research by ECB)
id	Article identifier.
news-image	The URL that points to an image. The URL prefix is: https://acuitycdn.azureedge.net/ The image URL is going to contain a {size} placeholder. To get the actual image, replace the {size} placeholder with either sm, md, or lg value. sm values are used in Calendar and NewsIQ news articles. md values are used in news tiles everywhere else in the tools (e.g., Hot News in AssetIQ).
tilesContent.asset_information.name	The asset symbol or name
tilesContent.asset_information.ISIN	The asset code (ISIN, DJ asset codes)
tilesContent.asset_information.old_target	The current Sentiment Analysis Engine Target ID
tilesContent.asset_information.new_target	The new Sentiment Analysis Engine version Target ID
tilesContent.emoji	Emoji for the tile
tilesContent.state	Bullish or Bearish state
tilesContent.vague	How vague or concrete the content of the article is, with respect to the instrument covered in the article.
tilesContent.tags	List of tags assigned to this content.
tilesContent.tags.name	Tag label
tilesContent.tags.id	Tag ID
tilesContent.tags.prob	Probability the text relates to this tag
tilesContent.summary	List of summary objects for the content
tilesContent.summary.language	ISO 2 code for the content's language
tilesContent.summary.text	Evaluation paragraph for the currency pair
tilesContent.summary.recommendation	Suggested action for currency pair
tilesContent.summary.subtitle	Subtitle for the tile content
tilesContent.summary.headline	The headline of the article

Summary

Field Name	Description
gen_time	The generation time of the output (UTC)
format	The News Type (e.g. tile)
language	The language of the content piece
source_id	Identifier of the content source (e.g., Research by ECB)
id	Article identifier.
news-image	The URL that points to an image. The URL prefix is: https://acuitycdn.azureedge.net/ The image URL is going to contain a {size} placeholder. To get the actual image, replace the {size} placeholder with either sm, md, or lg value. sm values are used in Calendar and NewsIQ news articles. md values are used in news tiles everywhere else in the tools (e.g., Hot News in AssetIQ).
tags	List of tags assigned to the content
tags.name	Tag label.
tags.id	ID of the tag
tags.prob	Probability the text relates to the tag
assets	List of assets (instruments, people, topics) that are relevant for this article.
asset_information.name	The asset symbol or name
asset_information.ISIN	The asset code (ISIN, DJ asset codes)
asset_information.old_target	The current SAE Target ID
asset_information.new_target	The new SAE version Target ID
content	Object containing the main content details
content.intro	List of introductory content
content.intro.headline	Generated headline for the introductory content
content.intro.summary	Summary for the introductory content
content.emojis	List of emojis associated with the content
content.keypoints	List of key points (amount varies from story to story)
content.keypoints.title	Title of the key point
content.keypoints.summary	Summary of the key point

Key Points

Field Name	Description
gen_time	The generation time of the output (UTC)
format	The News Type (e.g. tile)
language	The language of the content piece
source_id	Identifier of the content source (e.g., Research by ECB)
id	Article identifier.
news-image	The URL that points to an image. The URL prefix is: https://acuitycdn.azureedge.net/ The image URL is going to contain a {size} placeholder. To get the actual image, replace the {size} placeholder with either sm, md, or lg value. sm values are used in Calendar and NewsIQ news articles. md values are used in news tiles everywhere else in the tools (e.g., Hot News in AssetIQ).
tags	List of tags
tags.name	Tag label.
tags.id	Tag ID
tags.prob	Probability the text relates to this tag
content	Content details
content.intro	List of introductory information
content.intro.language	ISO2 code for the language of the content
content.intro.headline	Generated headline for the content
content.intro.summary	Introductory summary for the content
content.emoji1	Emoji for first keypoint
content.emoji2	Emoji for second keypoint
content.emoji3	Emoji for third keypoint
content.keypointn	Keypoint N keys (N = 3 in this format)
content.keypointn.language	ISO 2 code for the language of the content
content.keypointn.title	Title for the key point
content.keypointn.state	Status, e.g., bullish or bearish
content.keypointn.recommended_action	Recommended action based on the content
content.keypointn.summary	Summary of the key point

REST API

Documentation

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

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

Endpoint: POST /api/AcuityNews

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 --location 'https://api.acuitytrading.com/api/acuitynews' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer YOUR_BEARER_TOKEN' \ --data '{ "StartDate": "2025-05-10", "EndDate": "2025-06-10", "LanguageCode": "en-GB", "Count": 10, "FillAssetInfo": true }'

Retrieve Specific Article Types

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

ID	Article Type
1	Summary
2	Key Points
3	Snapshots (also known as Tile)

Sample Request

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

Sample Response

[ { "gen_time": "2025-06-09 22:47:47", "tags": [ { "name": "Macroeconomics", "id": "dcb020e6-651b-4e3e-9c73-eed27cedd291", "prob": 0.3 }, { "name": "InterestRate", "id": "e27abdc5-4754-4bcd-9a99-bce576aebb46", "prob": 0.2 }, { "name": "Australia", "id": "e90c822e-41b5-476e-bd7b-1a7d38f839fd", "prob": 0.2 }, { "name": "CPI", "id": "fa63261a-6207-4ced-9e78-8bd4b0c24926", "prob": 0.1 }, { "name": "NewZealand", "id": "1a67f189-3d10-416a-881e-dc45f9300401", "prob": 0.1 }, { "name": "ConsumerConfidence", "id": "3522750b-70f5-48f8-97a7-6a9add3a0581", "prob": 0.1 } ], "image": "news-images/dcb020e6-651b-4e3e-9c73-eed27cedd291/7-{size}.jpg", "assets": [ { "name": "AUD/USD", "ISIN": null, "old_target": "IAUDUS_LASDQEJO", "new_target": "999000076" }, { "name": "NZD/USD", "ISIN": null, "old_target": "INZDUS_SNUVLGCQ", "new_target": "999000091" }, { "name": "XAU/USD", "ISIN": null, "old_target": null, "new_target": null }, { "name": "S&P500", "ISIN": null, "old_target": "IXSP5_MWUFLSCT", "new_target": "999000119" } ], "format": "key", "language": "en", "content": { "intro": { "headline": "Westpac's Economic Insights: The Evolving Landscape of Policy and Consumer Sentiment", "summary": "In the latest weekly economic report from Westpac, analysts highlight several key economic indicators affecting Australia and New Zealand. Market sentiment appears to have rebounded following a period of uncertainty, particularly in light of the RBA's recent 25bp rate cut and overall steady financial markets. The report flags the upcoming releases of various economic metrics, including consumer sentiment, retail spending, and key inflation data across multiple regions including the US and Europe. A cautious outlook prevails as policymakers navigate the implications of weak GDP data, which only rose 0.2% in Q1, potentially prompting further adjustments to monetary policy. In New Zealand, the trade balance showcases mixed advancements, with export prices rising against some setbacks in service spending. Analysts are particularly focused on supportive signs in the housing market following interest rate adjustments. Investors should stay alert for the potential rise in consumer spending as lower interest rates filter through to households, affecting overall economic growth." }, "emoji1": "📉", "emoji2": "📈", "emoji3": "🔄", "keypoint1": { "title": "RBA's Rate Policy ", "state": "Cautious", "recommended_action": "Investors should closely monitor RBA's next moves regarding interest rates.", "summary": "The RBA's monetary policy adjustments are critical as the economy remains sensitive to a tight labour market and inflation pressures." }, "keypoint2": { "title": "Consumer Sentiment on the Rise ", "state": "Positive", "recommended_action": "Consider increasing positions in equities in response to improved consumer sentiment.", "summary": "The unexpected rise in consumer sentiment reflects a stabilising market sentiment post-election and in response to monetary easing." }, "keypoint3": { "title": "New Zealand's Mixed Economic Signals ️", "state": "Advertent", "recommended_action": "Remain vigilant about NZ economic data releases that could trigger changes in market positions.", "summary": "New Zealand's trade dynamics reveal both challenges and opportunities as export prices increase, albeit with caution on service sectors." } }, "source_id": "cb9f78ad-2f10-4070-8ca9-bd84d0e51cea", "id": "20250609224747_cb9f78ad-2f10-4070-8ca9-bd84d0e51cea_key", "AssetIds": [ 101828, 102737, 102766 ], "AssetClassIds": [ 10027, 8 ] } ]