Skip to content

Notice

Get Latest Notice

Get the latest active notice based on business type, language and timezone in request headers.

HTTP Request

GET
/api/perp-market-api/notice

Request Frequency Restriction:

  • Recommended: no more than 3 times per second

Request Parameters

Name Type Required Description
bizType string Yes Business type, e.g., "Perpetual" or "Swap"

Request Headers (Optional)

Name Type Required Description
lang string No Language code, e.g., "en", "zh-CN", default is "en"
Timezone string No Timezone offset hours, e.g., "7" for UTC+7, "-5" for UTC-5, default is UTC

Response Fields Description

Name Type Description
id long Notice ID
title string Notice title
content string Notice content
bizType string Business type
startTime long Start time (millisecond timestamp)
endTime long End time (millisecond timestamp)
languageCode string Language code
timezone string Timezone

Response Example

{
  "code": 200,
  "message": "success",
  "data": {
    "id": 1,
    "title": "System Maintenance Notice",
    "content": "The system will undergo maintenance tonight...",
    "bizType": "Perpetual",
    "startTime": 1700000000000,
    "endTime": 1700086400000,
    "languageCode": "en",
    "timezone": "0"
  }
}

Description

  • If lang header is not specified, English is used by default
  • If Timezone header is not specified, UTC is used by default