Tokenized Stocks API
Get Corporate Action
Return a tokenized stock’s announced or applied corporate action.
GET
Get 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.cURL
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.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.