빠른 시작 - Financial Context Documentation

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

1. 자격 증명 만들기

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

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

2. 시세 요청하기

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 사용하기

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();
}

처음 사용하기 좋은 호출

# 실시간 시세
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를 사용하세요.