API 문서

직접 만든 코드, 봇, 백테스트에서 GPTChart.ai 분석을 실행하세요.

API 키

계정당 활성 키는 하나입니다. 앱과 마찬가지로 크레딧을 사용하므로 클라이언트 측 코드나 공개 저장소에 넣지 마세요.

로그인하여 API 키 생성

아래 문서는 누구나 볼 수 있습니다. 키는 계정과 계정의 크레딧에 연결됩니다.

인증

모든 요청에 키를 Bearer 토큰으로 보내세요. 키는 sk_live_로 시작합니다.

헤더
Authorization: Bearer sk_live_...

엔드포인트

모든 경로는 https://gptchart.ai를 기준으로 합니다. 계정당 분당 6회, 시간당 60회 분석을 시작할 수 있으며, 세션은 분당 30회 조회할 수 있습니다. 심볼 목록은 하나의 IP 주소에서 5분마다 10회 요청할 수 있습니다.

  • POST암호화폐 차트 분석
  • POST주식 차트 분석
  • POST외환 또는 원자재 차트 분석
  • GET암호화폐 심볼 목록
  • GET주식 및 ETF 심볼 목록
  • GET외환 및 원자재 심볼 목록
  • GET세션의 최신 결과와 아직 실행 중인지 여부를 조회합니다

분석 비용은 앱에서와 같습니다. 가격은 모델과 에이전트가 차트에 표시하는 내용의 양에 따라 달라지며, creditsUsed에 각 분석의 비용이 표시됩니다. 심볼 목록과 세션 조회는 무료입니다. 플랜 및 크레딧을 확인하세요.

모드

모든 분석은 앱과 동일한 에이전트가 실행하며, 앱에서 다시 열 수 있도록 세션으로 저장됩니다. mode는 분석의 시작 방식을 선택합니다.

Litemode: "lite"
기본값입니다. 설정을 직접 선택하면 에이전트가 앱의 Lite 양식과 동일하게 해당 설정만 분석합니다. interval 또는 timeframes, 지표, 저장된 전략 및 메모를 지정할 수 있습니다.
Promode: "pro"
채팅에서처럼 message를 보내면 에이전트가 직접 시간대와 지표를 선택합니다. 대화형 메시지는 크레딧 1개가 들며 가격 레벨은 반환되지 않습니다.
후속 메시지sessionId
이곳이나 앱에서 시작한 세션을 이어가려면 sessionId와 message를 보내세요. 심볼, 차트 및 드로잉은 해당 세션의 정보를 사용합니다.

요청은 분석이 완료된 후 반환되며 몇 분이 걸릴 수 있으므로 클라이언트의 타임아웃을 길게 설정하세요. 분석이 먼저 중단되더라도 분석은 계속 완료되고 요금이 부과됩니다. 결과는 앱의 세션 목록에서 확인할 수 있습니다.

요청 본문

세 가지 분석 엔드포인트는 동일한 JSON 본문을 사용하며, 적용되는 필드는 모드에 따라 달라집니다. expertMode와 analyzeRelatedNews는 계속 허용되지만 아무런 영향을 주지 않습니다.

modestring
lite(기본값) 또는 pro입니다. 후속 메시지에는 필요하지 않습니다.
modelstring
실행할 모델입니다: luna, terra(기본값) 또는 sol. 각 모델의 가격은 앱과 동일합니다.
symbolstring · 세션 시작에 필수
마켓의 /symbols 엔드포인트에 있는 심볼입니다. 예: BTC-USD, AAPL 또는 EURUSD. 후속 메시지에서는 생략합니다.
intervalstring · Lite에서 timeframes 또는 strategyId가 없으면 필수
차트 시간대입니다: 1m, 5m, 15m, 30m, 1H, 4H, 1D 또는 1W. Pro에서는 시작 차트에 적용되며 기본값은 1H입니다.
timeframesstring[]
Lite 전용입니다. interval 대신 함께 분석할 시간대를 최대 3개까지 지정합니다.
selectedIndicatorsstring[]
Lite 전용입니다. 아래 목록에서 지표 ID를 최대 3개까지 지정합니다.
indicatorTimePeriodsobject
Lite 전용입니다. ema와 sma의 기간을 각각 최대 2개까지 지정합니다. 예: ema: [20, 50].
customPromptstring
Lite 전용입니다. 에이전트에게 전달할 지침을 최대 3,000자까지 작성할 수 있습니다.
strategyIdstring
Lite 전용입니다. 저장된 전략 중 하나를 실행합니다. 전략의 시간대, 지표 및 지침이 적용되며, 직접 보낸 항목은 해당 설정에 우선 적용됩니다.
messagestring · Pro 및 후속 메시지
Pro 및 후속 메시지에 사용합니다. 채팅에 입력할 내용을 최대 10,000자까지 작성할 수 있습니다.
sessionIdstring
이 세션을 이어갑니다. message와 함께만 보내세요.
languagestring
작성되는 분석의 언어: English, Simplified Chinese, Japanese, Korean, French. 기본값은 English입니다.

지표

selectedIndicators에 이 ID를 사용하세요. 요청당 최대 3개입니다.

  • Simple Moving Average추세 필터, 주로 20, 50 또는 200
  • Exponential Moving Average더 빠른 추세 반응
  • Ichimoku Cloud추세 국면과 지지/저항
  • Bollinger Bands변동성 밴드와 스퀴즈
  • Average True Range변동성, SL/TP 설정에 유용
  • Supertrend추세 추종형 트레일링 스톱
  • Parabolic SAR가격 가속도 기반 트레일링 스톱
  • Relative Strength Index모멘텀, 기본값 14
  • MACD모멘텀과 추세 교차
  • Know Sure Thing여러 변화율을 결합한 모멘텀
  • Stochastic Oscillator모멘텀, 과매수/과매도
  • Average Directional Index추세의 방향이 아닌 강도
  • %B볼린저 밴드 안에서의 가격 위치
  • Money Flow Index거래량 가중 모멘텀
  • Detrended Price Oscillator장기 추세를 제거한 사이클
  • VWAP거래량 가중 적정 가치
  • Relative Volume평균 대비 거래량
  • Accumulation/Distribution거래량의 유입과 유출

응답

분석이 성공하면 다음 필드와 함께 200을 반환합니다. 대화형 Pro 메시지처럼 응답에 분석 내용이 없는 경우 가격 필드는 null입니다. 세션 조회는 여기에 status를 더해 동일한 필드를 반환합니다.

biasstring | null
Buy, Sell 또는 Neutral입니다. 명확한 매수 또는 매도 판단만 Buy 또는 Sell로 표시됩니다.
biasDetailstring | null
에이전트의 전체 판단입니다: Buy, Neutral Buy, No Trade, Neutral Sell 또는 Sell.
entrynumber | null
추천 진입가.
stopLossnumber | null
추천 손절가.
takeProfitnumber | null
추천 익절가.
confirmationPricenumber | null
진입 전에 셋업을 확인해 주는 가격.
reasoningstring | null
거래에 대한 짧은 근거.
analysisstring
에이전트가 작성한 전체 답변입니다.
creditsUsednumber
이 요청에 사용된 크레딧.
modestring | null
lite, pro 또는 후속 메시지의 경우 null입니다.
modelstring
응답에 사용된 모델입니다. 대화형 답변은 항상 luna로 실행됩니다.
sessionIdstring
이 분석이 저장된 세션입니다. 후속 메시지를 보내려면 sessionId로 다시 전달하세요.
chartUrlstring
키 소유자의 계정에서 에이전트의 드로잉이 표시된 차트를 엽니다.
timeframesstring[]
분석 후 차트에 설정된 시간대입니다.
indicatorsobject[]
설정이 포함된 차트 지표입니다.
drawingsobject[]
차트에 표시된 에이전트의 표시입니다. 선, 구간, 패턴 및 마커가 포함됩니다.
statusstring
세션 조회 전용입니다. 에이전트가 작업 중이면 running이며, 완료되면 done 또는 failed가 됩니다.

예시

cURL
curl https://gptchart.ai/api/v2/crypto/analyze \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "symbol": "BTC-USD", "interval": "4H" }'
시간대 2개를 지정한 Lite 본문
{
  "symbol": "BTC-USD",
  "timeframes": ["15m", "1H"],
  "selectedIndicators": ["bbands", "atr", "ema"],
  "indicatorTimePeriods": { "ema": [20, 50] },
  "customPrompt": "Look for liquidity sweeps around the previous high and low. Use ATR for SL/TP.",
  "model": "sol"
}
Pro 본문
{
  "mode": "pro",
  "symbol": "AAPL",
  "message": "Where is the next resistance, and is a breakout likely this week?"
}
후속 메시지 본문
{
  "sessionId": "3mQk8vZr2LxTn5WcHd1F",
  "message": "If price breaks 78,000, where would you trail the stop?"
}
저장된 전략 본문
{
  "symbol": "AAPL",
  "strategyId": "c1mEhAha9qaVpHdAKQx0"
}
응답
{
  "bias": "Neutral",
  "biasDetail": "Neutral Buy",
  "entry": 77502.82,
  "stopLoss": 77002.44,
  "takeProfit": 78254.17,
  "confirmationPrice": 77502.82,
  "reasoning": "Early bullish structure shift on the 1H; a close above 77,500 confirms it.",
  "analysis": "Bias: **Neutral Buy** The 1H chart is turning up out of a decline...",
  "creditsUsed": 7,
  "mode": "lite",
  "model": "terra",
  "sessionId": "3mQk8vZr2LxTn5WcHd1F",
  "chartUrl": "https://gptchart.ai/btcusdt?session=3mQk8vZr2LxTn5WcHd1F",
  "timeframes": ["1H"],
  "indicators": [],
  "drawings": [
    { "id": "ai-stop", "type": "horizontal", "price": 77002.44, "label": "Stop", "author": "ai" }
  ]
}

오류

오류가 발생하면 error 메시지가 담긴 JSON 본문을 반환합니다.

  • 400잘못된 요청본문의 유효성 검사에 실패했거나 모드에 맞지 않습니다. 예: 알 수 없는 심볼 또는 월간 간격.
  • 401인증되지 않음키가 없거나 형식이 잘못되었거나 만료 또는 취소되었습니다.
  • 402크레딧 부족잔액이 분석 비용을 충당하기에 부족합니다. 메시지에 필요한 크레딧 수가 표시됩니다.
  • 403접근 금지계정이 더 이상 유료 플랜이 아닙니다(SUBSCRIPTION_REQUIRED).
  • 404찾을 수 없음strategyId 또는 sessionId가 사용자 계정에 속하지 않습니다.
  • 405허용되지 않는 메서드엔드포인트에 맞지 않는 HTTP 메서드입니다.
  • 409세션 사용 중이전 메시지에 대한 응답이 아직 진행 중입니다. 완료된 후 다시 시도하세요.
  • 429요청이 너무 많습니다한 계정에서 분당 6회 또는 시간당 60회 분석 한도를 초과했습니다. 잠시 기다린 후 다시 시도하세요.
  • 500서버 오류서버 측에서 오류가 발생했습니다. 실패한 분석에는 요금이 부과되지 않으며, 세션이 저장된 경우 본문에 sessionId가 포함됩니다.
400 응답
{
  "error": "Interval 1M (monthly) is not available. Use 1W or shorter."
}
GPTChart.ai

실제 시장 데이터와 구조화된 트레이드 로직으로 학습하는 자기 학습형 AI가 분석마다 발전하며 차트에서 빠르고 설명 가능한 트레이딩 인사이트를 제공합니다.

거래에는 큰 손실 위험이 따릅니다. GPTChart.ai가 제공하는 AI 분석은 정보 제공 목적으로만 사용되며 금융 조언이 아닙니다. AI는 실수할 수 있으니 항상 직접 조사하세요.

© 2026 GPTChart.ai. 모든 권리를 보유합니다.