Query calendar management configuration

POSThttps://b-api.lbkrs.com/v1/datasets/clearing_calendars

Authorization

AuthorizationstringheaderRequired

Send the Broker ACCESS_TOKEN as Authorization: Bearer <token>.

Permission

clearing.clearing_calendar_view

The Broker ACCESS_TOKEN must be granted the permission above, or the call will be rejected.

Request body application/json

filtersobject

Child attributes

marketstring

Values are dynamically queried from clearing_markets_all (not fixed); fetch them live via GET /v1/datasets/refs/clearing_markets.

trade_dateobject

Range filter; both bounds are optional (omit a bound to leave that side unbounded).

Child attributes

gtestring

ltestring

typestring

Values

1: Normal Day (Trade&Settlement)
2: Non-Settlement Day (Trade Only)
3: Non-Trading Day (Settlement Only)
4: Typhoon
5: Holidays

pageinteger

page_sizeinteger

Responses

HTTP 200Paginated list result.

Standard response envelopecodemessagedata

dataobjectdata structure

listarray<object>required

Child attributes

trade_datestring

typestring

type_valstring

Raw value behind field type. The type field returns the human-readable display value resolved via a dictionary/join mapping, while this field returns the underlying code/ID before that mapping.

totalintegerrequired

HTTP 400Bad request. Check the business error code in code and the error details in message.

Standard response envelopecodemessagedata

dataobjectdata structure

No nested fields

HTTP 401The user is not authenticated, or the login session has expired.

Standard response envelopecodemessagedata

dataobjectdata structure

No nested fields

HTTP 403The current account is not authorized to use this feature. Grant the required permission to the account in User Permission.

Standard response envelopecodemessagedata

dataobjectdata structure

No nested fields

HTTP 408The request timed out. Check the business error code in code and the error details in message.

Standard response envelopecodemessagedata

dataobjectdata structure

No nested fields

Request

curl --request POST \
  --url 'https://b-api.lbkrs.com/v1/datasets/clearing_calendars' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json'
  --data '{
  "filters": {},
  "page": 1,
  "page_size": 20
}'

Response

{
  "code": 0,
  "message": "success",
  "data": {
    "list": [
      {
        "trade_date": "20250101",
        "type": "1",
        "type_val": "1"
      }
    ],
    "total": 1
  }
}

Export

The export endpoint uses the same filters as this Dataset query.

POSThttps://b-api.lbkrs.com/v1/datasets/clearing_calendars/download

clearing.clearing_calendar_view

Export options Export records Download result