HTTP API시장 데이터
종목 목록 조회
요청 만들기
값을 바꾸면 명령이 함께 바뀝니다. 토큰은 여기에 입력하지 않습니다. 명령은 SPECTRE_LOCAL_API_TOKEN 환경 변수에서 토큰을 읽습니다. 자신의 터미널에서 실행하세요.
명령
curl 'http://127.0.0.1:48180/v1/instruments?exchange=binance&market=futures&q=btc&limit=50' \ -H "Authorization: Bearer $SPECTRE_LOCAL_API_TOKEN"
GET
한 거래소와 마켓의 종목 카탈로그이며, 심볼 순으로 정렬된 페이지 단위로 반환됩니다. connection_id를 전달하거나 exchange와 market을 함께 전달합니다. 스텝과 최솟값은 거래소가 알려 주지 않으면 null입니다.
bearerToken market:readheader
인증Bearer <token>Local API 토큰입니다: spt_와 16진수 문자 64개. Settings App → 일반 → Local API에서 복사합니다. Authorization 헤더로만 받습니다. 작업에 나열된 이름은 그 작업에 필요한 권한입니다. 터미널의 토큰에는 모든 권한이 있습니다.
권한: market:read
connection_id?integer목록을 조회할 거래소와 마켓을 가리키는 연결입니다.
형식
int64exchange?string거래소 이름입니다. market과 함께 사용합니다.
market?string마켓 유형입니다. exchange와 함께 사용합니다.
q?string심볼 또는 기준 코인의 일부입니다. 대소문자는 구분하지 않습니다.
limit?integer페이지 크기입니다. 범위를 벗어난 값은 범위 안으로 조정됩니다.
범위
1 <= value <= 2000기본값
500cursor?string이전 페이지의 next_cursor입니다.
카탈로그의 한 페이지입니다.
application/json- response
exchange*stringmarket*stringdata*array<>next_cursor*|다음 페이지를 요청할 때 cursor로 전달합니다. 마지막 페이지에서는 null입니다.
curl 'http://127.0.0.1:48180/v1/instruments?exchange=binance&market=futures&q=btc&limit=50' \ -H "Authorization: Bearer $SPECTRE_LOCAL_API_TOKEN"응답 예제
{ "exchange": "binance", "market": "futures", "data": [ { "instrument": "binance:futures:BTCUSDT", "exchange": "binance", "market": "futures", "symbol": "BTCUSDT", "base": "BTC", "quote": "USDT", "status": "active", "tick_size": "0.1", "lot_size": "0.001", "min_size": "0.001", "contract_value": "1" } ], "next_cursor": null}