Skip to content

Conversation

@devin-ai-integration
Copy link
Contributor

Description

This PR adds a new documentation page explaining the price aggregation algorithm used by Pyth Pro (formerly Lazer). The page describes how Pyth Pro aggregates price data from multiple publishers to produce aggregate prices, best bid/ask spreads, and confidence intervals.

The page covers:

  • How publishers submit best bid, price, and best ask data
  • The calculation of aggregate price (median of all prices)
  • The calculation of aggregate best bid (max bid below aggregate price)
  • The calculation of aggregate best ask (min ask above aggregate price)
  • The confidence interval calculation (max distance to 25th/75th percentiles)
  • Design properties and an example scenario with calculations

Type of Change

  • New Page
  • Page update/improvement
  • Fix typo/grammar
  • Restructure/reorganize content
  • Update links/references
  • Other (please describe):

Areas Affected

  • pages/price-feeds/pro/price-aggregation.mdx (new file)
  • pages/price-feeds/pro/_meta.json (added navigation entry)

Checklist

  • I ran npm run lint to check for linting errors (passed with pre-existing warnings only)
  • I have reviewed my changes for clarity and accuracy
  • All links are valid and working (no external links added)
  • Images (if any) are properly formatted and include alt text (no images per user request)
  • Code examples (if any) are complete and functional (no code examples)
  • Content follows the established style guide
  • Changes are properly formatted in Markdown
  • Preview renders correctly in development environment (not tested locally)

Related Issues

Requested via Slack thread: https://dourolabs.slack.com/archives/C02HJ4TFLN8/p1762861551140699

Additional Notes

Important for Reviewers:

  1. Verify technical accuracy: The aggregation methodology was provided via Slack message. Please verify that the algorithm description matches the actual implementation, particularly:

    • The median calculation for aggregate price
    • The filtering logic for best bid/ask selection
    • The confidence interval calculation using 25th/75th percentiles
  2. Example scenario: The example with 5 publishers and BTC/USD prices includes manual calculations. Please verify these are mathematically correct.

  3. No images included: Per user request, this page does not include diagrams like the Pyth Core price aggregation page. Consider whether visual aids would improve clarity.

  4. Navigation placement: The page is added under "Understanding Pyth Pro" section after "How Pyth Pro Works". Confirm this is the appropriate location.

Contributor Information

@devin-ai-integration
Copy link
Contributor Author

Prompt hidden (unlisted session)

@devin-ai-integration
Copy link
Contributor Author

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

  • Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
  • Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

  • Disable automatic comment and CI monitoring

@vercel
Copy link

vercel bot commented Nov 11, 2025

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Preview Comments Updated (UTC)
docs Ready Ready Preview Comment Nov 11, 2025 0:21am
documentation Error Error Nov 11, 2025 0:21am

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants