Get Corporate Action
Return a tokenized stock’s announced or applied corporate action.
Find the Action ID
Use the UUID at the end of theuri emitted in the token contract’s onchain Announcement event. Do not use the event’s id argument: it can be numeric or include a suffix such as :pre or -1. Announcements without an addressable URI cannot be looked up through this endpoint.
Example
This example retrieves a GOOGLc cash dividend.corporate_action wrapper. It includes the token, description, status, first announcement time, and onchain announcement history in chronological order.
CORPORATE_ACTION_STATUS_ANNOUNCED: the action is announced but has not changed the token’s multiplier.CORPORATE_ACTION_STATUS_APPLIED: the multiplier update has been applied. Only then areapplied_at,multiplier_before, andmultiplier_afterpopulated.
block_number values are decimal strings in JSON.
A malformed UUID returns HTTP 400; an unknown action or an action on a test/non-live token returns HTTP 404. Temporarily unavailable or stale action data returns HTTP 503. These errors use the JSON error format described in the API overview.Path Parameters
The corporate action UUID from the onchain announcement URI.
Response
The corporate action object, not a corporate_action wrapper.
A corporate action announced on a live tokenized equity token. Applied-only fields are omitted until the multiplier update is applied.
The UUID in the final segment of the onchain announcement URI.
The canonical public URI of this corporate action.
The token contract address on Base.
The token ticker symbol.
The action description, such as Cash Dividend or Stock Split.
Whether the action is announced or applied.
CORPORATE_ACTION_STATUS_UNSPECIFIED, CORPORATE_ACTION_STATUS_ANNOUNCED, CORPORATE_ACTION_STATUS_APPLIED The time of the first onchain announcement.
The time of the multiplier-changing announcement. Omitted until applied.
The multiplier before application, normalized from its 18-decimal fixed-point value. Omitted until applied.
The multiplier after application, normalized from its 18-decimal fixed-point value. Omitted until applied.
Onchain announcements, oldest first.