주식 기술적 지표 API: MACD·RSI를 JSON으로
원시 OHLCV API와 계산된 시그널 API를 비교하고, PickSkill REST API로 미국·홍콩·중국 A주의 MACD, RSI, KDJ를 받는 법을 정리했습니다.

주식 기술적 지표 API는 MACD, RSI, KDJ 같은 지표 값을, 가능하면 날짜가 찍힌 강세·약세·중립 판정과 함께 돌려주는 웹 서비스로, 원시 가격 데이터에서 직접 계산하는 수고를 덜어 줍니다. 실제 선택지는 가격을 내려받아 직접 계산하는 원시 OHLCV API와, 판정이 이미 계산되어 오는 시그널 API 두 가지입니다. PickSkill API에서는 GET /api/v1/signals를 한 번 호출하면 최대 10개 종목의 8개 지표 차원이 1크레딧에 반환됩니다. 2026년 11월 19일 결과에서 텐센트(0700.HK)의 RSI(14)는 27.86, 약세 5개 차원, 강세 1개 차원이었습니다.
이 글은 개발자가 기술적 지표를 얻는 세 가지 방법을 비교한 뒤, 실제 요청과 실제 필드 이름, 15줄짜리 Python 알림 예제로 PickSkill REST API를 안내합니다.
핵심 요약
- 원시 OHLCV API는 가격을, 시그널 API는 결론을 줍니다. 원시 데이터를 쓰면 계산식, 데이터 정제, 값을 '강세'로 판정하는 규칙까지 모두 직접 책임져야 합니다.
- 중국 A주는 별도 처리가 필요합니다. 메인보드는 하루 최대 10%, STAR 마켓(커촹반)은 20%까지만 움직입니다(상하이증권거래소). 고가와 저가가 같은 상한가 봉은 가짜 추세 시그널을 만들 수 있습니다.
- PickSkill REST API의 엔드포인트는 5개:
/signals,/screen,/earnings,/portfolios,/credits이며,Authorization: Bearer <key>로 인증합니다. - 월정액이 아닌 호출당 과금. 시그널은 1크레딧, 스크리닝은 3크레딧입니다. 크레딧 팩은 1,000크레딧 10달러부터이고, 모든 계정에 무료 100크레딧이 주어지며, 실패한 호출은 환불됩니다.
- MCP와 같은 데이터. MCP 서버와 REST API는 도구, 결과, 크레딧 잔액을 공유합니다.
원시 OHLCV API와 기술적 시그널 API의 차이는?
원시 OHLCV API는 시가·고가·저가·종가·거래량 봉만 반환하고, 나머지는 모두 사용자의 몫입니다. MACD를 얻으려면 충분한 과거 데이터(느린 EMA용 최소 26개 봉과 시그널선 워밍업 구간)를 받아 EMA를 계산하고, 무엇을 교차로 보고 무엇을 시그널로 볼지 정해야 합니다. 기술적 시그널 API는 이 작업을 서버에서 처리해 지표 값을 해석과 날짜와 함께 돌려줍니다. 핵심 트레이드오프는 통제권 대 시간입니다. 원시 데이터는 모든 파라미터를 조정하고 자신만의 지표를 만들 수 있게 해 주고, 시그널 API는 여러 시장에 걸쳐 일관되고 정제된 판정을 한 번의 호출로 제공합니다. 많은 팀이 둘 다 씁니다. 백테스트에는 원시 데이터를, 알림과 AI 에이전트에는 시그널 API를 쓰는 식입니다.
세 번째 방법은 지표 계산에 API를 쓰지 않고 TA-Lib 같은 라이브러리로 로컬에서 계산하는 것입니다. TA-Lib은 BSD 라이선스로 200개 이상의 지표와 Python 래퍼를 제공한다고 소개합니다. 다만 이를 돌릴 신뢰할 만한 가격 데이터는 따로 필요합니다.
세 가지 방법을 비교하면?
서드파티 데이터 공급업체의 비용은 요금제마다 다르므로 각 업체의 공식 요금 페이지를 확인하세요.
| 직접 계산 (pandas / TA-Lib) | 원시 OHLCV 데이터 API | 계산된 시그널 API (PickSkill) | |
|---|---|---|---|
| 얻는 것 | 직접 코딩한 모든 지표 | 가격·거래량 봉 | 8개 차원: 값 + 강세/약세/중립 + 5일 추이 |
| 첫 시그널까지의 수고 | 가장 큼: 데이터 수집, 계산식, 규칙 | 중간: 계산식과 규칙 | 가장 작음: HTTP 호출 1회 |
| 파라미터 조정 | 완전 | 완전 | 표준 설정 고정 (예: RSI 14, KDJ 9,3,3, 볼린저 20,2) |
| 시장 | 데이터 소스에 따라 | 공급업체에 따라 | 미국, 홍콩, 중국 A주. 일본·한국 티커도 지원 |
| A주 상한가·하한가 봉 | 직접 감지·처리해야 함 | 직접 감지·처리해야 함 | 고가 = 저가 봉은 중립으로 고정 |
| 종목군 스크리닝 | 모든 종목을 받아 계산 | 모든 종목을 받아 계산 | POST /screen으로 약 950개 지수 구성 종목 대상 |
| 비용 | 라이브러리 무료, 가격 데이터 별도 | 공급업체 구독 또는 호출당 과금 | 시그널 호출당 1크레딧 (0.008~0.01달러) |
| 적합한 용도 | 백테스트, 맞춤형 리서치 | 대규모 맞춤 지표 | 알림, 대시보드, AI 에이전트 |
소수 종목에 표준 지표 몇 개만 필요하다면 시그널 API가 더 빨리 출시할 수 있고, 특이한 파라미터로 백테스트한다면 직접 계산하는 편이 낫습니다.
왜 중국 A주에서는 단순한 지표 코드가 깨질까?
중국 A주에는 일일 가격 제한폭이 있어서, 어떤 거래일은 제한폭에 붙은 채 실질적인 가격 발견 없이 마감합니다. 상하이증권거래소는 메인보드에 하루 10%, STAR 마켓 종목에는 상장 후 첫 5거래일 이후 20%의 제한폭을 둡니다(상하이증권거래소 Q&A). 시초가부터 상한가에 묶인 날은 봉의 고가와 저가가 같아져 KDJ, 볼린저 밴드, ADX처럼 범위에 기반한 지표가 무의미해지고, 이를 확인하지 않는 코드에는 연속 상한가가 교과서적인 강한 추세처럼 보입니다. 거래 정지 종목도 같은 형태의 평평한 봉을 만듭니다. PickSkill의 지표 엔진은 고가와 저가가 같은 봉을 감지해 그날의 판정을 모든 차원에서 중립으로 고정하며, 5일 추이 안에서도 마찬가지이므로 연속 상한가가 가짜 시그널을 만들지 않습니다. 직접 계산한다면 교차 신호를 믿기 전에 같은 검사를 넣으세요. AI 에이전트가 이런 시그널을 어떻게 읽는지는 AI 에이전트 기술적 분석 가이드에서 볼 수 있습니다.
PickSkill 기술적 지표 API는 어떻게 호출할까?
PickSkill REST API의 기본 주소는 https://pickskill.ai/api/v1이며, API 키를 Authorization: Bearer <key>로 보내야 합니다(x-api-key 헤더도 사용 가능). 키는 계정의 API 대시보드에서 만듭니다. 모든 계정은 무료 100크레딧으로 시작하며, API와 MCP 서버는 같은 잔액을 씁니다. 성공 응답은 { data, credits: { charged, remaining } } 형태이고, 같은 숫자가 X-Credits-Charged와 X-Credits-Remaining 헤더에도 담깁니다. 오류는 { error: { code, message, docs } }가 상태 코드 400, 401, 402(크레딧 부족), 403, 404, 405, 502와 함께 반환되며, 실패한 호출의 크레딧은 환불됩니다. 전체 파라미터 표는 API 문서에 있습니다.
| 엔드포인트 | 메서드 | 반환 내용 | 크레딧 |
|---|---|---|---|
/signals?tickers= | GET | 최대 10개 종목: 종가, 1일·5일 등락률, 8개 차원 | 1 |
/screen | POST | 최대 8개 AND 조건에 맞는 종목과 근거 (유료 요금제 필요) | 3 |
/earnings?ticker= | GET | 최근 EPS 실적 대비 예상치와 주요 재무 비율 | 2 |
/portfolios | GET | 저장된 PickSkill 포트폴리오와 보유 종목별 시그널 | 1 |
/credits | GET | 잔액, 호출당 비용, 크레딧 팩 | 무료 |
홍콩 주식, 상하이 A주, 미국 주식을 대상으로 한 실제 요청입니다. 티커는 Yahoo Finance 형식(0700.HK, 600519.SS, 300750.SZ, NVDA)을 씁니다.
curl "https://pickskill.ai/api/v1/signals?tickers=0700.HK,600519.SS,NVDA" \
-H "Authorization: Bearer $PICKSKILL_API_KEY"
응답은 한 종목, 8개 차원 중 4개만 남겨 줄였습니다. 값은 2026년 11월 19일 실제 호출 결과(당일 홍콩 종가 기준)입니다.
{
"data": {
"disclaimer": "For research and education only; not investment advice. …",
"legend": "signals[dim].now = latest reading; last5 = last 5 trading days oldest→newest (B bullish, S bearish, N neutral); values = latest indicator values.",
"stocks": [
{
"ticker": "0700.HK",
"asOf": "2026-11-19",
"close": 348.4,
"changePct": -6.55,
"fiveDayChangePct": -12.64,
"signals": {
"macd": { "now": "bearish", "last5": "NNSSS", "values": { "dif": -10.77, "dea": -6.61, "hist": -8.32 } },
"rsi": { "now": "bullish", "last5": "NNNNB", "values": { "rsi": 27.86 } },
"kdj": { "now": "neutral", "last5": "NNNNN", "values": { "k": 11.46, "d": 24.39, "j": -14.42 } },
"boll": { "now": "bearish", "last5": "NNNNS", "values": { "mid": 393.32, "upper": 430.79, "lower": 355.85, "bandwidth": 19.05 } },
"…": "ma, adx, volume, flow"
},
"bullishCount": 1,
"bearishCount": 5,
"page": "https://pickskill.ai/stocks/0700.HK"
}
]
},
"credits": { "charged": 1, "remaining": "…" }
}

읽을 때 주의할 점이 두 가지 있습니다. RSI와 KDJ의 'bullish(강세)'는 '상승 중'이 아니라 '과매도'를 뜻합니다. RSI(14)가 30 이하면 강세, 70 이상이면 약세로 판정됩니다. 또 last5는 오래된 날부터 순서대로이므로 NNNNB는 과매도 판정이 가장 최근 하루에만 나타났다는 뜻입니다. 각 오실레이터의 차이는 KDJ와 RSI 비교를, MACD 골든크로스 활용법은 골든크로스 종목 스크리닝을 참고하세요.
API로 홍콩 주식과 중국 A주를 스크리닝하려면?
POST /screen은 약 950개 종목(S&P 500, Nasdaq-100, 항셍지수, CSI 300 구성 종목과 PickSkill 종목 페이지가 있는 종목)에 조건을 적용해 일치하는 종목을 근거와 함께 반환합니다. 조건은 세 가지 유형이며 모두 AND로 묶이고 한 번에 최대 8개입니다. signal(어떤 차원이 N일 동안 강세·약세·중립 유지), value(예: rsi.rsi < 30 또는 kdj.j), event(macd_golden_cross, ma5_ma20_golden_cross, turned_bullish와 그 반대 이벤트를 N일 이내에 감지, 즉 골든크로스·데드크로스 등)입니다. markets(us, hk, cn)나 indices(sp500, ndx, hsi, csi300)로 범위를 좁히고, 정렬해 최대 30개를 받을 수 있습니다. 스크리닝 1회는 3크레딧이며 PickSkill 유료 요금제가 필요합니다. Free 계정은 403을 받고 과금되지 않습니다. 시그널 스크리너와 같은 엔진입니다.
curl -X POST "https://pickskill.ai/api/v1/screen" \
-H "Authorization: Bearer $PICKSKILL_API_KEY" \
-H "Content-Type: application/json" \
-d '{"indices":["hsi","csi300"],
"conditions":[{"type":"value","field":"rsi.rsi","op":"<","value":30}],
"sort_by":"rsi","limit":8}'
2026년 11월 19일 종가로 실행하면 이 스크리닝은 항셍지수와 CSI 300의 385개 종목을 대상으로 RSI(14)가 30 미만인 33개 종목을 찾았습니다. 일치 결과 하나를 줄여 보면 다음과 같습니다.
{
"ticker": "0881.HK",
"name": "Zhongsheng",
"market": "hk",
"indices": ["hsi"],
"asOf": "2026-11-19",
"close": 1.73,
"evidence": ["rsi.rsi = 17.4 (< 30)"]
}
15줄로 시그널 알림을 만들려면?
첫 프로젝트로 좋은 것은 관심 종목의 판정이 강세로 바뀌면 알려 주는 알림입니다. 각 차원에 5일 추이가 붙어 있으므로 전날 상태를 저장할 필요가 없습니다. 추이가 NB나 SB로 끝나면 가장 최근 거래일에 강세로 전환됐다는 뜻입니다.
- PickSkill 계정에서 API 키를 만들고
PICKSKILL_API_KEY로 export합니다. - 한 번의 호출에 최대 10개 종목을 넣습니다. 시장이 섞여도 괜찮습니다.
- 관심 있는 차원을 고릅니다(예: MACD, RSI, KDJ).
- 각
last5추이의 마지막 두 글자를 확인합니다. - 장 마감 후 하루 한 번 스크립트가 실행되도록 예약합니다(cron, GitHub Actions, 클라우드 함수 등). 1회 실행에 1크레딧이 듭니다.
import os, requests
URL = "https://pickskill.ai/api/v1/signals"
KEY = os.environ["PICKSKILL_API_KEY"]
WATCH = "NVDA,0700.HK,600519.SS"
r = requests.get(URL, params={"tickers": WATCH},
headers={"Authorization": f"Bearer {KEY}"}, timeout=30)
r.raise_for_status()
body = r.json()
for s in body["data"]["stocks"]:
for dim in ("macd", "rsi", "kdj"):
trail = s.get("signals", {}).get(dim, {}).get("last5", "")
if trail[-2:] in ("NB", "SB"):
print(f"{s['ticker']} {dim} turned bullish ({trail}) as of {s['asOf']}")
print("credits left:", body["credits"]["remaining"])
2026년 11월 19일 데이터로 실행하면 스크립트는 0700.HK rsi turned bullish (NNNNB) as of 2026-11-19 한 줄을 출력합니다. 텐센트의 RSI가 그날 과매도 구간에 들어갔다는 뜻입니다. NVDA의 RSI는 5일 내내 강세(BBBBB)였으므로 새로운 전환이 아니고, 구이저우마오타이(600519.SS)에는 새로운 강세 판정이 없었습니다.
API 비용은 얼마인가?
API 사용은 선불 크레딧으로 과금되며, 요금 페이지의 채팅 요금제와는 별도입니다. 모든 계정에 한 번 무료 100크레딧이 주어지고, 이후 팩은 1,000크레딧 10달러, 5,000크레딧 45달러, 20,000크레딧 160달러이며 크레딧은 만료되지 않습니다. 이 가격이면 10개 종목 시그널 호출 1회가 0.008~0.01달러이므로, 위의 일일 알림은 하루 1센트에 훨씬 못 미치는 비용으로 돌아갑니다. 고정된 호출 한도는 없고, 잔액만이 호출을 제한합니다. 자세한 내용과 최신 팩 목록은 Data API 페이지에 있습니다.
AI 에이전트가 이 호출을 대신하게 하고 싶다면 같은 도구를 MCP로도 쓸 수 있습니다. 선택지 비교는 주식 시장 데이터용 MCP 서버 정리를 참고하세요.
이 글은 연구 및 교육 목적이며 투자 조언이 아닙니다. 기술적 시그널은 과거 가격 흐름을 설명할 뿐 미래 수익을 예측하지 않습니다.
FAQ
무료로 쓸 수 있는 주식 기술적 지표 API가 있나요? PickSkill은 모든 계정에 한 번 무료 100 API 크레딧을 제공하며, 이는 최대 10개 종목 시그널 호출 100회에 해당합니다. 그 이후에는 1,000크레딧 10달러부터 시작하는 선불 팩을 구매합니다. TA-Lib 같은 오픈소스 라이브러리로 직접 계산하는 것은 무료지만, 입력할 가격 데이터는 따로 필요합니다.
홍콩 주식과 중국 A주의 MACD·RSI를 주는 API는?
PickSkill의 /api/v1/signals 엔드포인트는 미국 주식과 함께 0700.HK 같은 홍콩 주식, 600519.SS나 300750.SZ 같은 중국 A주의 MACD, RSI, KDJ, 이동평균, 볼린저 밴드, ADX, 거래량, 자금 흐름을 반환합니다. 각 차원에는 최신 값, 강세·약세·중립 판정, 5일 추이가 포함됩니다.
API는 A주 상한가 날을 어떻게 처리하나요? 고가와 저가가 같은 일봉, 즉 시초가부터 묶인 상한가·하한가나 거래 정지로 생기는 봉은 정보가 없는 것으로 처리합니다. 그날의 판정은 모든 지표 차원에서 중립으로 고정되고 5일 추이 안에서도 마찬가지라서, 연속 상한가가 가짜 강한 추세 시그널을 만들 수 없습니다.
REST API와 MCP 서버는 무엇이 다른가요? 같은 도구를 실행하고, 같은 데이터를 반환하며, 크레딧 잔액도 하나를 공유합니다. REST API는 직접 만든 스크립트, 대시보드, 백엔드에 적합하고, MCP 서버는 Claude Code, Cursor, Claude Desktop 같은 AI 에이전트에 적합합니다. 에이전트가 도구를 스스로 찾아 호출합니다.
RSI 기간 같은 지표 파라미터를 바꿀 수 있나요? 아니요. API는 RSI(14), KDJ(9,3,3), 볼린저(20,2), ADX/DMI(14), 5·20·60일 이동평균 등 표준 설정으로 값을 반환합니다. 전략이 맞춤 기간에 의존한다면 원시 가격을 받아 해당 지표를 직접 계산하고, 시그널 API는 빠른 점검과 알림에 쓰는 것이 좋습니다.