whatisgithub

What is polyrec?

txbabaxyz/polyrec — explained in plain English

Analysis updated 2026-05-18

★ 307PythonAudience · researcherComplexity · 3/5LicenseSetup · moderate

In one sentence

A terminal dashboard that tracks Polymarket's 15-minute Bitcoin prediction markets in real time and helps backtest trading strategies.

Mindmap

mindmap
  root((polyrec))
    What it does
      Live BTC dashboard
      Tracks 15 min markets
      Logs data to CSV
    Tech stack
      Python
      Node.js
      WebSocket feeds
    Use cases
      Strategy backtesting
      Order book monitoring
      Market research
    Audience
      Traders
      Researchers
      Quant hobbyists

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Watch live Bitcoin price feeds and Polymarket order book data side by side in a terminal.

USE CASE 2

Log every 15-minute prediction market to a CSV file with 70+ indicators for later analysis.

USE CASE 3

Backtest a balance replication or impulse fade trading strategy against past market data.

USE CASE 4

Research short-duration prediction market behavior using multiple synchronized price sources.

What is it built with?

PythonNode.jsWebSocket

How does it compare?

txbabaxyz/polyrecgair-nlp/livetalksimonlin1212/tradingagents-astock
Stars307310312
LanguagePythonPythonPython
Setup difficultymoderatehardmoderate
Complexity3/55/53/5
Audienceresearcherresearcherdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires both Python 3.10+ and Node.js, plus a live internet connection for WebSocket feeds.

So what is it?

Polyrec is a real-time terminal dashboard for watching and researching Polymarket's Bitcoin price prediction markets. Polymarket runs short-term betting markets where people wager on whether Bitcoin's price will be higher or lower than its current level at the end of a 15-minute window. This tool helps traders and researchers monitor those markets by pulling in live price data from multiple sources at the same time. The dashboard shows the current Bitcoin price from two independent feeds, a Chainlink oracle (a decentralized price reference) and Binance's live price stream, alongside the current order book from Polymarket, so you can see how much money is being bet on each outcome. It calculates over 70 technical indicators in real time, things like price volatility, volume spikes, and order book imbalance. All of this is automatically saved to CSV files for later analysis. Beyond live monitoring, the project includes backtesting scripts, which let you replay historical data and test whether a particular trading strategy would have made money in the past. You would use this if you are researching or actively trading these short duration prediction markets and want a consolidated view of all relevant data in one place. It is written in Python, requires a live internet connection, and also needs Node.js for one of the price feeds. The project also documents the exact data sources it connects to, including the Binance and Polymarket WebSocket endpoints and the Polymarket Gamma REST API, so you can see precisely where each number on the dashboard comes from. The CSV logs record dozens of columns per market, covering timestamps, prices, returns, volume, volatility, and multiple levels of order book depth for both the up and down sides of each bet. The README also includes basic troubleshooting steps for cases where the dashboard shows no data or the Chainlink feed stops updating.

Copy-paste prompts

Prompt 1
Help me set up polyrec's Python virtual environment and install its dependencies.
Prompt 2
Explain how polyrec combines Chainlink, Binance, and Polymarket data into one dashboard.
Prompt 3
Walk me through running the fade_impulse_backtest.py script on logged CSV data.
Prompt 4
Show me how to point polyrec's Chainlink feed script to the correct file path.
Prompt 5
How can I use the CSV logs from polyrec to analyze order book imbalance trends?

Frequently asked questions

What is polyrec?

A terminal dashboard that tracks Polymarket's 15-minute Bitcoin prediction markets in real time and helps backtest trading strategies.

What language is polyrec written in?

Mainly Python. The stack also includes Python, Node.js, WebSocket.

How hard is polyrec to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is polyrec for?

Mainly researcher.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.

What are similar repos?