> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fcontext.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 시장 데이터

> 시세, 캔들, 시장 상태, 변동 상위, 거래 캘린더

Financial Context의 `/api/market-data` 엔드포인트를 사용해 읽기 전용 시장 데이터에 접근합니다.

## 실시간 시세

```bash theme={null}
curl "https://openapi.fcontext.com/api/market-data/quote?symbols=AAPL.US,MSFT.US" \
  -H "x-api-key: YOUR_FCONTEXT_API_KEY"
```

## 정적 증권 정보

```bash theme={null}
curl "https://openapi.fcontext.com/api/market-data/quote/static_info?symbols=AAPL.US,MSFT.US" \
  -H "x-api-key: YOUR_FCONTEXT_API_KEY"
```

## 캔들스틱

```bash theme={null}
curl "https://openapi.fcontext.com/api/market-data/quote/AAPL.US/history_candlestick?period=day&count=100&adjust=none" \
  -H "x-api-key: YOUR_FCONTEXT_API_KEY"
```

일반 파라미터:

| 파라미터           | 설명                                                             |
| -------------- | -------------------------------------------------------------- |
| `period`       | `1m`, `5m`, `15m`, `30m`, `1h`, `day`, `week`, `month`, `year` |
| `count`        | offset 모드에서 반환할 레코드 수                                          |
| `start`, `end` | `YYYY-MM-DD` 형식의 날짜 범위                                         |
| `adjust`       | `none` 또는 `forward`                                            |

## 시장 상태

```bash theme={null}
# 시장 상태
curl "https://openapi.fcontext.com/api/market-data/market/status" \
  -H "x-api-key: YOUR_FCONTEXT_API_KEY"

# 변동 상위
curl "https://openapi.fcontext.com/api/market-data/market/top_movers?market=US&count=20" \
  -H "x-api-key: YOUR_FCONTEXT_API_KEY"

# 거래일
curl "https://openapi.fcontext.com/api/market-data/market/trading_days?market=US&start=2026-01-01&end=2026-01-31" \
  -H "x-api-key: YOUR_FCONTEXT_API_KEY"
```
