Get daily price limits
tossinvest_get_price_limitsRead-onlyIdempotent
Check a stock's daily upper and lower price limits before placing a limit order to avoid price-out-of-range rejections. Returns current limits for KRX and US symbols, covering markets with daily bands.
Instructions
Get today's upper and lower price limits (상한가/하한가) for one stock.
Check this before placing a limit order: a price outside the band is rejected with 422 price-out-of-range.
Args:
symbol (string): One symbol.
response_format ('markdown' | 'json'): default 'markdown'.
Returns { symbol, currency, timestamp, upperLimitPrice, lowerLimitPrice }. Limits are decimal strings; either can be null for markets without a daily band (US stocks generally have none).
Errors: 404 stock-not-found for unknown symbols.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| symbol | Yes | Stock symbol. KRX: 6 digits (e.g. '005930' for Samsung Electronics). US: ticker (e.g. 'AAPL'). | |
| response_format | No | Output format: 'markdown' for a compact human-readable summary, 'json' for the complete raw payload. | markdown |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| symbol | Yes | ||
| currency | No | KRW or USD | |
| timestamp | No | ||
| lowerLimitPrice | No | Daily lower limit; null when the market has no limit | |
| upperLimitPrice | No | Daily upper limit; null when the market has no limit |