Skip to content

Calendar & Time

Market Time

python
market_time = client.get_market_time()

Returns: MarketTime dataclass

python
MarketTime(
    eastern_time='2026-01-26T11:11:00.793328-05:00',
    is_weekday=True,
    is_market_hours=True,
    market_open='2026-01-26T09:30:00-05:00',
    market_close='2026-01-26T16:00:00-05:00'
)
FieldTypeDescription
eastern_timestrCurrent time in ET (ISO format)
is_weekdayboolTrue if Mon-Fri
is_market_hoursboolTrue if 9:30-16:00 ET
market_openstrToday's open time
market_closestrToday's close time

Quick Checks

python
is_open = client.is_market_open()  # Returns: bool

Returns True if current time is within regular market hours (9:30 AM - 4:00 PM ET, weekdays).

Usage Patterns

Gate Trading on Market Hours

python
if not client.is_market_open():
    print("Market closed, skipping trade")
    return

# Proceed with trading logic

Time-Based Strategy Logic

python
market_time = client.get_market_time()

# Parse eastern time for comparisons
from datetime import datetime
et = datetime.fromisoformat(market_time.eastern_time)

# Exit-only mode after 12:59 PM
if et.hour >= 13:
    print("Exit-only mode")

Check Before Order

python
def safe_order(client, symbol, qty, price):
    if not client.is_market_open():
        raise Exception("Market is closed")
    return client.buy_limit(symbol, qty, price)