개요
API는 HTTPS 기반의 읽기 전용 JSON 엔드포인트 몇 개로 구성됩니다. 티커는 Yahoo 형식을 사용합니다: NVDA, BRK-B, 0700.HK, 600519.SS, 300750.SZ.
- 기본 URL
- https://pickskill.ai/api/v1
- 응답 형식
- 호출에 성공하면 HTTP 200과 함께 data와 credits를 반환합니다. 모든 data 객체에는 PickSkill 데이터가 리서치 및 교육 목적이며 투자 자문이 아니라는 안내가 포함됩니다.
인증
API 대시보드에서 키를 만들고 Authorization 헤더에 Bearer 토큰으로 전송하세요(x-api-key 헤더도 가능). 키는 psk_로 시작합니다. 키는 외부에 노출되지 않도록 관리하세요. 언제든지 폐기할 수 있습니다.
Authorization: Bearer psk_…
# or
x-api-key: psk_…크레딧
호출에 성공할 때마다 선불 잔액에서 크레딧이 차감되고, 실패한 호출은 환불됩니다. 모든 계정은 100 크레딧을 무료로 받고 시작하며, API와 MCP 서버는 잔액을 공유합니다.
| GET/signals | 1 |
| POST/screen | 3 |
| GET/earnings | 2 |
| GET/portfolios | 1 |
| GET/credits | 무료 |
각 응답은 차감된 크레딧과 남은 크레딧을 본문과 X-Credits-Charged, X-Credits-Remaining 헤더에 모두 담아 알려 줍니다.
오류
오류가 발생하면 오류 코드, 메시지, 이 문서로 연결되는 링크가 담긴 JSON 본문을 반환합니다.
{
"error": {
"code": "insufficient_credits",
"message": "Not enough API credits: this call needs 3, your balance is 2. …",
"docs": "https://pickskill.ai/data-api/docs"
},
"credits": { "remaining": 2 }
}| 상태 | 코드 | 의미 |
|---|---|---|
| 400 | invalid_input | 입력값이 올바르지 않습니다. 예를 들어 티커가 빠졌거나 스크리닝 조건 형식이 잘못된 경우입니다. 환불됩니다. |
| 401 | unauthorized | API 키가 없거나, 유효하지 않거나, 폐기되었습니다. |
| 402 | insufficient_credits | 이 호출에 필요한 크레딧이 부족합니다. 본문에 현재 잔액이 포함됩니다. |
| 404 | not_found / unknown_tool | 존재하지 않는 엔드포인트입니다. |
| 405 | method_not_allowed | 이 엔드포인트에서 지원하지 않는 HTTP 메서드입니다. |
| 500 | internal_error | 서버 측에서 문제가 발생했습니다. |
| 502 | upstream_error | 데이터 제공처에서 오류가 발생했습니다. 환불되며, 잠시 후 다시 시도해 주세요. |
엔드포인트
GET/api/v1/signals비용: 1주식 시그널 조회
최근 종가, 1일·5일 등락률, 8가지 기술적 시그널을 반환합니다. 각 시그널은 강세·약세·중립 중 하나이며, 5일 추이와 최신 지표 값이 함께 제공됩니다.
파라미터
tickersquery · 필수 | 쉼표로 구분한 티커, 최대 10개. 미국, 홍콩(.HK), 중국 A주(.SS, .SZ)를 지원합니다. |
요청 예시
curl "https://pickskill.ai/api/v1/signals?tickers=NVDA,0700.HK" \
-H "Authorization: Bearer $PICKSKILL_API_KEY"응답 예시
{
"data": {
"disclaimer": "For research and education only. Not investment advice.",
"legend": "signals[dim].now = latest reading; last5 = …",
"stocks": [
{
"ticker": "NVDA",
"asOf": "2026-11-17",
"close": 156.14,
"changePct": -1.2,
"fiveDayChangePct": 3.4,
"signals": {
"macd": { "now": "bullish", "last5": "NBBBB", "values": { "dif": 2.1, "dea": 1.7 } },
"rsi": { "now": "neutral", "last5": "NNNNN", "values": { "rsi": 58.4 } },
"…": "kdj, ma, boll, adx, volume, flow"
},
"bullishCount": 6,
"bearishCount": 1,
"page": "https://pickskill.ai/stocks/NVDA"
}
]
},
"credits": { "charged": 1, "remaining": 99 }
}POST/api/v1/screen비용: 3종목 스크리닝
S&P 500, 나스닥 100, 항셍지수, CSI 300(및 PickSkill 종목 페이지) 중 모든 조건을 충족하는 종목을 조건별 근거와 함께 찾아냅니다. JSON 본문으로 요청하세요.
파라미터
conditionsbody · 필수 | 조건 1~8개. 모든 조건을 충족해야 합니다. 스크리닝 조건 항목을 참고하세요. |
indicesbody · 선택 | 지수 구성 종목으로 제한: sp500, ndx, hsi, csi300. |
marketsbody · 선택 | 시장으로 제한: us, hk, cn. |
sort_bybody · 선택 | bullish_count(기본값), change_pct, five_day_change_pct 또는 rsi. |
limitbody · 선택 | 반환할 종목 수, 1~30. 기본값은 15. |
요청 예시
curl -X POST "https://pickskill.ai/api/v1/screen" \
-H "Authorization: Bearer $PICKSKILL_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"indices": ["sp500"],
"conditions": [
{ "type": "event", "event": "macd_golden_cross", "within_days": 3 },
{ "type": "value", "field": "rsi.rsi", "op": "<", "value": 50 }
],
"limit": 10
}'응답 예시
{
"data": {
"universe": "… [sp500]: 503 stocks screened.",
"matchedCount": 10,
"matches": [
{
"ticker": "CAT",
"name": "Caterpillar",
"market": "us",
"indices": ["sp500"],
"close": 512.3,
"bullishCount": 6,
"evidence": [
"MACD golden cross 1 day ago (DIF 4.12, DEA 3.80)",
"rsi.rsi = 47.6 (< 50)"
],
"page": "https://pickskill.ai/stocks/cat"
}
]
},
"credits": { "charged": 3, "remaining": 96 }
}GET/api/v1/earnings비용: 2실적 하이라이트 조회
기업의 최신 실적 발표(발표일, 실제 EPS와 예상 EPS, 서프라이즈)와 함께 밸류에이션, 마진, 수익률, 레버리지, 성장성 관련 핵심 지표를 반환합니다. 미국 상장 기업의 데이터가 가장 풍부합니다.
파라미터
tickerquery · 필수 | 티커 1개. |
요청 예시
curl "https://pickskill.ai/api/v1/earnings?ticker=NVDA" \
-H "Authorization: Bearer $PICKSKILL_API_KEY"응답 예시
{
"data": {
"ticker": "NVDA",
"latestEarnings": {
"report_date": "2026-08-26",
"report_time": "After Hours",
"eps_actual": 2.22,
"eps_estimate": 2.09,
"eps_surprise_percent": 6.22
},
"keyRatios": {
"pe_ratio": 20.2,
"forward_pe": 10.1,
"gross_margin": 0.75,
"return_on_equity": 1.17,
"quarterly_revenue_growth": 1.06,
"debt_to_equity": 0.17,
"…": "…"
},
"sources": ["…"]
},
"credits": { "charged": 2, "remaining": 94 }
}GET/api/v1/portfolios비용: 1포트폴리오 조회
PickSkill에 저장한 포트폴리오를 보유 종목, 비중과 함께 반환합니다. 종목별 최근 등락률과 시그널 개수도 포함됩니다.
파라미터
portfolioquery · 선택 | 포트폴리오 이름 또는 id. 생략하면 모든 포트폴리오를 반환합니다. |
include_signalsquery · 선택 | false로 설정하면 종목별 시그널을 생략합니다. 기본값은 true입니다. |
요청 예시
curl "https://pickskill.ai/api/v1/portfolios?include_signals=true" \
-H "Authorization: Bearer $PICKSKILL_API_KEY"응답 예시
{
"data": {
"portfolios": [
{
"id": "…",
"name": "Core",
"holdings": [
{
"ticker": "AAPL",
"name": "Apple",
"weightPct": 25,
"close": 228.4,
"changePct": 0.8,
"signals": { "macd": { "now": "bullish", "last5": "NBBBB", "values": { … } }, "…": "…" },
"bullishCount": 5,
"bearishCount": 1
}
]
}
]
},
"credits": { "charged": 1, "remaining": 93 }
}GET/api/v1/credits비용: 무료크레딧 확인
크레딧 잔액, 엔드포인트별 비용, 구매 가능한 크레딧 팩을 반환합니다. 호출은 무료입니다.
요청 예시
curl "https://pickskill.ai/api/v1/credits" \
-H "Authorization: Bearer $PICKSKILL_API_KEY"응답 예시
{
"data": {
"balance": 93,
"costPerCall": { "get_stock_signals": 1, "get_my_portfolio": 1, "get_earnings_highlights": 2, "screen_stocks": 3 },
"packs": [ { "credits": 1000, "priceUsd": 10 }, { "credits": 5000, "priceUsd": 45 }, { "credits": 20000, "priceUsd": 160 } ],
"buyUrl": "https://pickskill.ai/account/api"
}
}스크리닝 조건
조건은 type을 가진 객체로 지정합니다. 최대 8개까지 조합할 수 있으며, 모든 조건을 충족하는 종목만 결과에 포함됩니다.
type: "signal"
특정 지표의 판정이 강세·약세·중립인지 확인합니다. 최근 N일(1~5)을 지정할 수도 있습니다. RSI와 KDJ의 "강세"는 과매도를 의미합니다.
{ "type": "signal", "dimension": "ma", "is": "bullish", "days": 3 }type: "value"
지표 값을 숫자와 비교합니다: <, <=, > 또는 >=.
{ "type": "value", "field": "rsi.rsi", "op": "<", "value": 30 }type: "event"
최근 N일(1~5) 안에 발생한 MACD 또는 MA5/MA20의 골든크로스·데드크로스, 또는 지표 판정이 강세나 약세로 전환된 경우.
{ "type": "event", "event": "macd_golden_cross", "within_days": 3 }- 지표
macdmarsikdjbolladxvolumeflow- 주요 필드
rsi.rsikdj.kkdj.dkdj.jmacd.difmacd.histadx.adxboll.bandwidthvolume.volRatioprice.changePctprice.fiveDayChangePct- 이벤트
macd_golden_crossmacd_death_crossma5_ma20_golden_crossma5_ma20_death_crossturned_bullishturned_bearish
MCP로 사용하기
도구 호출을 AI 에이전트에게 맡기고 싶으신가요? MCP 서버는 같은 네 가지 도구를 Claude, Cursor, VS Code 등 MCP 클라이언트에 제공하며, 같은 키와 같은 크레딧을 사용합니다.
MCP 서버 설정하기PickSkill 데이터는 과거 가격을 바탕으로 하며 리서치 및 교육 목적으로만 제공됩니다. 투자 자문이 아닙니다.