GET
/
api
/
v1
/
market
/
calendars
curl -X GET "https://api.roxom.com/api/v1/market/calendars" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

{
  "data": [
    {
      "date": "2024-01-01",
      "name": "New Year's Day",
      "type": "holiday",
      "marketStatus": "closed",
      "affectsInstruments": ["US500-BTC"],
      "description": "New Year's Day - US markets closed",
      "tradingHours": null
    },
    {
      "date": "2024-01-15",
      "name": "Martin Luther King Jr. Day",
      "type": "holiday",
      "marketStatus": "closed",
      "affectsInstruments": ["US500-BTC"],
      "description": "Martin Luther King Jr. Day - US markets closed",
      "tradingHours": null
    },
    {
      "date": "2024-02-19",
      "name": "Presidents' Day",
      "type": "holiday", 
      "marketStatus": "closed",
      "affectsInstruments": ["US500-BTC"],
      "description": "Presidents' Day - US markets closed",
      "tradingHours": null
    },
    {
      "date": "2024-11-29",
      "name": "Day After Thanksgiving",
      "type": "earlyClose",
      "marketStatus": "earlyClose",
      "affectsInstruments": ["US500-BTC"],
      "description": "Early close at 1:00 PM EST",
      "tradingHours": {
        "start": "09:30:00",
        "end": "13:00:00",
        "timezone": "EST"
      }
    },
    {
      "date": "2024-07-04",
      "name": "Independence Day",
      "type": "holiday",
      "marketStatus": "closed",
      "affectsInstruments": ["US500-BTC"],
      "description": "Independence Day - US markets closed",
      "tradingHours": null
    },
    {
      "date": "2024-12-24",
      "name": "Christmas Eve",
      "type": "earlyClose",
      "marketStatus": "earlyClose",
      "affectsInstruments": ["US500-BTC"],
      "description": "Early close at 1:00 PM EST",
      "tradingHours": {
        "start": "09:30:00", 
        "end": "13:00:00",
        "timezone": "EST"
      }
    },
    {
      "date": "2024-12-25",
      "name": "Christmas Day",
      "type": "holiday",
      "marketStatus": "closed", 
      "affectsInstruments": ["US500-BTC"],
      "description": "Christmas Day - US markets closed",
      "tradingHours": null
    }
  ],
  "timestamp": "2024-01-15T10:30:00Z",
  "requestId": "req_abc123"
}

​
Get Trading Calendars

Retrieve trading calendar information, including market holidays, special sessions, and trading schedule changes.

​
Endpoint

GET /api/v1/market/calendars

​
Parameters

​
year
integer
Year to retrieve calendar for (e.g., 2024). Defaults to current year.
​
month
integer
Month to filter (1-12). If not provided, returns entire year.
​
instrument
string
Filter for specific instrument calendar (e.g., “US500-BTC”)
​
X-API-Key
string
required
API key for authentication

​
Example Request

curl -X GET "https://api.roxom.com/api/v1/market/calendars" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

​
Response

{
  "data": [
    {
      "date": "2024-01-01",
      "name": "New Year's Day",
      "type": "holiday",
      "marketStatus": "closed",
      "affectsInstruments": ["US500-BTC"],
      "description": "New Year's Day - US markets closed",
      "tradingHours": null
    },
    {
      "date": "2024-01-15",
      "name": "Martin Luther King Jr. Day",
      "type": "holiday",
      "marketStatus": "closed",
      "affectsInstruments": ["US500-BTC"],
      "description": "Martin Luther King Jr. Day - US markets closed",
      "tradingHours": null
    },
    {
      "date": "2024-02-19",
      "name": "Presidents' Day",
      "type": "holiday", 
      "marketStatus": "closed",
      "affectsInstruments": ["US500-BTC"],
      "description": "Presidents' Day - US markets closed",
      "tradingHours": null
    },
    {
      "date": "2024-11-29",
      "name": "Day After Thanksgiving",
      "type": "earlyClose",
      "marketStatus": "earlyClose",
      "affectsInstruments": ["US500-BTC"],
      "description": "Early close at 1:00 PM EST",
      "tradingHours": {
        "start": "09:30:00",
        "end": "13:00:00",
        "timezone": "EST"
      }
    },
    {
      "date": "2024-07-04",
      "name": "Independence Day",
      "type": "holiday",
      "marketStatus": "closed",
      "affectsInstruments": ["US500-BTC"],
      "description": "Independence Day - US markets closed",
      "tradingHours": null
    },
    {
      "date": "2024-12-24",
      "name": "Christmas Eve",
      "type": "earlyClose",
      "marketStatus": "earlyClose",
      "affectsInstruments": ["US500-BTC"],
      "description": "Early close at 1:00 PM EST",
      "tradingHours": {
        "start": "09:30:00", 
        "end": "13:00:00",
        "timezone": "EST"
      }
    },
    {
      "date": "2024-12-25",
      "name": "Christmas Day",
      "type": "holiday",
      "marketStatus": "closed", 
      "affectsInstruments": ["US500-BTC"],
      "description": "Christmas Day - US markets closed",
      "tradingHours": null
    }
  ],
  "timestamp": "2024-01-15T10:30:00Z",
  "requestId": "req_abc123"
}
​
data
array
Array of trading calendar events

​
Understanding Trading Calendars

While underlying markets may close, Bitcoin settlement and basic platform operations continue 24/7. However, reduced liquidity is expected during holiday periods.
Always check the calendar before major holidays to plan your trading strategy and position management accordingly.

Trading Instruments

View instrument specifications

Account Balance

Check your account status