> ## 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

> openapi.fcontext.com에서 제공되는 인증된 시장 데이터 엔드포인트

Financial Context는 인증되고 사용량 기반으로 과금되는 읽기 전용 US 시장 데이터 접근을 제공합니다. 시세, 캔들스틱, 회사 데이터, 뉴스, 캘린더, 스크리너 및 관련 분석에는 `/api/market-data/*` 아래의 지원 경로를 사용하세요.

## Base URL

```text theme={null}
https://openapi.fcontext.com
```

이 레퍼런스의 모든 엔드포인트는 `https://openapi.fcontext.com/api/market-data`를 루트로 사용하며, symbol 또는 market 필터가 필요한 경우 `.US` 심볼 또는 `US` market을 사용합니다.

## 인증

계정 설정에서 만든 Financial Context key를 사용하세요.

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

OAuth 클라이언트는 시장 데이터 접근 권한이 있는 bearer token을 사용할 수 있습니다.

```bash theme={null}
curl "https://openapi.fcontext.com/api/market-data/quote?symbols=AAPL.US" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
```

## 경로 형식

`/api/market-data` prefix 뒤에 지원되는 읽기 전용 `GET` 엔드포인트를 사용합니다. 예를 들어 실시간 시세는 `https://openapi.fcontext.com/api/market-data/quote`, 뉴스는 `https://openapi.fcontext.com/api/market-data/content/news`, 회사 개요는 `https://openapi.fcontext.com/api/market-data/fundamental/company`를 사용합니다. API 레퍼런스에는 현재 엔드포인트 범위가 나열됩니다.

필터, 날짜 범위, 페이지네이션, 엔드포인트별 옵션에는 query string을 사용하세요.

## 제한 및 오류

모든 시장 데이터 요청은 Financial Context 데이터 요청으로 계량됩니다.

| 상태    | 의미                                   |
| ----- | ------------------------------------ |
| `400` | 경로 또는 query parameter가 유효하지 않음       |
| `401` | Financial Context 자격 증명이 없거나 유효하지 않음 |
| `402` | 플랜 또는 데이터 요청 한도가 필요함                 |
| `403` | 자격 증명에 시장 데이터 엔드포인트 접근 권한이 없음        |
| `405` | 메서드가 지원되지 않으므로 `GET` 사용              |

전체 엔드포인트 목록과 파라미터 상세는 API Reference 섹션을 확인하세요.