feat: Mock Data SDK & Contributor Infrastructure#1
Merged
e35ventura merged 3 commits intomainfrom Feb 26, 2026
Merged
Conversation
- Generate mock data from all 10 Synth API endpoints across 9 assets (73 JSON files covering prediction percentiles, volatility, option pricing, liquidation, LP bounds, LP probabilities, polymarket, and leaderboard) - Add dual-mode SynthClient wrapper (auto-detects mock vs live mode via SYNTH_API_KEY env var) - Add tool template under tools/_template/ with example main.py and tests - Add GitHub Actions workflow for automated mock tests on every PR - Add comprehensive test suite (76 tests, all passing) - Rewrite README with getting started guide, endpoint reference table, asset/horizon compatibility matrix, and PR lifecycle docs - Add .gitignore and requirements.txt
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
This PR adds the complete contributor infrastructure for building hackathon tools without needing a Synth API key.
What's Included
1. Mock Data Bank (73 JSON files)
Real API responses fetched from all 10 Synth endpoints across all 9 supported assets (BTC, ETH, SOL, XAU, SPY, NVDA, TSLA, AAPL, GOOGL). Organized per-endpoint under
mock_data/.2. Dual-Mode SDK Wrapper (
synth_client/)SYNTH_API_KEYenv var is set → hits the real APImock_data/with a warning3. Tool Template (
tools/_template/)Starter kit with example
main.py,requirements.txt,README.mdtemplate, andtests/directory. Contributors copy this to start.4. GitHub Actions CI (
pr_mock_tests.yml)Runs automatically on every PR. Discovers all tools, installs their deps, runs pytest in mock mode. Zero API calls.
5. Test Suite (76 tests)
Comprehensive parameterized tests covering all endpoints × all assets × both horizons. All passing in 0.08s.
6. README Rewrite
Full getting started guide, endpoint reference table with asset/horizon compatibility, project structure diagram, and PR lifecycle documentation.
API Compatibility Notes Discovered
1hhorizon only works for crypto (BTC, ETH, SOL) and XAU — equities are 24h onlyAPI Budget Impact