# PriceFeed Store

> Markdown export of the Gearbox Protocol documentation page for agents and retrieval systems.

Canonical page: https://docs.gearbox.finance/developers/gp-pricefeed-store
Source file: content/developers/gp-pricefeed-store.mdx
Section router: https://docs.gearbox.finance/developers/llms.txt
Section full export: https://docs.gearbox.finance/developers/llms-full.txt

The PriceFeed Store (PFS) is a marketplace that links tokens with their approved price feeds, serving as the canonical registry that market curators draw from when configuring markets.

## Purpose

Price feeds are critical infrastructure — a malicious or misconfigured feed can directly threaten user funds. The PFS exists to provide a vetted catalog of token-to-feed mappings, reducing the risk of both intentional attacks and accidental misconfiguration.

| Goal | How PFS Achieves It |
| --- | --- |
| **Prevent malicious feeds** | Only Instance Owners can add or update feed entries |
| **Mitigate misconfiguration** | Curators select from pre-approved options rather than supplying arbitrary addresses |
| **Maintain neutrality** | Instance Owners must remain impartial regarding price feed brands |

## How It Works

Market curators do not interact with the PFS directly at runtime. Instead, they select assets and feeds from the PFS when composing a market configuration transaction. Once that transaction executes, the market's oracle references are set independently of the PFS.

```mermaid
flowchart LR
    IO[Instance Owner] -->|"approves feeds"| PFS[PriceFeed Store]
    PFS -->|"curators select from"| TX[Configuration Transaction]
    TX -->|"sets oracles in"| Market[Market]
```

### Key Properties

- **Snapshot, not live link** — after a market configurator transaction executes, the market no longer relies on the PFS. Removing an asset or feed from the PFS will not affect any existing market.
- **Instance Owner controlled** — only the Instance Owner multisig can add, update, or remove entries. The DAO cannot modify PFS contents directly.
- **Approval, not endorsement** — Instance Owners approve feeds as valid (not malicious), but are not responsible for the correctness of the underlying price data.

## Management

| Action | Who Can Perform It |
| --- | --- |
| Add a token/feed mapping | Instance Owner |
| Update an existing mapping | Instance Owner |
| Remove a mapping | Instance Owner |
| Use an approved feed in a market | Market Curator |

## Fixed Address

The PFS has a deterministic, fixed address on every chain where Gearbox is deployed. The current registry of instances and their addresses is available at:

[https://permissionless.gearbox.foundation/instances](https://permissionless.gearbox.foundation/instances)

## Learn More

- [Roles & Permissions](https://docs.gearbox.finance/developers/gp-roles) — Full breakdown of Instance Owner authority and other governance roles
- [Omni-EVM & Instances](https://docs.gearbox.finance/developers/gp-instances) — How per-chain instances operate independently
- [Treasury & Insurance](https://docs.gearbox.finance/developers/gp-treasury) — Fee collection and distribution mechanics
