> ## Documentation Index > Fetch the complete documentation index at: https://docs.kuru.io/llms.txt > Use this file to discover all available pages before exploring further. # Get 24-hour ticker > Get 24-hour rolling window price change statistics. **Weight**: 1 ## OpenAPI ````yaml /kuru-exchange/openapi.yaml get /api/v3/ticker/24hr openapi: 3.0.3 info: title: Kuru Exchange WebSocket Server API description: > # Introduction The Kuru Exchange WebSocket Server provides REST and WebSocket APIs for streaming Kuru Exchange's orderbook data. ## Key Features - **Four-State Orderbook Model**: Reflects Monad's BFT consensus pipeline (Proposed, Voted, Finalized, Committed) - **High Performance**: Low latency orderbook updates directly consuming from Monad's event ring. - **Real-Time Streaming**: WebSocket subscriptions with efficient broadcast ## Monad Consensus States | State | Description | Use Case | |-------|-------------|----------| | **Proposed** | Block execution started, speculative | Lowest latency, highest risk | | **Voted** | Block received quorum certificate | Early confirmation | | **Finalized** | Block finalized (reorg-proof) | Safe for most applications | | **Committed** | State root verified | Maximum safety | ## Base URLs - **REST API**: `https://exchange.kuru.io` - **WebSocket**: `wss://exchange.kuru.io/ws` ## WebSocket Streams Connect to `wss://exchange.kuru.io` and send JSON messages to subscribe/unsubscribe. ### Subscription Format ```json { "method": "SUBSCRIBE", "params": ["mon_usdc@depth", "ethusdc@trade"], "id": 1 } ``` ### Available Stream Types | Stream | Description | Example | |--------|-------------|---------| | `@depth` | Full orderbook updates (committed state) | `mon_usdc@depth` | | `@depth5` | Top 5 levels | `mon_usdc@depth5` | | `@depth10` | Top 10 levels | `mon_usdc@depth10` | | `@depth20` | Top 20 levels | `mon_usdc@depth20` | | `@depth@` | Specific state orderbook | `mon_usdc@depth@proposed` | | `@monadDepth` | All states in one message | `mon_usdc@monadDepth` | | `@trade` | Trade stream | `mon_usdc@trade` | ### State Values - `proposed` - Block execution started - `voted` - Block received QC - `finalized` - Block finalized (reorg-proof) - `committed` - State root verified ## Rate Limits ### REST API The REST API uses a **token bucket** algorithm per IP address. | Parameter | Value | Description | |-----------|-------|-------------| | Refill rate | 1200 req/min (20 req/sec) | Tokens added continuously | | Burst capacity | 100 tokens | Max tokens in the bucket — allows short bursts | | Tracking | Per IP address | Each IP has its own independent bucket | Each request consumes a **weight** from the bucket. Heavier endpoints consume more tokens: | Endpoint | Weight | |----------|--------| | `GET /health` | 1 | | `GET /api/v3/trades` | 1 | | `GET /api/v3/ticker/24hr` | 1 | | `GET /api/v3/exchangeInfo` | 10 | | `GET /api/v3/klines` (limit ≤ 100) | 1 | | `GET /api/v3/klines` (limit 101–500) | 2 | | `GET /api/v3/klines` (limit > 500) | 5 | | `GET /api/v3/depth` (limit ≤ 100) | 1 | | `GET /api/v3/depth` (limit 101–500) | 5 | | `GET /api/v3/depth` (limit 501–1000) | 10 | | `GET /api/v3/depth` (limit > 1000) | 20 | When the bucket is empty the server returns **HTTP 429**. The response includes a `Retry-After` header indicating how many seconds until the next token is available. ### WebSocket | Limit | Value | Description | |-------|-------|-------------| | Connections per IP | 5 | Max concurrent WebSocket connections from a single IP | | Subscriptions per connection | 1024 | Max active stream subscriptions on one connection | | Broadcast buffer | 32,768 messages | Per-channel internal queue before backpressure | Connections that exceed the per-IP limit are rejected at the TCP accept stage. Subscription requests that exceed the per-connection limit are silently ignored — subscribe to fewer streams or open a new connection. version: 1.0.0 contact: name: Kuru Exchange license: name: Apache 2.0 url: https://www.apache.org/licenses/LICENSE-2.0.html servers: - url: https://exchange.kuru.io description: Exchange server security: [] tags: - name: Market Data description: Market data endpoints (orderbook, trades, tickers) - name: User Data description: User-specific order and trade event endpoints - name: Exchange Info description: Exchange metadata and market information - name: Health description: Health and status endpoints paths: /api/v3/ticker/24hr: get: tags: - Market Data summary: Get 24-hour ticker description: | Get 24-hour rolling window price change statistics. **Weight**: 1 operationId: getTicker24hr parameters: - name: symbol in: query description: Trading pair symbol required: true schema: type: string example: MON_USDC responses: '200': description: Successful response content: application/json: schema: $ref: '#/components/schemas/Ticker24hr' example: symbol: MON_USDC priceChange: '1.50' priceChangePercent: '1.52' lastPrice: '100.50' bidPrice: '100.49' askPrice: '100.51' openPrice: '99.00' highPrice: '101.00' lowPrice: '98.50' volume: '1000000.50' quoteVolume: '100000000.25' openTime: 1699913599000 closeTime: 1699999999000 count: 10000 '400': description: Bad request content: application/json: schema: $ref: '#/components/schemas/Error' '404': description: Symbol not found content: application/json: schema: $ref: '#/components/schemas/Error' components: schemas: Ticker24hr: type: object description: 24-hour ticker statistics required: - symbol - priceChange - priceChangePercent - lastPrice - bidPrice - askPrice - openPrice - highPrice - lowPrice - volume - quoteVolume - openTime - closeTime - count properties: symbol: type: string description: Symbol name example: MON_USDC priceChange: type: string description: Price change in 24 hours example: '1.50' priceChangePercent: type: string description: Price change percent in 24 hours example: '1.52' lastPrice: type: string description: Last trade price example: '100.50' bidPrice: type: string description: Best bid price example: '100.49' askPrice: type: string description: Best ask price example: '100.51' openPrice: type: string description: Opening price 24 hours ago example: '99.00' highPrice: type: string description: Highest price in 24 hours example: '101.00' lowPrice: type: string description: Lowest price in 24 hours example: '98.50' volume: type: string description: Total traded volume in base asset example: '1000000.50' quoteVolume: type: string description: Total traded volume in quote asset example: '100000000.25' openTime: type: integer format: int64 description: Opening time in milliseconds example: 1699913599000 closeTime: type: integer format: int64 description: Closing time in milliseconds example: 1699999999000 count: type: integer format: int64 description: Number of trades in 24 hours example: 10000 Error: type: object description: Error response required: - code - msg properties: code: type: integer description: Error code example: -1102 msg: type: string description: Error message example: Mandatory parameter 'symbol' was not sent. ````