CoinCola Spot Exchange API Documentation – CoinCola Support

A. Spot Market API
B. Derivatives Market API
Error Response

A. Spot Market API

Get Summary

Returns market overview data for all tickers and all spot 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
  }
]

A1. 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
  }
}

A2. 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
    }
}

A3. 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]
  ]
}

A4. 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"
  }
]

A5. 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"
  }
]

B. Derivatives Market API

B1. Get Contracts Summary

Returns summary of every single contract.

HTTP Request

GET /v1/contract/market

Request Parameters

Parameter	Required	Type	Description
product_type	true	string	ProductTypeEnum, eg.(PERPETUAL, FUTURES, OPTIONS)

Response Parameters

Parameter	Type	Description
ticker_id	string	Identifier of a ticker with delimiter to separate base_quote, eg.BTC_PERPUSDT
base_currency	string	Symbol/currency code of base pair, eg. BTC
quote_currency	string	Symbol/currency code of quote pair, eg. USDT
last_price	decimal	Last transacted price of base currency based on given quote currency
base_volume	decimal	24 hour trading volume in BASE currency
USD_volume	decimal	24 hour trading volume in USD
quote_volume	decimal	24 hour trading volume in QUOTE currency
bid	decimal	Current highest bid price
ask	decimal	Current lowest ask price
high	decimal	Rolling 24-hour highest transaction price
low	decimal	Rolling 24-hour lowest transaction price
product_type	string	PERPETUAL , FUTURES , OPTIONS
open_interest	decimal	The number of outstanding derivatives contracts that have not been settled
open_interest_usd	decimal	The sum of the Open Positions (long or short) in USD Value of the contract
index_price	decimal	Last calculated index price for underlying of contract
creation_timestamp	int	Start date of derivative, UTC timestamp in ms, only for expirable futures/options
expiry_timestamp	int	Start date of derivative, UTC timestamp in ms, only for expirable futures/options
funding_rate	decimal	Current funding rate
next_funding_rate	decimal	Upcoming predicted funding rate
next_funding_rate_timestamp	int	Timestamp of the next funding rate change, UTC timestamp in ms
maker_fee	decimal	Fees for filling a "maker" order (can be negative if rebate is given)
taker_fee	decimal	Fees for filling a "taker" order (can be negative if rebate is given)
contract_type	string	Describes the type of contract - VANILLA, INVERSE or QUANTO?
contract_price	decimal	Describes the price per contract.
contract_price_currency	string	Describes the currency which the contract is priced in (e.g. USD, EUR, BTC, USDT)

Request Example

curl "https://api.coincola.com/v1/contract/market?product_type=PERPETUAL"

Response Example

[
  {
    "ticker_id": "BTC_PERPUSDT",
    "base_currency": "BTC",
    "quote_currency": "USDT",
    "last_price": 65432.50,
    "base_volume": 1250.75,
    "USD_volume": 81773968.75,
    "quote_volume": 81773968.75,
    "bid": 65431.00,
    "ask": 65434.00,
    "high": 66000.00,
    "low": 64800.00,
    "product_type": "PERPETUAL",
    "open_interest": 3500.25,
    "open_interest_usd": 229061843.75,
    "index_price": 65428.50,
    "funding_rate": 0.0001,
    "next_funding_rate": 0.00012,
    "next_funding_rate_timestamp": 1712345678000,
    "maker_fee": -0.00025,
    "taker_fee": 0.00075,
    "contract_type": "INVERSE",
    "contract_price": 1.00,
    "contract_price_currency": "USDT"
  }
]

Note: If an empty array is returned, it means there is no contract at the moment

B2. Get Contract Specifications

Describes the specification of the contracts, mainly the pricing of the contract and its type (vanilla, inverse, or quanto).

HTTP Request

GET /v1/contract/market/specifications

Request Parameters

Parameter	Required	Type	Description
product_type	true	string	ProductTypeEnum, eg.(PERPETUAL, FUTURES, OPTIONS)
ticker_id	true	string	ticker_id, eg.(BTC_PERPUSDT)

Response Parameters

Parameter	Type	Description
product_type	string	ProductTypeEnum, eg.(PERPETUAL, FUTURES, OPTIONS)
ticker_id	string	ticker_id, eg.(BTC_PERPUSDT)
contract_type	string	Describes the type of contract - VANILLA, INVERSE or QUANTO?
contract_price	decimal	Describes the price per contract.
contract_price_currency	string	Describes the currency which the contract is priced in (e.g. USD, EUR, BTC, USDT)

Request Example

curl "https://api.coincola.com/v1/contract/market/specifications?ticker_id=BTC_PERPUSDT"

Response Example

{
  "product_type": "PERPETUAL",
  "ticker_id": "BTC_PERPUSDT",
  "contract_type": "INVERSE",
  "contract_price": "1.00",
  "contract_price_currency": "USDT"
}

B3. Get Contract Order Book

Returns order book data for a specific trading pair.

HTTP Request

GET /v1/contract/market/orderbook

Request Parameters

Parameter	Required	Type	Description
product_type	true	string	ProductTypeEnum, eg.(PERPETUAL, FUTURES, OPTIONS)
ticker_id	true	string	ticker_id, eg.(BTC_PERPUSDT)
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

Request Example

curl "https://api.coincola.com/v1/contract/market/orderbook?product_type=PERPETUAL&ticker_id=BTC_PERPUSDT&depth=10"

Response Example

{
  "ticker_id": "BTC_PERPUSDT",
  "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]
  ]
}

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

A. Spot Market API

Get Summary

A1. Get Assets Info

A2. Get Ticker

A3. Get Order Book

A4. Get Recent Trades

A5. Get Trades History

B. Derivatives Market API

B1. Get Contracts Summary

B2. Get Contract Specifications

B3. Get Contract Order Book

Error Response

Related articles