Claude를 활용한 실시간 주식 및 금융 데이터 분석 방법

Claude를 활용한 실시간 금융 데이터 분석

Claude는 금융 데이터를 읽고 그 의미를 설명하는 데 매우 뛰어납니다. 하지만 언어 모델의 학습 데이터는 질문 시점보다 수개월 전에 종료되므로, 최신 수치를 파악하는 데는 한계가 있습니다. 해결책은 간단합니다. API를 통해 실시간 시장 데이터를 Claude에게 제공하고, Claude가 가장 잘하는 분석, 비교, 그리고 평이한 언어로 된 설명 기능을 수행하도록 하는 것입니다.

이 가이드에서는 무료 시장 데이터 API를 사용하여 Claude를 연결하는 세 가지 방법과 바로 복사해서 사용할 수 있는 프롬프트를 소개합니다. 참고로, 이 API는 저희 팀이 구축한 Strasmore의 서비스입니다. 계정 생성 없이도 이 가이드의 모든 내용을 5분 안에 직접 테스트해 볼 수 있습니다.

Claude에 데이터 소스가 필요한 이유

도구 없이 Claude에게 "현재 Microsoft의 배당 수익률이 얼마인가"라고 질문하면 두 가지 실패 모드 중 하나가 발생합니다. 모델이 답변을 거부하거나, 수개월 전의 학습 데이터에 기반한 답변을 내놓습니다. 두 경우 모두 모델이 현재 가격 정보에 접근할 수 없기 때문에 발생합니다. 모델은 스스로 정보를 조회할 수 없습니다.

데이터 소스를 연결하면 상황이 완전히 달라집니다. Claude는 JSON을 원활하게 읽고, 수십 개의 행을 문맥 내에서 유지하며, 데이터가 실제로 보여주는 내용을 비교, 순위 지정 및 요약하는 작업을 능숙하게 수행합니다. 이제 답변의 품질은 모델에게 제공하는 데이터의 품질에 달려 있습니다.

키가 필요 없는 무료 시장 데이터 API

Strasmore의 데모 API는 미국 주식 및 옵션 데이터에 대한 고정 쿼리 카탈로그를 일반 JSON 형식으로 제공합니다. 가입 절차나 API 키, 속도 제한(rate-limit)에 대한 복잡한 과정이 없습니다. 전체 엔드포인트 참조는 API 문서 게시물에서 확인할 수 있으며, 요약된 내용은 다음과 같습니다.

# What queries exist? (start here)
curl "https://ai.strasmore.com/api/demo/catalog"

# The highest large-cap dividend yields right now
curl "https://ai.strasmore.com/api/demo?q=dividend_yield_leaders"

# Implied-volatility leaders in the options market
curl "https://ai.strasmore.com/api/demo?q=iv_leaders"

# The latest market headlines with tickers
curl "https://ai.strasmore.com/api/demo?q=latest_market_news"

각 응답에는 행 데이터, 열 이름, 그리고 해당 수치를 산출한 정확한 SQL 문이 포함됩니다. 이 마지막 부분은 AI 작업에서 중요합니다. Claude에게 데이터와 함께 SQL을 보여주면, 결과뿐만 아니라 쿼리에 대한 설명까지 얻을 수 있기 때문입니다.

가격 정보는 지연 제공되며 옵션 그릭스(greeks)는 일일 마감 기준 값입니다. 학습, 스크리닝, 분석 워크플로우를 수행하기에는 이 정도면 충분합니다. 이는 트레이딩 피드가 아니며, 본 가이드는 트레이딩 실행이 아닌 분석을 목적으로 합니다.

방법 1: JSON을 채팅창에 붙여넣기

설정이 필요 없는 방식입니다. curl 명령을 한 번 실행한 뒤, 출력된 JSON을 복사하여 명확한 지시 사항과 함께 Claude 채팅창에 붙여넣습니다. 이 방법은 claude.ai 웹 앱, 데스크톱 앱, 또는 모든 채팅 인터페이스에서 작동합니다.

효과적인 프롬프트 구성은 다음과 같습니다:

Here is JSON from a market data API. The `sql` field shows exactly
how the numbers were computed.

[paste the JSON here]

1. Summarize what this data shows in plain English.
2. Which three rows stand out, and what makes them unusual?
3. What would you want to check next before drawing conclusions?

세 번째 질문이 핵심입니다. 이 질문은 Claude가 데이터를 과도하게 해석하지 않고 데이터의 한계를 명확히 밝히도록 유도합니다. 또한 Claude가 제안하는 내용("지급 내역 확인", "업종별 비교" 등)은 사용자가 직접 생각해서 입력하는 것보다 더 나은 후속 질문이 되는 경우가 많습니다.

방법 2: Claude Code가 직접 데이터를 가져오게 하기

Claude Code를 실행하면 복사 및 붙여넣기 과정을 완전히 생략할 수 있습니다. Claude Code는 스스로 curl을 실행할 수 있기 때문입니다. 질문을 던지고 데이터가 위치한 곳을 알려주기만 하면 됩니다.

Fetch https://ai.strasmore.com/api/demo/catalog, pick the query that
best answers this question, fetch it, and analyze the result:
which large-cap stocks pay the highest dividend yields right now,
and how do their P/E ratios compare?

Claude Code는 카탈로그를 읽고 dividend_yield_leaders를 선택한 뒤, 이를 가져와 실제 행(row)을 바탕으로 작업을 수행합니다. 에이전트 루프가 사용자의 머신에서 실행되므로, 머신에 있는 다른 모든 도구와 연동할 수 있습니다. 결과를 파일로 저장하거나, Python 스크립트로 차트를 그리거나, 오늘 화면과 지난주에 저장한 화면을 비교(diff)하는 작업이 가능합니다. 주의할 비용 요소가 하나 있습니다. 에이전트가 가져오는 모든 JSON 페이로드는 대화 내용에 포함되어 다음 턴마다 다시 전송되는데, 이것이 Claude Code 세션이 길어질수록 비용이 많이 발생하는 이유입니다.

상시 가동되는 Linux 서버는 이러한 워크플로우를 위한 최적의 환경입니다. "화면을 가져와 어제와 비교하고 요약본을 작성하라"는 일일 루프 작업에는 잠들지 않는 머신이 필요합니다. SSH 연결이 끊겨도 세션이 유지되도록 VPS에서 tmux와 함께 Claude Code를 실행하는 방법에 대한 전체 가이드를 제공하고 있습니다. 이 방식을 선택한다면 먼저 VPS에서 AI 에이전트를 안전하게 실행하는 방법 가이드를 읽어보시기 바랍니다. 셸 접근 권한을 가진 에이전트에는 그에 걸맞은 확실한 안전장치가 필요합니다.

방법 3: fetch 도구를 사용하는 Claude API

직접 개발 중인 소프트웨어라면 Claude에게 API를 도구로 제공하십시오. Anthropic의 Python SDK를 사용하면 도구 정의 하나와 fetch 함수 하나로 전체 연결이 완료됩니다.

import json, urllib.request
import anthropic

def fetch_demo(query_key: str) -> str:
    url = f"https://ai.strasmore.com/api/demo?q={query_key}"
    with urllib.request.urlopen(url, timeout=30) as r:
        return r.read().decode()

client = anthropic.Anthropic()
tools = [{
    "name": "fetch_market_data",
    "description": "Fetch a fixed market-data query. Keys are listed at "
                   "https://ai.strasmore.com/api/demo/catalog e.g. "
                   "dividend_yield_leaders, iv_leaders, latest_market_news.",
    "input_schema": {
        "type": "object",
        "properties": {"query_key": {"type": "string"}},
        "required": ["query_key"],
    },
}]

# Claude decides when to call the tool; your loop executes fetch_demo()
# and returns the JSON as the tool result. See Anthropic's tool-use docs.

질문에 데이터가 필요할 때 Claude가 해당 도구를 호출하면, 사용자는 fetch를 실행하여 JSON을 반환하고, Claude는 메모리가 아닌 실제 행(row) 데이터를 기반으로 답변합니다. 클라이언트는 환경 변수에서 키를 가져오므로, 이 코드가 서버나 클라우드 제공업체 환경에서 실행된다면 하드코딩하기 전에 해당 환경에서 클라이언트를 인증하는 방법을 먼저 해결하십시오. 이 방식은 채팅 구독을 이용하는 대신 토큰 단위로 비용이 청구되는 유일한 경로입니다. 따라서 Claude API에 무료 티어(free tier)가 있는지 궁금하다면, 짧은 답변은 가입 시 제공되는 소액의 크레딧과 그 이후의 종량제 요금 체계입니다. 인라인 도구보다 재사용 가능한 서버를 선호한다면 Model Context Protocol을 사용해도 동일한 패턴이 적용됩니다. 관련 내용은 VPS에서 MCP 서버 호스팅하기 가이드에서 다룹니다.

분석 품질을 높이는 프롬프트

연결 방식과 관계없이 출력 결과의 품질을 일관되게 높이는 몇 가지 패턴이 있습니다.

• Claude에게 행을 인용하도록 지시하십시오. "모든 주장에 대해 티커와 해당 수치가 나온 행 번호를 명시하라"고 요청하면 모호한 요약을 방지할 수 있습니다.
• 데이터가 보여줄 수 없는 부분을 질문하십시오. 지연된 가격, 장 마감 후의 greeks, 고정된 화면 등은 모두 한계가 있습니다. Claude에게 이를 물어보면 명확하게 답변하므로 분석의 객관성을 유지할 수 있습니다.
• 예측이 아닌 비교를 요청하십시오. "표시된 배당 성향을 바탕으로 볼 때 어떤 수익률이 지속 가능한가"라고 물으면 근거 있는 답변을 얻을 수 있습니다. 반면 "어떤 주식이 오를 것인가"라고 물으면 잘 작성된 추측을 내놓을 뿐입니다. 데이터는 예측을 뒷받침하지 않기 때문입니다.
• SQL을 문맥 안에 유지하십시오. sql 필드는 Claude에게 스크린이 어떻게 구성되었는지 정확히 알려줍니다. 이를 통해 특정 종목이 누락된 이유(시가총액 하한선, 수익률 상한선 등)를 지어내지 않고 정확히 설명할 수 있습니다.

고정된 쿼리로 충분하지 않을 때

데모 화면은 의도적으로 고정되어 있습니다. 다음 단계는 Strasmore의 유료 API를 사용하는 것입니다. 동일한 데이터 웨어하우스를 기반으로 22년 치 미국 주식 데이터와 12년 치 옵션 이력 데이터를 제공하며, 프로그래밍 방식의 키를 사용하여 SQL이나 자연어로 직접 질문할 수 있습니다. 워크플로우는 동일하게 유지됩니다. 사용자의 도구는 공개 엔드포인트 대신 인증된 엔드포인트에서 데이터를 가져오며, 질문은 사용자가 직접 정의하게 됩니다. Claude는 문서화된 스키마를 바탕으로 ClickHouse SQL을 작성하는 데 매우 능숙합니다. 이를 활용하면 "시가총액 10B 달러 이상인 모든 REIT의 배당 이력을 가져와 5년 성장률 순으로 정렬하라"는 요청을 단 하나의 프롬프트로 처리할 수 있습니다.

FAQ

Claude는 데이터 소스 없이 주식을 분석할 수 있습니까?

현재 수치로는 불가능합니다. 학습 데이터가 오늘 이전 시점에서 종료되므로, 현재 가격에 대해 언급하는 내용은 모두 과거의 기억에 의존한 것입니다. 실시간 API를 제공하면 가져온 데이터를 바탕으로 분석이 이루어집니다.

Strasmore 데모 API는 정말 무료입니까?

네, 그렇습니다. 키, 가입, 카드 정보가 필요 없습니다. 지연된 미국 주식 및 장 마감 옵션 데이터에 대한 고정 쿼리 카탈로그를 제공하며, AI 에이전트가 접근할 수 있도록 의도적으로 개방되어 있습니다.

이를 위해 VPS가 필요합니까?

아니요. 붙여넣기 방식의 워크플로우는 브라우저만 있으면 충분합니다. 에이전트 루프를 일정에 따라 실행하고, 연결이 끊겨도 유지하며, 과거 결과 파일을 로컬에 보관하려는 경우에 VPS가 유용합니다.

이것이 투자 조언입니까?

아니요. 이 모든 것은 분석 도구일 뿐입니다. Claude는 데이터를 요약하고 비교할 뿐이며, 이를 어떻게 활용할지는 사용자의 결정입니다. 지연된 교육용 데이터는 거래 실행의 근거가 될 수 없습니다.

하나의 화면을 하나의 채팅에 연결해 보면 즉시 차이를 알 수 있습니다. Claude는 알 수 없는 수치에 대해 확신을 갖는 것을 멈추고, 확인할 수 있는 수치에 대해 유용한 정보를 제공하기 시작합니다.