# MarketDataApi

All URIs are relative to *https://openapi.tossinvest.com*

| Method | HTTP request | Description |
|------------- | ------------- | -------------|
| [**getCandles**](https://openapi.tossinvest.com/openapi-docs/latest/api-reference/Apis/MarketDataApi.md#getCandles) | **GET** /api/v1/candles | 캔들 차트 조회 |
| [**getOrderbook**](https://openapi.tossinvest.com/openapi-docs/latest/api-reference/Apis/MarketDataApi.md#getOrderbook) | **GET** /api/v1/orderbook | 호가 조회 |
| [**getPriceLimit**](https://openapi.tossinvest.com/openapi-docs/latest/api-reference/Apis/MarketDataApi.md#getPriceLimit) | **GET** /api/v1/price-limits | 상/하한가 조회 |
| [**getPrices**](https://openapi.tossinvest.com/openapi-docs/latest/api-reference/Apis/MarketDataApi.md#getPrices) | **GET** /api/v1/prices | 현재가 조회 |
| [**getTrades**](https://openapi.tossinvest.com/openapi-docs/latest/api-reference/Apis/MarketDataApi.md#getTrades) | **GET** /api/v1/trades | 최근 체결 내역 조회 |


<a name="getCandles"></a>
# **getCandles**
> getCandles_200_response getCandles(symbol, interval, count, before, adjusted)

캔들 차트 조회

    종목의 캔들(OHLCV) 차트 데이터를 조회합니다. 최대 200개 봉을 반환합니다.  봉은 최신순(`timestamp` 내림차순)으로 정렬됩니다 — 배열의 첫 요소가 가장 최근 봉, 마지막 요소가 가장 오래된 봉입니다.  **Rate Limits Group**: `MARKET_DATA_CHART` 

### Parameters

|Name | Type | Description  | Notes |
|------------- | ------------- | ------------- | -------------|
| **symbol** | **String**| 종목 심볼. KRX: 6자리 종목코드 (숫자 또는 영문·숫자 조합; 예: 005930, 0101N0), US: 영문 티커 (예: AAPL). 영문 대/소문자, 숫자, '.', '-' 만 허용한다. | [default to null] |
| **interval** | **String**| 봉 단위 | [default to null] [enum: 1m, 1d] |
| **count** | **Integer**| 조회 봉 수 (최대 200) | [optional] [default to 100] |
| **before** | **Date**| 페이지네이션 상한 (inclusive, ISO 8601). 이 시각과 같거나 이전인 봉만 반환합니다. 미지정 시 가장 최신 봉부터 반환. 다음 페이지 요청 시 이전 응답의 `nextBefore` 값을 그대로 전달합니다. 타임존 오프셋의 `+` 는 쿼리스트링에서 `%2B` 로 URL 인코딩해야 합니다 (예: `before=2026-03-25T09:00:00%2B09:00`).  | [optional] [default to null] |
| **adjusted** | **Boolean**| 수정주가 적용 여부. `true` 면 수정주가 적용, `false` 면 미적용. | [optional] [default to true] |

### Return type

[**getCandles_200_response**](https://openapi.tossinvest.com/openapi-docs/latest/api-reference/Models/getCandles_200_response.md)

### Authorization

[oauth2ClientCredentials](https://openapi.tossinvest.com/openapi-docs/latest/api-reference/README.md#oauth2ClientCredentials)

### HTTP request headers

- **Content-Type**: Not defined
- **Accept**: application/json

<a name="getOrderbook"></a>
# **getOrderbook**
> getOrderbook_200_response getOrderbook(symbol)

호가 조회

    매수/매도 호가 및 잔량을 조회합니다.  **Rate Limits Group**: `MARKET_DATA` 

### Parameters

|Name | Type | Description  | Notes |
|------------- | ------------- | ------------- | -------------|
| **symbol** | **String**| 종목 심볼. KRX: 6자리 종목코드 (숫자 또는 영문·숫자 조합; 예: 005930, 0101N0), US: 영문 티커 (예: AAPL). 영문 대/소문자, 숫자, '.', '-' 만 허용한다. | [default to null] |

### Return type

[**getOrderbook_200_response**](https://openapi.tossinvest.com/openapi-docs/latest/api-reference/Models/getOrderbook_200_response.md)

### Authorization

[oauth2ClientCredentials](https://openapi.tossinvest.com/openapi-docs/latest/api-reference/README.md#oauth2ClientCredentials)

### HTTP request headers

- **Content-Type**: Not defined
- **Accept**: application/json

<a name="getPriceLimit"></a>
# **getPriceLimit**
> getPriceLimit_200_response getPriceLimit(symbol)

상/하한가 조회

    종목의 당일 상한가 및 하한가를 조회합니다.  **Rate Limits Group**: `MARKET_DATA` 

### Parameters

|Name | Type | Description  | Notes |
|------------- | ------------- | ------------- | -------------|
| **symbol** | **String**| 종목 심볼. KRX: 6자리 종목코드 (숫자 또는 영문·숫자 조합; 예: 005930, 0101N0), US: 영문 티커 (예: AAPL). 영문 대/소문자, 숫자, '.', '-' 만 허용한다. | [default to null] |

### Return type

[**getPriceLimit_200_response**](https://openapi.tossinvest.com/openapi-docs/latest/api-reference/Models/getPriceLimit_200_response.md)

### Authorization

[oauth2ClientCredentials](https://openapi.tossinvest.com/openapi-docs/latest/api-reference/README.md#oauth2ClientCredentials)

### HTTP request headers

- **Content-Type**: Not defined
- **Accept**: application/json

<a name="getPrices"></a>
# **getPrices**
> getPrices_200_response getPrices(symbols)

현재가 조회

    종목의 현재가 정보를 조회합니다. 최대 200건 까지 다건 조회를 지원하며 콤마(`,`)로 구분합니다.  **Rate Limits Group**: `MARKET_DATA` 

### Parameters

|Name | Type | Description  | Notes |
|------------- | ------------- | ------------- | -------------|
| **symbols** | **String**| 종목 심볼. 최대 200 개를 콤마(`,`)로 구분. 예: `005930,000660` 또는 `AAPL,MSFT`. 영문 대/소문자, 숫자, '.', '-' 만 허용한다. | [default to null] |

### Return type

[**getPrices_200_response**](https://openapi.tossinvest.com/openapi-docs/latest/api-reference/Models/getPrices_200_response.md)

### Authorization

[oauth2ClientCredentials](https://openapi.tossinvest.com/openapi-docs/latest/api-reference/README.md#oauth2ClientCredentials)

### HTTP request headers

- **Content-Type**: Not defined
- **Accept**: application/json

<a name="getTrades"></a>
# **getTrades**
> getTrades_200_response getTrades(symbol, count)

최근 체결 내역 조회

    당일 최근 체결 내역을 조회합니다.  **Rate Limits Group**: `MARKET_DATA` 

### Parameters

|Name | Type | Description  | Notes |
|------------- | ------------- | ------------- | -------------|
| **symbol** | **String**| 종목 심볼. KRX: 6자리 종목코드 (숫자 또는 영문·숫자 조합; 예: 005930, 0101N0), US: 영문 티커 (예: AAPL). 영문 대/소문자, 숫자, '.', '-' 만 허용한다. | [default to null] |
| **count** | **Integer**| 조회 건수 (최대 50) | [optional] [default to 50] |

### Return type

[**getTrades_200_response**](https://openapi.tossinvest.com/openapi-docs/latest/api-reference/Models/getTrades_200_response.md)

### Authorization

[oauth2ClientCredentials](https://openapi.tossinvest.com/openapi-docs/latest/api-reference/README.md#oauth2ClientCredentials)

### HTTP request headers

- **Content-Type**: Not defined
- **Accept**: application/json