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"
默认模式。由你选择设置——interval 或 timeframes、指标、已保存的策略和备注——智能体会严格按这些设置进行分析,就像应用中的 Lite 表单一样。
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 模式。最多可同时分析 3 个时间周期,用于替代 interval。
selectedIndicatorsstring[]
Lite 模式。从下方列表中选择最多 3 个指标 ID。
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波动率,适合设置止损/止盈
  • 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" }'
包含两个时间周期的 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. 保留所有权利。