Get exchange new coin listings

Growth This endpoint requires the growth plan or higher. Free, Basic and Startup plans can use preview access.

Retrieve the latest coin listings on a specific exchange. On Coinranking, we use this endpoint on our exchange new coin listings page.

https://api.coinranking.com/v2/exchange/:uuid/coins/new

Preview access

Free, Basic and Startup plans can test this endpoint with five successful requests per account per UTC day. Use the documented endpoint URL with your existing API key. Preview access is applied automatically. The allowance resets at 00:00 UTC.

All API keys, resource IDs, query parameters and pagination requests share this endpoint's allowance for your account. Failed requests do not consume the preview allowance. Successful previews also count toward your normal API usage, and your plan's result, historical-window and rate limits still apply. See endpoint previews for limits, response headers and quota errors.

Path parameters

Parameter	Description
uuid `String`	UUID of the exchange you want to request

Query parameters

Parameter	Description
referenceCurrencyUuid (optional) `String`	UUID of coin (either fiat or crypto), in which all the market caps are calculated. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint Default value: yhjMzLPhuIDl Example: `https://api.coinranking.com/v2/exchange/-zdvbieRdZ/coins/new?referenceCurrencyUuid=5k-_VTxqtCEI`
limit (optional) `Number`	Limit. Used for pagination. The maximum amount of results you can fetch in one request is 100 for Free and 5000 for all paid plans, including previews where available. Default value: 50 Size range: 0-5000 Example: `https://api.coinranking.com/v2/exchange/-zdvbieRdZ/coins/new?limit=10`
offset (optional) `Number`	Offset. Used for pagination Default value: 0 Example: `https://api.coinranking.com/v2/exchange/-zdvbieRdZ/coins/new?offset=50`

Code examples

curl 'https://api.coinranking.com/v2/exchange/-zdvbieRdZ/coins/new?referenceCurrencyUuid=5k-_VTxqtCEI&limit=50&offset=0' \
  -H 'x-access-token: your-api-key' \
  -G

const options = {
  headers: {
    'x-access-token': 'your-api-key',
  },
};

fetch('https://api.coinranking.com/v2/exchange/-zdvbieRdZ/coins/new?referenceCurrencyUuid=5k-_VTxqtCEI&limit=50&offset=0', options)
  .then((response) => response.json())
  .then((result) => console.log(result));

<?php
  $curl = curl_init();

  curl_setopt_array($curl, array(
    CURLOPT_URL => "https://api.coinranking.com/v2/exchange/-zdvbieRdZ/coins/new?referenceCurrencyUuid=5k-_VTxqtCEI&limit=50&offset=0",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 10,
    CURLOPT_TIMEOUT => 0,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_HTTPHEADER => array(
      "x-access-token: your-api-key"
    ),
  ));

  $response = curl_exec($curl);

  curl_close($curl);
  echo $response;

import requests

headers = {
  'x-access-token': 'your-api-key'
}

response = requests.request("GET", "https://api.coinranking.com/v2/exchange/-zdvbieRdZ/coins/new?referenceCurrencyUuid=5k-_VTxqtCEI&limit=50&offset=0", headers=headers)

print(response.text)

Response

HTTP/1.1 200 OK
{
  "status": "success",
  "data": {
    "coins": [
      {
        "listedAt": 1742303129,
        "uuid": "a3IXgFhtN",
        "symbol": "BMT",
        "name": "Bubblemaps",
        "iconUrl": "https://cdn.coinranking.com/R1dKV2Onp/Bubblemaps.png",
        "price": "0.1433805008008976",
        "volume": "13704742.016513946"
      },
      {
        "listedAt": 1741698332,
        "uuid": "MU49Lzl6d",
        "symbol": "EPIC",
        "name": "Epic Chain",
        "iconUrl": "https://cdn.coinranking.com/3Iv5Rus_f/EPIC.png",
        "price": "1.339",
        "volume": "2564091.2873"
      },
      {
        "listedAt": 1741093527,
        "uuid": "1-Ajtrq28",
        "symbol": "GPS",
        "name": "GoPlus Security",
        "iconUrl": "https://cdn.coinranking.com/HZi3rfMQ4/GPS.png",
        "price": "0.03128404558295149",
        "volume": "6235184.12285391"
      }
    ]
  }
}

Response fields

Property	Description
status `String`	Status of the request Allowed values: success
data `Object`
data.coins `Object[]`	List of coins, ordered by tier (ascending) then `listedAt` (descending)
data.coins.listedAt `Number`	An Epoch timestamp in seconds
data.coins.uuid `String`	UUID of the coin
data.coins.symbol `String`	Currency symbol
data.coins.name `String`	Name of the coin
data.coins.iconUrl `String`	Location of the icon. Replace `.svg` with `.png` or `.webp`, optionally with `?size=WIDTHxHEIGHT` (e.g. `?size=28x28`) to control dimensions. See Icons for more details.
data.coins.price `String`	Price of the coin
data.coins.24hVolume `String`	24h trade volume

Error response

HTTP/1.1 422 Unprocessable Entity
{
  "status": "fail",
  "type": "REFERENCE_UNAVAILABLE",
  "message": "Reference currency not available"
}

Error responses

Error	Description
EXCHANGE_NOT_FOUND `Object`	The exchange could not be found. Try another UUID

Error	Description
VALIDATION_ERROR `Object`	The request could not be validated. The response should provide more details.
REFERENCE_UNAVAILABLE `Object`	The reference currency used in the request is not available. Choose another UUID.