# warproxxx/poly_data

Polymarket Data Retriever that fetches, processes, and structures Polymarket data including markets, order events and trades.

Repository: https://github.com/warproxxx/poly_data
Canonical: https://ross.abutalabs.com/products/poly_data
Language: Python
License: GPL-3.0
License Family: copyleft
Last push: 2026-06-29T22:10:34+00:00

## Health v2 (maintenance only)
Score: 57/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 90, release rhythm 35, longevity 23
- inputs: {"age_days": 334, "days_push": 65, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2304, forks 440 (observed 2026-08-28T04:06:35.678659+00:00)

## What it is
A Python data pipeline that fetches, processes, and structures Polymarket trading data. It streams order events from the Polymarket CTF Exchange V2 contract on Polygon via Envio HyperSync, joins them with market metadata from the CLOB API, and writes structured trades to CSV.

## Use cases
- fetch polymarket trading data to csv
- backfill historical polymarket order fill events from polygon
- download polymarket market and trade history for analysis
- export structured prediction market trade data
- analyze polymarket CLOB order events
- replace the deprecated polymarket subgraph data pipeline

## When to choose
- You need complete, resumable backfills of Polymarket trades and order events sourced directly from on-chain logs rather than a deprecated subgraph
- You want structured CSV files of trades joined with market metadata for offline analysis
- You need incremental updates that keep a local Polymarket dataset current

## When to avoid
- You need to place orders or execute trades on Polymarket - this only retrieves data, it is not a trading bot
- You need data from prediction markets other than Polymarket
- You want a hosted API or dashboard - you must run the pipeline yourself and supply an Envio HyperSync token

## Facets
- artifact type: cli-tool
- maturity: active
- function: etl, streaming, trading, csv, analytics
- domain: blockchain, analytics, fintech
- platform: python, cross-platform, cli
- tags: polymarket, prediction-markets, on-chain-data, hypersync, polygon, data-pipeline, market-data, backfill, trading-data, order-events, cryptocurrency, data-engineering

## Member repositories
- warproxxx/poly_data (main) score 57

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:35.678659+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:39:53.646435+00:00, confidence not recorded.
  - readme: https://github.com/warproxxx/poly_data (fetched 2026-08-28T04:06:35.678659+00:00, sha 8ae7874efb71)
- Data as of 2026-08-30T08:39:29.467469+00:00.