Documentation

Get the market calendar

Get the market calendar for a given month.

Endpoint

Method
GET
URL
/v1/markets/calendar

Headers

Accept
application/xml, application/json, application/javascript
Default: application/xml
Required: false
Authorization
Bearer {access token}
Required: true

Form Parameters

month
Month of the calendar requested.
Optional: true
year
Year of the calendar requested.
Optional: true

Response

Field Description
month The month of the calendar.
year The year of the calendar.
date An ISO representation of the date in YYYY-MM-DD.
status The status of the market on the calendar day (one of: open, closed or holiday).
description A textual description of the market status (i.e., 'Market is Closed')
premarket A container node for premarket hours (only returned on days when market is open).
open A container node for open hours (only returned on days when market is open).
postmarket A container node for postmarket hours (only returned on days when market is open).
start The start time for the premarket/open/postmarket time range.
end The end time for the premarket/open/postmarket time range.

Example

Command

$ curl -H "Authorization: Bearer {access token}" https://api.tradier.com/v1/markets/calendar

Request

GET /v1/markets/calendar HTTP/1.1
Host: api.tradier.com
Accept: application/xml
Authorization: Bearer 098f6bcd4621d373cade4e832627b4f6
Content-Type: application/x-www-form-urlencoded
User-Agent: curl/7.24.0 (x86_64-apple-darwin12.0) libcurl/7.24.0 OpenSSL/0.9.8r zlib/1.2.5

Response

HTTP/1.1 200 OK
Content-Type: application/xml;charset=utf-8

<?xml version="1.0" encoding="UTF-8"?>
<calendar>
  <days>
    <day>
      <date>2014-05-01</date>
      <status>open</status>
      <description>Market is open</description>
      <premarket>
        <start>08:00</start>
        <end>09:30</end>
      </premarket>
      <open>
        <start>09:30</start>
        <end>16:00</end>
      </open>
      <postmarket>
        <start>16:00</start>
        <end>20:00</end>
      </postmarket>
    </day>

    ...

    <day>
      <date>2014-05-30</date>
      <status>open</status>
      <description>Market is open</description>
      <premarket>
        <start>08:00</start>
        <end>09:30</end>
      </premarket>
      <open>
        <start>09:30</start>
        <end>16:00</end>
      </open>
      <postmarket>
        <start>16:00</start>
        <end>20:00</end>
      </postmarket>
    </day>
    <day>
      <date>2014-05-31</date>
      <status>closed</status>
      <description>Market is closed</description>
    </day>
  </days>
  <month>5</month>
  <year>2014</year>
</calendar>

Tradier Inc. and its corresponding technology services (including API services) are distinct and separate from the services provided by Tradier Brokerage Inc. For more information regarding the services of Tradier, Inc., please contact techsupport@tradier.com. For more information regarding the services of Tradier Brokerage, Inc. please contact service@tradierbrokerage.com. Tradier Brokerage Inc. Member FINRA/SIPC

© 2017 Tradier Inc.
  • 11016 Rushmore Drive, Suite 350
  • Charlotte, NC 28277

All materials contained on this site and specifically the API documentation pages are protected by United States copyright law and may not be copied, reproduced, distributed, transmitted, displayed, published or broadcast without the prior written permission of Tradier Inc. The Structure, Format, Layout, Examples and Design of the pages are owned by Tradier Inc, and any efforts to willfully or accidently duplicate a whole or part of the pages on this site is a violation of United States copyright law.