`@getdashfy/ext-market-live`

Market Live extension for Dashfy - Real-time prices from the Pyth Network oracle.

This extension provides widgets to display live prices for crypto, equities, commodities, forex, and rates, streamed straight from the Pyth Network oracle on Solana.

Features

📈 Live prices: Sub-second price updates streamed from the Pyth oracle
🌍 Five asset classes: Crypto, US equities, commodities, forex, and rates
📊 Real-time chart: Rolling price chart with 1m/5m/15m windows
📋 Multi-asset table: Track many feeds side by side in one widget
🔌 No API key: Connects directly to Pythnet, so there is nothing to configure
⚡ Shared connection: All widgets reuse a single WebSocket, however many you render
🎨 Theme support: Works with all Dashfy themes (light/dark mode)

Installation

Install with your favorite package manager:

`npm`

npm install @getdashfy/ext-market-live

`pnpm`

pnpm add @getdashfy/ext-market-live

`yarn`

yarn add @getdashfy/ext-market-live

`bun`

bun add @getdashfy/ext-market-live

Quick start

Unlike most Dashfy extensions, Market Live needs no server setup, API client, or token. The widgets open their own connection to Pythnet from the browser, so there are only two steps.

1. Client setup

Register Market Live widgets in your React application (App.tsx):

import { WidgetRegistry } from '@getdashfy/ui'
import { PriceLive, TableLive } from '@getdashfy/ext-market-live'

// Register Market Live extension
WidgetRegistry.addExtension('market-live', {
  PriceLive,
  TableLive,
})

2. Dashboard configuration

Add Market Live widgets to your dashboard configuration (dashfy.config.yml):

dashboards:
  - title: Markets Dashboard
    columns: 3
    rows: 2
    widgets:
      - extension: market-live
        widget: PriceLive
        feedId: crypto.BTC_USD
        x: 0
        y: 0
        columns: 2
        rows: 1

      - extension: market-live
        widget: TableLive
        subject: Watchlist
        x: 2
        y: 0
        columns: 1
        rows: 2

Feed identifiers

Every widget takes Pyth feeds by identifier, and resolvePythFeedId accepts three forms:

Form	Example	Notes
`category.key`	`equities.US_AAPL_USD`	Preferred, and unambiguous
Key only	`BTC_USD`	Category defaults to `crypto`
Base58 address	`GVXRSBjFk6e6J3NbVPXohDJetcTjaeeuykUpbQF8UoMU`	Any Pyth price account, even a new one

The five categories are crypto, equities, commodities, forex, and rates, covering roughly 2,900 feeds in total. Keys come from the Pyth symbol with the category prefix stripped and separators replaced by underscores, so Crypto.BTC/USD becomes crypto.BTC_USD and Equity.US.AAPL/USD becomes equities.US_AAPL_USD.

Browse the full list at pyth.network/developers/price-feed-ids, or import a catalog and inspect its keys:

import { PYTH_CRYPTO_FEEDS, PYTH_EQUITIES_FEEDS } from '@getdashfy/ext-market-live'

Object.keys(PYTH_CRYPTO_FEEDS) // ['1INCH_USD', 'AAVE_USD', 'ADA_USD', ...]

An unknown category or key throws, so a typo surfaces as a widget error rather than a silently blank price.

Available widgets

`PriceLive`

Display the live price of a single feed, with an optional rolling chart and trend arrow.

Parameters:

Parameter	Type	Required	Default	Description
`title`	string	no	"Price Live"	Custom widget title
`subject`	string	no	derived from feed	Custom widget subject
`locale`	string	no	"en-US"	Locale for price formatting
`feedId`	string	no	`crypto.BTC_USD`	Pyth feed identifier
`showChart`	boolean	no	`true`	Show the rolling price chart below the price
`showTrend`	boolean	no	`true`	Show the trend arrow next to the price
`showWindows`	boolean	no	`true`	Show the 1m/5m/15m time window buttons

When subject is omitted, the label is derived from feedId (crypto.BTC_USD becomes BTC/USD). A raw base58 address has no derivable label, so pass subject explicitly in that case.

Example:

- extension: market-live
  widget: PriceLive
  feedId: crypto.BTC_USD
  columns: 2
  rows: 1

Example (price only, no chart):

- extension: market-live
  widget: PriceLive
  subject: Gold
  feedId: commodities.XAU_USD
  showChart: false
  columns: 1
  rows: 1

`TableLive`

Display a table of live prices for many feeds at once, each row showing symbol, price, and trend.

Parameters:

Parameter	Type	Required	Default	Description
`title`	string	no	"Markets Live"	Custom widget title
`subject`	string	no	-	Custom widget subject
`locale`	string	no	"en-US"	Locale for price formatting
`feeds`	`TableLiveFeed[]`	no	see below	Feeds to display, one per row
`showTrend`	boolean	no	`true`	Show the trend arrow in the Price column

Each entry in feeds is an object with an id (any feed identifier) and an optional label. When label is omitted, the row falls back to the derived pair, then to the raw id.

The default feeds list is a broad market snapshot: Bitcoin, Ethereum, Solana, gold, silver, and the seven largest US tech equities.

Example:

- extension: market-live
  widget: TableLive
  subject: Crypto Watchlist
  feeds:
    - id: crypto.BTC_USD
      label: Bitcoin
    - id: crypto.ETH_USD
      label: Ethereum
    - id: crypto.SOL_USD
      label: Solana
  columns: 1
  rows: 2

Example (mixed asset classes):

- extension: market-live
  widget: TableLive
  subject: Macro
  feeds:
    - id: commodities.XAU_USD
      label: Gold
    - id: forex.EUR_USD
      label: Euro
    - id: equities.US_AAPL_USD
      label: Apple
  columns: 1
  rows: 2

Rows render as soon as any feed reports, so a slow feed shows a placeholder instead of blocking the whole table.

Programmatic API

The package also exports the Pyth plumbing behind the widgets, for building your own custom widgets on the same shared connection.

Export	Description
`subscribeToPrice(feedPublicKey, callback)`	Subscribe to a feed; the callback receives `(price, status)` per update
`unsubscribeFromPrice(feedPublicKey, callback)`	Remove a callback, tearing down the connection once the last one is gone
`getPythConnection()`	The shared `PythConnection`, or `null` before the first subscription
`resolvePythFeedId(value)`	Resolve any feed identifier to a Solana `PublicKey`
`getPythFeedDisplayPair(feedId)`	Human-readable pair for a feed (`crypto.BTC_USD` becomes `BTC/USD`)
`isPythErrorStatus(status)`	Whether a status means the price is unreliable
`PYTH_ERROR_STATUSES`	The statuses treated as errors
`PYTH_CRYPTO_FEEDS` and the four siblings	Feed catalogs keyed by symbol, one per category

import {
  PYTH_CRYPTO_FEEDS,
  subscribeToPrice,
  unsubscribeFromPrice,
} from '@getdashfy/ext-market-live'
import * as React from 'react'

const MyPriceWidget = () => {
  const [price, setPrice] = React.useState(0)
  const feedId = PYTH_CRYPTO_FEEDS.BTC_USD

  React.useEffect(() => {
    const handleUpdate = (newPrice: number) => setPrice(newPrice)

    subscribeToPrice(feedId, handleUpdate)

    return () => unsubscribeFromPrice(feedId, handleUpdate)
  }, [feedId])

  return <div>${price}</div>
}

All subscribers share one Solana RPC connection and one PythConnection. Connection rebuilds are debounced, so subscribing to many feeds in a loop triggers a single rebuild rather than one per feed.

Price statuses

Widgets surface the Pyth price status rather than guessing at stale data:

Live — price and confidence are available, so the value is rendered.
Connecting — the initial state before the first update arrives; widgets show a loader.
Halted, Auction, Ignored, Unknown — the price is unreliable and widgets show an error state.

Equity feeds are only Live during US market hours; outside them they report a non-trading status, which is expected rather than a failure.

Regenerating feed catalogs

The catalogs under src/lib/pyth-feeds/ are generated from the live Pythnet program accounts and are checked in, so no network access is needed at build or run time. To refresh them after Pyth adds feeds:

pnpm generate:feeds

The script rewrites one file per category plus an index barrel. The files carry an AUTO-GENERATED - DO NOT EDIT header; edit the generator at src/scripts/generate-pyth-feeds.ts instead.

Troubleshooting

Prices stay on "Connecting"

Solution: The widgets reach Pythnet over a WebSocket from the browser. Check that the network or a corporate proxy is not blocking the Pythnet RPC endpoint, and that no ad blocker is interfering with the connection.

"Unknown feed" or "Unknown feed category" error

Solution: Check the identifier against the feed identifier forms. Categories are crypto, equities, commodities, forex, and rates, and keys use underscores (BTC_USD, not BTC/USD).

An equity price shows an error state

Solution: Equity feeds only trade during US market hours and report Halted or Unknown outside them. Use a crypto feed to confirm the connection itself is healthy, since crypto trades continuously.

No subject label on a widget

Solution: A raw base58 feed address has no reverse lookup, so no label can be derived. Pass subject explicitly, or use the category.key form instead.

Contributing

Contributions are welcome. For issues and pull requests related to the extension, use the dashfy/dashfy-ext-market-live repository. Framework contributions belong in dashfy/dashfy.

Community

Join the community on Dashfy's Discord server to discuss the project, ask questions, or get help.

Join the conversation on X (Twitter) and follow @dashfydev for updates and announcements.

License

This project is licensed under the AGPL-3.0 License - see the LICENSE file for details.

Name		Name	Last commit message	Last commit date
Latest commit History 9 Commits
.changeset		.changeset
.github		.github
.husky		.husky
preview		preview
scripts		scripts
src		src
.editorconfig		.editorconfig
.gitignore		.gitignore
CHANGELOG.md		CHANGELOG.md
LICENSE		LICENSE
README.md		README.md
commitlint.config.mjs		commitlint.config.mjs
eslint.config.mjs		eslint.config.mjs
lint-staged.config.mjs		lint-staged.config.mjs
package.json		package.json
pnpm-lock.yaml		pnpm-lock.yaml
prettier.config.mjs		prettier.config.mjs
tsconfig.json		tsconfig.json
tsup.config.ts		tsup.config.ts
vitest.config.ts		vitest.config.ts
vitest.setup.ts		vitest.setup.ts

Navigation Menu

Uh oh!

Uh oh!

Repository files navigation

`@getdashfy/ext-market-live`

Features

Installation

`npm`

`pnpm`

`yarn`

`bun`

Quick start

1. Client setup

2. Dashboard configuration

Feed identifiers

Available widgets

`PriceLive`

`TableLive`

Programmatic API

Price statuses

Regenerating feed catalogs

Troubleshooting

Prices stay on "Connecting"

"Unknown feed" or "Unknown feed category" error

An equity price shows an error state

No subject label on a widget

Contributing

Community

License

About

Releases

Sponsor this project

Packages

Contributors

Languages

Uh oh!

Uh oh!

Folders and files

Latest commit

History

Repository files navigation

@getdashfy/ext-market-live

Features

Installation

npm

pnpm

yarn

bun

Quick start

1. Client setup

2. Dashboard configuration

Feed identifiers

Available widgets

PriceLive

TableLive

Programmatic API

Price statuses

Regenerating feed catalogs

Troubleshooting

Prices stay on "Connecting"

"Unknown feed" or "Unknown feed category" error

An equity price shows an error state

No subject label on a widget

Contributing

Community

License

About

Topics

Resources

Stars

Watchers

Forks

Releases

Sponsor this project

Packages

Contributors

Languages

`@getdashfy/ext-market-live`

`npm`

`pnpm`

`yarn`

`bun`

`PriceLive`

`TableLive`