본문 바로가기
트레이딩/암호화폐

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

by 리치굿맨 2020. 12. 7.

 

 

개요 - 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 API 개요 - 형식 : REST , WebSocket - bybit 거래소 가입 하여 API 키 발급 받아야 API 적용된 클라이언트 앱에서 활용가능. - 개발가능한 언어 : REST, WebSocket 구현가능한 모든 언어 - C++, 자바스크립..

igotit.tistory.com

 

 

 

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

바이빗 거래소 주요특징. - 거래가능 종목 : - BTCUSD , ETHUSD , EOSUSD , XRPUSD - 최대 레버리지 100 까지 가능 매매자가 레버리지 사용 유무 선택가능. 바이빗 레버리지 상세   - - 장점 : 레버리지 1에서

igotit.tistory.com

 

 

 

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

개요 인버스무기한 종목 BTCUSD 와  USDT 무기한 종목 BTCUSD 차이점 단순 명료 이해.  아래 설명은 인버스 종목 중 BTCUSD를 예를들어 설명하나, 다른 인버스 종목 ETHUSD, XRPUSD, EOSUSD 모두 동일. 바이빗

igotit.tistory.com

 

 

 

 

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

개요 아래 용어들 개념 정리. - 화폐, 통화, 법정화폐, - 환율, 기준 통화, 상대 통화. - 환율 트레이딩 - 현물 . 화폐, 통화 , 환율, 기준통화/상대통화 - Currency, Exchange Rate , Base Currency, Quote Curre..

igotit.tistory.com

 

 

 

 


첫 등록 :  2020.12.07

최종 수정 : 2022.02.22

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

 


 

 

 

태그

댓글0


   
현물 |선물 인버스 |선물 USDT     현물 | 선물 USDT |봇제작툴/카피트레이딩     현물 |선물 인버스 |선물 USDT     선물 인버스 |선물 USDT