---
title: "Get Market Clock"
method: GET
path: "/v2/clock"
tags: ["Calendar"]
---

# Get Market Clock

`GET /v2/clock`

This API serves information about multiple markets: the current time, if it's a market day, the current phase of the market, etc.

## Query parameters

- `markets` string
- `time` string, date-time

## Response `200`

OK

- ClockResp — Clock response.
  - `clocks` Clock[], required
    - `is_market_day` boolean, required — Whether the clock is on a market day.
    - `market` PublicMarket, required — A market.
      - `acronym` string, required — The acronym of the market.
      - `bic` string — Business Identifier Code (BIC/SWIFT).
      - `mic` string — Market identifier code (ISO 10383).
      - `name` string, required — The full name of the market.
      - `timezone` string, required — The timezone of the market.
    - `next_market_close` string, date-time, required — Next market close timestamp
    - `next_market_open` string, date-time, required — Next market open timestamp
    - `phase` 'closed' | 'pre' | 'core' | 'lunch' | 'post', required
    - `phase_until` string, date-time, required — The end of the current phase.
    - `timestamp` string, date-time, required — The time on the clock.

## Other responses

- `400` — One of the request parameters is invalid. See the returned message for details.
- `429` — Too many requests. You hit the rate limit. Use the X-RateLimit-... response headers to make sure you're under the rate limit.
- `500` — Internal server error. We recommend retrying these later. If the issue persists, please contact us on [Slack](https://alpaca.markets/slack) or on the [Community Forum](https://forum.alpaca.markets/).

---

[API](https://skmtc.net/alpacahq/apis/gift-city-extensions-api.md) · [All operations](https://skmtc.net/alpacahq/apis/gift-city-extensions-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/alpacahq/gift-city-extensions-api/revisions/62e3378bb273/schema)