자산 유형별 시장 순위
GET /v1/markets/movers: 자산 유형별로 주식 상승·하락·거래 활발 순위와 암호화폐 상승·거래대금·시가총액 순위를 반환합니다.
GET /v1/markets/movers
시장 개요 보드의 주요 순위를 반환합니다. class=stocks(기본값)는 Yahoo Finance 공개 프리셋 스크리너에서 주식 상승, 하락, 거래 활발 순위를 가져오며 Minara 인기 주식을 대체 데이터로 사용합니다. class=crypto는 24시간 상승, 24시간 거래대금, 시가총액 순위를 반환합니다. 무료 플랜은 CoinGecko Public을 우선 사용하고, 유료 플랜은 priceChange24H, volume24H, marketCap으로 정렬하는 세 개의 Minara /tokens/trending-tokens 요청을 병렬 실행하며 각 요청에 limit=30을 명시합니다. 우선 공급자의 순위가 10개 미만이거나 비어 있으면 다른 공급자에서 중복되지 않는 항목을 추가하고, 병합 결과를 해당 순위 지표로 다시 정렬해 상위 10개를 반환합니다. 암호화폐 클라이언트는 ranking=gainers, volume, marketCap 중 하나를 지정해 순위를 개별 로드할 수 있습니다. 시장 UI는 클라이언트에서 세 개의 Gateway 요청을 동시에 보내고 각 응답이 도착하는 즉시 독립적으로 렌더링합니다. ranking을 생략하면 기존 집계 응답을 반환합니다. 상승 순위에는 24시간 거래대금이 최소 50,000달러라는 조건이 적용되며, 세 암호화폐 순위 모두에서 스테이블코인과 토큰화 주식을 제외합니다. 이 API가 구성 자산과 순서를 결정하며 라이브 스트림은 행 가격만 갱신합니다. 주식 순위는 60초, 암호화폐 순위는 우선 공급자별로 120초 동안 캐시하며 진행 중인 동일 요청은 중복 제거합니다.
| 메서드 | GET |
| 경로 | /v1/markets/movers |
| 인증 | GATEWAY_AUTH_TOKEN이 설정된 경우 Authorization: Bearer <token> 필요 |
| 카테고리 | market |
응답 본문
{ "gainers": [{ "symbol": "TOKEN", "price": 1.23, "changePct": 12.5, "chainId": "1", "address": "0x...", "logoUrl": "https://..." }], "losers": [], "active": [], "volumeLeaders": [], "marketCapLeaders": [] }