Candle Data API

Retrieve comprehensive OHLCV (Open, High, Low, Close, Volume) candlestick data for Solana trading pairs with flexible time intervals and data limits.

POST/candle/api/v1/sol/candle

Request Parameters

Parameter	Type	Required	Description
symbol	string	Yes	Trading pair symbol (e.g., So11111111111111111111111111111111111111112)
interval	string	Yes	Time interval (e.g., 1m, 5m, 1h, 1d)
limit	number	No	Number of candles to return Default: 100
startTime	integer	No	Start time (Unix timestamp in seconds)
endTime	integer	No	End time (Unix timestamp in seconds)

Supported Intervals

Choose from various time frames for technical analysis:

• 1m - 1 minute candles for high-frequency trading
• 5m - 5 minute candles for short-term analysis
• 15m - 15 minute candles for intraday trading
• 1h - 1 hour candles for medium-term analysis
• 4h - 4 hour candles for swing trading
• 1d - Daily candles for long-term analysis

Response Format

{
  "symbol": "So11111111111111111111111111111111111111112",
  "interval": "1m",
  "data": [
    {
      "timestamp": 1642680000000,
      "open": 150.25,
      "high": 151.50,
      "low": 149.80,
      "close": 150.75,
      "volume": 1250000.50
    },
    {
      "timestamp": 1642680060000,
      "open": 150.75,
      "high": 152.10,
      "low": 150.30,
      "close": 151.25,
      "volume": 980000.25
    }
  ],
  "count": 100,
  "timestamp": "2024-01-20T10:30:00Z"
}

Data Fields

• timestamp - Candle timestamp in milliseconds
• open - Opening price for the time period
• high - Highest price during the period
• low - Lowest price during the period
• close - Closing price for the time period
• volume - Total trading volume

Trading Analysis

Use candle data for comprehensive technical analysis:

• Price Trends - Identify upward and downward movements
• Support & Resistance - Find key price levels
• Volume Analysis - Understand market activity
• Pattern Recognition - Detect trading patterns
• Risk Management - Set stop-loss and take-profit levels

Responses

200

Candle data retrieved successfully

{
  "symbol": "So11111111111111111111111111111111111111112",
  "interval": "1m",
  "data": [
    {
      "timestamp": 1642680000000,
      "open": 150.25,
      "high": 151.5,
      "low": 149.8,
      "close": 150.75,
      "volume": 1250000.5
    },
    {
      "timestamp": 1642680060000,
      "open": 150.75,
      "high": 152.1,
      "low": 150.3,
      "close": 151.25,
      "volume": 980000.25
    }
  ],
  "count": 100,
  "timestamp": "2024-01-20T10:30:00Z"
}

400

Bad Request - Invalid parameters

{
  "error": "Invalid symbol format or interval",
  "timestamp": "2024-01-20T10:30:00Z"
}

401

Unauthorized - Invalid API key

{
  "error": "Invalid or missing API key",
  "timestamp": "2024-01-20T10:30:00Z"
}

429

Too Many Requests - Rate limit exceeded

{
  "error": "Rate limit exceeded. Please try again in 60 seconds",
  "retryAfter": 60,
  "timestamp": "2024-01-20T10:30:00Z"
}

500

Internal Server Error

{
  "error": "Failed to retrieve candle data",
  "timestamp": "2024-01-20T10:30:00Z"
}