Category list

Category list (market cap, volume, change)

GET/api/tabs17/categories

Request

Query parameters

Name	Type	Required	Default	Allowed values	Description
limit	integer	Optional	50	≤ 200	Number of rows to return. Example: 50
offset	integer	Optional	0	—	Pagination offset.

Example request

curl -s "https://www.coinboss.com/api/tabs17/categories?limit=50"

Response fields

The field table is generated from real responses, so it lists exactly what the endpoint returns. Paths use a[] for array items and {*} for objects keyed by a dynamic name such as a coin or an exchange.

Field	Type	Unit	Description
success	boolean	—	true when the request succeeded. On failure the body is `{ success: false, code, error, request_id }`.
total	number	—	Total.
offset	number	—	Row offset applied.
limit	number	—	Row limit applied.
data	array	—	Payload.
data[]	object	—	Payload.
data[].id	string	—	Identifier.
data[].name	string	—	Name.
data[].market_cap	number	—	Market capitalisation.
data[].mcap_change_24h	number	%	Change of the category's total market cap over the last 24 hours as published by the third-party source; null when not published.
data[].volume_24h	number	—	24h volume.
data[].vol_chg_24h_pct	number	%	24h change of volume.
data[].oi_usd	number\|null	USD	Open interest in USD notional.
data[].oi_chg_1h_pct	number\|null	%	1h change of open interest.
data[].oi_chg_24h_pct	number\|null	%	24h change of open interest.
data[].liq_24h_usd	number\|null	USD	24h liquidations.
data[].funding_avg	number\|null	—	Average funding rate across exchanges.
data[].top3	array	—	Top three entries.
data[].top3[]	string	—	Top three entries.
data[].rank	number	—	Rank in this list (1 = first).
source	string	—	Where the value comes from.

Generated 2026-11-11 23:00 UTC from 1 real responses.

Example response

/api/tabs17/categories?limit=50 · Real response captured 2026-11-13 03:53:17 UTC. Long arrays and maps are shortened for display: data had 50 items.

{
- "success": true,
- "total": 383,
- "offset": 0,
- "limit": 50,
- "data": [
  - { … 13 },
  - { … 13 }
  ],
- "source": "CoinGecko"
}

Details

Authentication: None. Public endpoint.
Rate limit: 1200 requests per minute per IP
Server cache: 2m
Edge micro-cache: 10s
Update frequency: categories every 6 h; derivatives metrics every 5-30 min; API cache 120 s
Window: 24h
Data sources: Category list with market cap and 24h volume from a third-party market-data aggregator, plus per-category open interest, liquidations and average funding aggregated in-house.
Exchange coverage: third-party market-data aggregator categories with market cap > 0 (383 at probe time); derivatives columns only for the 49 categories with member lists
Pagination: limit (default 50, max 200) + offset
Sorting: market cap desc
Units: USD; change in percent
Timestamps: Unix epoch milliseconds (UTC) unless the field description says otherwise
Response format: json
Stability: Stable

Live status

AvailableChecked 2026-11-13 03:53:17 UTCHTTP 20050 msSchema matches

Availability, last 30 days

100% of 408 checks passed

Errors

Failed calls share one shape on every endpoint. The full list is on the errors page. Errors and rate limits →

Code	HTTP	Meaning	What to do
INVALID_PARAM	400	A required parameter is missing or a value is not accepted. `param` names the parameter when it is known.	Do not retry unchanged; fix the request.
UNAUTHORIZED	401	The `CB-API-KEY` header was sent but the key is unknown or revoked. Public data needs no key — drop the header or use a valid key.	Do not retry unchanged.
FORBIDDEN	403	The route is not part of the public API (internal or account-only).	Do not retry.
NOT_FOUND	404	Unknown route, or the requested coin / exchange / fund does not exist.	Do not retry; check the path and identifiers against the catalog.
RATE_LIMITED	429	More requests than the per-minute limit. `Retry-After` gives the seconds to wait.	Wait for `Retry-After`, then retry with backoff.
INTERNAL	500	Unexpected server error. The message is generic by design; quote `request_id` when reporting it.	Retry once after a few seconds; report it with the request id if it persists.
UPSTREAM_FAILED	503	The data source behind this endpoint did not answer in time. No stale or substitute numbers are returned in its place.	Retry with backoff; check the status page.
UNAVAILABLE	501 / 503	The dataset is temporarily not ready (cache warming) or the endpoint has no lawful public source yet.	Retry later; the catalog marks endpoints that are unavailable by design.
REQUEST_FAILED	200	Some older endpoints answer HTTP 200 with `success: false`. Always check `success`, not only the HTTP status.	Depends on the message; treat as a failed request.

Try it

GET/api/tabs17/categoriesAvailable

Parameters

limit

integer · default 50 · max 200 — Number of rows to return.

offset

integer · default 0 — Pagination offset.

Request URLhttps://www.coinboss.com/api/tabs17/categories?limit=50

Choose an endpoint and press “Send request”. The response, headers and timing will appear here.

Category list (compact) /api/categories/list
Category list /api/tabs17/categories
Coins within a category /api/tabs17/category-coins
Token unlock schedule /api/tabs17/unlocks