Info Endpoint
Public market data and information endpoints that don't require authentication.
Overview
The info endpoints provide access to public market data, trading information, and system configuration. Note that some streaming data is available through subscriptions.
For the endpoint URL, see Environments.
Request Structure
All info endpoints wrap inputs inside a params object and identify the requested action with the params.action field:
{
"params": {
"action": "getMarkets",
"symbol": "BTC-USDT",
"limit": 100
}
}Available Endpoints
Market Information
| Method | Action | Description | Purpose |
|---|---|---|---|
| Get Markets | getMarkets | Retrieves detailed market configuration | Get comprehensive market specifications, trading rules, and limits |
Market Data
| Method | Action | Description | Purpose |
|---|---|---|---|
| Get Candles | getCandles | Retrieves OHLCV price data | Get historical price charts for technical analysis |
| Get Last Trades | getLastTrades | Retrieves recent trade executions | Get public trade history from the orderbook |
| Get Market Prices | getMarketPrices | Retrieves current market prices | Get real-time price information for all markets |
| Get Orderbook | getOrderbook | Retrieves order book snapshot | Get current market depth and liquidity information |
Market Statistics
| Method | Action | Description | Purpose |
|---|---|---|---|
| Get Funding Rate | getFundingRate | Retrieves funding rates | Get current funding rates for perpetual markets |
| Get Open Interest | getOpenInterest | Retrieves open interest data | Get current open interest for all markets |
Features
- No authentication required for public market data
- Optimized for frequent data access
- Real-time market information and statistics
- Consistent response structure across all endpoints
- Higher rate limits than authenticated endpoints
Response
All info endpoints return responses in the standard API format:
{
"status": "ok",
"response": [
// Endpoint-specific data
],
"requestId": "5ccf215d37e3ae6d",
"timestamp": 1704067200000
}Error Handling
Info endpoints use the same error response format as other API endpoints:
{
"status": "error",
"error": {
"message": "Invalid request parameters",
"code": "VALIDATION_ERROR"
},
"requestId": "5ccf215d37e3ae6d",
"timestamp": 1704067200000
}Rate Limiting
Info endpoints have higher rate limits than trading endpoints:
- Default: 1000 requests per minute per IP
- Burst: Up to 100 requests per second
- WebSocket: Unlimited for real-time subscriptions
Next Steps
- Get Markets - Start with market configuration
- Get Candles - Access historical price data
- WebSocket API - Real-time data streams
- Trading Endpoints - Start trading