marketDataDocsPage.restInstruments
지원 Ticker / Symbol
페이지 단위 ticker-list 엔드포인트로 브로커가 이 계정에 설정한 Ticker와 Symbol을 조회합니다. 지원 시장 목록 API가 반환한 marketType을 선택하세요.
POST /app-api/v1/market/ticker-list
이 엔드포인트는 페이지 단위 목록을 반환합니다. page(Flutter 클라이언트는 1부터 시작)와 pageSize를 설정하고, query.marketType으로 시장을 필터링합니다. query.brokerId는 선택 항목입니다. 응답에는 해당 페이지의 data.total과 data.items가 포함됩니다. 최대 페이지 크기와 종목 범위는 브로커/서비스 설정에 따라 달라집니다.
POST /app-api/v1/market/ticker-list
{ "page": 1, "pageSize": 20, "query": { "marketType": <marketType from overview>, "brokerId": null } }ticker-list: page, pageSize, query.marketType, query.brokerId응답 형식 예시
앱은 표준 API 응답 래퍼와 total, items가 포함된 페이지 데이터를 파싱합니다. 예시는 클라이언트에서 확인된 필드이며 일부 값은 비어 있거나 생략될 수 있습니다.
{
"code": 0,
"data": {
"total": 1,
"items": [
{ "ticker": "<TICKER>", "symbol": "<SYMBOL>", "name": "<DISPLAY_NAME>" }
]
}
}각 시장에서 실제로 설정되고 제공되는 Ticker / Symbol은 브로커가 결정합니다. Finger Trader는 브로커가 특정 시장의 모든 Ticker / Symbol을 지원한다고 보장할 수 없습니다. 종목 범위와 이용 가능 여부는 브로커에 확인하세요.
REST 요청 테스트
Access Token을 입력하고 요청 필드를 수정하세요. 요청을 보내면 브라우저에서 선택한 Finger Trader 공식 BFF 환경으로 직접 전송됩니다.
POST /app-api/v1/market/ticker-list
준비되었습니다. 요청 보내기를 누르기 전까지 전송되지 않습니다.
응답이 여기에 표시됩니다.
Access Token은 이 페이지 메모리에만 보관되며 브라우저 저장소나 Finger Trader 웹사이트 서버로 전송되지 않습니다. 요청 버튼을 누른 후 선택한 공식 API 환경으로만 전송됩니다.
CORS 또는 네트워크 오류가 표시되면 이 웹사이트 출처의 요청이 허용되지 않을 수 있습니다. 승인된 서버 측 클라이언트를 사용하고 브라우저 보안을 해제하지 마세요.
POST /app-api/v1/market/ticker-detail
ticker, market, brokerId로 상품 상세를 조회합니다. 서비스가 반환하는 경우 시세 값과 거래 파라미터도 클라이언트 모델에서 처리합니다.
POST /app-api/v1/market/ticker-detail
{ "ticker": "<broker-configured ticker>", "market": <marketType from overview>, "brokerId": null }REST 요청 테스트
Access Token을 입력하고 요청 필드를 수정하세요. 요청을 보내면 브라우저에서 선택한 Finger Trader 공식 BFF 환경으로 직접 전송됩니다.
POST /app-api/v1/market/ticker-detail
준비되었습니다. 요청 보내기를 누르기 전까지 전송되지 않습니다.
응답이 여기에 표시됩니다.
Access Token은 이 페이지 메모리에만 보관되며 브라우저 저장소나 Finger Trader 웹사이트 서버로 전송되지 않습니다. 요청 버튼을 누른 후 선택한 공식 API 환경으로만 전송됩니다.
CORS 또는 네트워크 오류가 표시되면 이 웹사이트 출처의 요청이 허용되지 않을 수 있습니다. 승인된 서버 측 클라이언트를 사용하고 브라우저 보안을 해제하지 마세요.
POST /app-api/v1/market/search-ticker
keyword, page, pageSize로 상품을 검색하며, 클라이언트는 Ticker 항목 목록으로 응답을 처리합니다.
POST /app-api/v1/market/search-ticker
{ "keyword": "EURUSD", "page": 1, "pageSize": 20 }REST 요청 테스트
Access Token을 입력하고 요청 필드를 수정하세요. 요청을 보내면 브라우저에서 선택한 Finger Trader 공식 BFF 환경으로 직접 전송됩니다.
POST /app-api/v1/market/search-ticker
준비되었습니다. 요청 보내기를 누르기 전까지 전송되지 않습니다.
응답이 여기에 표시됩니다.
Access Token은 이 페이지 메모리에만 보관되며 브라우저 저장소나 Finger Trader 웹사이트 서버로 전송되지 않습니다. 요청 버튼을 누른 후 선택한 공식 API 환경으로만 전송됩니다.
CORS 또는 네트워크 오류가 표시되면 이 웹사이트 출처의 요청이 허용되지 않을 수 있습니다. 승인된 서버 측 클라이언트를 사용하고 브라우저 보안을 해제하지 마세요.
아래 값은 Flutter 클라이언트에 정의된 marketType enum이며 브로커가 활성화한 시장 목록이 아닙니다. 실제 지원 범위는 계좌 및 연결 설정에 따라 달라지므로 브로커에 지원 시장 목록을 요청하세요. REST 시장 필터와 과거 데이터 요청에는 해당 코드를 지정하고, WebSocket은 해당 시장에서 브로커가 설정한 ticker를 확인한 뒤 구독합니다. ticker-list로 반환 종목을 확인할 수 있지만 결과가 비어 있다고 미지원으로 단정할 수는 없습니다.