Skip to main content

Get Symbols Information

Get trading pair information including trading rules, precision, and fees.

HTTP Request

GET /api/v1/spot/market/symbols

Request Parameters

ParameterTypeRequiredDescription
symbolstringNoTrading pair symbol (e.g., BTCUSDT). If omitted, returns all symbols

Request Example

Single Symbol Request

curl -X GET "https://open-api.bydoxe.com/api/v1/spot/market/symbols?symbol=BTCUSDT"

All Symbols Request

curl -X GET "https://open-api.bydoxe.com/api/v1/spot/market/symbols"

Response Parameters

ParameterTypeDescription
codestringResponse code
msgstringResponse message
requestTimenumberRequest timestamp in milliseconds
dataobject/arrayResponse data (object for single symbol, array for all)
> symbolstringTrading pair symbol (e.g., BTCUSDT)
> baseCoinstringBase currency (e.g., BTC)
> quoteCoinstringQuote currency (e.g., USDT)
> minTradeAmountstringMinimum trade amount in base currency
> maxTradeAmountstringMaximum trade amount in base currency
> takerFeeRatestringTaker fee rate (decimal format)
> makerFeeRatestringMaker fee rate (decimal format)
> pricePrecisionstringPrice decimal precision
> quantityPrecisionstringQuantity decimal precision
> quotePrecisionstringQuote currency decimal precision
> statusstringTrading status (online, offline, etc.)
> minTradeUSDTstringMinimum trade amount in USDT equivalent

Response Example

Success Response (Single Symbol)

{
"code": "00000",
"msg": "success",
"requestTime": 1732000000000,
"data": {
"symbol": "BTCUSDT",
"baseCoin": "BTC",
"quoteCoin": "USDT",
"minTradeAmount": "0.0001",
"maxTradeAmount": "100",
"takerFeeRate": "0.001",
"makerFeeRate": "0.001",
"pricePrecision": "2",
"quantityPrecision": "6",
"quotePrecision": "2",
"status": "online",
"minTradeUSDT": "5"
}
}

Success Response (All Symbols)

{
"code": "00000",
"msg": "success",
"requestTime": 1732000000000,
"data": [
{
"symbol": "BTCUSDT",
"baseCoin": "BTC",
"quoteCoin": "USDT",
"minTradeAmount": "0.0001",
"maxTradeAmount": "100",
"takerFeeRate": "0.001",
"makerFeeRate": "0.001",
"pricePrecision": "2",
"quantityPrecision": "6",
"quotePrecision": "2",
"status": "online",
"minTradeUSDT": "5"
},
{
"symbol": "ETHUSDT",
"baseCoin": "ETH",
"quoteCoin": "USDT",
"minTradeAmount": "0.001",
"maxTradeAmount": "1000",
"takerFeeRate": "0.001",
"makerFeeRate": "0.001",
"pricePrecision": "2",
"quantityPrecision": "4",
"quotePrecision": "2",
"status": "online",
"minTradeUSDT": "5"
}
]
}

Error Codes

CodeMessage
40034symbol does not exist
50010No symbols found