API 레퍼런스

PickSkill API 문서

PickSkill REST API 호출에 필요한 모든 것을 담았습니다. 기본 URL, 인증, 크레딧, 오류, 그리고 엔드포인트별 예제까지.

API 키 만들기https://pickskill.ai/api/v1

개요

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_…
API 키 만들기

크레딧

호출에 성공할 때마다 선불 잔액에서 크레딧이 차감되고, 실패한 호출은 환불됩니다. 모든 계정은 100 크레딧을 무료로 받고 시작하며, API와 MCP 서버는 잔액을 공유합니다.

GET/signals1
POST/screen3
GET/earnings2
GET/portfolios1
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 }
}
상태코드의미
400invalid_input입력값이 올바르지 않습니다. 예를 들어 티커가 빠졌거나 스크리닝 조건 형식이 잘못된 경우입니다. 환불됩니다.
401unauthorizedAPI 키가 없거나, 유효하지 않거나, 폐기되었습니다.
402insufficient_credits이 호출에 필요한 크레딧이 부족합니다. 본문에 현재 잔액이 포함됩니다.
404not_found / unknown_tool존재하지 않는 엔드포인트입니다.
405method_not_allowed이 엔드포인트에서 지원하지 않는 HTTP 메서드입니다.
500internal_error서버 측에서 문제가 발생했습니다.
502upstream_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 데이터는 과거 가격을 바탕으로 하며 리서치 및 교육 목적으로만 제공됩니다. 투자 자문이 아닙니다.