거래소 통계

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

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

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

구조상 집계 데이터

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

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

이 페이지의 작업

작업

경로

반환 내용

누적 거래량(영어)

GET /stats/volume

누적 체결 명목 가치, 거래소 합계 및 시장별

미결제약정(영어)

GET /stats/open-interest

미결제약정, 롱과 숏을 따로 보고

잔액 분포(영어)

GET /stats/balance-distribution

잔액 구간별 계정 수

두 개의 /stats 작업은 다른 곳에 문서화되어 있습니다. GET /stats(거래소 스냅숏)와 GET /stats/history(처리량 샘플)는 계약에서 Markets 태그가 붙어 있으며 GET /stats(영어)에서 다룹니다. 다섯 개 모두 공개입니다.

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

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

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

필드

의미

testnet

boolean, 현재 항상 true. 데이터는 예시입니다.

note

사람이 읽을 수 있는 고지 문구로, 미결제약정의 단측 대 총합(one-sided versus gross) 경고를 포함합니다

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

소수는 문자열입니다

모든 명목 가치 수치는 문자열로 직렬화된 무손실 소수입니다(Decimal(영어) 스키마). 부동소수점이 아니라 반드시 decimal 타입으로 파싱하십시오. account_count와 count는 JSON 정수이며, 타임스탬프는 Unix epoch 밀리초입니다(TimestampMs(영어)).

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

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

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

미해결 질문

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

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

이전포트폴리오 및 계정 상태

다음오류

마지막 업데이트 9일 전