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