> For the complete documentation index, see [llms.txt](https://docs.chiliz.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.chiliz.com/ko/gaebal/goseup/on-chain-gaseukaemul-pidi.md).
# 온체인 가격 피드 조회
Chiliz Chain은 스마트 컨트랙트에 신뢰할 수 있고 변조 방지된 자산 가격을 직접 제공하는 온체인 기관급 가격 피드 시스템을 제공합니다. 이 시스템은 **Chainlink AggregatorV3Interface**를 구현하므로, 이미 Chainlink 데이터 피드와 통합된 dApp은 최소한의 변경으로 연결할 수 있습니다.
가격 데이터는 여러 주요 중앙화 거래소에서 수집되고, VWAP(거래량 가중 평균 가격)로 집계되며, 이상값이 필터링된 후 완전히 자동화된 고빈도 파이프라인을 통해 허가된 서명자에 의해 온체인에 게시됩니다.
## 작동 방식
오라클 시스템은 검증된 가격을 온체인 컨트랙트에 지속적으로 게시하는 3단계 오프체인 파이프라인으로 구축됩니다.
```mermaid
flowchart LR
subgraph pipeline["Off-chain Pipeline"]
direction LR
FETCHER --> AGGREGATOR --> SIGNER
end
SIGNER --> pricefeed["Chiliz Chain\nPriceFeed Contracts"]
```
**1단계: Fetcher**\
WebSocket 스트림(Binance, Bybit, Bitget, Mexc, OKX, BingX)과 REST 폴링(Binance, Bybit, Bitget, Gate, Coinex), 그리고 서브그래프 쿼리(FanX)를 통해 중앙화 거래소에서 실시간 시장 데이터를 수집합니다. 수집된 모든 가격은 내부 캐시에 저장되어 Aggregator에서 사용할 수 있게 됩니다.
**2단계: Aggregator**\
유동성이 높은 거래소에 더 많은 가중치를 부여하는 VWAP 계산을 적용한 후 이상값을 필터링합니다. 다음 두 가지 규칙에 따라 온체인 업데이트 제출 여부를 결정합니다:
* **편차 임계값**: 집계된 가격이 마지막 온체인 값으로부터 설정된 비율(예: 0.5%)을 초과하여 변동한 경우 업데이트가 제출됩니다.
* **Heartbeat**: 가격이 편차 임계값을 초과하여 변동하지 않더라도 최대 시간 간격이 경과하면 강제로 업데이트됩니다. 이를 통해 피드가 절대 오래된 상태가 되지 않도록 보장합니다.
**3단계: Signer**\
Aggregator로부터 검증된 가격 작업을 수신하고 기관급 서명 솔루션인 Fireblocks를 통해 온체인에 제출합니다. Signer는 Aggregator가 가격 준비 완료를 알릴 때만 동작합니다.
## 컨트랙트 시스템
| 컨트랙트 | 역할 |
| ----------------------- | --------------------------------------------------------------------------- |
| **PriceFeed** | 거래 쌍별 하나의 컨트랙트. dApp이 읽는 컨트랙트입니다. Chainlink AggregatorV3Interface를 구현합니다. |
| **OracleFactory** | 레지스트리 및 관리자. 쌍 심볼(예: `"PSG/USDT"`)에서 오라클 주소로의 권위 있는 매핑을 보유합니다. |
| **OracleFactoryReader** | 읽기 전용 편의 컨트랙트. 모든 활성 오라클 주소 조회, 여러 쌍 해석, 또는 단일 호출로 시스템 전반의 상태 확인 기능을 제공합니다. |
오라클 컨트랙트는 [Halborn](https://www.halborn.com/audits/chiliz/oracle-contracts-40e905)의 감사를 받았습니다(2026년 1월).
## 컨트랙트 주소
Mainnet 및 Testnet 네트워크 파라미터는 [RPC로 연결](/ko/gaebal/gibon/chiliz-chain-yeongyeol/rpc-yeongyeol.md)에서 확인할 수 있습니다.
{% tabs %}
{% tab title="Chiliz Chain Mainnet" %}
Contract
Address
OracleFactory
Coming soon...
OracleFactoryReader
Coming soon...
{% endtab %}
{% tab title="Spicy Testnet" %}
Contract
Address
OracleFactory
0x824A1C121DD4baeA7f074f829294Af7DD10D9723
OracleFactoryReader
0x8908cd1586e90b399Dbc160Be98396172ef2F378
{% endtab %}
{% endtabs %}
[Price Oracle Tracker](https://price-oracle-tracker.vercel.app/?network=mainnet)에서 실시간 가격, decimals, heartbeat 파라미터, 개별 컨트랙트 주소와 함께 모든 사용 가능한 쌍을 확인할 수 있습니다.
---
# 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.chiliz.com/ko/gaebal/goseup/on-chain-gaseukaemul-pidi.md?ask=&goal=
```
`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.