HTTP API시장 데이터
거래량 클러스터
요청 만들기
값을 바꾸면 명령이 함께 바뀝니다. 토큰은 여기에 입력하지 않습니다. 명령은 SPECTRE_LOCAL_API_TOKEN 환경 변수에서 토큰을 읽습니다. 자신의 터미널에서 실행하세요.
명령
curl 'http://127.0.0.1:48180/v1/market/clusters?instrument=binance:futures:BTCUSDT' \ -H "Authorization: Bearer $SPECTRE_LOCAL_API_TOKEN"
GET
최신 클러스터 버킷 최대 10개이며, 오래된 것부터 나열됩니다. 인터벌은 터미널에서 해당 종목에 선택된 것이며 기본값은 5m입니다. 터미널에 열려 있지 않은 종목의 경우, 첫 호출이 계산을 시작하고 히스토리를 최대 3초 기다립니다.
bearerToken market:readheader
인증Bearer <token>Local API 토큰입니다: spt_와 16진수 문자 64개. Settings App → 일반 → Local API에서 복사합니다. Authorization 헤더로만 받습니다. 작업에 나열된 이름은 그 작업에 필요한 권한입니다. 터미널의 토큰에는 모든 권한이 있습니다.
권한: market:read
instrument*string종목 주소, exchange:market:symbol.
connection_id?integer데이터를 읽을 때 거칠 연결입니다. 지정하지 않으면 터미널은 해당 거래소와 마켓의 활성화된 거래 연결을 사용하고, 없으면 읽기 전용 연결을 사용합니다.
형식
int64최신 버킷입니다.
application/json- response
instrument*stringconnection_id*integer형식
int64interval*string터미널에서 해당 종목에 선택된 인터벌입니다.
ts*integer형식
int64data*array<>curl 'http://127.0.0.1:48180/v1/market/clusters?instrument=binance:futures:BTCUSDT' \ -H "Authorization: Bearer $SPECTRE_LOCAL_API_TOKEN"응답 예제
{ "instrument": "binance:futures:BTCUSDT", "connection_id": 12, "interval": "5m", "ts": 1730294400123, "data": [ { "interval": "5m", "ts": 1730294100000, "end_ts": 1730294400000, "volume": "12.5", "buy_volume": "7.25", "sell_volume": "5.25", "trades": 120, "vwap": "67000.1", "min_price": "66990.0", "max_price": "67010.5", "completed": false, "last_trade_ts": 1730294399870, "levels": [ { "price": "67000.1", "volume": "1.25", "buy_volume": "0.75", "sell_volume": "0.5", "buy_trades": 3, "sell_trades": 2 } ] } ]}