Get the bid/ask orderbook (호가) for a symbol.

symbol: KRX 6-digit code (e.g. 005930) or US ticker (e.g. AAPL).

Get current prices (현재가) for up to 200 symbols.

symbols: comma-separated, e.g. "005930,000660" or "AAPL,MSFT".

Get recent executed trades (체결 내역) for a symbol. count: max 50.

Get the upper/lower price limits (상/하한가) for a symbol.

Get candlestick chart data (캔들).

interval: "1m" (minute) or "1d" (daily). count: max 200. before: ISO 8601 cursor (exclusive) — pass the previous response's nextBefore to paginate. adjusted: apply adjusted prices (수정주가).

Get reference info (name, market, currency, listing status, shares outstanding) for up to 200 symbols. symbols: comma-separated, e.g. "005930,AAPL".

Get purchase warnings/cautions (매수 유의사항) for a symbol — 정리매매, 단기과열, 투자경고/위험, VI, 신주인수권 등.

Get the reference exchange rate between two currencies (e.g. base USD / quote KRW).

date_time: optional ISO 8601 timestamp to query a historical rate.

Get KRX/NXT market operating calendar. date: YYYY-MM-DD (default today).

Get US market operating calendar. date: YYYY-MM-DD (US local date, default today).

List your active accounts. The returned accountSeq is the value used as account_seq (the X-Tossinvest-Account header) by every account-scoped tool. Call this first to discover your account(s).

Get holdings/positions (보유 주식) with per-symbol P&L and an account summary.

account_seq: defaults to TOSS_ACCOUNT_SEQ if unset. symbol: optional single-holding filter.

List orders by lifecycle group. status: OPEN (in-progress) or CLOSED (finished).

from_date/to_date: YYYY-MM-DD (KST, by order time). cursor/limit apply to CLOSED only (limit default 20, max 100; ignored for OPEN, which returns all).

Get full detail for one order (any status), including partial-execution history.

Get cash buying power (매수 가능 금액, excludes margin) for a currency (KRW or USD).

Get the sellable quantity (매도 가능 수량) for a symbol in your account.

Get trading commission/fee rates (매매 수수료) by market for your account.

Place a REAL-MONEY order. Requires TOSS_ENABLE_TRADING=true.

Provide exactly one of:

• quantity: shares as an integer string (e.g. "10").

• order_amount: dollar amount string — US MARKET orders only, regular hours only. LIMIT requires price; MARKET must omit price. price — KR: integer won matching the tick size; US: up to 4 dp (<$1) or 2 dp (>=$1). time_in_force: DAY (default) or CLS (US LIMIT only). client_order_id: idempotency key (<=36 chars, [A-Za-z0-9_-], valid 10 min). Orders >= 100M KRW require confirm_high_value_order=true.

Modify an open order's price/quantity. Requires TOSS_ENABLE_TRADING=true.

KR stocks: quantity required (positive integer string). US stocks: quantity not supported (omit it). LIMIT requires price; MARKET must omit price.

Cancel an open order. Requires TOSS_ENABLE_TRADING=true.