시장 데이터 레퍼런스
시장 데이터 API
Finger Trader 시장 데이터 엔드포인트로 상품 목록, Ticker 상세, 검색 및 캔들 데이터를 조회할 수 있습니다. 실시간 시세와 호가 잔량은 인증된 WebSocket 채널로 전달됩니다.
문서 프레임워크 · 개요
용도에 맞는 시장 데이터 인터페이스 선택
상품 목록, Ticker 상세, 검색, 캔들 데이터처럼 요청/응답이 필요한 조회에는 REST를 사용하고, 구독형 실시간 시세와 호가 데이터에는 WebSocket을 사용합니다. 두 방식 모두 Finger Trader BFF 인터페이스입니다. Flutter 클라이언트는 HTTP 요청에 계정 Access Token을 넣고 소켓 연결 전에 단기 ticket을 받습니다.
지원 시장 목록응답의 data.market에는 해당 계정에 대해 브로커가 설정한 시장 유형이 포함됩니다.→지원 Ticker / Symbol페이지 단위 ticker-list 엔드포인트로 브로커가 이 계정에 설정한 Ticker와 Symbol을 조회합니다. 지원 시장 목록 API가 반환한 marketType을 선택하세요.→과거 시장 데이터REST K-line 엔드포인트로 과거 캔들 데이터를 요청합니다. 본문의 market 코드로 시장을 지정하며 interval과 제공 범위는 시장 및 브로커 설정에 따라 다릅니다.→실시간 시세인증된 시장 데이터 Socket에서 시세 업데이트를 구독합니다. 시장별 종목을 조회한 다음 ticker 식별자로 구독하세요.→호가 잔량인증된 시장 데이터 Socket에서 bid/ask 호가 잔량을 구독합니다. 지원 여부와 호가 단계 수는 브로커 및 시장 설정에 따라 달라집니다.→