요청주소
GET /futures/{settle}/trades
full url : https://fx-api.gateio.ws/api/v4/futures/{settle}/trades
BTC_USDT 최신 체결데이터 요청 예.
- {settle} 에는 usdt 소문자로 기록해야하며, 대문자로 기록하면 오류 반환.
- 인자 limit 지정하지 않으면 최신 50개 반환됨. limit 지정시 최대 1000개까지 요청 가능. 1000 초과하여 요청하면 에러 반환.
https://fx-api.gateio.ws/api/v4/futures/usdt/trades?contract=BTC_USDT
BTC_USDT 요청 최신체결데이터 1개 요청 예.
https://fx-api.gateio.ws/api/v4/futures/usdt/trades?contract=BTC_USDT&limit=1
요청인자
Name | In | Type | Required | Description |
settle | path | string | true | Settle currency |
contract | query | string | true | Futures contract |
limit | query | integer | false | Maximum number of records to be returned in a single list |
last_id | query | string | false | Specify the starting point for this list based on a previously retrieved id |
from | query | integer(int64) | false | Specify starting time in Unix seconds. If not specified, to and limit will be used to limit response items. |
to | query | integer(int64) | false | Specify end time in Unix seconds, default to current time |
응답 데이터
[
{
"id": 121234231,
"create_time": 1514764800,
"contract": "BTC_USDT",
"size": -100,
"price": "100.123"
}
]
주의
1. 문서상의 응답데이터 에는 create_time 이 초단위 시간처럼 표시되어있으나, 실제 제공되는 데이터는 소수점이하 3자리 추가된 밀리초 단위의 값으로 제공됨.
2. 문서에는 create_time_ms 설명 없는데, 실 수신 데이터에는 create_time_ms 항목도 있고, 소수점 이하 3자리까지 표현된 밀리초 단위 제공됨.
3. 여러 개의 데이터 요청시 시간적으로 최신의 것이 리스트의 앞부분에 배치되어 있음.
최종 정확한 응답데이터 형식은 아래임.
응답 데이터 - 정확한것.
[
{
"id": 121234231,
"create_time_ms": 1514764800.678, // 밀리초 단위.
"create_time": 1514764800.678, // 밀리초 단위.
"contract": "BTC_USDT",
"size": -100, // 음수 : 매도, 양수 : 매수.
"price": "100.123"
}
]
상위정리
첫 등록 : 2022.08.07
최종 수정 : 2022.08.17
단축 주소 : https://igotit.tistory.com/3735
'트레이딩 > 암호화폐' 카테고리의 다른 글
bybit . MetaTrader 4 . Strategy Tester 오류해결 tester cannot calculate prices (1) | 2022.09.11 |
---|---|
아비 페어 , 3각 가능성 확인 (0) | 2022.08.25 |
암호화폐 . 게이트아이오. API . 현물. 실시간 호가 (0) | 2022.05.08 |
암호화폐 . 게이트아이오. API . 현물. 실시간 시세 (0) | 2022.05.08 |
암호화폐 . 게이트아이오. API . 현물. 웹소켓 공통 사항 (0) | 2022.05.08 |
댓글