> For the complete documentation index, see [llms.txt](https://docs.nexus.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nexus.xyz/api-reference/ko/guides/statistics.md).

# 거래소 통계

**이 페이지는 생성된 레퍼런스 페이지가 다룰 수 없는 내용을 다룹니다.** 세 작업은 각각 계약에서 렌더링된 자체 페이지가 있습니다. 이 페이지는 세 작업의 공통점, 즉 왜 공개되어 있는지, 수치가 무엇을 의미하는지, 그리고 그럴듯한 해석이 틀리는 세 가지 지점을 다룹니다.

거래소 전체의 집계 텔레메트리: 누적 거래량, 미결제약정, 계정 잔액 분포. **세 가지 작업이며 모두 공개입니다.** `security: []`를 선언하므로 API 키가 필요하지 않습니다.

이는 거래소 전체의 수치입니다. 계정별 상태는 레퍼런스 사이드바의 Account 페이지와 Positions 페이지에 있습니다.

## 구조상 집계 데이터

이 페이지의 모든 스키마는 **계정별 데이터를 전혀 담지 않는** 것으로 문서화되어 있습니다: *"Aggregate only — it carries no account id, address, or per-account volume by construction."*(집계 전용이며, 구조상 계정 ID, 주소, 계정별 거래량을 담지 않습니다.) 이는 계약 자체의 문구이며, Account의 모든 엔드포인트가 비공개인 반면 이 엔드포인트들이 공개인 이유입니다.

공개 대시보드, 시장 데이터 페이지, 또는 거래소 맥락이 필요한 에이전트를 구축한다면 **이 엔드포인트를 사용하십시오.** 계정별 조회를 여러 번 호출해서 거래소 집계를 도출하지 마십시오.

## 이 페이지의 작업

| 작업                                                                                      | 경로                                | 반환 내용                     |
| --------------------------------------------------------------------------------------- | --------------------------------- | ------------------------- |
| [누적 거래량](https://docs.nexus.xyz/api-reference/statistics/fetch-cumulative-volume)(영어)   | `GET /stats/volume`               | 누적 체결 명목 가치, 거래소 합계 및 시장별 |
| [미결제약정](https://docs.nexus.xyz/api-reference/statistics/fetch-open-interest)(영어)        | `GET /stats/open-interest`        | 미결제약정, 롱과 숏을 따로 보고        |
| [잔액 분포](https://docs.nexus.xyz/api-reference/statistics/fetch-balance-distribution)(영어) | `GET /stats/balance-distribution` | 잔액 구간별 계정 수               |

**두 개의 `/stats` 작업은 다른 곳에 문서화되어 있습니다.** `GET /stats`(거래소 스냅숏)와 `GET /stats/history`(처리량 샘플)는 계약에서 `Markets` 태그가 붙어 있으며 [`GET /stats`](https://docs.nexus.xyz/api-reference/markets/fetch-stats)(영어)에서 다룹니다. 다섯 개 모두 공개입니다.

여기의 세 작업에는 `/api/v1` 쌍둥이 경로가 없습니다. 게이트웨이 경로로만 제공됩니다.

## 테스트넷 데이터는 예시이며, 계약이 응답 안에서 이를 밝힙니다

세 응답 모두 제거하지 말고 표시해야 하는 두 개의 필드를 담고 있습니다.

| 필드        | 의미                                                                   |
| --------- | -------------------------------------------------------------------- |
| `testnet` | boolean, 현재 **항상 `true`**. 데이터는 예시입니다.                               |
| `note`    | 사람이 읽을 수 있는 고지 문구로, 미결제약정의 단측 대 총합(one-sided versus gross) 경고를 포함합니다 |

이 수치는 전체 기간 원장이 아니라 인덱서 로컬 프로젝션이므로 **서비스가 재시작되면 함께 초기화됩니다**. 거래량 응답의 `coverage_start_ms`는 합계가 얼마나 과거까지 거슬러 올라가는지 알려 줍니다.

## 소수는 문자열입니다

모든 명목 가치 수치는 문자열로 직렬화된 무손실 소수입니다([`Decimal`](https://docs.nexus.xyz/api-reference/guides/schemas#decimal)(영어) 스키마). **부동소수점이 아니라 반드시 decimal 타입으로 파싱하십시오.** `account_count`와 `count`는 JSON 정수이며, 타임스탬프는 Unix epoch 밀리초입니다([`TimestampMs`](https://docs.nexus.xyz/api-reference/guides/schemas#timestampms)(영어)).

## 양측은 미리 합산되지 않으며, 이름은 의도적입니다

이 엔드포인트의 숫자에 설명을 붙이기 전에 이 내용을 읽으십시오.

* **설명에 쓸 수치는 `long_oi_quote`(또는 `short_oi_quote`)입니다.** 매칭된 오더북에서는 구조상 두 값이 같습니다. 차이가 계속된다면 프로젝션이 엔진과 동기화되지 않은 것입니다.
* **`gross_oi_two_sided_quote`는 `long + short`입니다.** 단측 수치의 두 배입니다. 누구도 이를 단측 합계로 오인해 내세울 수 없도록 `gross`와 `two_sided`라는 이름을 붙였습니다.
* **거래소 수치는 호가 통화 기준으로만 제공됩니다.** 거래소 전체의 기초 자산 단위 합계는 의도적으로 없습니다. 기초 자산 단위는 시장 간에 합산되지 않으므로, 계약은 일관된 단위가 없는 숫자를 게시하지 않습니다.

## 관련 항목

* [`GET /stats`](https://docs.nexus.xyz/api-reference/markets/fetch-stats)(영어): `GET /stats`와 `GET /stats/history`, 그리고 시장별 요약 및 리스크 파라미터.
* 레퍼런스 사이드바의 Tickers 페이지: 시장별 24시간 이동 가격 및 거래량 통계.
* [스키마](https://docs.nexus.xyz/api-reference/guides/schemas)(영어): 컴포넌트 스키마 레퍼런스.

## 미해결 질문

채우지 않고 표시만 해 둔 계약의 공백:

* **하위 객체의 범위 타입에 대한 스키마가 선언되어 있지 않습니다.** `BalanceBucket.min`과 `max`는 설명은 있지만 계약에 선언된 타입이 없습니다. 이 페이지는 "in USDX collateral"(USDX 담보 기준)이라는 설명과 페이지 전체의 소수 규칙에 근거해 이를 소수 문자열로 문서화합니다.
* **`testnet`은 boolean으로 타입이 지정되어 있지만 "always `true`"(항상 `true`)로 문서화되어 있습니다.** 이 값이 `false`가 되는 배포 환경에서의 동작은 명시되어 있지 않으며, 어떤 배포 환경과 통신하고 있는지 알려 주는 작업도 없습니다.
* **보존 기간이 명시되어 있지 않습니다.** 세 작업 모두 서비스와 함께 재시작된다고 설명되어 있지만, 계약은 보존 기간, 버퍼 크기, 체크포인트 주기를 제공하지 않습니다. 따라서 계약만으로는 `coverage_start_ms`가 얼마나 과거까지 거슬러 올라갈 수 있는지 알 수 없습니다.
* **`quote_error` 값이 열거되어 있지 않습니다.** 본문은 세 가지 원인(미러링된 마크 가격 없음, 오래된 마크 가격, 오버플로)을 설명하지만 문자열을 명시하지 않으므로, 이 값으로 안전하게 분기할 수 없습니다.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.nexus.xyz/api-reference/ko/guides/statistics.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.