> ## Documentation Index > Fetch the complete documentation index at: https://docs.tickdb.ai/llms.txt > Use this file to discover all available pages before exploring further. # Other Calendar Events > Query other financial events such as macroeconomic releases and market closures by category. ## Plan Access | Plan | Available | | - | :-: | | Free | ❌ | | Starter | ✅ | | Professional | ✅ | | Full-Market Plans (A-Shares, HK Stocks, US Stocks) | ✅ | | Enterprise | ✅ | ## Notes * You must select one `category`. Use the dedicated endpoints for earnings, dividends, splits, and IPO events. * `from` defaults to the current UTC date; `to` defaults to seven days after `from`. Both endpoints of the date range are inclusive. * The default page size is 100; the maximum is 500. Omit `cursor` on the first request. For subsequent pages, keep the filters unchanged and pass the previous `page.next_cursor` verbatim until it is `null`. If you omitted dates initially, use the first response's `data.from` and `data.to` on later pages. * If the API key is restricted to certain markets, send an allowed `market`. An empty `events` array means no events matched. ## Supported Markets | Market | Examples | | - | - | | US Stocks | US | | HK Stocks | HK | | A-Shares | CN | ## Request Parameters | Parameter | Required | Description | | - | :-: | - | | `from` | No | Inclusive start date, `YYYY-MM-DD` | | `to` | No | Inclusive end date, `YYYY-MM-DD` | | `category` | Yes | Other-event category; see the table below | | `market` | No\* | Market filter: `US`, `HK`, or `CN`; required for market-restricted API keys | | `symbols` | No | Comma-separated stock symbols, up to 50 | | `limit` | No | Page size, `1–500`; default `100` | | `cursor` | No | Next-page cursor; omit on the first request | ## Category Values | Value | Description | | - | - | | `macrodata` | Macroeconomic data release | | `closed` | Market closure | | `meeting` | Meeting | | `merge` | Merger or acquisition | | `halt_resume` | Trading halt or resumption | | `special_treatment` | Special treatment | | `special_treatment_start` | Start of special treatment | | `special_treatment_end` | End of special treatment | | `listing_status` | Listing status | | `listing_suspension` | Listing suspension | | `listing_resumption` | Listing resumption | | `delisting` | Delisting | | `lockup_expiry` | Lock-up expiry | ## Request Example ```bash theme={null} curl -H "X-API-Key: YOUR_API_KEY" \ "https://api.tickdb.ai/v1/fundamentals/calendar/other?from=2026-09-21&to=2026-09-28&market=US&category=macrodata&limit=100" ``` ## Response Fields A successful response contains top-level `code`, `data`, and `page` fields. | Field | Description | | - | - | | code | Business status code; `0` means success. | | data | Date range and events on this page. | | └─ from | Query start date, `YYYY-MM-DD`. | | └─ to | Query end date, `YYYY-MM-DD`. | | └─ events | Events on this page; an empty array if none match. | |   └─ event\_datetime | Event time as a UTC date-time string. | |   └─ market | Associated market. | |   └─ symbol | Associated product symbol; may be empty when not applicable. | |   └─ category | Detailed event category; may be more specific than the request category. | |   └─ event\_type | Event type. | |   └─ content | Event description. | |   └─ counter\_name | Associated name; may be `null`. | |   └─ currency | Currency; may be `null`. | |   └─ star | Importance level. | |   └─ date\_type | Event date type; may be `null`. | |   └─ data | Optional array of additional event data. | |     └─ key | Additional-data key. | |     └─ value\_raw | Raw value; may be `null`. | |     └─ value\_text | Display value; may be `null`. | |     └─ value\_type | Value type. | | page | Pagination information. | | └─ next\_cursor | Next-page cursor; `null` on the final page. | | └─ limit | Current page limit. | ## OpenAPI ````yaml openapi.en.yaml GET /v1/fundamentals/calendar/other openapi: 3.1.0 info: title: TickDB API description: TickDB unified real-time market data API via REST and WebSocket. version: 1.0.3 contact: email: support@tickdb.ai servers: - url: https://api.tickdb.ai description: Production server security: - ApiKeyAuth: [] paths: /v1/fundamentals/calendar/other: get: tags: - fundamentals-events summary: Other Calendar Events description: >- Query other financial events such as macroeconomic releases and market closures by category. operationId: getFundamentalsCalendarOther parameters: - $ref: '#/components/parameters/CalendarFromQuery' - $ref: '#/components/parameters/CalendarToQuery' - $ref: '#/components/parameters/CalendarOtherCategoryQuery' - $ref: '#/components/parameters/CalendarMarketQuery' - $ref: '#/components/parameters/CalendarSymbolsQuery' - $ref: '#/components/parameters/CalendarLimitQuery' - $ref: '#/components/parameters/CursorQuery' responses: '200': $ref: '#/components/responses/CalendarResponse' default: $ref: '#/components/responses/ErrorResponse' components: parameters: CalendarFromQuery: name: from in: query required: false schema: type: string format: date description: Inclusive start date, `YYYY-MM-DD` CalendarToQuery: name: to in: query required: false schema: type: string format: date description: Inclusive end date, `YYYY-MM-DD` CalendarOtherCategoryQuery: name: category in: query required: true schema: type: string enum: - macrodata - closed - meeting - merge - halt_resume - special_treatment - special_treatment_start - special_treatment_end - listing_status - listing_suspension - listing_resumption - delisting - lockup_expiry description: Other-event category; see the table below CalendarMarketQuery: name: market in: query required: false schema: type: string enum: - US - HK - CN description: >- Market filter: `US`, `HK`, or `CN`; required for market-restricted API keys CalendarSymbolsQuery: name: symbols in: query required: false schema: type: string minLength: 1 examples: - AAPL.US - AAPL.US,700.HK,600519.SH description: Comma-separated stock symbols, up to 50 CalendarLimitQuery: name: limit in: query required: false schema: type: integer minimum: 1 maximum: 500 default: 100 description: Page size, `1–500`; default `100` CursorQuery: name: cursor in: query required: false schema: type: string minLength: 1 description: Next-page cursor; omit on the first request responses: CalendarResponse: description: Earnings Calendar response. content: application/json: schema: $ref: '#/components/schemas/CalendarEnvelope' ErrorResponse: description: >- Error response. Common HTTP statuses include 400 (invalid parameters), 401 (authentication failed), 403 (permission or quota restriction), 404 (no matching data), 429 (rate limit), and 503 (service temporarily unavailable). content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' examples: missingAPIKey: summary: Missing API key value: code: '1002' message: API key is required. Provide via X-API-Key header error: '1002' missingKind: summary: Missing required parameter value: code: 40001 message: kind is required data: null endpointForbidden: summary: API key cannot access this endpoint value: code: 3009 message: This endpoint is not allowed for your API key data: null marketForbidden: summary: API key cannot access this market value: code: 3010 message: Fundamentals market not allowed for your API key data: market: US noAvailableSource: summary: Data temporarily unavailable value: code: 5003 message: Data is temporarily unavailable data: null notFound: summary: No matching data value: code: 40404 message: shareholder detail not found data: null businessNoData: summary: No business data matches the query value: code: 40405 message: valuation time series not found data: null schemas: CalendarEnvelope: allOf: - $ref: '#/components/schemas/SuccessEnvelope' - type: object required: - page properties: data: $ref: '#/components/schemas/CalendarData' page: $ref: '#/components/schemas/CalendarPage' ErrorEnvelope: type: object required: - code - message properties: code: description: >- TickDB API business error code; may be an integer or string. Convert it to a string before comparing. oneOf: - type: integer - type: string message: type: string description: Error description. error: type: string description: >- Compatibility error identifier; present only in some error responses. data: description: Optional error context; may be null, an object, or an array. oneOf: - type: 'null' - type: object additionalProperties: true - type: array items: {} SuccessEnvelope: type: object required: - code - data properties: code: type: integer const: 0 description: Business status code; `0` means success. CalendarData: type: object required: - from - to - events properties: from: type: string format: date description: Query start date, `YYYY-MM-DD`. to: type: string format: date description: Query end date, `YYYY-MM-DD`. events: type: array description: Events on this page; an empty array if none match. maxItems: 500 items: $ref: '#/components/schemas/FullCalendarEvent' additionalProperties: false CalendarPage: type: object required: - next_cursor - limit properties: next_cursor: type: - string - 'null' description: Next-page cursor; `null` on the final page. limit: type: integer minimum: 1 maximum: 500 description: Current page limit. additionalProperties: false FullCalendarEvent: type: object required: - category - content - counter_name - currency - date_type - event_datetime - event_type - market - star - symbol properties: category: type: string description: >- Detailed event category; may be more specific than the request category. event_datetime: type: string format: date-time description: Event time as a UTC date-time string. symbol: type: string description: Associated product symbol; may be empty when not applicable. market: type: string enum: - US - HK - CN description: Associated market. event_type: type: string description: Event type. content: type: string description: Event description. counter_name: type: - string - 'null' description: Associated name; may be `null`. date_type: type: - string - 'null' description: Event date type; may be `null`. star: type: integer description: Importance level. currency: type: - string - 'null' description: Currency; may be `null`. issue_price: type: - string - 'null' description: >- IPO issue price; returned for applicable events and `null` when unavailable. data: type: array description: Additional event data; omitted when unavailable. items: $ref: '#/components/schemas/CalendarEventData' additionalProperties: false CalendarEventData: type: object required: - key - value_type - value_text - value_raw properties: key: type: string description: Additional-data key. value_type: type: string description: Value type. value_text: type: - string - 'null' description: Display value; may be `null`. value_raw: type: - string - 'null' description: Raw value; may be `null`. additionalProperties: false securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-Key ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.