KLineAPI - A주 실시간 시세 API 스킬

밀리초 응답 · 56개 이상 데이터 인터페이스 · 한 번 연동으로 전 장면 커버 공식 사이트: https://klineapi.com · 문서: https://klineapi.com/docs · 가입: https://klineapi.com/register

KLineAPI는 개발자와 퀀트 팀을 위한 A주 시세 데이터 인터페이스로, 실시간 시세, 역사적 K라인, 상한가 모니터링, 자금 흐름, 재무 데이터 등 전 장면을 커버합니다. 본 스킬은 바로 사용 가능한 연동 매뉴얼과 코드 예제를 제공합니다.

빠른 시작

1. 가입하여 API 키 받기

https://klineapi.com/register 에 접속하여 무료 가입 후, '개발자 콘솔'에서 API 키(형식: kline_xxxxxxxx)를 받으세요.

스킬 체험 할당량(가입 즉시 활성화):

✅ 모든 인터페이스 개방
✅ 일 100회 호출 / 분당 10회
✅ 초과 시 프로페셔널 버전(월 49위안) 또는 엔터프라이즈 버전(월 199위안, 한정 시간)으로 업그레이드하여 할당량 대폭 증가

2. 인증 방식

모든 인터페이스는 API 키가 필요하며, 다음 두 가지 전달 방식 중 선택 가능:

# 방식 1: 쿼리 파라미터
curl "https://klineapi.com/v1/quote?key=YOUR_KEY&code=600519"

# 방식 2: 요청 헤더
curl -H "X-API-Key: YOUR_KEY" "https://klineapi.com/v1/quote?code=600519"

3. Python 예제

import requests

KEY = "YOUR_API_KEY"
BASE = "https://klineapi.com"

def get_quote(code):
    r = requests.get(f"{BASE}/v1/quote", params={"key": KEY, "code": code}, timeout=10)
    return r.json()

print(get_quote("600519"))  # 구이저우마오타이 실시간 시세

인터페이스 개요 (56개 이상, 전체 분류)

📊 실시간 시세 (무료 인터페이스)

인터페이스	경로	설명
실시간 시세	`/v1/quote`	단일 주식 실시간 호가
일괄 시세	`/v1/batch`	최대 50개 일괄 시세
5단계 호가창	`/v1/orderbook`	매수/매도 5단계 주문
분봉 데이터	`/v1/intraday`	당일 분봉 추세
경매 정보	`/v1/auction`	경매 정보
상승률 순위	`/v1/top`	전체 시장 상승률 순위
시장 지수	`/v1/index`	상하이/선전/창업판 등 지수
K라인 히스토리	`/v1/kline`	일/주/월/분봉 K라인
코드 검색	`/v1/search`	주식 코드/명칭 검색
AH주 시세 스냅샷	`/v1/hsgt/ah_spot`	AH주 대조 시세

🚀 상한가/급등

인터페이스	경로	설명
상한가 풀	`/v1/limit_up`	당일/역사적 상한가 풀
하한가 풀	`/v1/limit_down`	당일/역사적 하한가 풀
급등 풀	`/v1/limit_up_break`	상한가 후 하락
연속 상한가 사다리	`/v1/lianban`	연속 상한가 수 계층

4개 풀 모두 ?date=YYYY-MM-DD 지원하여 역사적 거래일 데이터 조회 가능

🏷️ 섹터/테마

개별 주식 섹터 /v1/stock_sector · 섹터 목록 /v1/board_list · 개념 섹터 /v1/thematic/list · 업종 섹터 /v1/thematic/industry_list · 섹터 구성 /v1/sector_detail · 섹터 상한가 /v1/plates_zt

🐉 용호방

용호방 /v1/lhb · 기관 좌석 /v1/lhb/institution · 활발한 주식 통계 /v1/lhb_active

💰 자금 흐름

개별 주식 자금 내역 /v1/finance/stock_fund_flow · 개별 주식 자금 순위 /v1/moneyflow/rank · 주력 자금 /v1/moneyflow/main_rank

🏢 회사 데이터

회사 개요 /v1/company/profile (주요 업무/법인/개념 태그 포함) · 배당 내역 /v1/company/dividend · 주요 주주 10인 /v1/company/top10_holder · 유통 주요 주주 10인 /v1/company/top10_float_holder · 자본 구조 /v1/company/capital_structure · 보호 예수 해제 /v1/trade/release

📈 재무 분석

재무 데이터 /v1/finance · 손익계산서 /v1/finance/income · 대차대조표 /v1/finance/balance · 현금흐름표 /v1/finance/cashflow · 실적 전망 /v1/finance/forecast · 실적 속보 /v1/finance/express · 실적 보고서 /v1/finance/performance · 재무 지표 분석 /v1/finance/analysis

💹 펀드/ETF

펀드 개요 /v1/fund/brief · 펀드 보유 /v1/fund/hold · 역사적 NAV /v1/fund/nav · ETF 전체 시세 /v1/fund/etf_spot · ETF K라인 /v1/etf/kline · 전환사채 실시간 /v1/bond/realtime

고급 사용법

상한가 리뷰 자동화 (매일 장 종료 후)

import requests
from datetime import date

KEY = "YOUR_KEY"
BASE = "https://klineapi.com"

def daily_limitup_review(d=None):
    d = d or date.today().isoformat()
    pools = {}
    for name, path in [("상한가", "limit_up"), ("하한가", "limit_down"),
                       ("급등", "limit_up_break"), ("연속 상한가", "lianban")]:
        r = requests.get(f"{BASE}/v1/{path}", params={"key": KEY, "date": d}, timeout=15)
        pools[name] = r.json().get("data", {})
    return pools

보유 주식 모니터링 + 재무 건강 검진

def watch_stock(code):
    q = get_quote(code)              # 실시간 가격
    f = requests.get(f"{BASE}/v1/finance/analysis",
                     params={"key": KEY, "code": code}, timeout=15).json()
    return {"quote": q, "finance": f}

오류 코드

코드	의미
200	성공
400	파라미터 오류
401	유효하지 않은 API 키
403	요금제 권한 부족
429	호출 한도 초과 (요금제 업그레이드로 해결)
502	데이터 소스 일시적 사용 불가, 잠시 후 재시도

요금제 비교

요금제	가격	일일 할당량	분당 할당량	인터페이스 권한
무료 버전	¥0	100회	10회	기본 인터페이스
스킬 체험 버전	¥0 (가입 즉시 제공)	100회	10회	전체 56개 이상 인터페이스
프로페셔널 버전	¥49/월	10,000회	100회	전체 인터페이스
엔터프라이즈 버전	¥199/월 (원가 ¥299)	100,000회	무제한	전체 인터페이스

링크

🌐 공식 사이트: https://klineapi.com
📖 API 문서: https://klineapi.com/docs
🚀 체험 가입: https://klineapi.com/register
💬 문의 지원: https://klineapi.com/contact

kraine2008-ux/klineapi-skill

klineapi-skill란 무엇인가요?

즐겨 사용하는 AI에게 물어보기

문서