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."
}