Create a feed
Register a global or asset-scoped issuer-signed scalar data feed.
Once you have a scalar feed topic and a trusted issuer configured, you can register a data feed. Feeds can be global (market-wide data) or asset-scoped (data tied to a specific token).
Prerequisites
- Feeds manager role (
feedsManager) assigned on the System Access Manager - A scalar feed verification topic already created (see Create a topic)
- A trusted issuer configured for the topic (see Configure trusted issuers)
- For asset-scoped feeds: the target asset must already be deployed
Steps
Navigate to Data Feeds
Go to Platform Settings > Data Feeds in the sidebar. The page lists all registered feeds.
Select the feed scope
Choose the scope that matches your use case:
- Global - For market-wide data (BTC/USD, ETH/USD). The subject address is set to the zero address automatically.
- Asset-scoped - For data tied to a specific token. A Subject address selector appears where you select the target asset.
- Identity-scoped - For data tied to a specific identity. A Subject address selector appears where you select the target identity.
For asset-scoped feeds, select the asset from the dropdown. The dropdown lists all deployed assets with their name and contract address.
Configure feed properties
Fill in the remaining fields:
- Topic name - Select a scalar feed topic from the dropdown. Only topics with the
(int256 value)signature appear. - Source type - Choose Issuer-signed for EIP-712 signed submissions or Chainlink for external oracle integration.
- Decimals - Set the decimal precision (0-18). For USD prices, 8 decimals is common. For integer metrics, use 0.
- Description - Describe what the feed measures (e.g., "BTC/USD spot price from major exchanges").
Expand the Advanced options section to configure:
- History mode - Choose how past values are retained:
- Latest only - Keeps only the most recent value (default)
- Bounded - Keeps a fixed number of past values (specify History size)
- Full - Keeps all values permanently
- Require positive - Enable to reject zero or negative values
- Drift allowance - Maximum allowed time difference in seconds between the submitted
observedAttimestamp and the block timestamp. Set to0to disable.
Review and confirm
Click Continue to see the configuration summary. Review all properties carefully as they cannot be changed after deployment.
Click Register feed and enter your PIN to authenticate the transaction.
Verify the feed was created
After the transaction confirms, the new feed appears in the Data Feeds list. Click on the feed row to view its detail page with the full configuration and latest value.
Creating an asset-scoped feed
Asset-scoped feeds are tied to a specific deployed token and are used for asset-specific metrics like NAV, interest rates, or risk scores.
The process is the same as above, with one additional step: when you select Asset-scoped as the scope, a Subject address dropdown appears. Select the target asset from the list.
Asset must exist first
The target asset must already be deployed before you can create an asset-scoped feed for it. If you need to create an asset first, see Create asset.
Feed properties summary
All properties are immutable after deployment.
| Property | Required | Default | Notes |
|---|---|---|---|
| Scope | Yes | Global | Determines the subject address |
| Subject address | Only for asset/identity scopes | - | Auto-filled for global scope |
| Data format | Yes | Numeric (Scalar) | Only scalar is currently supported |
| Topic name | Yes | - | Must be a scalar feed topic |
| Source type | Yes | Issuer-signed | Chainlink requires an external oracle address |
| Decimals | Yes | 18 | Range: 0-18 |
| Description | Yes (issuer-signed) | - | Free text describing the feed |
| History mode | Yes | Latest only | Controls value retention |
| History size | Only for Bounded mode | - | Minimum: 1 |
| Require positive | No | Off | Rejects non-positive values |
| Drift allowance | No | 0 (disabled) | In seconds |
Troubleshooting
| Issue | Solution |
|---|---|
| Create feed button not visible | Verify you have the Feeds manager role on the System Access Manager |
| No topics in the dropdown | Create a scalar feed topic first (see Create a topic) |
| Continue button disabled | Ensure all required fields are filled (topic name and description are commonly missed) |
| Asset not in subject dropdown | Verify the asset is deployed; check under Asset management in the sidebar |
| Transaction fails | Check wallet gas balance and PIN/OTP configuration |
Next steps
After creating a feed, publish a feed update to submit the first value.