CoinCola Spot Exchange API Documentation – CoinCola Support

Base URL: https://api.coincola.com

Note: CoinCola currently only supports spot markets and does not support derivatives (e.g., perpetual swaps, options, or physically delivered futures).

Market Data API
Error Response

Market Data API

Get Summary

Returns market overview data for all tickers and all market pairs.

HTTP Request

GET /v1/market

Response Parameters

Parameter	Type	Description
base_currency	string	Base currency code (e.g., BTC, ETH, USDT)
quote_currency	string	Quote currency code
trading_pairs	string	Trading pair identifier (e.g., BTC_USDT)
last_price	decimal	Last traded price
base_volume	decimal	24h trading volume in base currency
quote_volume	decimal	24h trading volume in quote currency
highest_bid	decimal	Highest bid price
lowest_ask	decimal	Lowest ask price
price_change_percent_24h	decimal	24h price change percentage
highest_price_24h	decimal	Highest price in last 24h
lowest_price_24h	decimal	Lowest price in last 24h

Request Example

curl https://api.coincola.com/v1/market

Response Example

[
  {
    "trading_pairs": "BTC_USDT",
    "base_currency": "BTC",
    "quote_currency": "USDT",
    "last_price": 90276.51,
    "lowest_ask": 90272,
    "highest_bid": 90267.4,
    "base_volume": 1782.69337896,
    "quote_volume": 158629475.689171,
    "price_change_percent_24h": 0.0348307117819786,
    "highest_price_24h": 90995.34,
    "lowest_price_24h": 86733.71
  },
  ...
]

Get Assets Info

Returns detailed information about all supported assets.

HTTP Request

GET /v1/market/assets

Response Parameters

Parameter	Type	Description
name	string	Full name of the asset
unified_cryptoasset_id	int	Unique identifier for the asset
can_withdraw	boolean	Whether withdrawals are enabled
can_deposit	boolean	Whether deposits are enabled
min_withdraw	decimal	Minimum withdrawal amount
max_withdraw	decimal	Maximum withdrawal amount
maker_fee	decimal	Maker fee rate
taker_fee	decimal	Taker fee rate
contractAddressUrl	string	URL of contract address on each chain
contractAddress	string	Contract address of the asset on each chain

Request Example

curl https://api.coincola.com/v1/market/assets

Response Example

{
  "BTC": {
    "name": "Bitcoin",
    "unified_cryptoasset_id": 1,
    "can_withdraw": true,
    "can_deposit": true,
    "min_withdraw": 0.00030,
    "max_withdraw": 100,
    "maker_fee": 0.001,
    "taker_fee": 0.001
  },
  "ETH": {
    "name": "Ethereum",
    "unified_cryptoasset_id": 1027,
    "can_withdraw": true,
    "can_deposit": true,
    "min_withdraw": 0.001,
    "max_withdraw": 5000,
    "maker_fee": 0.001,
    "taker_fee": 0.001
  },
  ...
}

Get Ticker

Returns 24-hour pricing and volume summary for each market pair.

HTTP Request

GET /v1/market/ticker

Response Parameters

Parameter	Type	Description
base_id	int	Base currency ID
quote_id	int	Quote currency ID
last_price	decimal	Last traded price
base_volume	decimal	24h trading volume in base currency
quote_volume	decimal	24h trading volume in quote currency
is_frozen	int	Trading status (0: active, 1: frozen)

Request Example

curl https://api.coincola.com/v1/market/ticker

Response Example

{
  "BTC_USDT": {
    "base_id": 1,
    "quote_id": 825,
    "last_price": 91447.81,
    "base_volume": 1832.05804424,
    "quote_volume": 163276599.8241,
    "is_frozen": 0
  },
  ...
}

Get Order Book

Returns order book data for a specific trading pair.

HTTP Request

GET /v1/market/orderbook

Request Parameters

Parameter	Required	Type	Description
market_pair	Yes	string	Trading pair (e.g., BTC_USDT)
level	Yes	int	Order book level: 1 - Best bid and ask only 2 - Arranged by best bids and asks.
depth	No	int	Order depth: [0, 10,20,50,100,400], Default 400. Not defined or 0 = full order book. depth = 100 means 50 for each bid/ask side

Response Parameters

Parameter	Type	Description
asks	array	List of ask orders [price, quantity]
bids	array	List of bid orders [price, quantity]
timestamp	int	Timestamp in milliseconds

Request Example

curl "https://api.coincola.com/v1/market/orderbook?market_pair=BTC_USDT&depth=10&level=2"

Response Example

{
  "timestamp": 1741227795711,
  "bids": [
    [91213.36, 0.01921275],
    [91207.69, 0.0444051],
    [91202.00, 0.06712361],
    [91196.30, 0.08603591],
    [90967.56, 0.39221442]
  ],
  "asks": [
    [91228.32, 0.0265707],
    [91230.21, 0.00647987],
    [91234.02, 0.050472],
    [91239.68, 0.06964654],
    [91243.99, 0.0124498]
  ],
  ...
}

Get Recent Trades

Returns recent trades for a specific trading pair. Supports the latest 24 hours of records

HTTP Request

GET /v1/market/trade

Request Parameters

Parameter	Required	Type	Description
market_pair	Yes	string	Trading pair (e.g., BTC_USDT)
limit	No	int	Number of trades to return (1-1000), By default, all trading records in the last 24 hours are returned.

Response Parameters

Parameter	Type	Description
trade_id	int	Unique trade identifier
price	decimal	Trade price
base_volume	decimal	Trade amount in base currency
quote_volume	decimal	Trade amount in quote currency
timestamp	int	Trade timestamp in milliseconds
type	string	Trade type: “buy” or “sell”

Request Example

curl "https://api.coincola.com/v1/market/trade?market_pair=BTC_USDT&limit=100"

Response Example

[
  {
    "trade_id": 3739268804857651810,
    "price": 91547.16000000,
    "base_volume": 0.11399589,
    "quote_volume": 10435.99998117,
    "timestamp": 1741232725032,
    "type": "sell"
  },
  ...
]

Get Trades History

Returns recent trades for a specific trading pair from the last 3 months with pagination.

HTTP Request

GET /v1/market/history-trade

Request Parameters

Parameter	Required	Type	Description
market_pair	Yes	string	Trading pair (e.g. BTC_USDT)
from_trade_id	No	int	`trade_id` to fetch from, Default gets most recent trades.
from_ts	No	int	Trade `timestamp` in milliseconds to fetch from, Default gets most recent trades.
limit	No	int	Default 500; max 1000

Note:

Either from_trade_id or from_ts can be used; if both are provided, from_trade_id takes precedence.

The system supports querying historical trade records for up to the recent 3 months.

Response Parameters

Parameter	Type	Description
trade_id	int	Unique trade identifier
price	decimal	Trade price
base_volume	decimal	Trade amount in base currency
quote_volume	decimal	Trade amount in quote currency
timestamp	int	Trade timestamp in milliseconds
type	string	Trade type: “buy” or “sell”

Request Example

curl "https://api.coincola.com/v1/market/history-trade?market_pair=BTC_USDT&from_ts=1741232724000&limit=100"

Response Example

[
  {
    "trade_id": 3739268804857651810,
    "price": 91547.16000000,
    "base_volume": 0.11399589,
    "quote_volume": 10435.99998117,
    "timestamp": 1741232725032,
    "type": "sell"
  },
  ...
]

Error Response

Response Parameters

Parameter	Type	Description
error_code	int	Business error code which is different with http status code.
error_msg	string	Error message

Response Example

{
  "error_code": 400,
  "error_msg": "{\"field\":\"market_pair\",\"rejected_value\":null}"
}

Related to

Table of Contents

Market Data API

Get Summary

Get Assets Info

Get Ticker

Get Order Book

Get Recent Trades

Get Trades History

Error Response

Related articles