바이비트 파이썬 API - 포지션 확인

정의

my position 함수. 내 포지션에 대한 데이터를 리스트로 받는다.

 

---

 

코드

from pybit import usdt_perpetual
session = usdt_perpetual.HTTP(
        endpoint="https://api-testnet.bybit.com", 
        api_key='나의 api키 입력', 
        api_secret='나의 api 비번 입력',
    )
session.my_position(symbol="BTCUSDT")['result']

 

내 포지션에 대한 정보를 얻어야 하므로, 발급받은 key를 입력해주어야 한다. 입력 파라미터로는 포지션을 확인할 코인명만 넣어주면 된다.

 

Response Parameters

Parameter	Type	Comment
symbol	string	코인명
side	string	long 또는 short 포지션
size	number	진입한 수량. 진입하지 않았을 경우 0
entry_price	string	진입 가격. 분할매매를 진행할 경우에 전부 반영된 나의 진입 가격을 알려준다.
is_isolated	bool	교차/격리에 대한 정보. 교차의 경우 False, 격리의 경우 True이다.
leverage	string	레버리지
take_profit	string	수익 실현 가격
stop_loss	string	스탑 로스 가격

 

---

 

결과 예시

[{'user_id': 488851,
  'symbol': 'BTCUSDT',
  'side': 'Buy',
  'size': 0,
  'position_value': 0,
  'entry_price': 0,
  'liq_price': 0,
  'bust_price': 0,
  'leverage': 2,
  'auto_add_margin': 0,
  'is_isolated': True,
  'position_margin': 0,
  'occ_closing_fee': 0,
  'realised_pnl': 0,
  'cum_realised_pnl': -1014.47535632,
  'free_qty': 0,
  'tp_sl_mode': 'Full',
  'unrealised_pnl': 0,
  'deleverage_indicator': 0,
  'risk_id': 1,
  'stop_loss': 0,
  'take_profit': 0,
  'trailing_stop': 0,
  'position_idx': 1,
  'mode': 'BothSide'},
 {'user_id': 488851,
  'symbol': 'BTCUSDT',
  'side': 'Sell',
  'size': 0,
  'position_value': 0,
  'entry_price': 0,
  'liq_price': 0,
  'bust_price': 0,
  'leverage': 2,
  'auto_add_margin': 0,
  'is_isolated': True,
  'position_margin': 0,
  'occ_closing_fee': 0,
  'realised_pnl': 0,
  'cum_realised_pnl': -454.42722933,
  'free_qty': 0,
  'tp_sl_mode': 'Full',
  'unrealised_pnl': 0,
  'deleverage_indicator': 0,
  'risk_id': 1,
  'stop_loss': 0,
  'take_profit': 0,
  'trailing_stop': 0,
  'position_idx': 2,
  'mode': 'BothSide'}]

 

항상 long 포지션과 short 포지션이 각각 나온다. 해당 함수를 활용하면 다양한 기능을 구현할 수 있는데 다음과 같다.

1. 현재 포지션을 잡고 있는지 확인(파라미터 size 확인)하여 포지션이 없을 경우 주문
2. 진입 가격을 받아(파라미터 entry_price 확인) take profit, stop loss 자체 구현
3. 현재 setting 되어 있는 레버리지(파라미터 leverage 확인) 확인