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 https://gptchart.ai/api/v2/crypto/analyze \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{ "symbol": "BTC-USD", "interval": "4H" }'{
"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"
}{
"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가 포함됩니다.
{
"error": "Interval 1M (monthly) is not available. Use 1W or shorter."
}