> ## 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.
# Market activity
> Get 24-hour trading activity statistics for all markets on WhiteBIT via the V4 API.
* [Market info](/api-reference/market-data/market-info) — market configuration, trading rules, and fee structure.
* [Recent trades](/api-reference/market-data/recent-trades) — individual trade executions for a specific market.
## OpenAPI
````yaml /openapi/public/http-v4.yaml GET /api/v4/public/ticker
openapi: 3.0.3
info:
title: Public HTTP API V4
description: >
WhiteBIT Public HTTP API V4 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 calls.
Send parameters as query string when an endpoint requires them.
Rate limit: 2000 requests/10 sec for most endpoints (specific limits noted
per endpoint).
## Caching and data freshness
Most public endpoints serve cached data. The cache is **shared across all
callers** — values are keyed by the resource (market, currency), never by
account — and invalidates on a **time basis only**: an upstream change
becomes visible after the next refresh, not immediately.
Two refresh tiers apply:
- **Reference data** (`markets`, `assets`, `fee`, `collateral/markets`,
`futures`) refreshes from the database on a fixed interval, ranging from
about 10 seconds to about 1 minute depending on the endpoint.
- **Market data** (`trades`, `orderbook`, `orderbook/depth`, `ticker`) uses
a short-lived cache, about 1 second by default.
`time` and `ping` are computed per request and are not cached. Each endpoint
states its own refresh interval. Polling faster than that interval returns
identical data and consumes rate-limit budget without producing fresher
results.
## Error responses
Public V4 endpoints do not share a single error schema. Depending on the
endpoint, an error arrives in one of three shapes (there is no `params`
field on any public error):
- **Flat validation bag (HTTP 422)** — `{ "": [""] }`. No
envelope. Used by the market endpoints (`orderbook`, `orderbook/depth`,
`trades`). Example: `{ "market": ["Market is not available."] }`. On
`funding-history` the values are single strings rather than arrays.
- **Wrapped, HTTP 200 even on validation errors** — `{ "success": false,
"message": { "": [""] }, "result": null }`. Used by the V4
`kline` endpoint (not part of this portal — the documented Kline endpoint is
V1).
- **Wrapped string message (HTTP 4xx)** — `{ "success": false, "message":
"", "errors": [] }`. Used by the margin/futures collateral subset of
endpoints. Parameterless endpoints (`markets`, `ticker`, `assets`, `fee`)
take no input and so produce no validation errors — they fail only at the
infrastructure level below.
Common failures are produced at the infrastructure layer, not by the
application, and do not follow these shapes:
- **Maintenance** — every endpoint returns **HTTP 503** with a non-JSON body
served by the gateway.
- **Rate limit exceeded** — **HTTP 429** with a non-JSON body served by the
gateway/CDN.
- **Internal server error** — **HTTP 500** with a flat body `{ "error":
["Internal server error."] }`.
- **Unknown route** — **HTTP 404** with an empty body.
version: 4.0.0
servers:
- url: https://whitebit.com
description: WhiteBIT Global Server
- url: https://whitebit.eu
description: WhiteBIT EU Server
security: []
tags:
- name: Public API V4
description: Public endpoints for market data, trading information, and platform status
paths:
/api/v4/public/ticker:
get:
tags:
- Public API V4
summary: Market activity
description: >
The endpoint retrieves a 24-hour pricing and volume summary for each
market pair available on the exchange.
The API caches the response for 1 second
Rate limit: 2000 requests/10 sec. See [Public API V4
overview](/public/http-v4/index) for rate limit details.
parameters: []
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
additionalProperties:
type: object
properties:
base_id:
type: integer
description: CoinMarketCap ID of base currency; 0 - if unknown
example: 1
quote_id:
type: integer
description: CoinMarketCap ID of quote currency; 0 - if unknown
example: 825
last_price:
type: string
description: Most recent trade price in the quote currency.
example: '9164.09'
quote_volume:
type: string
description: Rolling 24-hour trading volume in the quote currency.
example: '43341942.90416876'
base_volume:
type: string
description: Rolling 24-hour trading volume in the base currency.
example: '4723.286463'
is_frozen:
type: boolean
description: >-
Indicates whether trading is disabled for the market
pair.
example: false
change:
type: string
description: >-
Percentage change between the rolling 24-hour open price
and the last traded price.
example: '0.57'
example:
BTC_USDT:
base_id: 1
quote_id: 825
last_price: '9164.09'
quote_volume: '43341942.90416876'
base_volume: '4723.286463'
is_frozen: false
change: '0.57'
default:
description: Error response
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorV4'
components:
schemas:
ErrorV4:
type: object
description: >-
Generic wrapped error envelope (fallback). Market-data validation errors
use the flat PublicValidationError shape (HTTP 422) instead, and
infrastructure-level failures (maintenance, rate limit, internal error,
unknown route) are non-JSON or flat. See the API description for the
full set of public error shapes.
properties:
success:
type: boolean
example: false
message:
type: string
description: Error message
example: Internal server error.
errors:
type: array
items:
type: string
example: []
````