개요
- 암호화폐 거래소 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개 반환됨.)
요청응답 결과
[[1647244320000,"0.066278","0.0663","0.06626","0.06626","0.037",1647244380000,"0.002452"]]
예2. 상기 예1에서 캔들 시간격 단위로 떨어지지 않는 시간차이를 endTime 으로 한 경우 endTime 이하인 시간의 캔들 포함되어 반환됨.
[[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
'트레이딩 > 암호화폐' 카테고리의 다른 글
| 암호화폐 . MEXC . API . 선물 . 웹소켓. 실시간 캔들 K-line (0) | 2022.03.15 |
|---|---|
| 암호화폐 . MEXC . API . 선물 . 캔들 확보 (0) | 2022.03.14 |
| 암호화폐 . MEXC . API . 선물 . 종목 정보 확보 (0) | 2022.03.11 |
| 암호화폐 . MEXC . API . 현물 . ETF . 종목 정보 확보 (0) | 2022.03.10 |
| 거래소. bybit. 바이빗. 개요. 가입방법. 암호화폐 (1) | 2022.03.04 |
댓글