bybit. API. Query Symbol. 종목 정보 받기

 

 

개요 - Query Symbol 

베이스 주소 ( https://api.bybit.com 혹은 https://api.bytick.com  )  공통. 

 

bybit 의 3개 종목군(Inverse Perpetual, Inverse Future, USDT Perpetual,  : 줄여서 각각 IP, IF, UP 라고 하자 ..) 의 심볼정보 는 동일 주소 로 요청하고 반환 데이터 형식도 동일. 

 

IP, IF, UP Query Symbol  GET  주소 :  /v2/public/symbols . 

 

 

현물 Query Symbol GET 주소 : /spot/v1/symbols . 

 

 

 

 

Inverse Perpetual, Inverse Future, USDT Perpetual

 

Response Parameters

parameter	type	comments
name	string	Symbol name
base_currency	string	Base currency
quote_currency	string	Quote currency
price_scale	number	Price scale
taker_fee	string	Taker fee
maker_fee	string	Maker fee
leverage_filter > min_leverage	number	Min leverage
leverage_filter > max_leverage	number	Max leverage
leverage_filter > leverage_step	string	Leverage step
price_filter > min_price	string	Min price
price_filter > max_price	string	Max price
price_filter > tick_size	string	Tick size
lot_size_filter > max_trading_qty	number	Max trading quantity
lot_size_filter > min_trading_qty	number	Min trading quantity
lot_size_filter > qty_step	number	Qty step

 

각 항목들 설명 

base currency, quote currency

종목 BTCUSD :

base currency = BTC, quote currency = USD

 

종목 BTCUSDT :

base currency = BTC, quote currency = USDT 

 

 

모든 종목에서 가격 단위는 quote currency  

USDT Perpetual 종목들의 주문 수량단위는 base currency 

Inverse Perputual , Inverse Future 종목들의 주문 수량단위는 quote currency 

 

 

개념이해 : 환율 , 기준통화(base currency) , 상대통화(quote currency) 개념 : https://igotit.tistory.com/3502

 

price_scale

 

종목 가격 표현 소수점 이하 자리수. 정수로 1, 2, 식으로 기록되어있음. 

종목 BTCUSD 인 경우에는 2가 기록되어있는데, 가격 표시할때 소수점이하 2자리까지만 표현한다는 의미. 

주의 : 소수점 이하 두자리 까지 표현한다는 것이 xxx.01 , xx.02 처럼 0.01 단위의 정밀도를 의미하는 것은 아니다. 실제  BTCUSD 의 가격은 0.5 가 가격 틱이며, price_filter > tick_size 에 가격 틱 값이 기록되어있다. 

 

비교 : 현물 종목의 Symbol Query 데이터 항목에서는 price_scale 제공안됨. 현물에서는 minPricePrecision 의 값을 보고 소수점 이하 자리수 알 수 있다. 예. 현물 종목의 minPricePrecision 이 0.05 라면 price_scale 은 2. 

 

 

price_filter > min_price

가격의 최소값.

BTCUSD 의 경우 0.5 . 

 

price_filter > max_price

가격의 최대값. 

BTCUSD 의 경우 999999.5 . 

 

price_filter > tick_size

종목 가격의 틱

BTCUSD 의 경우 0.5 . 가격최소스텝을 의미한다. 3450.50 , 3450.00 은 가능하나, 3450.01 , 3450.03 같은 가격은 없다. 

- 종목가격의 틱이 0.5 라면 소수점 이하 자리수는 1로 충분한데 BTCUSD 는 소수점이하 자리수 2까지 표현하고 있음. 

 

위 용어에서의 가격, price  의 정확한 의미는 2개 통화의 교환비율을 의미한다.

BTCUSDT 의 가격 = BTC가치 / USDT가치

ETHUSDT 의 가격 = ETH가치/ USDT가치.

환율 상세 : https://igotit.tistory.com/3502

 

가격의 단위 

- 모든 심볼들 공통적으로 가격 단위는 quote currency  임. 

예:

BTCUSDT 의 가격 단위 :  USDT, 

BTCUSDC 의 가격 단위 :  USDC

BTCUSD 의 가격 단위 : USD

참고 : 암호화폐 외의 환율 거래 대상인 FX 마진류들도 가격단위는 quote currency 임.

예 : EURUSD 의 가격단위 USD, EURGBP 가격단위 GBP. 

 

 

max_trading_qty : 주문 가능 최대 수량 예 : 1000000

max_trading_qty : 주문 가능 최소 수량 예 1

qty_step : 주문 수량 스텝 : 예 1이면 3, 4, 5, ...식으로만 주문수량 설정가능.

 

주문 수량의 단위 및  결제 통화. 

 

- 주문수량 단위는 종목 그룹별로 다르며, Inverse 종목이 통상적인 거래 종목들과 다름.  

 

- USDT Perpetual 종목들의 주문수량 단위 : base currency

 - - 예 : BTCUSDT의 주문 수량 단위 BTC,  ETHUSDT 의 주문수량 단위 ETH,  XRPUSDT 주문수량 단위 XRP. 

 - - 주문하여 확보되는 포지션도 주문 수량 단위 와 동일한 base currency . BTCUSDT 1BTC 매수주문 체결되었다면 1BTC 매수 포지션 생김. 

- USDT Perpetual 종목들의 결제 통화 : quote currency 

 - - 예 : BTCUSDT, ETHUSDT, XRPUSDT  ,... 모두 결제 통화는 USDT. 

 

 

 

 

- Inverse Perpetual, Inverse Future 종목들의 주문수량 단위 : quote currency 

 - - 예 : BTCUSD , ETHUSD , XRPUSD 의 주문수량 단위 : USD

- Inverse Perpetual, Inverse Future 종목들의 결제 통화 : base currency 

 - - 예 : BTCUSD 결제통화 BTC,  ETHUSD 결제통화 ETH, XRPUSD 결제통화 XRP.

 

 - - Inverse 종목들의 주문수량단위는 quote currency 인 USD 이지만  거래체결되어 포지션 확보되는것은 base currency . 

 - - - 예 : BTCUSD  1USD 매수 의미 = 1USD 가치에 해당하는  BTC  매수포지션 확보.  

 - - - 상세설명 : https://igotit.tistory.com/2730

 

 

테이블로 간략 정리. -주문수량 단위, 결제통화, 포지션 통화. 

	주문수량 단위	결제통화	포지션	예시
USDT Perpetual	base	quote	base	BTCUSDT 주문 수량단위는 base 인 BTC , 결제통화 quote 인 USDT 로 매수(매도)하면, base 인 BTC매수(매도) 포지션 확보된다.
Inverse Perpetual Inverse Future	quote	base	base	BTCUSD 주문 수량단위는 quote 인 USD, 결제통화 base 인 BTC 로 매수(매도)하면 , base 인 BTC매수(매도) 포지션 확보된다.

 

비교 : FX마진 

FX마진 종목들은 주문수량 단위는 base curency 이며, 결제통화는 종목명에 있는 quote 나 base 가 지정되는 규칙 적용안함.  FX 마진에서는  본인 계좌 개설할 때 선택한 결제통화(USD, EUR 등 선택가능)로 결정됨. 

예:

FX마진 종목 EURGBP 의 주문수량 단위는 base 인 EUR 이고, 결제통화 USD 로 매수(매도) 하면 EUR 매수(매도) 포지션 확보된다.

FX마진 종목 EURUSD 의 주문수량 단위는 base 인 EUR 이고, 결제통화 USD 로 매수(매도)하면 EUR 매수(매도)포지션 확보된다.   

 

 

 

 

 

 

taker_fee : 시장가 주문 수수료 비율. 

maker_fee : 지정가 주문 수수료 비율.

 

 

 

 

Response Example

{
  "ret_code": 0,
  "ret_msg": "OK",
  "ext_code": "",
  "ext_info": "",
  "result": [
    {
      "name": "BTCUSD",
      "base_currency": "BTC",
      "quote_currency": "USD",
      "price_scale": 2,
      "taker_fee": "0.00075",
      "maker_fee": "-0.00025",
      "leverage_filter": {
        "min_leverage": 1,
        "max_leverage": 100,
        "leverage_step": "0.01"
      },
      "price_filter": {
        "min_price": "0.5",
        "max_price": "999999.5",
        "tick_size": "0.5"
      },
      "lot_size_filter": {
        "max_trading_qty": 1000000,
        "min_trading_qty": 1,
        "qty_step": 1
      }
    },
    {
      "name": "ETHUSD",
      "base_currency": "ETH",
      "quote_currency": "USD",
      "price_scale": 2,
      "taker_fee": "0.00075",
      "maker_fee": "-0.00025",
      "leverage_filter": {
        "min_leverage": 1,
        "max_leverage": 50,
        "leverage_step": "0.01"
      },
      "price_filter": {
        "min_price": "0.05",
        "max_price": "99999.95",
        "tick_size": "0.05"
      },
      "lot_size_filter": {
        "max_trading_qty": 1000000,
        "min_trading_qty": 1,
        "qty_step": 1
      }
    }
  ],
  "time_now": "1581411225.414179"
}

 

 

 

SPOT 

Response Parameters

Parameter	Type	Comment
name	string	Name of the trading pair
alias	string	Alias
baseCurrency	string	Base currency
quoteCurrency	string	Quote currency
basePrecision	string	Decimal precision (base currency)
quotePrecision	string	Decimal precision (quote currency)
minTradeQuantity	string	Min. order qty
minTradeAmount	string	Min. order value
minPricePrecision	string	Min. number of decimal places
maxTradeQuantity	string	Max. order qty
maxTradeAmount	string	Max. order value
category	int	Category

 

 

 

 

각 항목들 설명 

 

 

name : 심볼 명.  api 에서 심볼 식별 아이디 역할. 예 : BTCUSDT

alias : 심볼 별명.  예 : BTCUSDT

baseCurrency : base currecny . 예 : BTCUSDT 인 경우 BTC , base currency 가 주문 수량의 단위. 

quoteCurrency : quote currency . 예 : BTCUSDT 인 경우 USDT ,  quote currency 가 종목 가격의 단위.

 

( 참고 : 환율 거래, base, quote 상세설명 : https://igotit.tistory.com/3502    ) 

 

basePrecision : base currecy 가격 정밀도. 예 : BTCUSDT 인 경우 base 인 BTC 의 가격 정밀도 = 0.000001

quotePrecision : quote currency 가격 정밀도. 예 :   BTCUSDT 인 경우 quote 인 USDT 의 가격 정밀도 = 0.01

 

minPricePrecision : 종목 가격 정밀도. 예 : BTCUSDT 인 경우 0.01, SANDUSDT 인 경우 0.00001  (단위 : USDT)

 

 

minTradeQuantity : 주문 가능 최소수량 . (단위 : BTC)

maxTradeQuantity : 주문 가능 최대수량. (단위 : BTC)

 

minTradeAmount : 주문 가능 최소 금액 .  (단위 : USDT)

maxTradeAmount : 주문 가능 최대 금액 .  (단위 : USDT)

 

주문 가능 최소"수량"과 "금액" 2개가 있는데, 주문시 2개의 값 모두 초과되는 수량, 금액이어야 함. 

 

 

선물 제공정보와 비교

 

 - - 현물 심볼 정보 반환값에 거래 수수료 항목 없음. 

 - - 선물에서는 가격의 최소, 최대값 제공되었으나 현물에서는 제공 안됨. 

 - - 선물에서 가격의 소수점 이하 자리수 price_scale 은 현물에서는  제공 안됨. 

  - - - 현물에서는 minPricePrecision 의 값을 보고 소수점 이하 자리수 알 수 있다.

예.  minPricePrecision 이 0.05 라면 price_scale 은 2. 

- - 선물에서는 최소주문수량과 주문수량스텝이 따로 제공되었으나, 현물에서는 주문수량 스텝 제공되지 않음. 

  - - - 현물에서는 최소주문수량을 스텝으로 취급하면됨. 

- 선물에서는 최소/최대 주문수량만 제공되었으나, 현물에서는 추가로 최소/최대주문금액 도 제공된다. 

 

 

 

 

Response Example 

{
    "ret_code": 0,
    "ret_msg": "",
    "ext_code": null,
    "ext_info": null,
    "result": [
        {
            "name": "BTCUSDT",
            "alias": "BTCUSDT",
            "baseCurrency": "BTC",
            "quoteCurrency": "USDT",
            "basePrecision": "0.000001",
            "quotePrecision": "0.01",
            "minTradeQuantity": "0.0001",
            "minTradeAmount": "10",
            "minPricePrecision": "0.01",
            "maxTradeQuantity": "2",
            "maxTradeAmount": "200",
            "category": 1
        },
        {
            "name": "ETHUSDT",
            "alias": "ETHUSDT",
            "baseCurrency": "ETH",
            "quoteCurrency": "USDT",
            "basePrecision": "0.0001",
            "quotePrecision": "0.01",
            "minTradeQuantity": "0.0001",
            "minTradeAmount": "10",
            "minPricePrecision": "0.01",
            "maxTradeQuantity": "2",
            "maxTradeAmount": "200",
            "category": 1
        }
    ]
}

 

 

 

 

연관 

 

 

암호화폐. API. 바이빗. REST , WebSocket

 

 

거래소. bybit. 바이빗. 개요. 가입방법. 암호화폐

 

 

bybit. BTCUSD , BTCUSDT 차이점. 주문 수량 단위 단순명료 이해.

 

 

 

암호화폐 . 환율 트레이딩. 기준통화 상대통화 . 개념 정리 .

 

 

 

 

---

첫 등록 :  2020.12.07

최종 수정 : 2022.02.22

단축 주소 : https://igotit.tistory.com/2726

 

---