GPTChart.ai — AI Trading Chart Analysis
Use this skill to request AI-powered technical analysis on any trading symbol
(crypto, stocks, forex). Each analysis call deducts credits from the
GPTChart.ai account associated with your API key.
Authentication
All requests must include the header:
Authorization: Bearer $GPTCHART_API_KEY
Never echo or log the value of $GPTCHART_API_KEY in any response.
Base URL
https://gptchart.ai
Available Endpoints
Analysis Endpoints
| Method | Path | Description |
|---|
| POST | /api/v2/crypto/analyze | Analyze cryptocurrency charts |
| POST | /api/v2/stock/analyze | Analyze stock charts |
| POST | /api/v2/forex/analyze | Analyze forex charts |
Symbol Endpoints
| Method | Path | Description |
|---|
| GET | /api/v2/crypto/symbols | Get available crypto symbols |
| GET | /api/v2/stock/symbols | Get available stock symbols |
| GET | /api/v2/forex/symbols | Get available forex symbols |
Analysis Request Schema
All analysis endpoints (POST /api/v2/{market}/analyze) accept the same request structure:
| Field | Type | Required | Description |
|---|
symbol | string | Yes | Trading symbol (e.g., BTC-USD, AAPL, EURUSD) |
interval | enum | Yes* | Timeframe: 1m, 5m, 15m, 30m, 1H, 4H, 1D, 1W, 1M |
expertMode | boolean | No | Enable advanced analysis (default: false) |
selectedIndicators | string[] | No | Max 3 indicator keys (see Available Indicators) |
timeframes | string[] | No | Max 2 additional timeframes for expert mode |
customPrompt | string | No | Custom analysis instructions (max 3000 chars) |
analyzeRelatedNews | boolean | No | Include news analysis (default: false) |
strategyId | string | No | User strategy ID for personalized analysis |
language | string | No | Response language (default: en) |
*interval is required unless strategyId is provided.
Available Indicators
Use these IDs in selectedIndicators (max 3):
| ID | Indicator |
|---|
sma | Simple Moving Average |
ema | Exponential Moving Average |
ichimoku | Ichimoku Cloud |
bbands | Bollinger Bands |
atr | Average True Range |
supertrend | Supertrend |
sar | Parabolic SAR |
rsi | Relative Strength Index |
macd | MACD |
kst | Know Sure Thing |
stoch | Stochastic Oscillator |
adx | Average Directional Index |
percent_b | %B (Percent B) |
mfi | Money Flow Index |
dpo | Detrended Price Oscillator |
vwap | Volume Weighted Average Price |
rvol | Relative Volume |
ad | Accumulation/Distribution |
Analysis Response Schema
| Field | Type | Description |
|---|
analysis | string | Detailed AI analysis and reasoning |
entry | number | Suggested entry price |
stopLoss | number | Recommended stop-loss price |
takeProfit | number | Target take-profit price |
confirmationPrice | number | Price level for trade confirmation |
reasoning | string | Concise trading rationale |
bias | string | Market bias: Buy, Sell, or Neutral |
creditsUsed | number | Credits consumed for this analysis |
How to Use This Skill
Basic Analysis
When the user asks to analyze a symbol, construct a basic request:
curl -s -X POST https://gptchart.ai/api/v2/crypto/analyze \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $GPTCHART_API_KEY" \
-d '{
"symbol": "BTC-USD",
"interval": "4H"
}'
Expert Analysis with Indicators
When the user wants a deep analysis with specific indicators:
curl -s -X POST https://gptchart.ai/api/v2/forex/analyze \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $GPTCHART_API_KEY" \
-d '{
"symbol": "XAUUSD",
"interval": "1D",
"expertMode": true,
"selectedIndicators": ["rsi", "macd", "bbands"],
"timeframes": ["1D", "1W"]
}'
Expert Analysis with Custom Prompt
When the user wants a tailored analysis with specific trading rules:
curl -s -X POST https://gptchart.ai/api/v2/stock/analyze \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $GPTCHART_API_KEY" \
-d '{
"symbol": "AAPL",
"interval": "1W",
"expertMode": true,
"selectedIndicators": ["ichimoku", "vwap", "adx"],
"customPrompt": "Focus on swing trade setups with R:R above 2"
}'
Strategy-Based Analysis
When the user has a saved strategy:
curl -s -X POST https://gptchart.ai/api/v2/crypto/analyze \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $GPTCHART_API_KEY" \
-d '{
"symbol": "BTC-USD",
"strategyId": "c1mEhAha9qaVpHdAKQx0"
}'
Get Available Symbols
curl -s https://gptchart.ai/api/v2/crypto/symbols \
-H "Authorization: Bearer $GPTCHART_API_KEY"
Presenting Results
After a successful analysis response, present the results clearly:
- State the bias prominently (Buy / Sell / Neutral)
- Show Entry, Stop Loss, and Take Profit as formatted prices
- Include the Confirmation Price if provided
- Summarize the analysis narrative in plain language
- Mention credits used so the user stays aware of their balance
Example format:
BTCUSD 4H Analysis
Bias: Buy
Entry: $98,200
Stop Loss: $95,800
Take Profit: $103,500
Confirmation Price: $98,500
Summary: Price is consolidating above the 200 EMA with RSI recovering
from oversold. MACD showing bullish crossover. Setup favors long on
a breakout above $98,500 resistance.
Credits used: 3
Error Handling
| Status | Meaning | Action |
|---|
| 400 | Bad Request | Check symbol, interval, and request body values |
| 401 | Unauthorized | API key is missing, invalid, or insufficient credits |
| 403 | Forbidden | Subscription required — user is on Free tier |
| 405 | Method Not Allowed | Check HTTP method (POST for analysis, GET for symbols) |
| 429 | Rate Limited | Wait and retry after a short delay |
| 500 | Server Error | Inform user and suggest retrying in a moment |
On a 403 error, tell the user: "A paid GPTChart.ai subscription is required to use the API. Please upgrade at https://gptchart.ai/account/pricing-plan."
Setup Instructions for Users
- Go to https://gptchart.ai/account/api-keys
- Generate a new API key
- Add it to your OpenClaw config:
{
"env": {
"GPTCHART_API_KEY": "your-api-key-here"
}
}
Or set it as a system environment variable:
export GPTCHART_API_KEY=your-api-key-here
- Install this skill:
clawhub install gptchart-analysis
- Ask your agent: "Analyze BTCUSD on the 4-hour timeframe"
