API Documentation - GPTChart.ai - Analyse Trading Charts With AI

You need to sign in to create and manage API keys. The full API documentation is still available below.

Important Security Information

API keys are only shown once upon creation, store them securely
You can only have one active API key at a time
API keys provide full access to your account and credits
Revoke any compromised keys immediately

Your API Keys

Loading API keys...

Authentication

Include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Available Endpoints

Analysis Endpoints

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

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 accept the same request structure:

Field	Type	Required	Description
symbol	string	Yes	Trading symbol (e.g., "BTC-USDT", "SPY", "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 indicators (see available indicators below)
timeframes	string[]	No	Max 2 additional timeframes for expert mode
customPrompt	string	No	Custom analysis instructions (max 500 chars)
analyzeRelatedNews	boolean	No	Include news analysis (default: false)
strategyId	string	No	User strategy ID for personalized analysis

Available Indicators

Use these IDs in selectedIndicators (max 3).

Simple Moving Average (SMA)

Trend filter (20/50/200 common)

sma

Exponential Moving Average (EMA)

Faster trend response (e.g., 20/50)

ema

Ichimoku Cloud

Regime context & S/R

ichimoku

Bollinger Bands

Volatility bands; squeezes/means

bbands

Average True Range (ATR)

Volatility sizing; great for SL/TP

atr

Relative Strength Index (RSI)

Momentum (14 default)

rsi

MACD

Momentum + trend; crosses & hist

macd

Stochastic Oscillator

Momentum / OB-OS

stoch

Average Directional Index (ADX)

Trend strength (not direction)

adx

%B (Percent B)

Price vs. BB location (0–1)

percent_b

Money Flow Index (MFI)

Volume-weighted momentum

mfi

Detrended Price Oscillator (DPO)

Removes longer-term trend

dpo

Example:

{
  "symbol": "BTC-USDT",
  "interval": "15m",
  "expertMode": true,
  "selectedIndicators": ["bbands", "atr", "rsi"]
}

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

Example Requests & Responses

Basic Analysis Request

{
  "symbol": "BTC-USDT",
  "interval": "15m"
}

Expert Mode Request

{
  "symbol": "BTC-USDT",
  "interval": "15m",
  "expertMode": true,
  "selectedIndicators": ["bbands", "atr"],
  "timeframes": ["15m", "1H"],
  "customPrompt": "Look for stop-hunts or liquidity sweeps around previous highs/lows. Use ATR for SL/TP and confirm using price rejection patterns and Bollinger Band volatility.",
  "analyzeRelatedNews": false
}

Strategy Request

{
  "symbol": "BTC-USDT",
  "strategyId": "c1mEhAha9qaVpHdAKQx0"
}

Response Example

{
  "analysis": "Technical analysis shows bullish momentum with price above key moving averages...",
  "entry": 642.5,
  "stopLoss": 634.38,
  "takeProfit": 660.25,
  "confirmationPrice": 642.5,
  "reasoning": "Daily shows bullish regime with price above Ichimoku cloud...",
  "bias": "Buy",
  "creditsUsed": 3
}

Error Responses

Status Code	Error Type	Description
400	Bad Request	Invalid request body or parameters
401	Unauthorized	Invalid API key or insufficient credits
405	Method Not Allowed	Incorrect HTTP method
429	Rate Limited	Too many requests
500	Internal Server Error	Server-side error

Error Response Format:

{
  "error": "Invalid request body",
  "details": [
    {
      "code": "invalid_type",
      "expected": "string",
      "received": "number",
      "path": ["symbol"]
    }
  ]
}