암호화폐 . 게이트아이오 . API . 선물 . 체결 데이터 확보

 

 

 

요청주소 

 

 

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"
  }
]

 

 

 

상위정리 

 

암호화폐. gate.io API 활용모음

 

 

 

 

 

---

첫 등록 : 2022.08.07

최종 수정 : 2022.08.17

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

 

---