GETAvailableFRESH
Changelog and versioning policy
Dated API changes, the current version, compatibility and deprecation policy, and the list of legacy endpoints with their replacements.
GET
/api/meta/changelogRequest
This endpoint takes no parameters.
Example request
curl -s "https://www.coinboss.com/api/meta/changelog"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 }`. |
| schema | string | — | Schema id of this response (`coinboss.meta.changelog/1`). |
| now | number | ms | Server time when the response was built. |
| api_version | string | — | Version of the public API (`v1`). |
| catalog_version | string | — | Version of the endpoint catalog, a release date such as `2026.11.11`. |
| policy | object | — | Versioning, compatibility and deprecation rules of the API, as lists of statements. |
| policy.versioning | array | — | Statements on how the API and its response schemas are versioned. |
| policy.versioning[] | string | — | One statement. |
| policy.compatibility | array | — | Statements on which changes count as non-breaking and how missing data is represented. |
| policy.compatibility[] | string | — | One statement. |
| policy.deprecation | array | — | Statements on how `legacy` and `beta` endpoints are treated and retired. |
| policy.deprecation[] | string | — | One statement. |
| entries | array | — | Changelog entries, newest first. |
| entries[] | object | — | One entry: `id`, `date`, `version`, `type` (`added`, `changed`, `fixed`, `deprecated`, `removed`), `title` and `items`. |
| entries[].id | string | — | Identifier. |
| entries[].date | string | — | Calendar date (UTC). |
| entries[].version | string | — | Catalog version the change shipped in. |
| entries[].type | string | — | Type. |
| entries[].breaking | boolean | — | `true` when the change can break existing clients (a field removed or renamed, a type or meaning changed). may be absent |
| entries[].title | string | — | One-line summary of the change. |
| entries[].items | array | — | Result items. |
| entries[].items[] | string | — | Result items. |
| deprecated | array | — | Endpoints marked `legacy` or deprecated in the catalog. |
| deprecated[] | object | — | One endpoint: `id`, `path`, `replacement` and `note`. |
| deprecated[].id | string | — | Identifier. |
| deprecated[].path | string | — | Request path of the deprecated endpoint. |
| deprecated[].replacement | string | — | Path of the endpoint to use instead; null when there is none. |
| deprecated[].note | string | — | Note. |
| meta | object | — | Envelope of this response: schema id, producing system, timestamps, cache lifetime and freshness. |
| meta.schema | string | — | Schema id of this response; same value as the top-level `schema`. |
| meta.source | array | — | Where the value comes from. |
| meta.source[] | object | — | Where the value comes from. |
| meta.source[].system | string | — | System that produced the data; always `coinboss` for the developer-center endpoints. |
| meta.source[].component | string | — | Component behind the data: the endpoint probe and the data-quality patrol. |
| meta.observed_at | null | — | Timestamp. |
| meta.received_at | null | — | Timestamp. |
| meta.fetched_at | number | ms | When CoinBoss fetched the data from the source. |
| meta.window | string | — | Window. |
| meta.cache_ttl_s | number | s | Server-side cache lifetime of this response. |
| meta.quality | string | — | Always `FRESH`: the changelog is static content shipped with the API release. |
| meta.is_stale | boolean | — | true when the row is older than the freshness window; stale rows are not used in totals. |
| meta.fallback | string | — | Plain-text note on what this endpoint returns when its inputs are stale or missing. |
Generated 2026-11-11 23:01 UTC from 1 real responses.
Example response
/api/meta/changelog · Real response captured 2026-11-13 03:53:45 UTC. Long arrays and maps are shortened for display: entries had 26 items.
- "success"true
- "schema""coinboss.meta.changelog/1"
- "now"1794542025700
- "api_version""v1"
- "catalog_version""2026.11.12"
- "policy"
- "versioning"
- "compatibility"
- "deprecation"
- "entries"
- "deprecated"
- "meta"
- "schema""coinboss.meta.changelog/1"
- "source"
- "observed_at"null
- "received_at"null
- "fetched_at"1794542025700
- "window""latest"
- "cache_ttl_s"120
- "quality""FRESH"
- "is_stale"false
- "fallback""static content shipped with the API release"
Details
- Authentication
- None. Public endpoint.
- Rate limit
- 1200 requests per minute per IP
- Server cache
- 2m
- Edge micro-cache
- 10s
- Timestamps
- Unix epoch milliseconds (UTC) unless the field description says otherwise
- Response format
- json
- Stability
- Stable
- Available since
- 2026-11-11
Live status
AvailableChecked 2026-11-13 03:53:45 UTCHTTP 2005 msSchema matches
Availability, last 30 days
99.75% of 407 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/meta/changelogAvailableParameters
No parameters.
Request URL
https://www.coinboss.com/api/meta/changelogChoose an endpoint and press “Send request”. The response, headers and timing will appear here.
More in this category
- Data-quality matrix (collector view) /api/sd/quality
- API catalog /api/meta/catalog
- Changelog and versioning policy /api/meta/changelog
- Endpoint documentation /api/meta/endpoint
- OpenAPI document /api/meta/openapi
- Data-quality matrix /api/meta/quality
- Service status /api/meta/status
- Checks whether a coin symbol is known to the platform /api/coin-exists
- Map of coin symbol to locally hosted icon path /api/coin-icons
- Coin-page aggregated summary /api/content/coin
- Site-wide section summary /api/content/summary
- Fiat FX rate table /api/currency/fx
- Map of exchange id to locally hosted icon path /api/exchange-icons
- Liveness check /api/health
- Research-page statistics /api/research/stats