본문으로 건너뛰기
HTTP API서비스

API 버전, 빌드 및 제한

요청 만들기

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

명령
curl 'http://127.0.0.1:48180/v1/meta' \
  -H "Authorization: Bearer $SPECTRE_LOCAL_API_TOKEN"
GET
/meta

API 버전, 터미널 빌드, 토큰의 권한, 제한, 스트림의 토픽입니다. 시장 데이터 없이 빌드된 터미널은 workspace와 settings만 topics에 나열합니다. 이 경우 시장 토픽과 시장 작업은 unsupported로 응답합니다.

인증

bearerToken
header인증Bearer <token>

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

응답 본문

이 터미널에 대한 설명입니다.

application/json
  1. response
api_version*string

v1에서는 항상 1입니다.

app_version*string

터미널의 버전입니다.

build_hash*string
build_env*string

production 또는 development.

features*string

빌드의 Cargo 피처를 하나의 문자열로 나타냅니다.

scopes*array<>

토큰의 권한입니다.

limits*
topics*array<string>

이 빌드가 제공하는 스트림 토픽입니다.

요청 예제
curl 'http://127.0.0.1:48180/v1/meta' \  -H "Authorization: Bearer $SPECTRE_LOCAL_API_TOKEN"
응답 예제
{  "api_version": "1",  "app_version": "2.0.0",  "build_hash": "3f1c2ab",  "build_env": "production",  "features": "local-api",  "scopes": [    "market:read",    "connections:read",    "account:read",    "trading:write",    "workspace:read",    "workspace:write",    "settings:read",    "settings:write"  ],  "limits": {    "ws_connections_per_token": 8,    "subscriptions_per_connection": 100,    "api_only_instruments": 50,    "exchange_subscriptions_per_second": 5,    "commands_per_second": 10,    "workspace_commands_per_second": 5,    "settings_commands_per_second": 5  },  "topics": [    "trades",    "ticker",    "mark_price",    "book.top",    "clusters",    "account.orders",    "account.positions",    "account.balances",    "account.fills",    "workspace",    "settings"  ]}