Skip to main content
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

Trading may be affected by holidays in the underlying markets:
  • US Holidays: Affect US500 (follows NYSE calendar)
  • Global Markets: GOLD and OIL may have different schedules
  • 24/7 Trading: Bitcoin settlement continues during holidays
  • Reduced Liquidity: Expect lower volume during holiday periods
  • Holiday: Full market closure, no trading
  • Early Close: Market closes earlier than usual
  • Late Open: Market opens later than usual
  • Special Session: Modified trading rules or hours
  • Position Management: Plan exits before holidays
  • Funding Payments: May be adjusted during closures
  • Order Books: Reduced liquidity during affected periods
  • Risk Management: Higher volatility around closures
Different instruments may have different holiday schedules:
  • US500: Follows US market holidays
  • GOLD: Follows precious metals market schedule
  • OIL: Follows energy market schedule
  • Bitcoin Settlement: Always available 24/7
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
⌘I