Acuity Corporate Events API

Supported Event Classes

We currently support the following event classes in the Acuity Events API

• Earnings
• Ex-Dividend Events
• Dividend Payment Events
• Stock Splits

Earnings

Earnings is a corporate-action data type that represents a company’s scheduled and reported financial results for a specific fiscal period, including the announcement timing, the Earnings Per Share value, and their comparison to market expectations.

Event Format

Field Name	Data Type	Description	Example
EventClass	string	The event class that corresponds to this item in the API response.	Earnings
EPSActual	float	The Earnings Per Share Actual value	1.42
EPSForecast	float	The Earnings Per Share forecast value	-0.2266
EPSPrevious	float	The previous Earnings Per Share value	-0.22
EventTime	string	The time of the earnings report (BMO - before market open, AMC - after market close, DMT - during market time, NA - not available).	AMC
Id	string	The unique identifier of the event in the Acuity database	2026-01-12_US88025U1097_TXG_Earnings
AssetId	int	The Acuity Asset ID of the instrument mentioned in the event.	114083
AssetTicker	string	The symbol of the instrument.	TXG
ISIN	string	The ISIN code of the instrument.	US88025U1097
EventName	string	The name of the event	Q4 2025 Results
EventDate	string	The date and time of the event (UTC)	2026-01-12T00:00:00
IsLatest	bool	A flag indicating if this is the most recent available event for this company with this event class	false

Ex-Dividend Events

Ex-Dividend Date is a corporate-action data type that identifies the first trading day on which a stock trades without entitlement to the next declared dividend. Investors who purchase the stock on or after this date will not receive the upcoming dividend.

Event Format

Field Name	Data Type	Description	Example
EventClass	string	The event class that corresponds to this item in the API response.	ExDividend
DividendAmount	float	The expected dividend amount to be paid on the dividend payment date for this company	0.69
Id	string	The unique identifier of the event in the Acuity database	2026-01-12_US92343V1044_VZ_ExDividend
AssetId	int	The Acuity Asset ID of the instrument mentioned in the event.	112967
AssetTicker	string	The symbol of the instrument.	VZ
ISIN	string	The ISIN code of the instrument.	US92343V1044
EventName	string	The name of the event	Quarterly 2026 Ex-Dividend Date
EventDate	string	The date and time of the event (UTC)	2026-01-12T00:00:00
IsLatest	bool	A flag indicating if this is the most recent available event for this company with this event class	true

Dividend Payment Events

Dividend Payment Date is a corporate-action data type that specifies the date on which a declared dividend is actually paid to eligible shareholders. It marks when cash or shares are distributed to investors who were on record as of the record date.

Event Format

Field Name	Data Type	Description	Example
EventClass	string	The event class that corresponds to this item in the API response.	DividendPayment
DividendAmount	float	The expected dividend amount to be paid on the dividend payment date for this company	2.22
Id	string	The unique identifier of the event in the Acuity database	2026-01-12_US91879Q1094_MTN_DividendPayment
AssetId	int	The Acuity Asset ID of the instrument mentioned in the event.	115265
AssetTicker	string	The symbol of the instrument.	MTN
ISIN	string	The ISIN code of the instrument.	US91879Q1094
EventName	string	The name of the event	Quarterly 2026 Dividend Payment Date
EventDate	string	The date and time of the event (UTC)	2026-01-12T00:00:00
IsLatest	bool	A flag indicating if this is the most recent available event for this company with this event class	true

Stock Splits

Stock Split is a corporate-action data type that represents a change in a company’s share structure in which existing shares are converted into a different number of shares based on a defined split ratio (FromFactor to ToFactor). It adjusts the number of shares outstanding and the per-share price while preserving the company’s overall market value and each shareholder’s proportional ownership.

Event Format

Field Name	Data Type	Description	Example
EventClass	string	The event class that corresponds to this item in the API response.	Splits
FromFactor	int	FromFactor represents the number of pre-split (old) shares that are required to be exchanged.	30
ToFactor	int	ToFactor represents the number of post-split (new) shares issued in return.	1
Id	string	The unique identifier of the event in the Acuity database	2026-01-02_US70387R1068_PAVM_Splits
AssetId	int	The Acuity Asset ID of the instrument mentioned in the event.	116208
AssetTicker	string	The symbol of the instrument.	PAVM
ISIN	string	The ISIN code of the instrument.	US70387R1068
EventName	string	The name of the event.	PAVmed Inc 1-for-30 reverse split: share update date.
EventDate	string	The date and time of the event (UTC)	2026-01-02T00:00:00
IsLatest	bool	A flag indicating if this is the most recent available event for this company with this event class	true

REST API

Documentation

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

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

• Endpoint: POST /api/AcuityEvents

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 --location 'https://api.acuitytrading.com/api/AcuityEvents' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJwcm9kdWN0MiIsImh0dHA6Ly9zY2hlbWFzLmFjdWl0eXRyYWRHkvY2xhaW1zL3VzZXJpZCI6IjU3OSIsImh0dHA6Ly9zY2hlbWFzLmFjdWl0eXRyYWRpbmcuY29tL3dzLzIwMTMvMDgvaWRlbnRpdHkvY2xhaW1zL2FwaWtleSI6ImI5MDNmYjcxLTE5ZDItNGFhNy05NjBlLTRkZWE4OGRmZTQyMSIsImh0dHA6LRyYWRpbmcuY29tL3dzLzIwMTMvMDgvaWRlbnRpdHkvY2xhaW1zL2lzYWRtaW5pc3RyYXRvciI6IlRydWUiLCJqdGkiOiIxOTFiZWRjYi0yOGIwLTQ4ZTItYjYxOC00NTU1ZjFmM2Y5YzMiLCJpYXQiOjE3Njc3NzQ4NzcsIm5iZiI6MTc2Nzc3NDg3NywiZXhwIjoxNzY4OTg0NDc3LCJpc3MiOiJBY3VpdHkiLCJhdWQiOiJBY3VpdHlBdWRpZW5jZSJ9.JBPvEDH2th5iB0p-qyWnv3dX0rycGm7XiB6Wo98OoVI' \
--header 'Content-Type: application/json' \
--data '{
    "StartDate": "2025-01-12T14:50:12.281Z",
    "EndDate": "2026-01-12T14:50:12.281Z",
    "EventClasses": [
        "Earnings",
        "ExDividend",
        "DividendPayment"
    ],
    "Count": 100
}'

Sample Response

[
    {
        "EventClass": "ExDividend",
        "DividendAmount": 0.69,
        "Id": "2026-01-12_US92343V1044_VZ_ExDividend",
        "AssetId": 112967,
        "AssetTicker": "VZ",
        "ISIN": "US92343V1044",
        "EventName": "Quarterly 2026 Ex-Dividend Date",
        "EventDate": "2026-01-12T00:00:00",
        "IsLatest": true
    },
    {
        "EventClass": "DividendPayment",
        "DividendAmount": 2.22,
        "Id": "2026-01-12_US91879Q1094_MTN_DividendPayment",
        "AssetId": 115265,
        "AssetTicker": "MTN",
        "ISIN": "US91879Q1094",
        "EventName": "Quarterly 2026 Dividend Payment Date",
        "EventDate": "2026-01-12T00:00:00",
        "IsLatest": true
    },
    {
        "EventClass": "Earnings",
        "EPSActual": null,
        "EPSForecast": -0.2266,
        "EPSPrevious": -0.22,
        "EventTime": "AMC",
        "Id": "2026-01-12_US88025U1097_TXG_Earnings",
        "AssetId": 114083,
        "AssetTicker": "TXG",
        "ISIN": "US88025U1097",
        "EventName": "Q4 2025 Results",
        "EventDate": "2026-01-12T00:00:00",
        "IsLatest": false
    }
]

Common Requests

Find Specific Event Types

Sample Request

curl --location 'https://api.acuitytrading.com/api/AcuityEvents' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1Ni3NzQ4NzcsIm5iZiI6MTc2Nzc3NDg3NywiZXhwIjoxNzY4OTg0NDc3LCJpc3MiOiJBY3VpdHkiLCJhdWQiOiJBY3VpdHlBdWRpZW5jZSJ9.JBPvEDH2th5iB0p-qyWnv3dX0rycGm7XiB6Wo98OoVI' \
--header 'Content-Type: application/json' \
--data '{
    "StartDate": "2025-01-12T14:50:12.281Z",
    "EndDate": "2026-01-12T14:50:12.281Z",
    "EventClasses": [
        "Earnings",
        "ExDividend",
        "DividendPayment"
    ],
    "Count": 100
}'

Find Events by Ticker

Sample Request

curl --location 'https://api.acuitytrading.com/api/AcuityEvents' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJwcm9kdWN0MiIsImh0dHA6Ly9zY2hlbWFzLmFjdWl0eWUiLCJqdGkiOiIxOTFiZWRjYi0yOGIwLTQ4ZTItYjYxOC00NTU1ZjFmM2Y5YzMiLCJpYXQiOjE3Njc3NzQ4NzcsIm5iZiI6MTc2Nzc3NDg3NywiZXhwIjoxNzY4OTg0NDc3LCJpc3MiOiJBY3VpdHkiLCJhdWQiOiJBY3VpdHlBdWRpZW5jZSJ9.JBPvEDH2th5iB0p-qyWnv3dX0rycGm7XiB6Wo98OoVI' \
--header 'Content-Type: application/json' \
--data '{
    "StartDate": "2025-01-12T14:50:12.281Z",
    "EndDate": "2026-01-12T14:50:12.281Z",
    "AssetTickers": ["MSFT", "AAPL"],
    "Count": 100
}'

Find Events by ISIN

Sample Request

curl --location 'https://api.acuitytrading.com/api/AcuityEvents' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJwcm9kdWN0MiIsImh0dHA6Ly9zY2hlbWFzLmFjdWl0eXRyYWRpbmcuY29tL3dzLzIwMTMvMDgvaWRlbnRpdHkvY2xhaW1zL3VzZXJpZCI6IjU3OSIsImh0dHA6Ly9zYsIm5iZiI6MTc2Nzc3NDg3NywiZXhwIjoxNzY4OTg0NDc3LCJpc3MiOiJBY3VpdHkiLCJhdWQiOiJBY3VpdHlBdWRpZW5jZSJ9.JBPvEDH2th5iB0p-qyWnv3dX0rycGm7XiB6Wo98OoVI' \
--header 'Content-Type: application/json' \
--data '{
    "StartDate": "2024-01-12T14:50:12.281Z",
    "EndDate": "2026-01-12T14:50:12.281Z",
    "ISINCodes": ["US88160R1014"],
    "Count": 100
}'

Streaming API

The purpose of this API is to deliver the Acuity Events in real time after their publication and/or modification.

Documentation

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

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

• Acuity Events: https://api.acuitytrading.com/Streaming#acuity-events-parameters

Authentication

To authenticate, you need to pass your API key in the server URL when connecting to Acuity API. 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": "ACTION",
    "topic": "TOPIC"
}

Parameter	Type	Possible Values
"action"	string	subscribe, unsubscribe
"topic"	string	assets, acuityevents, other supported topics (requires additional services)

Subscribe to all news

Sample request

{
    "action" : "subscribe",
    "topic" : "acuityevents"
}

Subscribe to events of a specific event class

Sample request

{
    "action": "subscribe",
    "topic": "acuityevents",
    "eventClasses": ["Earnings", "ExDividend"]
}

Subscribe to events with specific tickers

Sample request

{
    "action": "subscribe",
    "topic": "acuityevents",
    "tickers": ["MSFT", "PFE"]
}

Expected Message Types in the Response

Message Type	Description
Insert message	This message type is sent when a new event is published.
Update message	This message is sent when event content needs to be updated. Any part of the event can be updated. Find the previously saved event by ID and fully replace its contents. If no event can be found with the ID, simply add the newly received event to your database.