NAV

Introduction

Welcome to the CryptingUp API! Free access to cryptocurrency information, markets and exchanges in our database

The data exposed on this public API is being used on our website. Please checkout: All assets, Specific asset, CryptingUp.com - Main Page

API Architecture

API URL

Base URL for all the rest API requests is: https://www.cryptingup.com/api/

Pagination

CryptingUp uses cursor pagination for some REST requests which return arrays. URL query parameters:

Parameter Description
size Number of results per request
start Start point of results

The response will contain a "next" field which will return the cursor id to use in your next request, which should be passed using the "start" parameter.

For example: Get all assets request

{
  "assets": [
    {
      "asset_id": "USDT",
      ...
    },
    {
      "asset_id": "BTC",
      ...
    },
    ...
  ],
  "next": "8423129941"
}

The request to fetch the next page will be: GET https://www.cryptingup.com/api/assets?start=8423129941

Rate limit

When a rate limit is exceeded, a status of 429 Too Many Requests will be returned.

The rate limit is set to 5 calls per second.

Errors

The CryptingUp API uses the following error codes:

Error Code Meaning
400 Bad Request -- Your request is invalid.
401 Unauthorized -- Your API key is wrong.
403 Forbidden -- Authenticated users only
404 Not Found -- Item not found
429 Too Many Requests -- Rate limit reached
500 Internal Server Error -- Something went wrong on our side

Depending on the type of error the response body can have additional information:

{
   "error": "Asset not found"
}

Authentication

This is a free public API which doesn't require API keys or other type of authentication

Exchanges

Get all exchanges

{
  "exchanges": [
    {
      "exchange_id": "BINANCE",
      "name": "Binance",
      "website": "https://www.binance.com",
      "volume_24h": 36052149854.27475
    },
    {
      "exchange_id": "HUOBIGLOBAL",
      "name": "Huobi Global",
      "website": "https://www.huobi.com",
      "volume_24h": 8408806476.281028
    },
    {
      "exchange_id": "COINBASE",
      "name": "Coinbase",
      "website": "https://pro.coinbase.com",
      "volume_24h": 8058319118.753507
    },
    {
      "exchange_id": "KRAKEN",
      "name": "Kraken",
      "website": "https://www.kraken.com",
      "volume_24h": 2441844209.9216576
    },
    {
      "exchange_id": "BITFINEX",
      "name": "Bitfinex",
      "website": "https://www.bitfinex.com",
      "volume_24h": 2055812699.7361362
    },
    {
      "exchange_id": "POLONIEX",
      "name": "Poloniex",
      "website": "https://www.poloniex.com",
      "volume_24h": 347918754.7724478
    },
    {
      "exchange_id": "BITTREX",
      "name": "Bittrex",
      "website": "https://www.bittrex.com",
      "volume_24h": 277214474.0304707
    }
  ]
}

This endpoint retrieves all exchanges

HTTP Request

GET https://www.cryptingup.com/api/exchanges

Get a specific exchange

{
  "exchange": {
    "exchange_id": "COINBASE",
    "name": "Coinbase",
    "website": "https://pro.coinbase.com",
    "volume_24h": 8058319132.157681
  }
}

This endpoint retrieves a specific exchange

HTTP Request

GET https://www.cryptingup.com/api/exchanges/<ID>

URL Parameters

Parameter Description
ID The ID of the exchange to retrieve

Markets

Get all markets

{
  "markets": [
    {
      "exchange_id": "BINANCE",
      "symbol": "BTC-USDT",
      "base_asset": "BTC",
      "quote_asset": "USDT",
      "price_unconverted": 41889.994999999995,
      "price": 41892.9812494475,
      "change_24h": -10.829720081068553,
      "spread": 0.000023872045839191375,
      "volume_24h": 3658767993.397291,
      "status": "recent",
      "created_at": "2021-09-20T23:47:33",
      "updated_at": "2021-09-21T00:46:14"
    },
    {
      "exchange_id": "BINANCE",
      "symbol": "ETH-USDT",
      "base_asset": "ETH",
      "quote_asset": "USDT",
      "price_unconverted": 2907.27,
      "price": 2907.4772531503345,
      "change_24h": -11.41746318544541,
      "spread": 0.020635788648265176,
      "volume_24h": 2879229818.65177,
      "status": "recent",
      "created_at": "2021-09-20T23:47:33",
      "updated_at": "2021-09-21T00:46:14"
    },
    ...
  ],
  "next": "10"
}

This endpoint retrieves all markets (using pagination)

HTTP Request

GET https://www.cryptingup.com/api/markets

Query Parameters

Parameter Description
size Number of results per request
start Start point of results

Get exchange markets

{
  "markets": [
    {
      "exchange_id": "COINBASE",
      "symbol": "ETH-USD",
      "base_asset": "ETH",
      "quote_asset": "USD",
      "price_unconverted": 2906.5150000000003,
      "price": 2906.5150000000003,
      "change_24h": -11.5059888808374,
      "spread": 0.018233234025285715,
      "volume_24h": 1352009908.7926917,
      "status": "recent",
      "created_at": "2021-09-20T23:47:33",
      "updated_at": "2021-09-21T00:47:14"
    },
    {
      "exchange_id": "COINBASE",
      "symbol": "BTC-USD",
      "base_asset": "BTC",
      "quote_asset": "USD",
      "price_unconverted": 41847.735,
      "price": 41847.735,
      "change_24h": -10.946937462214246,
      "spread": 0.012305763087523555,
      "volume_24h": 1293486348.5634005,
      "status": "recent",
      "created_at": "2021-09-20T23:47:33",
      "updated_at": "2021-09-21T00:47:14"
    },
    ...
  ],
  "next": "10"
}

This endpoint retrieves all markets for a specific exchange (using pagination)

HTTP Request

GET https://www.cryptingup.com/api/exchanges/<ID>/markets

URL Parameters

Parameter Description
ID The ID of the exchange

Query Parameters

Parameter Description
size Number of results per request
start Start point of results

Get asset markets

{
  "markets": [
    {
      "exchange_id": "BINANCE",
      "symbol": "BTC-USDT",
      "base_asset": "BTC",
      "quote_asset": "USDT",
      "price_unconverted": 41905.744999999995,
      "price": 41911.80403722003,
      "change_24h": -10.828841872269523,
      "spread": 0.01309997091281018,
      "volume_24h": 3664222557.5606112,
      "status": "recent",
      "created_at": "2021-09-20T23:47:33",
      "updated_at": "2021-09-21T00:48:14"
    },
    {
      "exchange_id": "HUOBIGLOBAL",
      "symbol": "BTC-USDT",
      "base_asset": "BTC",
      "quote_asset": "USDT",
      "price_unconverted": 41873.845,
      "price": 41879.899424886156,
      "change_24h": -4.508105689581095,
      "spread": 0.000023881252863152702,
      "volume_24h": 1405685404.1780424,
      "status": "recent",
      "created_at": "2021-09-20T23:47:33",
      "updated_at": "2021-09-21T00:48:14"
    },
    ...
  ],
  "next": "10"
}

This endpoint retrieves all markets for a specific asset (using pagination)

HTTP Request

GET https://www.cryptingup.com/api/assets/<ID>/markets

URL Parameters

Parameter Description
ID The ID of the asset

Query Parameters

Parameter Description
size Number of results per request
start Start point of results

Assets

Get all assets

{
  "assets": [
    {
      "asset_id": "USDT",
      "name": "Tether",
      "price": 1.0001452718521675,
      "volume_24h": 35389562234.59391,
      "change_1h": -0.020511090129785286,
      "change_24h": 0.0033725872157232663,
      "change_7d": 0.0033725872157232663,
      "status": "recent",
      "created_at": "2021-09-20T23:47:33",
      "updated_at": "2021-09-21T00:49:14"
    },
    {
      "asset_id": "BTC",
      "name": "Bitcoin",
      "price": 41692.49540778383,
      "volume_24h": 12818479669.43981,
      "change_1h": -2.4667883546888842,
      "change_24h": -2.3611592605930327,
      "change_7d": -2.3611592605930327,
      "status": "recent",
      "created_at": "2021-09-20T23:47:33",
      "updated_at": "2021-09-21T00:49:14"
    },
    ...
  ],
  "next": "10"
}

This endpoint retrieves all assets (using pagination)

HTTP Request

GET https://www.cryptingup.com/api/assets

Query Parameters

Parameter Description
size Number of results per request
start Start point of results

Get a specific asset

{
  "asset": {
    "asset_id": "BTC",
    "name": "Bitcoin",
    "price": 41692.49540778383,
    "volume_24h": 12818479669.43981,
    "change_1h": -2.4667883546888842,
    "change_24h": -2.3611592605930327,
    "change_7d": -2.3611592605930327,
    "status": "recent",
    "created_at": "2021-09-20T23:47:33",
    "updated_at": "2021-09-21T00:49:14"
  }
}

This endpoint retrieves a specific asset

HTTP Request

GET https://www.cryptingup.com/api/assets/<ID>

URL Parameters

Parameter Description
ID The ID of the asset to retrieve

Get assets overview

{
    "assets": [
        {
            "asset_id": "AKRO",
            "name": "Akropolis"
        },
        {
            "asset_id": "RAD",
            "name": ""
        },
        {
            "asset_id": "FXS",
            "name": "Frax Share"
        },
        ...
    ]
}

This endpoint retrieves the ID and name of all the assets

HTTP Request

GET https://www.cryptingup.com/api/assetsoverview