Get Symbol

GET

https://api.kucoin.com/api/v2/symbols/{symbol}

domain:Spot

api-channel:Public

api-permission:NULL

api-rate-limit-pool:Public

sdk-service:Spot

sdk-sub-service:Market

sdk-method-name:getSymbol

api-rate-limit-weight:4

Description

Request via this endpoint to get detail currency pairs for trading. If you want to get the market information of the trading symbol, please use Get All Tickers.

The baseMinSize and baseMaxSize fields define the min and max order size.

The priceIncrement field specifies the min order price as well as the price increment.This also applies to quote currency.

The order price must be a positive integer multiple of this priceIncrement (i.e. if the increment is 0.01, the 0.001 and 0.021 order prices would be rejected).

priceIncrement and quoteIncrement may be adjusted in the future. We will notify you by email and site notifications before adjustment.

Order Type	Follow the rules of minFunds
Limit Buy	[Order Amount * Order Price] >= minFunds
Limit Sell	[Order Amount * Order Price] >= minFunds
Market Buy	Order Value >= minFunds
Market Sell	[Order Amount * Last Price of Base Currency] >= minFunds

Note:

API market buy orders (by amount) valued at (Order Amount * Last Price of Base Currency) < minFunds will be rejected.

API market sell orders (by value) valued at < minFunds will be rejected.

Take profit and stop loss orders at market or limit prices will be rejected when triggered.

Request

Path Params

symbol

string

required

Path parameter, Symbol

Example:

BTC-USDT

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Body

code

string

required

data

object

required

symbol

string

required

unique code of a symbol, it would not change after renaming

Examples:

BTC-USDTBCHSV-USDT

name

string

required

Name of trading pairs, it would change after renaming

Examples:

BTC-USDTBSV-USDT

baseCurrency

string

required

Base currency,e.g. BTC.

quoteCurrency

string

required

Quote currency,e.g. USDT.

feeCurrency

string

required

The currency of charged fees.

market

string

required

The trading market.

Examples:

USDSBTCALTS

baseMinSize

string

required

The minimum order quantity requried to place an order.

quoteMinSize

string

required

The minimum order funds required to place a market order.

baseMaxSize

string

required

The maximum order size required to place an order.

quoteMaxSize

string

required

The maximum order funds required to place a market order.

baseIncrement

string

required

Quantity increment: The quantity for an order must be a positive integer multiple of this increment. Here, the size refers to the quantity of the base currency for the order. For example, for the ETH-USDT trading pair, if the baseIncrement is 0.0000001, the order quantity can be 1.0000001 but not 1.00000001.

quoteIncrement

string

required

Quote increment: The funds for a market order must be a positive integer multiple of this increment. The funds refer to the quote currency amount. For example, for the ETH-USDT trading pair, if the quoteIncrement is 0.000001, the amount of USDT for the order can be 3000.000001 but not 3000.0000001.

priceIncrement

string

required

Price increment: The price of an order must be a positive integer multiple of this increment. For example, for the ETH-USDT trading pair, if the priceIncrement is 0.01, the order price can be 3000.01 but not 3000.001.

priceLimitRate

string

required

Threshold for price portection

minFunds

string

required

The minimum trading amounts

isMarginEnabled

boolean

required

Available for margin or not.

enableTrading

boolean

required

Available for transaction or not.

feeCategory

enum<integer>

required

Fee Type

Allowed values:

123

makerFeeCoefficient

string

required

The maker fee coefficient. The actual fee needs to be multiplied by this coefficient to get the final fee. Most currencies have a coefficient of 1. If set to 0, it means no fee

takerFeeCoefficient

string

required

The taker fee coefficient. The actual fee needs to be multiplied by this coefficient to get the final fee. Most currencies have a coefficient of 1. If set to 0, it means no fee

boolean

required

Whether it is a Special Treatment symbol

callauctionIsEnabled

boolean

required

The call auction status returns true/false

callauctionPriceFloor

string

required

The lowest price declared in the call auction

Example:

0.00001

callauctionPriceCeiling

string

required

The highest bid price in the call auction

Example:

0.6

callauctionFirstStageStartTime

integer <int64>

required

The first phase of the call auction starts at (Allow add orders, allow cancel orders)

Example:

1740470400000

callauctionSecondStageStartTime

integer <int64>

required

The second phase of the call auction starts at (Allow add orders, don't allow cancel orders)

Example:

1740473400000

callauctionThirdStageStartTime

integer <int64>

required

The third phase of the call auction starts at (Don't allow add orders, don't allow cancel orders)

Example:

1740473700000

tradingStartTime

integer <int64>

required

Official opening time (end time of the third phase of call auction)

Example:

1740474000000

Example

{
  "code": "200000",
  "data": {
    "symbol": "BTC-USDT",
    "name": "BTC-USDT",
    "baseCurrency": "BTC",
    "quoteCurrency": "USDT",
    "feeCurrency": "USDT",
    "market": "USDS",
    "baseMinSize": "0.00001",
    "quoteMinSize": "0.1",
    "baseMaxSize": "10000000000",
    "quoteMaxSize": "99999999",
    "baseIncrement": "0.00000001",
    "quoteIncrement": "0.000001",
    "priceIncrement": "0.1",
    "priceLimitRate": "0.1",
    "minFunds": "0.1",
    "isMarginEnabled": true,
    "enableTrading": true,
    "feeCategory": 1,
    "makerFeeCoefficient": "1.00",
    "takerFeeCoefficient": "1.00",
    "st": false,
    "callauctionIsEnabled": false,
    "callauctionPriceFloor": null,
    "callauctionPriceCeiling": null,
    "callauctionFirstStageStartTime": null,
    "callauctionSecondStageStartTime": null,
    "callauctionThirdStageStartTime": null,
    "tradingStartTime": null
  }
}

Modified at 2025-03-20 08:00:27

Get All Currencies

Get All Symbols