> ## Documentation Index > Fetch the complete documentation index at: https://staging-docs.orderly.network/llms.txt > Use this file to discover all available pages before exploring further. # Get active announcement cards > **Limit: 10 requests per 1 second per IP address** Returns published announcements whose `notification_card_end_time` is later than the current server time. Use this endpoint to load notification cards with their content. Card expiration affects card eligibility. Published announcements remain available through the [list](/build-on-omnichain/restful-api/public/get-announcements-v2) and [detail](/build-on-omnichain/restful-api/public/get-announcement-details) endpoints while they are published. Uses the same official and builder scope as the list endpoint. Results are not paginated and do not include `meta`. The response includes `message` and `i18n` for backward compatibility. For new integrations, read the title and content from `translations` and use `translations.en` for both if the requested language is unavailable. ## OpenAPI ````yaml orderly.openapi get /v2/public/announcement/active openapi: 3.0.1 info: title: EVM description: '' version: 1.0.0 servers: - url: https://api.orderly.org description: Mainnet - url: https://testnet-api.orderly.org description: Testnet security: [] tags: - name: public - name: private paths: /v2/public/announcement/active: get: tags: - public summary: Get active announcement cards description: >- **Limit: 10 requests per 1 second per IP address** Returns published announcements whose `notification_card_end_time` is later than the current server time. Use this endpoint to load notification cards with their content. Card expiration affects card eligibility. Published announcements remain available through the [list](/build-on-omnichain/restful-api/public/get-announcements-v2) and [detail](/build-on-omnichain/restful-api/public/get-announcement-details) endpoints while they are published. Uses the same official and builder scope as the list endpoint. Results are not paginated and do not include `meta`. The response includes `message` and `i18n` for backward compatibility. For new integrations, read the title and content from `translations` and use `translations.en` for both if the requested language is unavailable. parameters: - $ref: '#/components/parameters/AnnouncementBrokerId' - $ref: '#/components/parameters/AnnouncementExcludeOfficial' - $ref: '#/components/parameters/AnnouncementCategoryFilter' - name: locale in: query description: >- Case-insensitive locale: `en`, `zh`, `es`, `fr`, `ja`, or `ko`. If provided, `translations` includes English and the requested translation when available. If omitted, all complete translations are returned. Use `ja` for Japanese. schema: type: string example: zh responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/GetActiveAnnouncementCardsResponse' examples: success: summary: Active notification cards (illustrative) value: success: true timestamp: 1789430400000 data: last_updated_time: 1789426800000 rows: - announcement_id: 12345 message: New perpetual market listing url: null i18n: zh: 新永續合約市場上架 es: null fr: null jp: null ko: null type: LISTING updated_time: 1789426800000 is_official: true category: LISTINGS slug: new-perpetual-market-listing published_time: 1789426800000 notification_card_end_time: 1789513200000 translations: en: title: New perpetual market listing content: A new perpetual market is now available. zh: title: 新永續合約市場上架 content: 新的永續合約市場現已開放交易。 '400': description: >- INVALID_PARAM (-1005). The broker ID does not exist or a query parameter is invalid. content: application/json: schema: $ref: '#/components/schemas/AnnouncementQueryError' security: [] components: parameters: AnnouncementBrokerId: name: broker_id in: query description: >- Builder ID. If omitted, only official announcements are in scope. The ID must refer to an existing builder. schema: type: string AnnouncementExcludeOfficial: name: exclude_official in: query description: Exclude official announcements from the result. schema: type: boolean default: false AnnouncementCategoryFilter: name: category in: query description: >- Case-insensitive category filter: `CAMPAIGN`, `LISTINGS`, `DELISTINGS`, `UPDATES`, `LEGAL`, or `OTHERS`. schema: type: string example: LISTINGS schemas: GetActiveAnnouncementCardsResponse: allOf: - $ref: '#/components/schemas/AnnouncementResponseBase' - type: object required: - data properties: data: type: object required: - last_updated_time - rows properties: last_updated_time: $ref: '#/components/schemas/AnnouncementLastUpdatedTime' rows: description: >- Published announcements currently eligible for notification cards. An empty result is returned as an empty array. type: array items: $ref: '#/components/schemas/AnnouncementWithContent' AnnouncementQueryError: type: object required: - success - code - message properties: success: type: boolean example: false code: type: integer example: -1005 message: type: string example: category is invalid AnnouncementResponseBase: allOf: - $ref: '#/components/schemas/BasicResponse' - type: object required: - timestamp properties: timestamp: description: >- Time the response was generated, as a Unix timestamp in milliseconds. type: integer format: int64 AnnouncementLastUpdatedTime: description: >- Latest update time among published announcements in scope, before category, card eligibility, or pagination filters. A Unix timestamp in milliseconds, or 0 when there are no published announcements in scope. type: integer format: int64 example: 1789426800000 AnnouncementWithContent: allOf: - $ref: '#/components/schemas/AnnouncementSummaryFields' - type: object required: - translations properties: translations: type: object description: >- Titles and content. English is always included. Other complete locales may include zh, es, fr, ja, and ko. The active cards endpoint can limit these with the locale query parameter. required: - en properties: en: $ref: '#/components/schemas/AnnouncementContentTranslation' additionalProperties: $ref: '#/components/schemas/AnnouncementContentTranslation' BasicResponse: required: - success type: object properties: success: description: Indicates whether the request was successful. type: boolean example: true timestamp: description: Server timestamp in milliseconds. type: integer example: 1702989203989 AnnouncementSummaryFields: type: object required: - announcement_id - message - url - i18n - type - updated_time - is_official - category - slug - published_time - notification_card_end_time properties: announcement_id: description: Unique announcement ID. type: integer format: int64 message: description: English title in the legacy response format. type: string url: description: Legacy destination link. The v2 response returns null. type: string nullable: true i18n: description: >- Legacy translated titles. Unavailable translations are null. The Japanese key is jp. type: object additionalProperties: false required: - zh - es - fr - jp - ko properties: zh: type: string nullable: true description: Chinese translation. es: type: string nullable: true description: Spanish translation. fr: type: string nullable: true description: French translation. jp: type: string nullable: true description: Japanese translation. ko: type: string nullable: true description: Korean translation. type: description: >- Legacy category. LISTINGS maps to LISTING and DELISTINGS maps to DELISTING. Other categories use their category value. type: string enum: - CAMPAIGN - LISTING - DELISTING - UPDATES - LEGAL - OTHERS example: LISTING updated_time: description: Last update time, as a Unix timestamp in milliseconds. type: integer format: int64 is_official: description: >- True for an official Orderly announcement and false for a builder announcement. type: boolean category: $ref: '#/components/schemas/AnnouncementCategory' slug: description: >- Stable URL identifier after publication. Unique within the official source or a single builder. type: string published_time: description: Publication time, as a Unix timestamp in milliseconds. type: integer format: int64 notification_card_end_time: description: >- Notification card display deadline, as a Unix timestamp in milliseconds. Null means there is no card deadline. The deadline controls card eligibility. type: integer format: int64 nullable: true AnnouncementContentTranslation: allOf: - $ref: '#/components/schemas/AnnouncementTitleTranslation' - type: object required: - content properties: content: description: Localized announcement content in Markdown. type: string AnnouncementCategory: type: string enum: - CAMPAIGN - LISTINGS - DELISTINGS - UPDATES - LEGAL - OTHERS description: Announcement category. example: LISTINGS AnnouncementTitleTranslation: type: object required: - title properties: title: description: Localized announcement title. type: string ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.