Get candlesticks (OHLCV) data

get

https://api.mevx.io/api/v1/candlesticks

Retrieve OHLCV (Open, High, Low, Close, Volume) candlestick data for tokens and trading pairs.
Essential for building trading charts, technical analysis, and price visualization.

Usage Notes

Candlestick data is aggregated based on the specified timeBucket interval
Supports multiple time intervals from 1 minute to 1 week
Historical data availability depends on chain and liquidity pool
Results are returned in chronological order (oldest to newest)
Use endTime parameter to fetch historical data ranges
Maximum number of candlesticks per request varies by time bucket

Accessibility

Tier Access: Free, Starter, Pro, Enterprise

Compute Unit Cost: 1 CU Cost

Chain Supported

Solana
Ethereum
Base
BSC

Common Use Cases

Build TradingView-style price charts
Perform technical analysis (moving averages, RSI, MACD)
Display price trends and patterns
Calculate volatility and price ranges
Monitor volume trends over time
Identify support and resistance levels
Create price alerts based on candlestick patterns

Best Practices

Choose appropriate timeBucket based on your use case:
- 1m, 5m, 15m for day trading and short-term analysis
- 1h, 4h for swing trading
- 1d, 1w for long-term trend analysis
Implement caching to reduce API calls for historical data
Request only the necessary number of candlesticks
Use outlier parameter cautiously as it may affect data quality
Combine with volume data for comprehensive market insights

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

chain

string

Blockchain network identifier (e.g., "sol", "eth", "bsc").
If not specified, defaults to the primary supported chain.

poolAddress

string

Liquidity pool contract address for the trading pair.
Required for most use cases. Use checksum address format for EVM chains.

timeBucket

string

enum

Defaults to 1h

Time interval for each candlestick. Supported values:

1m - 1 minute
5m - 5 minutes
15m - 15 minutes
30m - 30 minutes
1h - 1 hour
4h - 4 hours
1d - 1 day
1w - 1 week

Default: 1h

endTime

int64

Unix timestamp (in seconds) for the end of the time range.
If not provided, defaults to the current time.
Use this to fetch historical data ranges.

outlier

boolean

Defaults to false

Whether to include outlier data points in the response.
Outliers are extreme price movements that may indicate wash trading or errors.

true - Include all data points (may affect chart accuracy)
false - Filter out statistical outliers (recommended)

limit

integer

1 to 1000

Defaults to 100

Maximum number of candlesticks to return.
Valid range: 1-1000. Defaults to 100 if not specified.

Note: Requesting large limits may increase response time and CU consumption.

Responses

200Successful response with OHLCV candlestick data

400Bad request - validation error or invalid parameters

401Unauthorized - missing, invalid, or expired API key

429Rate limit exceeded - too many requests

500Internal server error - unexpected system error