Skip to main content

Get Convert Coin List

You can query the coin list of convert from (to).

HTTP Request

GET /v5/asset/exchange/query-coin-list

Request Parameters

ParameterRequiredTypeComments
coinfalsestringCoin, uppercase only
  • Convert from coin (coin to sell)
  • when side=0, coin field is ignored
  • sidefalseinteger0: fromCoin list, the balance is given if you have it; 1: toCoin list (coin to buy)
  • when side=1 and coin field is filled, it returns toCoin list based on coin field
  • accountTypetruestringWallet type
  • eb_convert_funding
  • eb_convert_uta
  • eb_convert_spot
  • eb_convert_contract
  • eb_convert_inverse
  • Response Parameters

    ParameterTypeComments
    coinsarray<object>Coin spec
    > coinstringCoin
    > fullNamestringFull coin name
    > iconstringCoin icon url
    > iconNightstringCoin icon url (dark mode)
    > accuracyLengthintegerCoin precision
    > coinTypestringcrypto
    > balancestringCoin balance
  • Only when side=0, it checks balance, otherwise, it is ""
  • > uBalancestringCoin balance in USDT worth value
    > singleFromMinLimitstringThe minimum amount of fromCoin per transaction
    > singleFromMaxLimitstringThe maximum amount of fromCoin per transaction
    > disableFrombooleantrue: the coin is disabled to be fromCoin, false: the coin is allowed to be fromCoin
    > disableTobooleantrue: the coin is disabled to be toCoin, false: the coin is allowed to be toCoin
    > timePeriodintegerReserved field, ignored for now
    > singleToMinLimitstringReserved field, ignored for now
    > singleToMaxLimitstringReserved field, ignored for now
    > dailyFromMinLimitstringReserved field, ignored for now
    > dailyFromMaxLimitstringReserved field, ignored for now
    > dailyToMinLimitstringReserved field, ignored for now
    > dailyToMaxLimitstringReserved field, ignored for now

    Request Example

    GET /v5/asset/exchange/query-coin-list?side=0&accountType=eb_convert_funding HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXXX
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1720064061248
    X-BAPI-RECV-WINDOW: 5000

    Response Example

    {
    "retCode": 0,
    "retMsg": "ok",
    "result": {
    "coins": [
    {
    "coin": "BTC",
    "fullName": "BTC",
    "icon": "https://t1.bycsi.com/app/assets/token/0717b8c28c2373bf714c964195411d0f.svg",
    "iconNight": "https://t1.bycsi.com/app/assets/token/9504b4c841194cc38f04041003ffbfdb.svg",
    "accuracyLength": 8,
    "coinType": "crypto",
    "balance": "0",
    "uBalance": "0",
    "timePeriod": 0,
    "singleFromMinLimit": "0.001",
    "singleFromMaxLimit": "1",
    "singleToMinLimit": "0",
    "singleToMaxLimit": "0",
    "dailyFromMinLimit": "0",
    "dailyFromMaxLimit": "0",
    "dailyToMinLimit": "0",
    "dailyToMaxLimit": "0",
    "disableFrom": false,
    "disableTo": false
    },
    ...
    {
    "coin": "SOL",
    "fullName": "SOL",
    "icon": "https://s1.bycsi.com/app/assets/token/87ca5f1ca7229bdf0d9a16435653007c.svg",
    "iconNight": "https://t1.bycsi.com/app/assets/token/383a834046655ffe5ef1be1a025791cc.svg",
    "accuracyLength": 8,
    "coinType": "crypto",
    "balance": "18.05988133",
    "uBalance": "2458.46990211775033220586588327",
    "timePeriod": 0,
    "singleFromMinLimit": "0.1",
    "singleFromMaxLimit": "1250",
    "singleToMinLimit": "0",
    "singleToMaxLimit": "0",
    "dailyFromMinLimit": "0",
    "dailyFromMaxLimit": "0",
    "dailyToMinLimit": "0",
    "dailyToMaxLimit": "0",
    "disableFrom": false,
    "disableTo": false
    },
    ...
    {
    "coin": "ETH",
    "fullName": "ETH",
    "icon": "https://s1.bycsi.com/app/assets/token/d6c17c9e767e1810875c702d86ac9f32.svg",
    "iconNight": "https://t1.bycsi.com/app/assets/token/9613ac8e7d62081f4ca20488ae5b168d.svg",
    "accuracyLength": 8,
    "coinType": "crypto",
    "balance": "0.80264489",
    "uBalance": "2596.09751650032773106431534138",
    "timePeriod": 0,
    "singleFromMinLimit": "0.01",
    "singleFromMaxLimit": "250",
    "singleToMinLimit": "0",
    "singleToMaxLimit": "0",
    "dailyFromMinLimit": "0",
    "dailyFromMaxLimit": "0",
    "dailyToMinLimit": "0",
    "dailyToMaxLimit": "0",
    "disableFrom": false,
    "disableTo": false
    }
    ]
    },
    "retExtInfo": {},
    "time": 1720064061736
    }