> ## Documentation Index > Fetch the complete documentation index at: https://docs.whitebit.com/llms.txt > Use this file to discover all available pages before exploring further. # Kline > The endpoint retrieves information about market kline. The API caches the response for: 1 second Rate limit 1000 requests/10 sec. The maximum number of candles per request is 1440. Use `limit` (default: 1440, max: 1440) to control the number of results. Use `start` and `end` timestamps to page through historical data. Request validation errors return HTTP `200` with `success: false`, `result: null`, and a `message` object mapping each invalid field to the corresponding messages — for example `{"market": ["Market is not available."]}` or `{"end": ["End field must be greater then start."]}`. export const RestRateLimit = ({requests, period = '10 seconds', scope}) => { const formatted = requests.toLocaleString(); return

Rate limit: {formatted} requests per {period} {scope && <> (applies to all {scope} endpoints)}. Exceeding this limit returns HTTP 429. See Rate limits for details and best practices.

; }; export const RelatedResources = ({children}) => { const {useEffect, useRef, useState} = React; const ref = useRef(null); const [visible, setVisible] = useState(false); useEffect(() => { if (!ref.current) return; const el = ref.current; if (el.parentElement) { el.parentElement.appendChild(el); } setVisible(true); }, []); return

Related resources

{children}
; }; ## Rate limit * [Recent trades](/api-reference/market-data/recent-trades) — individual trade executions for a market. * [Market activity](/api-reference/market-data/market-activity) — 24-hour pricing and volume summary per market. ## OpenAPI ````yaml openapi/public/http-v1.yaml GET /api/v1/public/kline openapi: 3.0.3 info: title: Public HTTP API V1 description: | WhiteBIT Public HTTP API V1 for market data and trading information. Base URL: https://whitebit.com All endpoints return time in Unix-time format. All endpoints return either a JSON object or array. Use HTTP method GET for API requests. If an endpoint requires parameters, send them as query string. The API caches responses for a specified duration per endpoint. Rate limit: 1000 requests/10 sec for all endpoints. version: 1.0.0 servers: - url: https://whitebit.com description: WhiteBIT Global Server - url: https://whitebit.eu description: WhiteBIT EU Server - url: https://whitebit.tr description: WhiteBIT TR Server - url: https://whitebit.ge description: WhiteBIT GE Server security: [] tags: - name: Public API V1 description: Public endpoints for market data and trading information paths: /api/v1/public/kline: get: tags: - Public API V1 summary: Kline description: > The endpoint retrieves information about market kline. The API caches the response for: 1 second Rate limit 1000 requests/10 sec. The maximum number of candles per request is 1440. Use `limit` (default: 1440, max: 1440) to control the number of results. Use `start` and `end` timestamps to page through historical data. Request validation errors return HTTP `200` with `success: false`, `result: null`, and a `message` object mapping each invalid field to the corresponding messages — for example `{"market": ["Market is not available."]}` or `{"end": ["End field must be greater then start."]}`. parameters: - name: market in: query required: true description: >- Trading pair to query. The market must exist and be enabled for trading. Example: BTC_USDT schema: type: string default: BTC_USDT example: BTC_USDT - name: start in: query required: false description: >- Start time in Unix seconds. Must be greater than or equal to 0 and not greater than the end parameter. When omitted, the default time window depends on the interval — see the interval parameter. Example: 1596848400 schema: type: integer example: 1596848400 - name: end in: query required: false description: >- End time in Unix seconds. Must be greater than the start parameter and not greater than the current timestamp. Default value is the current time. Example: 1596927600 schema: type: integer example: 1596927600 - name: interval in: query required: false description: >- Candlestick interval. Possible values: 1s, 10s, 30s, 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, 1M. Default value is 1h. When start and end are omitted, the default time window depends on the interval: sub-minute intervals (1s, 10s, 30s) return the last 10 minutes; minute intervals (1m–30m) return 1 day; hour intervals (1h–12h) return 1 week; day and week intervals (1d, 3d, 1w) return 1 month; the month interval (1M) returns 1 year. schema: type: string enum: - 1s - 10s - 30s - 1m - 3m - 5m - 15m - 30m - 1h - 2h - 4h - 6h - 8h - 12h - 1d - 3d - 1w - 1M default: 1h example: 1h - name: limit in: query required: false description: >- Number of candles to return, from 1 to 1440. Default value is 1440. When limit is set, the server derives start as end − limit × interval. schema: type: integer minimum: 1 maximum: 1440 default: 1440 example: 100 responses: '200': description: Successful response content: application/json: schema: type: object properties: success: type: boolean example: true message: type: string nullable: true example: null result: type: array items: type: array items: oneOf: - type: integer - type: string example: - 1631440800 - '45865.62' - '45958.14' - '45981.3' - '45750.23' - '15.327634' - '703140.24230131' description: >- [Time in seconds, Open, Close, High, Low, Volume stock, Volume money] default: description: Error response content: application/json: schema: $ref: '#/components/schemas/ErrorV1' components: schemas: ErrorV1: type: object properties: success: type: boolean example: false message: type: string description: Error message example: ERROR MESSAGE params: type: array items: type: string example: [] ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.