무료 주식 시장 데이터 API 사용법

Strasmore는 별도의 키 발급이나 가입 절차 없이 사용할 수 있는 무료 주식 시장 데이터 API를 운영합니다. 이 API는 미국 주식 및 옵션 데이터에 대해 엄선된 읽기 전용 쿼리를 HTTPS 기반의 JSON 형식으로 제공하며, 사용자와 AI 에이전트 모두가 사용할 수 있도록 설계되었습니다. 또한, 사용자가 직접 쿼리를 작성할 수 있는 무료 SQL API라는 희소한 기능을 데모 형태로 제공합니다. 이 페이지에는 모든 엔드포인트에 대한 설명과 실행 가능한 호출 예시, 그리고 API가 반환하는 데이터와 동일한 데이터를 보여주는 차트가 포함되어 있습니다.

무료 API 제공 데이터

각 키는 시장 분석가가 실제로 궁금해하는 질문에 대한 답을 제공합니다. 현재 기준 데이터 목록은 다음과 같습니다:

• spy_qqq: 지난 45거래일 동안의 SPY 및 QQQ 정규화 수익률
• dividend_yield_leaders: 최근 거래일 기준 대형주 중 가장 높은 배당수익률(dividend yields)
• upcoming_ex_dividends: 향후 예정된 미국 주식의 배당락일(ex-dividend dates), 배당금 및 지급일
• short_interest_watch: 최근 공매도 결제 기준 days-to-cover(상환 소요 일수) 상위 종목
• iv_leaders: 유동성 있는 옵션 기초자산 중 종가 기준 implied volatility(내재 변동성) 상위 종목
• recent_ipos: 최근 180일 이내의 미국 상장 종목, 공모가 및 규모 포함
• latest_market_news: 최신 시장 헤드라인 및 관련 티커(tickers)
• biggest_movers: 최근 정규 거래 세션 중 유동성 종목의 최대 변동폭
• revenue_leaders: 최근 연간 매출 및 순이익 기준 미국 최대 기업
• most_active_options: 옵션 거래량이 집중된 종목 및 평균 내재 변동성
• put_call_ratio: 거래가 가장 활발한 기초자산의 put/call volume ratio(풋/콜 거래량 비율)
• upcoming_splits: 최근 및 예정된 주식 분할(stock splits)
• market_holidays: 향후 NYSE(뉴욕증권거래소) 휴장 및 조기 종료 일정

주식 가격은 지연되어 제공됩니다. 옵션 greeks(그릭스) 및 내재 변동성은 종가 기준 값입니다. 모든 데이터 페이로드(payload)에는 해당 데이터를 생성한 SQL 쿼리가 포함되어 있어, 모든 수치를 쿼리를 통해 추적할 수 있습니다.

호출 방법

헤더가 필요 없는 단일 GET 요청을 사용합니다:

curl "https://ai.strasmore.com/api/demo?q=dividend_yield_leaders"

카탈로그 엔드포인트(endpoint)에는 즉시 호출 가능한 URL, 각 쿼리에 대한 평이한 설명, 사용 시 주의 사항이 포함된 모든 가용 키(key) 목록이 나열되어 있습니다. API를 프로그래밍 방식으로 탐색하는 경우, 먼저 이 엔드포인트를 호출하십시오:

curl "https://ai.strasmore.com/api/demo/catalog"

응답에는 결정된 키, 해당 키가 답변하는 질문, SQL, 컬럼(column) 이름, 행(row), 그리고 두 개의 포인터 필드가 포함됩니다. 데이터 구조(값은 생략됨)는 다음과 같습니다:

{
  "key": "dividend_yield_leaders",
  "label": "Highest dividend yields, large caps, latest session",
  "nl": "Which large-cap US stocks currently have the highest dividend yields?",
  "sql": "SELECT ...",
  "columns": ["as_of", "ticker", "dividend_yield_pct", "..."],
  "rows": ["..."],
  "source": "Strasmore Research",
  "more": "Get more at https://www.strasmore.com ..."
}

존재하지 않는 키를 전달하면 오류가 발생하는 대신 기본 쿼리가 반환되며 fallback_from 필드가 표시됩니다. 해당 필드를 오타 알림으로 간주하고, 유효한 키에 대해서는 카탈로그를 신뢰할 수 있는 정보원(source of truth)으로 사용하십시오.

에이전트 및 LLM을 위한 설계

본 데모는 사용자가 직접 작성하지 않은 소프트웨어에 의해 호출되도록 설계되었습니다. 응답 시 access-control-allow-origin: * 및 CORS(Cross-Origin Resource Sharing, 교차 출처 리소스 공유) 프리플라이트(preflights)가 모든 출처에 대해 허용적으로 응답하므로, 브라우저 앱, 노트북 및 LLM(Large Language Model, 거대 언어 모델) 에이전트가 모두 직접 데이터를 가져올 수 있습니다. 내부적으로 각 쿼리는 최대 10분마다 재계산되며, 메모리에서 수 밀리초(milliseconds) 내에 제공됩니다.

에이전트가 읽어야 할 순서에 따른 기계 판독 가능 엔트리 포인트(entry points)는 다음과 같습니다:

1. https://www.strasmore.com/llms.txt은 하나의 짧은 파일에 콘텐츠 인덱스와 데모 API를 명시합니다.
2. https://ai.strasmore.com/api/demo/catalog은 모든 쿼리를 URL과 함께 나열합니다.
3. 각 응답의 more 필드는 카탈로그와 전체 제품을 다시 가리킵니다.

두 가지 주의 사항이 있습니다. 각 쿼리의 수치는 최대 10분마다 갱신되므로, 이보다 빠르게 폴링(polling)하면 동일한 데이터가 반환됩니다. 각 페이로드(payload) 내부의 source 필드는 데이터의 출처를 명시합니다. 수치를 재게시할 때는 가능한 경우 이 필드를 계속 표시하십시오.

데모의 데이터 근거

API의 답변은 이 블로그가 참조하는 것과 동일한 데이터 웨어하우스(Warehouse)에서 추출됩니다. 아래 패널들은 블로그 파이프라인을 통해 데모 쿼리를 실행하며, 각 항목 아래에 SQL 코드가 공개되어 있습니다.

spy_qqq 키는 SPY와 QQQ의 종가를 45일 기간의 시작점 대비 수익률(Percentage returns)로 정규화합니다. 현재 기간 내 30 세션 동안, SPY의 누적 변동은 -1.6%을, QQQ의 변동은 -5.69%을 측정합니다.

SELECT day,
       round((spy / first_value(spy) OVER (ORDER BY day ASC) - 1) * 100, 2) AS spy_return_pct,
       round((qqq / first_value(qqq) OVER (ORDER BY day ASC) - 1) * 100, 2) AS qqq_return_pct
FROM (
    SELECT toDate(window_start) AS day,
           argMaxIf(close, window_start, ticker = 'SPY') AS spy,
           argMaxIf(close, window_start, ticker = 'QQQ') AS qqq
    FROM global_markets.delayed_stocks_minute_aggs
    WHERE ticker IN ('SPY', 'QQQ') AND window_start >= now() - INTERVAL 45 DAY
    GROUP BY day
)
ORDER BY day

dividend_yield_leaders 키는 시가총액(Market cap)이 20억 달러 이상이면서 수익률이 2%에서 15% 사이인 종목을 필터링합니다. 하한선은 노이즈를 제거하며, 상한선은 기업이 유지할 수 없는 수준으로 나타나는 특별 배당(Special-dividend)의 왜곡을 제거합니다. Jul 17 기준, 필터링된 최상위 종목은 STRC이며 수치는 13.45%입니다. 단일 기업의 수십 년간 배당 이력에 대해서는 Microsoft의 배당 이력을 참조하십시오.

SELECT ticker,
       round(dividend_yield * 100, 2) AS dividend_yield_pct,
       formatDateTime(date, '%b %e') AS as_of_label
FROM global_markets.stocks_ratios
WHERE date = (SELECT max(date) FROM global_markets.stocks_ratios)
  AND dividend_yield BETWEEN 0.02 AND 0.15
  AND market_cap > 2e9
  AND ticker NOT IN ('SPCX')
ORDER BY dividend_yield DESC
LIMIT 12

iv_leaders 키는 모든 상장된 행사가격(Strike)과 만기일(Expiry)에 대해 기초 자산별 종가 내재 변동성(Implied volatility)을 평균하며, 유의미한 옵션 거래량이 있는 종목을 유지하고 순위를 매깁니다. 현재 선두 종목은 평균 내재 변동성 299.1%을 기록한 SNXX입니다. 이 필터에서 높은 수치가 나타나면 옵션 시장이 큰 변동성을 예상하고 있음을 의미합니다. 필터는 수치만을 제공하며 해석은 사용자의 몫입니다.

SELECT underlying_symbol AS ticker,
       round(avg(implied_volatility) * 100, 1) AS avg_iv_pct
FROM global_markets.options_greeks
WHERE date = (SELECT max(date) FROM global_markets.options_greeks)
  AND iv_converged
  AND underlying_symbol NOT IN ('SPCX')
GROUP BY underlying_symbol
HAVING sum(volume) > 10000
ORDER BY avg_iv_pct DESC
LIMIT 12

short_interest_watch 키는 공매도 잔고 데이터 가이드에서 설명한 것과 동일한 FINRA 데이터셋을 사용하여 days-to-cover(상환 소요 일수) 순위를 매기며, upcoming_ex_dividends는 기업 활동(Corporate-actions) 캘린더를 읽습니다. 두 항목 모두 위와 동일한 방식을 따릅니다. 즉, 고정된 필터링, 제한된 결과값, 그리고 페이로드 내의 SQL을 포함합니다.

데모에서 전체 데이터 웨어하우스까지

데모 쿼리는 의도적으로 고정되어 있습니다. 비용이 저렴하고, 캐싱이 가능하며, 모든 사용자에게 공개해도 안전합니다. 데모의 기반이 되는 데이터 웨어하우스에는 22년 치의 US equities(미국 주식)와 12년 치의 options(옵션) 이력이 저장되어 있습니다. 무료 계정(카드 등록 불필요)은 하루 100개의 쿼리를 통해 직접 SQL을 작성할 수 있습니다. 유료 등급을 사용하면 전체 이력과 tick data(틱 데이터), 그리고 programmatic API(프로그래밍 방식 API) 키를 사용할 수 있습니다. 고정된 화면만으로 부족할 경우, free SQL tier(무료 SQL 등급)이 다음 단계입니다.

FAQ

Strasmore market data API는 정말 무료입니까?

그렇습니다. 데모 엔드포인트(endpoint)는 키(key)나 회원가입, 결제 정보가 필요하지 않습니다. 데모는 고정된 쿼리(query)만 제공하며, 임의의 질문은 유료 제품을 통해 실행됩니다.

API 키나 인증이 필요합니까?

아니요. 모든 데모 엔드포인트는 인증되지 않은 일반 GET 요청에 응답합니다. 키는 사용자 정의 쿼리를 실행하는 유료 프로그래매틱(programmatic) API에만 사용됩니다.

데모 데이터의 최신성은 어떠합니까?

주식 가격은 실시간이 아닌 지연된 데이터를 제공합니다. 비율(ratio), 공매도 잔고(short interest), 기업 활동(corporate actions)은 각 소스의 업데이트 주기에 따라 갱신됩니다. 그리스 문자(Greeks)와 내재 변동성(implied volatility)은 종가 기준입니다. 각 쿼리의 결과는 최대 10분마다 갱신됩니다.

LLM 에이전트나 브라우저 앱에서 직접 호출할 수 있습니까?

그렇습니다. 모든 오리진(origin)에 대해 오픈 CORS(Cross-Origin Resource Sharing)를 지원하며, 프리플라이트(preflight) 요청이 모든 곳에서 성공합니다. /api/demo/catalog에 있는 카탈로그에는 에이전트가 문서 없이도 읽을 수 있는 JSON 형식의 모든 쿼리가 설명되어 있습니다.

존재하지 않는 키를 요청하면 어떻게 됩니까?

API는 기본 spy_qqq 쿼리를 반환하며, 요청한 키의 이름을 fallback_from 필드에 추가합니다. 유효한 키 목록은 카탈로그를 확인하십시오.

이 페이지의 모든 패널은 실시간으로 저장된 쿼리입니다. 동일한 데이터 웨어하우스(warehouse)가 Strasmore terminal에서 SQL 또는 일반 영어로 작성한 질문에 답변합니다.