MINARA

암호화 자산 백엔드 시세

백엔드 /assets/quote에서 통합 시세를 조회합니다.

GET /v1/quote/crypto/:symbol

백엔드 /assets/quote에서 암호화 자산 시세를 조회합니다. Agent는 /assets/resolve로 assetId를 확인한 후 정확한 자산을 요청합니다. referenceDataSource/sourceRef는 필요하지 않으며 CMC 또는 CoinGecko를 직접 호출하지 않습니다. 지정된 체인과 주소가 일치하지 않으면 asset_not_found, 스냅샷이 없거나 요청이 실패하면 사용 불가 상태를 반환합니다.

GATEWAY_AUTH_TOKEN이 설정된 경우 Authorization: Bearer <token>이 필요합니다.

{"connected": true, "supported": true, "assetId": "crypto:bitcoin", "symbol": "BTC", "source": "minara", "price": 78000.12, "price_change_24h_pct": 1.2, "currency": "USD", "asOf": "2026-09-14T08:00:00.000Z", "retrievedAt": "2026-09-14T08:00:05.000Z", "coverage": {"status": "partial", "sources": ["hyperliquid_snapshot"], "stale": false, "dataAgeMs": 5000, "reason": "partial_coverage", "missing": []}}

참고

Gateway와 AI get_price는 동일한 조회 서비스와 5초 백엔드 스냅샷 캐시를 공유합니다. 계정이나 백엔드가 변경되면 캐시를 삭제합니다. coverage는 실제 소스, 누락 필드와 오래된 데이터 상태를 유지하며 Hyperliquid 표시 가격이 소스일 수도 있습니다. asOf는 백엔드 주 가격의 시각이고 retrievedAt는 로컬 조회 시각입니다. 가격 API는 가격과 24시간 등락률만 담당합니다. USD 거래대금, 시가총액, FDV 및 유동성은 /v1/markets/crypto/stats로 별도 조회하고 가격이 없어도 유지합니다. 고정 거래소, 주식, 캔들은 기존 경로를 유지합니다.

가격은 백엔드에서 조회합니다. 24시간 등락률은 백엔드 값을 우선하고 누락 시 /v1/markets/crypto/stats에서 동일 자산의 Token Info를 사용합니다. 실제 0을 유지합니다.

목차