Equities API 레퍼런스
REST와 MCP를 통한 일일 데이터와 USD 주식 8개를 위한 유료 WebSocket 스트림입니다.
작업
전송 Authorization: Bearer YOUR_API_KEY 대상 https://api.narwhalapi.com MCP는 다음에서 사용할 수 있습니다: /mcp 검색으로 반환된 실제 상품 ID를 사용하십시오.
| GET 경로 | MCP 도구 |
|---|---|
/v1/equities/instruments | equities_list_instruments |
/v1/equities/instruments/{instrument_id} | equities_get_instrument |
/v1/equities/instruments/{instrument_id}/bars | equities_get_bars |
curl "https://api.narwhalapi.com/v1/equities/instruments?symbol=AAPL" \
-H "Authorization: Bearer $NARWHAL_API_KEY"매개변수
검색에서는 선택 사항을 허용합니다 symbol, mic_code 및 country, 추가로 page (기본값 1) 및 outputsize (기본값 100, 최대 5,000).
막대 그래프에는 다음이 필요합니다 instrument_id 지원되는 값은 다음과 같습니다: interval=1day 및 adjust=splits 선택 사항 start_date 및 end_date YYYY-MM-DD를 사용하세요. outputsize 기본값은 30이며 최대 5,000입니다.
응답 및 제한
검색과 상세 조회는 다음을 반환합니다 count, data 및 status 각 상품에는 ID, 심볼, 이름, 통화, 거래소, MIC, 국가 및 보통주 유형이 포함됩니다.
막대 그래프는 다음을 반환합니다 meta, values 및 status 메타데이터에는 통화, 거래소 시간대 및 MIC가 포함됩니다. 값에는 다음이 포함됩니다: datetime, open, high, low, close 및 volume, 최신 항목부터 정렬됩니다. 가격과 거래량은 소수 문자열입니다.
REST 및 MCP 카탈로그는 승인된 종목 102개와 마감된 일일 세션을 지원합니다. 장중 바, 배당 및 펀더멘털은 이번 릴리스 범위 밖입니다. 성공한 REST 및 MCP 호출은 동일한 공유 할당량을 소비합니다.
방법론 및 데이터 범위 읽기 다음 항목: 런타임 OpenAPI 스키마 정확한 검증 및 오류 응답을 정의합니다.
시세 스트리밍 · Basic 및 Pro
연결 대상 wss://api.narwhalapi.com/v1/equities/stream 활성 Basic 또는 Pro Narwhal 키와 함께 사용합니다. 서버 클라이언트는 다음을 보냅니다 Authorization: Bearer YOUR_API_KEY WebSocket 업그레이드 중입니다. 이 프로토콜은 REST 및 MCP와 별개입니다.
지원 심볼은 다음과 같습니다 ADSK, ALL, APD, ASML, EBAY, DOW, KMX, DVA, USD로 표시됩니다. 일일 데이터 카탈로그가 스트리밍 커버리지를 의미하지는 않습니다.
다음을 기다리세요 ready 메시지인 다음 각 명령을 별도의 JSON 텍스트 프레임으로 보내세요:
{"action":"subscribe","symbols":["ADSK","ALL"]}
{"action":"unsubscribe","symbols":["ALL"]}
{"action":"ping"}시세에는 다음이 포함됩니다 symbol, currency, 소수 문자열 price, source_timestamp, received_at, delivered_at, source_age_seconds, stale 및 snapshot 해당 유형은 다음과 같습니다: quote. market_status 다음입니다 not_evaluated; 소스 연령이 60초를 초과하면 다음 상태가 설정됩니다: stale=true.
허용된 각 시세는 캐시된 스냅샷을 포함해 공유 월간 할당량 1단위를 소비합니다. 계정별 속도 및 버스트 제한도 적용됩니다. 동일한 시세를 받는 연결 2개는 2단위를 소비합니다. 명령에는 계량이 적용되지 않지만 세션당 최대 30개 명령, 2KiB 이하의 텍스트 프레임만 사용하세요.
각 계정은 동시에 2개의 연결을 열 수 있습니다. 세션은 최대 180초 동안 유지되며, 백오프 후 다시 연결하고 재구독하세요. 접근 권한 취소, 데이터 이용 불가, 할당량 소진 또는 느린 소비자가 연결을 닫습니다. 시세가 할당량을 소비한 뒤에도 전송이 실패할 수 있습니다.
현재 브라우저 연결은 다음만 허용합니다 https://narwhalapi.com origin입니다. 다음을 전송합니다 {"action":"auth","api_key":"YOUR_API_KEY"} 구독하기 전에 5초 이내에 수행합니다. 다른 브라우저 origin은 거부되므로 통합에는 서버 클라이언트를 사용하세요. 키를 URL에 넣거나 클라이언트 코드에 게시하지 마세요.