/api/meta/changelog
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/changelog

Request

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.

FieldTypeUnitDescription
successboolean—true when the request succeeded. On failure the body is `{ success: false, code, error, request_id }`.
schemastring—Schema id of this response (`coinboss.meta.changelog/1`).
nownumbermsServer time when the response was built.
api_versionstring—Version of the public API (`v1`).
catalog_versionstring—Version of the endpoint catalog, a release date such as `2026.11.11`.
policyobject—Versioning, compatibility and deprecation rules of the API, as lists of statements.
policy.versioningarray—Statements on how the API and its response schemas are versioned.
policy.versioning[]string—One statement.
policy.compatibilityarray—Statements on which changes count as non-breaking and how missing data is represented.
policy.compatibility[]string—One statement.
policy.deprecationarray—Statements on how `legacy` and `beta` endpoints are treated and retired.
policy.deprecation[]string—One statement.
entriesarray—Changelog entries, newest first.
entries[]object—One entry: `id`, `date`, `version`, `type` (`added`, `changed`, `fixed`, `deprecated`, `removed`), `title` and `items`.
entries[].idstring—Identifier.
entries[].datestring—Calendar date (UTC).
entries[].versionstring—Catalog version the change shipped in.
entries[].typestring—Type.
entries[].breakingboolean—`true` when the change can break existing clients (a field removed or renamed, a type or meaning changed). may be absent
entries[].titlestring—One-line summary of the change.
entries[].itemsarray—Result items.
entries[].items[]string—Result items.
deprecatedarray—Endpoints marked `legacy` or deprecated in the catalog.
deprecated[]object—One endpoint: `id`, `path`, `replacement` and `note`.
deprecated[].idstring—Identifier.
deprecated[].pathstring—Request path of the deprecated endpoint.
deprecated[].replacementstring—Path of the endpoint to use instead; null when there is none.
deprecated[].notestring—Note.
metaobject—Envelope of this response: schema id, producing system, timestamps, cache lifetime and freshness.
meta.schemastring—Schema id of this response; same value as the top-level `schema`.
meta.sourcearray—Where the value comes from.
meta.source[]object—Where the value comes from.
meta.source[].systemstring—System that produced the data; always `coinboss` for the developer-center endpoints.
meta.source[].componentstring—Component behind the data: the endpoint probe and the data-quality patrol.
meta.observed_atnull—Timestamp.
meta.received_atnull—Timestamp.
meta.fetched_atnumbermsWhen CoinBoss fetched the data from the source.
meta.windowstring—Window.
meta.cache_ttl_snumbersServer-side cache lifetime of this response.
meta.qualitystring—Always `FRESH`: the changelog is static content shipped with the API release.
meta.is_staleboolean—true when the row is older than the freshness window; stale rows are not used in totals.
meta.fallbackstring—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": [ … 3 ],
      • "compatibility": [ … 5 ],
      • "deprecation": [ … 3 ]
      },
    • "entries": [
      • { … 6 },
      • { … 6 }
      ],
    • "deprecated": [
      • { … 4 },
      • { … 4 }
      ],
    • "meta": {
      • "schema": "coinboss.meta.changelog/1",
      • "source": [ … 1 ],
      • "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 →

CodeHTTPMeaningWhat to do
INVALID_PARAM400A 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.
UNAUTHORIZED401The `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.
FORBIDDEN403The route is not part of the public API (internal or account-only).Do not retry.
NOT_FOUND404Unknown route, or the requested coin / exchange / fund does not exist.Do not retry; check the path and identifiers against the catalog.
RATE_LIMITED429More requests than the per-minute limit. `Retry-After` gives the seconds to wait.Wait for `Retry-After`, then retry with backoff.
INTERNAL500Unexpected 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_FAILED503The 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.
UNAVAILABLE501 / 503The 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_FAILED200Some 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/changelogAvailable
Parameters

No parameters.

Request URLhttps://www.coinboss.com/api/meta/changelog
Choose an endpoint and press “Send request”. The response, headers and timing will appear here.