Fetches current prices from Toss Securities. Korean listings use the 6-digit code (e.g. 005930); US listings use the ticker (e.g. NVDA). Both can be mixed in one call. If you only know the company name, call toss_resolve_symbol first.

Finds the Toss Securities symbol for a company name or ticker, e.g. '삼성전자' -> 005930. When exact is false the query matched several candidates — ask the user which one instead of picking one yourself.

Returns the actual positions and P&L in the Toss Securities account. Prefer this over any hand-maintained portfolio file, which may be out of date.

Returns available cash in the Toss Securities account. toss_get_holdings excludes cash, so call this too when computing total assets.

Returns the Toss Securities FX rate, defaulting to USD -> KRW. Use it to convert USD positions to KRW. Quotes expire in about five minutes, so do not cache the result.

Returns OHLCV candles for a symbol, for trend and volatility analysis. Interval is 1m or 1d; at most 200 candles per call.

Previews a NEW market or limit order to buy or sell one stock immediately. For trigger-based orders use toss_prepare_conditional_order; to change or withdraw an order that already exists use toss_prepare_order_modify or toss_prepare_order_cancel. Nothing reaches the market from this call: it only validates the request and returns a preview plus a confirmation token. Show that preview to the user, obtain explicit approval, then pass the token to toss_submit_prepared_order. The token is single-use and expires 60 seconds after this call.

Previews a NEW conditional order that stays dormant until its trigger price is reached. SINGLE arms one leg. OCO arms two legs where filling either one cancels the other (typical take-profit plus stop-loss pair). OTO arms a second leg that is placed only after the first leg fills. For an order that should execute right away use toss_prepare_order instead. Nothing reaches the market from this call: it only validates the request and returns a preview plus a confirmation token. Show that preview to the user, obtain explicit approval, then pass the token to toss_submit_prepared_order. The token is single-use and expires 60 seconds after this call.

Previews a change to an EXISTING open regular order — its quantity, price, or order type. The order keeps its identity; only the listed fields change. Find the orderId with toss_get_orders (status 'OPEN'). Use toss_prepare_conditional_order_modify for conditional orders. Nothing reaches the market from this call: it only validates the request and returns a preview plus a confirmation token. Show that preview to the user, obtain explicit approval, then pass the token to toss_submit_prepared_order. The token is single-use and expires 60 seconds after this call.

Previews the withdrawal of an EXISTING open regular order so that none of its remaining quantity can fill. Already-executed shares are unaffected — cancelling never reverses a fill. Find the orderId with toss_get_orders (status 'OPEN'). Use toss_prepare_conditional_order_cancel for conditional orders. Nothing reaches the market from this call: it only validates the request and returns a preview plus a confirmation token. Show that preview to the user, obtain explicit approval, then pass the token to toss_submit_prepared_order. The token is single-use and expires 60 seconds after this call.

Previews a change to an EXISTING conditional order that has not triggered yet — its trigger prices, legs, quantity, or expiry. Every field is replaced, so send the complete intended state rather than only the parts you want changed. The symbol cannot be changed; cancel and create a new order for that. Find the conditionalOrderId with toss_get_conditional_orders (status 'OPEN'). Nothing reaches the market from this call: it only validates the request and returns a preview plus a confirmation token. Show that preview to the user, obtain explicit approval, then pass the token to toss_submit_prepared_order. The token is single-use and expires 60 seconds after this call.

Previews the removal of an EXISTING conditional order so that it can no longer trigger. Legs that already triggered and became live orders are unaffected — cancel those with toss_prepare_order_cancel. Find the conditionalOrderId with toss_get_conditional_orders. Nothing reaches the market from this call: it only validates the request and returns a preview plus a confirmation token. Show that preview to the user, obtain explicit approval, then pass the token to toss_submit_prepared_order. The token is single-use and expires 60 seconds after this call.

Places the previously prepared order. Call only after the user has explicitly confirmed the exact preview in this conversation. The confirmation token is single-use and expires after 60 seconds.

Returns live ask and bid levels for a Korean stock code or US ticker.

Returns recent executions for a Korean stock code or US ticker.

Returns session and holiday information for the Korean or US market, including adjacent business days.

Returns investment cautions, liquidation trading, volatility interruption, and warrant warnings.

Returns daily Korean-stock trading trends for retail, foreign, institutional, and other investors.

Returns daily Korean-stock short-selling volume, value, and ratio.

Ranks Korean or US stocks by traded value, traded volume, or price change, for screening what is active today. Returns a leaderboard, not data about a stock you already picked — use toss_get_price for that.

Returns current prices for market indicators such as KOSPI and KOSDAQ. Pass one or more documented indicator symbols.

Returns 1-minute or daily OHLCV candles for a market indicator.

Returns investor trading value trends for KOSPI or KOSDAQ.

Lists regular orders in the account, filtered by status. Use it to find the orderId needed by toss_prepare_order_modify and toss_prepare_order_cancel, or to check whether an order filled. Conditional orders are listed separately by toss_get_conditional_orders.

Gets one regular order in full, including its current status and every partial execution. Use it to confirm what actually filled after submitting an order.

Returns how many shares of one symbol can be sold right now. This can be lower than the holding shown by toss_get_holdings, because shares reserved by open sell orders or still settling are excluded. Check it before sizing a SELL order.

Returns applicable Korean and US stock trading commission schedules.

Lists conditional (trigger-based) orders in the account, filtered by status. Use it to find the conditionalOrderId needed by toss_prepare_conditional_order_modify and toss_prepare_conditional_order_cancel. Regular orders are listed separately by toss_get_orders.

Gets one conditional order in full, including whether its trigger has fired and what each leg is doing. Use it to check on an armed condition before modifying it.