From a plain-English question to a DataFrame.

# Written with Claude, run locally after a quick read-through
from datetime import date
from thetadata import ThetaClient
from thetadata.errors import AuthenticationError, NoDataFoundError

client = ThetaClient(dataframe_type="pandas")

try:
    eod = client.stock_history_eod(
        symbol="AAPL",
        start_date=date(2024, 1, 2),
        end_date=date(2024, 1, 31),
    )
except AuthenticationError:
    raise SystemExit("Check THETADATA_API_KEY and try again.")
except NoDataFoundError:
    raise SystemExit("No data returned for this symbol/date range.")

print(eod.head())
eod.plot(x="last_trade", y="close", title="AAPL — January 2024")

from thetadata import ThetaClient

# Option 1 — environment variable (recommended)
#   export THETADATA_API_KEY="your_api_key_here"
client = ThetaClient(dataframe_type="pandas")

# Option 2 — pass the key directly
client = ThetaClient(api_key="your_api_key_here", dataframe_type="pandas")

# Option 3 — email + password via ./creds.txt
#   line 1: email, line 2: password
client = ThetaClient(email="you@yourfirm.com", password="your-password")

# dataframe_type defaults to "polars" — pass "pandas" if that's your stack.
# Get your key at thetadata.net/portal/api_key

curl "http://localhost:25503/v3/stock/history/ohlc\
?symbol=AAPL&start_date=2024-01-02&end_date=2024-01-05&interval=1m"

import httpx, csv

BASE_URL = "http://localhost:25503/v3"
params = {"symbol": "MSFT", "expiration": "*"}

response = httpx.get(f"{BASE_URL}/option/snapshot/ohlc", params=params, timeout=60)
response.raise_for_status()

for row in csv.reader(response.text.split("\n")):
    print(row)