MCP 도구
spectre-terminal-mcp 서버의 모든 도구: 하는 일, 받는 인자, 상태 변경 여부.
모든 도구
| 도구 | 접근 | 하는 일 |
|---|---|---|
account_overview | 읽기 전용 | 한 연결의 잔고, PnL이 포함된 열린 포지션, 미체결 주문 수입니다. |
leverage | 읽기 전용 | 종목의 레버리지, 최대 레버리지, 터미널의 레버리지 모드, 마진 모드입니다. |
open_orders | 읽기 전용 | 연결의 미체결 주문과 트리거 주문이며, 각각의 키와 거래소 id가 함께 옵니다. |
recent_fills | 읽기 전용 | 연결의 최근 체결 내역이며, 오래된 것부터 나열되고 매수와 매도 거래량 합계가 함께 옵니다. |
find_instrument | 읽기 전용 | 코인 또는 심볼의 정확한 종목 주소를 찾습니다. |
market_snapshot | 읽기 전용 | 최종 가격, 스프레드가 포함된 최우선 매수·매도 호가, 마크 가격, 24시간 변동과 거래량입니다. |
order_book_top | 읽기 전용 | 호가창의 상단 레벨이며, 방향별 거래량과 불균형이 함께 옵니다. |
recent_trades_summary | 읽기 전용 | 최근 체결의 매수·매도 거래량, 델타, VWAP, 가격 범위, 최대 단일 체결입니다. |
cluster_summary | 읽기 전용 | 버킷별 거래량 클러스터입니다. |
candles | 읽기 전용 | 인터벌의 OHLCV 봉이며, 최신 limit개의 봉을 오래된 것부터 나열합니다. |
settings | 읽기 전용 | 저장된 그대로의 설정 행이며, 각 행을 update_settings로 쓸 수 있는지 여부가 함께 옵니다. |
orderbook_settings | 읽기 전용 | 한 종목의 스택 설정이며, 해당 연결의 스택이 보는 그대로입니다. |
update_settings | 상태 변경 | 터미널의 설정 창이 하는 방식으로 설정을 씁니다. |
terminal_status | 읽기 전용 | Spectre Terminal이 실행 중인지 확인하고 거래소 연결을 나열합니다. |
place_order | 상태 변경 | 연결에 지정가 또는 시장가 주문을 넣습니다. |
cancel_order | 상태 변경 | 터미널의 키 또는 거래소의 id로 주문 하나를 취소합니다. |
cancel_all_orders | 상태 변경 | 이 연결에서 종목의 모든 미체결 주문을 취소합니다. |
close_position | 상태 변경 | 터미널 창이 하는 방식으로 종목의 포지션을 청산합니다. |
place_trigger | 상태 변경 | 창이 하는 방식으로 스톱로스, 테이크프로핏 또는 스톱을 넣습니다. |
cancel_trigger | 상태 변경 | open_orders에서 가져온 숫자 id로 트리거 주문 하나를 취소합니다. |
cancel_all_triggers | 상태 변경 | 종목의 모든 트리거 주문을 취소합니다. |
amend_trigger | 상태 변경 | 트리거를 새 가격으로 옮깁니다(취소한 뒤 다시 넣음). |
set_leverage | 상태 변경 | 창이 하는 방식으로 선물 종목의 레버리지를 설정합니다. |
set_margin_mode | 상태 변경 | 선물 종목의 마진 모드를 설정합니다. |
workspace | 읽기 전용 | 터미널의 모든 창과 그 탭, 스택(호가창), 차트입니다. |
open_stack | 상태 변경 | 종목의 스택을 새 탭 또는 새 창에서 열며, 선택적으로 차트도 엽니다. |
open_tab | 상태 변경 | 여러 종목으로 탭 하나를 엽니다. |
add_stacks | 상태 변경 | 기존 탭에 종목을 추가합니다. |
open_multiview | 상태 변경 | 멀티뷰 버튼이 하는 방식으로 «거래소 배치»의 모든 거래소에서 코인을 엽니다. |
set_stack_instrument | 상태 변경 | 스택(및 그 스택을 따르는 차트)을 다른 종목으로 전환합니다. |
close_stack | 상태 변경 | 스택 하나를 닫기 버튼과 같이 닫습니다. |
close_tab | 상태 변경 | 창의 탭을 닫습니다. |
activate_tab | 상태 변경 | 창에서 탭을 선택합니다. |
close_window | 상태 변경 | 창을 닫습니다. |
activate_window | 상태 변경 | 창이 최소화되어 있으면 복원하고 맨 앞으로 가져옵니다. |
계정
account_overview
읽기 전용
한 연결의 잔고, PnL이 포함된 열린 포지션, 미체결 주문 수입니다.
"이 계정이 무엇을 보유하고 있는가"에 답하는 가장 저렴한 방법입니다. 잔고와 체결 내역은 터미널이 API를 켠 시점부터 수집한 것이고, 포지션과 주문은 실시간 상태입니다.
| 매개변수 | 타입 | 설명 |
|---|---|---|
connection_id필수 | int | terminal_status에서 가져온 연결 id이며, 거래할 수 있어야 합니다(키 있음, 활성화됨) |
leverage
읽기 전용
종목의 레버리지, 최대 레버리지, 터미널의 레버리지 모드, 마진 모드입니다.
터미널의 캐시에서 읽습니다. 터미널이 아직 건드리지 않은 종목은
not_active로 응답합니다. 터미널에서 그 종목을 열거나
set_leverage로 레버리지를 설정합니다.
| 매개변수 | 타입 | 설명 |
|---|---|---|
connection_id필수 | int | terminal_status에서 가져온 연결 id이며, 거래할 수 있어야 합니다(키 있음, 활성화됨) |
instrument필수 | str | 선물 종목 주소 exchange:market:symbol |
open_orders
읽기 전용
연결의 미체결 주문과 트리거 주문이며, 각각의 키와 거래소 id가 함께 옵니다.
API로 넣은 주문을 취소하거나 place_order 뒤에 그 주문을 알아보려면
key(t-…)를 사용합니다.
| 매개변수 | 타입 | 설명 |
|---|---|---|
connection_id필수 | int | terminal_status에서 가져온 연결 id이며, 거래할 수 있어야 합니다(키 있음, 활성화됨) |
instrument선택 | str | None | 이 종목만(exchange:market:symbol); 생략하면 전체 |
recent_fills
읽기 전용
연결의 최근 체결 내역이며, 오래된 것부터 나열되고 매수와 매도 거래량 합계가 함께 옵니다.
체결 내역은 터미널이 API를 켠 시점부터 보관합니다(연결당 최근 1000건). 그 이전의 히스토리는 여기서 제공되지 않습니다.
| 매개변수 | 타입 | 설명 |
|---|---|---|
connection_id필수 | int | terminal_status에서 가져온 연결 id이며, 거래할 수 있어야 합니다(키 있음, 활성화됨) |
limit선택 | int | 반환할 최신 체결 내역 수 기본값: 20. |
since_ts선택 | int | None | 이 UTC 밀리초 타임스탬프 또는 그 이후의 체결 내역만 |
종목
find_instrument
읽기 전용
코인 또는 심볼의 정확한 종목 주소를 찾습니다.
터미널 연결의 카탈로그를 검색합니다. 연결 하나, 거래소 하나 또는
전체를 대상으로 하며, 가장 잘 맞는 결과부터 반환합니다: 정확한 심볼
또는 기준 코인, 다음으로 숫자 접두사 뒤에 같은 기준 코인이 있는
것(1000PEPE), 그다음으로 접두사 일치. 다른 모든 도구에서는 결과의
instrument 필드를 사용합니다.
| 매개변수 | 타입 | 설명 |
|---|---|---|
query필수 | str | 코인 또는 심볼의 일부이며 대소문자를 구분하지 않습니다: BTC, ETHUSDT, SOL-USDT |
exchange선택 | str | None | 소문자 거래소 이름: binance, bybit, okx, …; 생략하면 전체 |
market선택 | str | None | spot 또는 futures; 생략하면 둘 다 |
connection_id선택 | int | None | 한 연결만 검색(terminal_status에서 가져옴) |
limit선택 | int | 반환할 결과 수 기본값: 10. |
시장 데이터
market_snapshot
읽기 전용
최종 가격, 스프레드가 포함된 최우선 매수·매도 호가, 마크 가격, 24시간 변동과 거래량입니다.
"X가 지금 어디서 거래되고 있는가"에 답하는 가장 저렴한 방법입니다. 터미널이 아직 받지 못한 필드는 null입니다. 터미널에 열려 있지 않은 종목의 경우, 도구가 필드를 채우기 위해 한 번 잠시 기다립니다.
| 매개변수 | 타입 | 설명 |
|---|---|---|
instrument필수 | str | 종목 주소 exchange:market:symbol |
connection_id선택 | int | None | terminal_status에서 가져온 연결 id이며, 거래할 수 있어야 합니다(키 있음, 활성화됨) |
order_book_top
읽기 전용
호가창의 상단 레벨이며, 방향별 거래량과 불균형이 함께 옵니다.
imbalance는 반환된 레벨에 대한 (매수 거래량 - 매도 거래량) / (매수
거래량 + 매도 거래량)입니다. +1은 전부 매수 호가, -1은 전부 매도
호가입니다. 레벨은 [price, size] 쌍이며, 매수 호가는 최우선 가격부터
아래로, 매도 호가는 최우선 가격부터 위로 나열됩니다.
| 매개변수 | 타입 | 설명 |
|---|---|---|
instrument필수 | str | 종목 주소 exchange:market:symbol |
depth선택 | int | 각 방향의 레벨 수 기본값: 10. |
connection_id선택 | int | None | terminal_status에서 가져온 연결 id이며, 거래할 수 있어야 합니다(키 있음, 활성화됨) |
recent_trades_summary
읽기 전용
최근 체결의 매수·매도 거래량, 델타, VWAP, 가격 범위, 최대 단일 체결입니다.
터미널이 해당 종목에 대해 보관하는 최신 limit건의 체결을
요약합니다(최근 1000건을 보관합니다). 체결 자체는 반환되지
않습니다. span_ms는 이 묶음이 포괄하는 시간입니다.
| 매개변수 | 타입 | 설명 |
|---|---|---|
instrument필수 | str | 종목 주소 exchange:market:symbol |
limit선택 | int | 최신 체결 중 몇 건을 요약할지 기본값: 200. |
connection_id선택 | int | None | terminal_status에서 가져온 연결 id이며, 거래할 수 있어야 합니다(키 있음, 활성화됨) |
cluster_summary
읽기 전용
버킷별 거래량 클러스터입니다: 방향별 거래량, 델타, VWAP, 범위, 거래량이 가장 많은 가격 레벨.
버킷은 트레이더가 터미널에서 이 종목에 선택한 인터벌(기본값 5m)을
따릅니다. 가장 최신 버킷은 보통 아직 열려 있습니다(completed가
false). 터미널이 아직 계산하지 않던 종목은 요청 시 계산을 시작하고
히스토리로 채웁니다. 도구는 그 채워짐을 한 번 기다립니다.
| 매개변수 | 타입 | 설명 |
|---|---|---|
instrument필수 | str | 종목 주소 exchange:market:symbol |
buckets선택 | int | 반환할 최신 버킷 수 기본값: 3. |
top_levels선택 | int | 버킷당 가격 레벨 수, 거래량 기준 기본값: 5. |
connection_id선택 | int | None | terminal_status에서 가져온 연결 id이며, 거래할 수 있어야 합니다(키 있음, 활성화됨) |
candles
읽기 전용
인터벌의 OHLCV 봉이며, 최신 limit개의 봉을 오래된 것부터 나열합니다.
행은 columns 아래의 압축 배열입니다. ts는 봉의 시작 시각이고,
closed가 false이면 아직 형성 중인 봉입니다. 첫 행의 ts를
end로 전달하면 과거로 페이지를 넘깁니다.
| 매개변수 | 타입 | 설명 |
|---|---|---|
instrument필수 | str | 종목 주소 exchange:market:symbol |
interval선택 | str | 봉 인터벌: 1m, 5m, 15m, 30m, 1h, 4h, 1d, 1w, 1M 기본값: '1m'. |
limit선택 | int | 반환할 최신 봉 수 기본값: 50. |
end선택 | int | None | 오른쪽 경계, UTC 밀리초; 생략하면 현재 |
connection_id선택 | int | None | terminal_status에서 가져온 연결 id이며, 거래할 수 있어야 합니다(키 있음, 활성화됨) |
설정
settings
읽기 전용
저장된 그대로의 설정 행이며, 각 행을 update_settings로 쓸 수 있는지 여부가 함께 옵니다.
인수가 없으면 터미널 전체의 행(멀티뷰, 차트, 사운드, 단축키, …)입니다.
스택 하나의 설정을 그 스택이 보는 방식으로 해석한 것은
orderbook_settings입니다.
| 매개변수 | 타입 | 설명 |
|---|---|---|
scope선택 | str | None | global(기본값) 또는 order_book |
category선택 | str | None | 카테고리 필터 |
key선택 | str | None | 키 필터 |
connection_id선택 | int | None | 이 연결의 행; 없으면 앱 전체 |
instrument선택 | str | None | 이 페어의 행(범위 order_book) |
orderbook_settings
읽기 전용
한 종목의 스택 설정이며, 해당 연결의 스택이 보는 그대로입니다.
모든 키에는 값을 가져온 단계가 표시됩니다: 페어 자체의 행, 연결의 기본값, 연결이 없는 페어의 행, 또는 전역 기본값.
| 매개변수 | 타입 | 설명 |
|---|---|---|
connection_id필수 | int | terminal_status에서 가져온 연결 id |
instrument필수 | str | 종목 주소 exchange:market:symbol |
update_settings
상태 변경
터미널의 설정 창이 하는 방식으로 설정을 씁니다.
instrument가 있는 변경은 페어의 행을 쓰고, scope order_book에
connection_id가 있으면 연결의 기본값을, 둘 다 없으면 전역 기본값을
씁니다. 모든 변경은 먼저 검사되며, 알 수 없는 키, 잘못된 타입, 범위
초과, 잘못된 형태는 아무것도 쓰지 않은 채 해당 인덱스로 거부됩니다.
레버리지는 거부됩니다(set_leverage를 사용합니다). 처음 실패한
변경이 목록을 멈추고, 그 앞의 변경은 적용된 채로 남습니다.
| 매개변수 | 타입 | 설명 |
|---|---|---|
changes필수 | list[dict[str, Any]] | 순서대로 나열한 변경 목록; 각 항목에는 category, key, value가 있고, 선택적으로 scope(global 또는 order_book), instrument, connection_id가 있습니다 |
상태
terminal_status
읽기 전용
Spectre Terminal이 실행 중인지 확인하고 거래소 연결을 나열합니다.
터미널 버전, API 상태, 제공하는 스트림 토픽, 에이전트에게 중요한 제한, 그리고 모든 연결을 id, 거래소, 마켓, 상태와 함께 반환합니다. 세션이 시작될 때, 또는 다른 도구가 터미널에 연결할 수 없다고 보고할 때 이 도구를 먼저 호출합니다.
거래
place_order
상태 변경
연결에 지정가 또는 시장가 주문을 넣습니다. 응답은 "accepted"이며 "filled"가 아닙니다.
size(기준 코인)와 notional(호가 통화 금액) 중 정확히 하나만
지정합니다. 가격과 금액은 10진수 문자열입니다. 터미널은 전송 전에
거래소의 최솟값과 스텝을 검사하고, 맞지 않으면 사유와 함께
거부합니다. 반환된 key를 open_orders에서 지켜봅니다.
| 매개변수 | 타입 | 설명 |
|---|---|---|
connection_id필수 | int | terminal_status에서 가져온 연결 id이며, 거래할 수 있어야 합니다(키 있음, 활성화됨) |
instrument필수 | str | 종목 주소 exchange:market:symbol |
side필수 | str | buy 또는 sell |
order_type필수 | str | limit(가격 필요) 또는 market(가격 없음) |
client_key필수 | str | 이 의도에 대한 멱등성 키입니다. 예: 'rebalance-2026-11-03-1'. 같은 키로 재시도하면 이전 응답을 반환하고 아무것도 넣지 않습니다. |
price선택 | str | None | 지정가, 10진수 문자열 |
size선택 | str | None | 기준 코인 단위의 수량, 10진수 문자열 |
notional선택 | str | None | 호가 통화 금액, 10진수 문자열 |
reduce_only선택 | bool | 기존 포지션만 줄입니다 기본값: False. |
post_only선택 | bool | 유동성을 가져가는 대신 거부합니다 기본값: False. |
time_in_force선택 | str | None | gtc, ioc, fok 또는 post_only; 생략하면 거래소의 기본값 |
cancel_order
상태 변경
터미널의 키 또는 거래소의 id로 주문 하나를 취소합니다. "accepted"로 응답합니다.
| 매개변수 | 타입 | 설명 |
|---|---|---|
connection_id필수 | int | terminal_status에서 가져온 연결 id이며, 거래할 수 있어야 합니다(키 있음, 활성화됨) |
instrument필수 | str | 종목 주소 exchange:market:symbol |
order_id필수 | str | open_orders에서 가져온 터미널 키(t-…) 또는 거래소의 주문 id |
cancel_all_orders
상태 변경
이 연결에서 종목의 모든 미체결 주문을 취소합니다. "accepted"로 응답합니다.
| 매개변수 | 타입 | 설명 |
|---|---|---|
connection_id필수 | int | terminal_status에서 가져온 연결 id이며, 거래할 수 있어야 합니다(키 있음, 활성화됨) |
instrument필수 | str | 종목 주소 exchange:market:symbol |
close_position
상태 변경
터미널 창이 하는 방식으로 종목의 포지션을 청산합니다. "accepted"로 응답합니다.
선물: 포지션 전체에 대한 시장가 주문. 현물: 모든 주문 취소와 매도를 하나의 원자적 명령으로 처리. 열린 포지션이 없으면 거부됩니다.
| 매개변수 | 타입 | 설명 |
|---|---|---|
connection_id필수 | int | terminal_status에서 가져온 연결 id이며, 거래할 수 있어야 합니다(키 있음, 활성화됨) |
instrument필수 | str | 종목 주소 exchange:market:symbol |
place_trigger
상태 변경
창이 하는 방식으로 스톱로스, 테이크프로핏 또는 스톱을 넣습니다. "accepted"로 응답합니다.
반환된 key(sl_…, tp_…, stop_…)는 open_orders에서 트리거의
client_id로 나타납니다. 취소하거나 옮기려면 그곳의 숫자 id를
사용합니다. stop_loss/take_profit은 열린 포지션이 없으면
거부되고, 터미널에 트리거 주문이 없는 거래소에서는 unsupported로
거부됩니다.
| 매개변수 | 타입 | 설명 |
|---|---|---|
connection_id필수 | int | terminal_status에서 가져온 연결 id이며, 거래할 수 있어야 합니다(키 있음, 활성화됨) |
instrument필수 | str | 종목 주소 exchange:market:symbol |
kind필수 | str | stop_loss 또는 take_profit(열린 포지션에 걸리며 방향, 수량, 규칙을 포지션에서 가져옵니다) 또는 stop(자체 방향과 금액) |
trigger_price필수 | str | 트리거 가격, 10진수 문자열 |
client_key필수 | str | 이 의도에 대한 멱등성 키입니다. 같은 키로 재시도하면 이전 응답을 반환하고 아무것도 넣지 않습니다. |
side선택 | str | None | stop 전용: buy 또는 sell |
notional선택 | str | None | stop 전용: 호가 통화 금액, 10진수 문자열 |
rule선택 | str | None | stop 전용: price_above_or_equal 또는 price_below_or_equal; 생략하면 매수는 시장 가격 위, 매도는 시장 가격 아래 |
cancel_trigger
상태 변경
open_orders에서 가져온 숫자 id로 트리거 주문 하나를 취소합니다. "accepted"로 응답합니다.
| 매개변수 | 타입 | 설명 |
|---|---|---|
connection_id필수 | int | terminal_status에서 가져온 연결 id이며, 거래할 수 있어야 합니다(키 있음, 활성화됨) |
instrument필수 | str | 종목 주소 exchange:market:symbol |
trigger_id필수 | str | open_orders에서 가져온 트리거의 숫자 id |
cancel_all_triggers
상태 변경
종목의 모든 트리거 주문을 취소합니다. 일반 주문은 그대로 둡니다. "accepted"로 응답합니다.
| 매개변수 | 타입 | 설명 |
|---|---|---|
connection_id필수 | int | terminal_status에서 가져온 연결 id이며, 거래할 수 있어야 합니다(키 있음, 활성화됨) |
instrument필수 | str | 종목 주소 exchange:market:symbol |
amend_trigger
상태 변경
트리거를 새 가격으로 옮깁니다(취소한 뒤 다시 넣음). "accepted"로 응답합니다.
| 매개변수 | 타입 | 설명 |
|---|---|---|
connection_id필수 | int | terminal_status에서 가져온 연결 id이며, 거래할 수 있어야 합니다(키 있음, 활성화됨) |
instrument필수 | str | 종목 주소 exchange:market:symbol |
trigger_id필수 | str | open_orders에서 가져온 트리거의 숫자 id |
kind필수 | str | stop_loss, take_profit 또는 stop — 트리거의 유형 |
trigger_price필수 | str | 새 트리거 가격, 10진수 문자열 |
side선택 | str | None | stop 전용: buy 또는 sell |
rule선택 | str | None | stop 전용: price_above_or_equal 또는 price_below_or_equal |
set_leverage
상태 변경
창이 하는 방식으로 선물 종목의 레버리지를 설정합니다. "accepted"로 응답합니다.
leverage와 mode 중 정확히 하나만 지정합니다. 적용된 값은
거래소가 응답한 뒤 leverage로 읽습니다.
| 매개변수 | 타입 | 설명 |
|---|---|---|
connection_id필수 | int | terminal_status에서 가져온 연결 id이며, 거래할 수 있어야 합니다(키 있음, 활성화됨) |
instrument필수 | str | 종목 주소 exchange:market:symbol |
leverage선택 | int | None | 1 이상의 정수 레버리지; 또는 mode를 지정 |
mode선택 | str | None | max 또는 smart(터미널의 모드); 또는 leverage를 지정 |
set_margin_mode
상태 변경
선물 종목의 마진 모드를 설정합니다. "accepted"로 응답합니다.
창에서와 마찬가지로 포지션이 열려 있는 동안에는 거래소가 변경을 거부합니다. accepted 응답은 아직 그 사실을 알지 못합니다.
| 매개변수 | 타입 | 설명 |
|---|---|---|
connection_id필수 | int | terminal_status에서 가져온 연결 id이며, 거래할 수 있어야 합니다(키 있음, 활성화됨) |
instrument필수 | str | 종목 주소 exchange:market:symbol |
margin_mode필수 | str | cross 또는 isolated |
워크스페이스
workspace
읽기 전용
터미널의 모든 창과 그 탭, 스택(호가창), 차트입니다.
메인 창은 닫을 수 없습니다. 탭은 창마다 번호가 매겨지고, 스택과 차트의 위젯 id는 전역입니다. 워크스페이스 명령을 보내기 전에 이 도구를 먼저 읽습니다. id는 터미널을 실행할 때마다 달라집니다.
open_stack
상태 변경
종목의 스택을 새 탭 또는 새 창에서 열며, 선택적으로 차트도 엽니다.
창, 새 탭, 새 위젯 id로 응답합니다. 터미널의 카탈로그가 모르는
종목은 invalid_request입니다.
| 매개변수 | 타입 | 설명 |
|---|---|---|
instrument필수 | str | 종목 주소 exchange:market:symbol |
connection_id선택 | int | None | 연결; 공통 규칙이 하나를 선택합니다 |
chart선택 | bool | 스택 위에 차트를 엽니다 기본값: False. |
target선택 | str | new_tab(window_id 창 또는 포커스가 있는 창에) 또는 new_window 기본값: 'new_tab'. |
window_id선택 | int | None | 새 탭을 열 창 |
activate선택 | bool | False이면 탭을 백그라운드에서 엽니다; 새 창은 항상 포커스를 가져갑니다 기본값: True. |
open_tab
상태 변경
여러 종목으로 탭 하나를 엽니다: 항목마다 열 하나씩, 새 탭 또는 새 창에.
각 항목은 스택이며, chart가 있으면 그 위의 차트도 포함합니다.
항목은 1개에서 50개까지입니다. 창, 새 탭, 새 위젯 id를 열 순서대로
응답합니다. 거부 시에는 해당 항목을 알려 주며(items[1]: …)
아무것도 열리지 않습니다.
| 매개변수 | 타입 | 설명 |
|---|---|---|
items필수 | list[dict[str, Any]] | 순서대로 나열한 열 목록; 각 항목에는 instrument(exchange:market:symbol)가 있고, 선택적으로 connection_id와 chart(true이면 스택 위에 차트를 엽니다)가 있습니다 |
name선택 | str | None | 탭 이름, 최대 64자; None이면 종목 이름을 따릅니다 |
target선택 | str | new_tab(window_id 창 또는 포커스가 있는 창에) 또는 new_window 기본값: 'new_tab'. |
window_id선택 | int | None | 새 탭을 열 창 |
activate선택 | bool | False이면 탭을 백그라운드에서 엽니다; 새 창은 항상 포커스를 가져갑니다 기본값: True. |
add_stacks
상태 변경
기존 탭에 종목을 추가합니다: 탭의 마지막 열 뒤에 항목마다 열 하나씩.
탭은 이름과 열 너비를 그대로 유지합니다. 추가된 스택과 차트의 위젯
id만 응답합니다. 그런 창 또는 탭이 없으면 not_found입니다.
| 매개변수 | 타입 | 설명 |
|---|---|---|
window_id필수 | int | 워크스페이스 도구에서 가져온 창 id |
tab_id필수 | int | 워크스페이스 도구에서 가져온 탭 id; 탭은 창마다 번호가 매겨집니다 |
items필수 | list[dict[str, Any]] | 순서대로 나열한 열 목록; 각 항목에는 instrument(exchange:market:symbol)가 있고, 선택적으로 connection_id와 chart(true이면 스택 위에 차트를 엽니다)가 있습니다 |
open_multiview
상태 변경
멀티뷰 버튼이 하는 방식으로 «거래소 배치»의 모든 거래소에서 코인을 엽니다.
배치의 활성화된 행 중 어느 것도 그 코인을 포함하지 않으면 not_found입니다.
| 매개변수 | 타입 | 설명 |
|---|---|---|
base필수 | str | 코인(BTC) 또는 페어(BTC/USDT) |
target선택 | str | None | new_tab 또는 new_window; None이면 터미널 설정을 따릅니다 |
window_id선택 | int | None | 새 탭을 열 창 |
activate선택 | bool | False이면 탭을 백그라운드에서 엽니다; 새 창은 항상 포커스를 가져갑니다 기본값: True. |
set_stack_instrument
상태 변경
스택(및 그 스택을 따르는 차트)을 다른 종목으로 전환합니다.
| 매개변수 | 타입 | 설명 |
|---|---|---|
widget_id필수 | int | 워크스페이스 도구에서 가져온 스택 widget_id |
instrument필수 | str | 종목 주소 exchange:market:symbol |
connection_id선택 | int | None | 연결; 공통 규칙이 하나를 선택합니다 |
close_stack
상태 변경
스택 하나를 닫기 버튼과 같이 닫습니다. 차트 위젯 id는 invalid_request입니다.
| 매개변수 | 타입 | 설명 |
|---|---|---|
widget_id필수 | int | 워크스페이스 도구에서 가져온 스택 widget_id |
close_tab
상태 변경
창의 탭을 닫습니다. 창의 유일한 탭은 닫을 수 없습니다.
| 매개변수 | 타입 | 설명 |
|---|---|---|
window_id필수 | int | 워크스페이스 도구에서 가져온 창 id |
tab_id필수 | int | 워크스페이스 도구에서 가져온 탭 id; 탭은 창마다 번호가 매겨집니다 |
activate_tab
상태 변경
창에서 탭을 선택합니다. 창의 포커스는 바뀌지 않습니다(activate_window 참고).
| 매개변수 | 타입 | 설명 |
|---|---|---|
window_id필수 | int | 워크스페이스 도구에서 가져온 창 id |
tab_id필수 | int | 워크스페이스 도구에서 가져온 탭 id; 탭은 창마다 번호가 매겨집니다 |
close_window
상태 변경
창을 닫습니다. 메인 창은 거부됩니다: 닫으면 터미널이 종료되기 때문입니다.
| 매개변수 | 타입 | 설명 |
|---|---|---|
window_id필수 | int | 워크스페이스 도구에서 가져온 창 id |
activate_window
상태 변경
창이 최소화되어 있으면 복원하고 맨 앞으로 가져옵니다.
| 매개변수 | 타입 | 설명 |
|---|---|---|
window_id필수 | int | 워크스페이스 도구에서 가져온 창 id |
spectre-terminal-mcp 코드의 커밋 2d1c324에서 생성되었습니다.