v1

latestOpenAPI 3.0.42026-07-262045103.2 KB
Status

Get Asset Statuses

This endpoint retrieves information about individual asset trading statuses, including the reason and expected duration. Asset trading can be affected for various reasons such as earnings announcements, dividend events, and global market closures.

Important:

This endpoint should be used in conjunction with the Market Status and Market Data endpoints to get a complete picture of trading availability.

Market Sessions and Holidays

Asset trading follows the same schedule as outlined in Get Current Market Status. During market closures, holidays, or unscheduled downtime, all assets are unavailable for trading.

Earnings and Dividends

Individual assets may be temporarily suspended or limited during earnings announcements and dividend events according to the following schedule:

  • Dividends: Trading is paused from 7:50 PM to 8:10 PM ET on the day before the dividend ex-date.
  • Earnings: Trading is limited for certain assets around earnings announcements, with timing dependent on the announcement schedule. "Limited" here means that the quantity which can be minted in one request is reduced. For exact limits, see Get Trading Limits. For pre-market announcements, trading is suspended from 5:00 AM to 9:31 AM ET. For post-market announcements, trading is suspended from 4:00 PM to 7:30 PM ET. Trading may resume earlier at the platform's discretion.
  • Other corporate actions: Trading is paused for an indeterminate amount of time as needed for Ondo to process the corporate action.

Asset Status Reason Codes

reason.code is one of:

  • ASSET_PAUSED: Asset is paused for trading.
  • ASSET_LIMITED: Asset can be traded, but order size is more limited than usual.

Asset Status Reason Messages

reason.message is one of:

  • cash_dividend
  • stock_dividend
  • stock_split
  • merger
  • acquisition
  • spinoff
  • earnings
  • maintenance

For caching details on this endpoint, please see: Endpoint Caching.

get/v1/status/assets

Response

OK

symbolstring required

The GM token symbol.

status'active' | 'upcoming' required

The current status of the pause. ('active' indicates the pause is live, 'upcoming' indicates it is scheduled for the future)

type'scheduled' | 'unscheduled' required

The type of pause. ('scheduled' indicates a planned pause for events such as dividends, 'unscheduled' indicates an unplanned pause such as emergency maintenance)

startstring

The start time of the pause. ('unscheduled' pauses may not provide a start time.)

endstring

The end time of the pause. ('unscheduled' pauses may not provide an end time.)

eventIdstring

The unique id associated with the pause. (Might be empty if the sharesMultiplier will not be updated for the asset during the pause.)

updateSharesMultipliertrue | false

A boolean flag that indicates whether the sharesMultiplier value will be updated for the asset during this pause or not.

Example response

[
  {
    "symbol": "AAPLon",
    "status": "active",
    "type": "unscheduled",
    "reason": {
      "code": "ASSET_PAUSED",
      "message": "Maintenance",
      "documentation": "https://docs.ondo.finance/"
    },
    "start": "2025-08-05T10:30:00Z",
    "end": "2025-08-05T10:45:00Z",
    "eventId": "94fe2f8f-e69c-45a5-9e48-dd8226dd8e67",
    "updateSharesMultiplier": true
  }
]