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

암호화폐 . MEXC . API . 현물 . ETF . 캔들 확보

by i.got.it 2022. 3. 14.

 

개요

 

- 암호화폐 거래소 MEXC 의  현물 종목들 ( 예 : BTC, ETH, XRP  ,...  )   rest api 로 캔들 확보.  동일 요청주소로 ETF 종목들 (예:  BTC3L_USDT, BTC3S_USDT  ,...) 도 정보 제공됨.  

 

 

 

 

요청 주소 :  https://api.mexc.com/api/v3/klines

 

요청 예 : 

 

현물 BTC_USDT 1일봉 : https://api.mexc.com/api/v3/klines?symbol=BTCUSDT&interval=1d 

현물 BTC_USDT 1일봉 2개 : https://api.mexc.com/api/v3/klines?symbol=BTCUSDT&interval=1d&limit=2 

 

ETF BTC3S_USDT 1일봉 : https://api.mexc.com/api/v3/klines?symbol=BTC3LUSDT&interval=1d

 

요청 파라메타 

- symbol, interval 필수 지정해야함. 

name Type Mandatory Description
symbol string YES  
interval ENUM YES 아래 리스트만 가능
startTime long NO 캔들 시작시간 지정. 
endTimne long NO 캔들 끝시간 시정. 
limit integer NO 지정하지 않으면 500개의 캔들반환,
지정가능 최대수량 1000

 

 

interval 에 지정 가능한 값.

 

API 문서에서 제시된 값들에 틀린 정보있으며 확인결과 아래처럼 지원 안되는 interval 이 많으며, 1시간봉 요청은 1h 로 안되고 60m 으로 해야 정상 확보가능. 2022.03.14 

  • 1m 1 minute
  • 3m 3 minute -> 지원안됨.
  • 5m 5 minute
  • 15m 15 minute
  • 30m 30 minute
  • 1h 1 hour   -> 60m 으로 해야함. 
  • 2h 2 hour  -> 지원안됨.
  • 4h 4 hour 
  • 6h 6 hour -> 지원안됨.
  • 8h 8 hour -> 지원안됨. 
  • 12h 12 hour -> 지원안됨.
  • 1d 1 day
  • 3d 3 day -> 지원안됨. 
  • 1w 1 week  -> 지원안됨.
  • 1M 1 month

 

시간지정시 반드시 startTime, endTime 동시에 지정해야함. 

시간지정 상세 특성 

 

요청시 startTime >= endTime 이면 오류 반환. 

 

 

시간지정시 startTime 과 endTime 을 동시에 지정해야 하며, 어느 하나만 지정하면 부정확한 정보 반환됨.

 

endTime 만 지정하면 endTime 포함 된 캔들 데이터가 반환되긴 하는데 반환데이터의 마지막이 endTime 아님. 

 

예 : 

https://api.mexc.com/api/v3/klines?symbol=ETHBTC&interval=1m&endTime=1647244320000 

 

요청 결과  

- 아래처럼 endTime 으로 지정한 16472443200 이 캔들 데이터의 끝이 아님. 


[1647243540000,"0.066217","0.066227","0.066199","0.066199","0.022",1647243600000,"0.001456"],[1647243600000,"0.066199","0.066272","0.066184","0.066264","0.084",1647243660000,"0.005564"],[1647243660000,"0.066264","0.066264","0.066156","0.066213","0.302",1647243720000,"0.020001"],[1647243720000,"0.066213","0.066213","0.066123","0.066141","0.024",1647243780000,"0.001587"],[1647243780000,"0.066141","0.06627","0.066141","0.06627","0.337",1647243840000,"0.022327"],[1647243840000,"0.06627","0.066276","0.06624","0.06624","0.075",1647243900000,"0.004969"],[1647243900000,"0.06624","0.066263","0.066228","0.066257","0.065",1647243960000,"0.004306"],[1647243960000,"0.066257","0.066317","0.066257","0.066317","0.028",1647244020000,"0.001856"],[1647244020000,"0.066317","0.066317","0.06625","0.066289","0.053",1647244080000,"0.003513"],[1647244080000,"0.066289","0.066311","0.066289","0.066293","0.032",1647244140000,"0.002121"],[1647244140000,"0.066293","0.06632","0.066293","0.06632","0.24",1647244200000,"0.015914"],[1647244200000,"0.06632","0.06632","0.06628","0.066311","0.011",1647244260000,"7.29E-4"],[1647244260000,"0.066311","0.066311","0.066262","0.066278","0.063",1647244320000,"0.004175"],[1647244320000,"0.066278","0.0663","0.06626","0.06626","0.037",1647244380000,"0.002452"],[1647244380000,"0.06626","0.066279","0.066243","0.066264","0.017",1647244440000,"0.001126"],[1647244440000,"0.066264","0.06628","0.066216","0.066261","0.051",1647244500000,"0.003378"],[1647244500000,"0.066261","0.06628","0.066236","0.066276","0.163",1647244560000,"0.010802"],[1647244560000,"0.066276","0.066276","0.066246","0.066246","0.062",1647244620000,"0.004108"],[1647244620000,"0.066246","0.066246","0.066237","0.066238","0.031",1647244680000,"0.002053"],[1647244680000,"0.066238","0.066238","0.066208","0.066227","0.023",1647244740000,"0.001522"],[1647244740000,"0.066227","0.066275","0.066213","0.066244","0.04",1647244800000,"0.00265"],[1647244800000,"0.066244","0.066268","0.066195","0.06624","0.054",1647244860000,"0.003576"],[1647244860000,"0.06624","0.066257","0.066204","0.066209","0.043",1647244920000,"0.002847"],[1647244920000,"0.066209","0.066222","0.066147","0.066147","0.356",1647244980000,"0.023567"]]

 

endTime 과 limit 조합하면 endTime 은 응답결과에 보이지도 않는다.  

예 : 앞의 endTime 에서 limit 을 2로 한경우 . 

https://api.mexc.com/api/v3/klines?symbol=ETHBTC&interval=1m&endTime=1647244320000&limit=2 

 

요청응답결과. 

[[1647245340000,"0.066228","0.066345","0.066228","0.066345","0.025",1647245400000,"0.001657"],[1647245400000,"0.066345","0.066377","0.066299","0.066358","0.185",1647245460000,"0.012274"]]

 

 

 

startTime , endTime 지정시 반환 특성  

 

예1.  startTime 과 endTime 이 캔들 시간격 차이를 두고 요청하면 반환 캔들은 startTime 에 해당하는 1개만 반환됨. (비교 : bybit 현물인 경우에는 캔들 2개 반환됨.) 

 

https://api.mexc.com/api/v3/klines?symbol=ETHBTC&interval=1m&startTime=1647244320000&endTime=1647244380000

 

요청응답 결과 

[[1647244320000,"0.066278","0.0663","0.06626","0.06626","0.037",1647244380000,"0.002452"]]

 

예2. 상기 예1에서 캔들 시간격 단위로 떨어지지 않는 시간차이를 endTime 으로 한 경우 endTime 이하인 시간의 캔들 포함되어 반환됨. 

 

https://api.mexc.com/api/v3/klines?symbol=ETHBTC&interval=1m&startTime=1647244320000&endTime=1647244381000

[[1647244320000,"0.066278","0.0663","0.06626","0.06626","0.037",1647244380000,"0.002452"],
[1647244380000,"0.06626","0.066279","0.066243","0.066264","0.017",1647244440000,"0.001126"]]

 

strtTime, endTime 사이의 캔들이 제한수량 초과시. 

- 요청시 limit 설정하지 않는 경우 기본 500 개 반환되며 , startTime 부터 500개의 캔들만 반환. 

- limit 로 설정가능한 최대수량은 1000. 

 

 

요청 응답 데이터 형식

- 요청실패시 , 심볼명이 틀린경우. 

{"msg":"Invalid symbol.","code":-1121,"_extend":null}

 

- 요청 성공시



[
  [
    1640804880000, 
    "47482.36", 
    "47482.36", 
    "47416.57", 
    "47436.1", 
    "3.550717", 
    1640804940000, 
    "168387.3"
  ]
]

 

Index Description
0 Open time . 단위 : 밀리 초. 
1 Open 
2 High
3 Low
4 Close
5 Volume
6 Close time 
7 Quote asset volume . 거래 금액 . 단위 : quote currency. BTC_USDT 이면 USDT 

 

 

연관

 

 

상위정리

 

암호화폐. MEXC. API 활용모음

현물 전 종목 정보 확보 암호화폐 . MEXC . API . 현물 . ETF . 종목 정보 확보 개요 - 암호화폐 거래소 MEXC 의 현물 종목들 ( 예 : BTC, ETH, XRP ,... )  rest api 로 종목 정보 확보. 동일 요청주소로 ETF..

igotit.tistory.com

 

 


첫 등록 : 2022.03.13

최종 수정 : 2022.03.14

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


 

댓글



 

비트코인




암호화폐       외환/나스닥/골드       암호화폐/외환/나스닥/골드 암호화폐/외환/나스닥/골드   암호화폐/외환/나스닥/골드
     
현물 |선물 인버스 |선물 USDT       전략매니저(카피트레이딩)     롤오버 이자 없는 스왑프리계좌
( 스왑프리 암호화폐도 거래 가능 )    
MT4, MT5 , cTrader 모두 지원     FTMO 계좌 매매운용. MT4,MT5