MINARA

캔들 이력

지정한 자산과 주기의 캔들 이력을 조회합니다.

GET /v1/market/candles

체인과 주소를 모두 지정하면 Token Story를 사용하고 startTime/endTime을 Unix 밀리초로 전달합니다. 같은 이름의 다른 자산으로 전환하지 않습니다. 정상적인 빈 이력은 candles=[]를, 공급자 요청 실패나 잘못된 응답은 HTTP 502를 반환합니다. 다른 요청은 Binance/Yahoo 경로를 유지하며 기존 Minara 분석 데이터는 실제 주기인 4h를 요청할 때만 사용합니다.

GATEWAY_AUTH_TOKEN 설정 시 Authorization: Bearer <token>이 필요합니다

참고

현물 차트는 minara-discover와 같이 token-info.exchangeMarketPair로 TradingView 임베드 차트를 설정하고 다른 온체인 자산은 Token Story 캔들을 사용합니다. 네이티브 코인은 symbol로 메타데이터를 조회하며 거래용 래핑 토큰 주소로 차트를 선택하지 않습니다. 시세 및 차트 요청에는 referenceDataSource/sourceRef가 필요하지 않으며 자산 일치는 백엔드 식별 정보로 확인합니다. TradingView iframe은 이 API에 구조화된 OHLCV를 반환하지 않습니다. Token Story는 1m, 5m, 15m, 1h, 4h, 12h, 1d, 3d, 1w를 지원합니다. 무기한 선물은 Hyperliquid/Lighter의 독립적인 데이터 경로를 유지합니다.

목차