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

# Get Market Clock

`GET /v2/clock`

## Request

- Base URL: `https://broker-api.giftcity.sandbox.in.alpaca.markets`
- URL: `https://broker-api.giftcity.sandbox.in.alpaca.markets/v2/clock`
- Auth: HTTP basic

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 or on the Community Forum.

---

[API](https://skmtc.dev/alpacahq/apis/broker-api.md) - [All operations](https://skmtc.dev/alpacahq/apis/broker-api/llms.txt) - [OpenAPI document](https://skmtc.dev/alpacahq/apis/broker-api/revisions/381b1ecb3ccc?raw)