본문으로 건너뛰기
HTTP API설정

종목의 호가창 설정

요청 만들기

값을 바꾸면 명령이 함께 바뀝니다. 토큰은 여기에 입력하지 않습니다. 명령은 SPECTRE_LOCAL_API_TOKEN 환경 변수에서 토큰을 읽습니다. 자신의 터미널에서 실행하세요.

명령
curl 'http://127.0.0.1:48180/v1/settings/orderbook?connection_id=12&instrument=binance:futures:BTCUSDT' \
  -H "Authorization: Bearer $SPECTRE_LOCAL_API_TOKEN"
GET
/settings/orderbook

이 연결의 스택이 보는 그대로의 종목 호가창 설정이며, 카테고리와 키별로 정리됩니다. 값은 그 값이 있는 첫 번째 위치에서 가져옵니다: 연결에 있는 페어의 행, 연결의 기본값, 연결이 없는 페어의 행, 전역 기본값. resolved_from은 그 위치를 알려 줍니다.

인증

bearerToken settings:read
header인증Bearer <token>

Local API 토큰입니다: spt_와 16진수 문자 64개. Settings App → 일반 → Local API에서 복사합니다. Authorization 헤더로만 받습니다. 작업에 나열된 이름은 그 작업에 필요한 권한입니다. 터미널의 토큰에는 모든 권한이 있습니다.

권한: settings:read

쿼리 매개변수

connection_id*integer

종목의 연결입니다.

형식int64
instrument*string

종목 주소, exchange:market:symbol.

응답 본문

data[category][key].

application/json
  1. response
connection_id*integer
형식int64
instrument*string
data*

카테고리입니다.

요청 예제
curl 'http://127.0.0.1:48180/v1/settings/orderbook?connection_id=12&instrument=binance:futures:BTCUSDT' \  -H "Authorization: Bearer $SPECTRE_LOCAL_API_TOKEN"
응답 예제
{  "connection_id": 12,  "instrument": "binance:futures:BTCUSDT",  "data": {    "general": {      "auto_scroll": {        "value": false,        "resolved_from": "global",        "writable": true      }    },    "trading": {      "slippage": {        "value": {          "value": "0.1",          "type": "percent"        },        "resolved_from": "instrument",        "writable": true      }    }  }}

설정 변경 PATCH

한 요청에 변경을 최대 100개까지 담을 수 있습니다. 먼저 모든 변경을 검사한 뒤 순서대로 적용합니다. 적용에 실패한 변경이 있으면 목록은 거기서 멈추고, 응답은 그 번호를 알려 줍니다: `changes[2]: …`. 이미 적용된 변경은 되돌리지 않습니다. 변경의 대상은 다음과 같이 지정합니다: - `scope`의 기본값은 `global`입니다. `instrument`가 있으면 항상 `order_book`입니다. - `instrument`는 페어의 행을 가리킵니다. 이때 `connection_id`는 공통 규칙에 따라 선택됩니다. - `order_book`에 `instrument`가 없으면 `connection_id`는 해당 연결의 기본값을 가리킵니다. 그것도 없으면 변경은 전역 기본값에 적용됩니다. - `connection_id`는 `global`에서 받지 않습니다. 일부 키는 고유한 방식으로 처리됩니다. `appearance/theme`는 `stack`, `graphic`, `interface` 중 임의의 부분 집합을 담은 객체를 받습니다. 각 값은 테마 이름이며, `graphic`과 `interface`는 `light`와 `dark`만 받습니다. `hotkeys_*`는 `{ "code", "modifiers" }` 또는 `null`을 받습니다. 다른 동작이 쓰고 있는 조합은 거부됩니다. `appearance/font_family`와 `localization/current_language`도 고유한 방식으로 처리됩니다. 제한은 모든 클라이언트를 합산하여 초당 요청 5개입니다.

WebSocket 스트림

시장 데이터, 계정, 창 레이아웃, 설정을 하나의 연결로 받습니다.