Get coin supply history

professional This endpoint requires the professional plan or higher

With the coin supplies endpoint you can check out a coin's historical amount of supplies

GET /coin/:uuid/supplies

Path parameters

uuid StringUUID of the coin you want to request the supply data for.

Query parameters

Parameter Description
interval (optional) String

The interval determines the time period over which each supply item is determined.

Default value: day
Allowed values:
hour day week month

limit (optional) Number

Limit. Limit the amount of time periods for which the supplies are retrieved. For example, when interval=hour and limit is 10, data will be returned for the last 10 hours. The maximum amount of results you can fetch in one request is 5000 for the Startup and Professional plan, and 100 for the Free plan.

Default value: 50
Size range: 0-5000


Code examples


HTTP/1.1 200 OK
  "status": "success",
  "data": {
    "history": [
        "timestamp": 1698624000,
        "circulating": "19527731",
        "total": "19527731"
        "timestamp": 1698537600,
        "circulating": "19526875",
        "total": "19526875"
        "timestamp": 1698451200,
        "circulating": "19525868",
        "total": "19525868"

Response fields

status String

Status of the request

Allowed values:
data Object
data.history Object[]

List of supply items

data.history.timestamp Number

An Epoch timestamp in seconds

data.history.circulating String/null

the circulating supply in US Dollars String/null

the total supply in US Dollars

Error response

HTTP/1.1 404 Not Found
  "status": "fail",
  "type": "COIN_NOT_FOUND",
  "message": "Coin not found"

Error responses