> ## 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 시장 데이터 요청 보내기

Financial Context는 `openapi.fcontext.com`에서 인증된 `/api/market-data/*` 시장 데이터 엔드포인트를 제공합니다.

## 1. 자격 증명 만들기

[fcontext.com](https://fcontext.com)에서 Financial Context에 로그인하고, 계정 설정을 열어 외부 접근용 API key를 만듭니다.

<Warning>
  API key는 비공개로 보관하세요. 환경 변수 또는 플랫폼의 secret manager를 사용하세요.
</Warning>

## 2. 시세 요청하기

```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"
```

응답 본문에는 요청한 심볼의 시세 데이터가 포함됩니다. 현재 API는 `.US` 심볼과 `US` market 필터를 지원합니다.

## 3. 코드에서 API 사용하기

```javascript theme={null}
const baseUrl = "https://openapi.fcontext.com";
const apiKey = process.env.FCONTEXT_API_KEY;

export async function getQuote(symbols) {
  const params = new URLSearchParams({ symbols: symbols.join(",") });
  const response = await fetch(`${baseUrl}/api/market-data/quote?${params}`, {
    headers: { "x-api-key": apiKey },
  });

  if (!response.ok) {
    throw new Error(`Financial Context request failed: ${response.status}`);
  }

  return response.json();
}
```

## 처음 사용하기 좋은 호출

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

# 회사 개요
curl "https://openapi.fcontext.com/api/market-data/fundamental/company?symbol=AAPL.US" \
  -H "x-api-key: YOUR_FCONTEXT_API_KEY"

# 뉴스
curl "https://openapi.fcontext.com/api/market-data/content/news?symbol=AAPL.US" \
  -H "x-api-key: YOUR_FCONTEXT_API_KEY"

# 스크리너
curl "https://openapi.fcontext.com/api/market-data/screener/search?market=US&conditions=pettm:10:50&count=20" \
  -H "x-api-key: YOUR_FCONTEXT_API_KEY"
```

## 메서드 지원

시장 데이터 엔드포인트는 `GET`을 지원합니다. 필터와 페이지네이션에는 query parameter를 사용하세요.