# massive-com/client-python

The official Python client library for the Massive.com REST and WebSocket API.

Repository: https://github.com/massive-com/client-python
Canonical: https://ross.abutalabs.com/products/client-python
Homepage: https://massive.com/
Language: Python
License: MIT
License Family: permissive
Topics: client-python, polygon, websocket, python, api, stocks-api, realtime-stocks, stock-data, stock-prices, trading
Last push: 2026-07-09T15:25:39+00:00

## Health v2 (maintenance only)
Score: 91/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 91, release rhythm 86, longevity 100
- inputs: {"age_days": 2508, "days_push": 55, "days_rel": 99, "gap_med": 18, "n_releases_24m": 26}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1499, forks 360 (observed 2026-08-28T04:04:54.132914+00:00)

## What it is
The official Python client library for the Massive.com (formerly Polygon.io) REST and WebSocket APIs, providing access to stock, options, forex, crypto, and indices market data. It wraps API endpoints with typed methods, automatic pagination, and real-time streaming support.

## Use cases
- fetch historical stock price bars in python
- stream real-time stock trades and quotes via websocket
- get last trade and quote for a ticker
- download market data for backtesting strategies
- integrate polygon.io market data into a python app
- paginate through large trade datasets

## When to choose
- you need programmatic access to Massive/Polygon market data from Python
- you want automatic pagination and typed responses for REST endpoints
- you need real-time streaming market data in Python applications

## When to avoid
- you use another language like JavaScript, Go, or Java - use the official client for that language
- you need bulk historical datasets better served by Massive Flat Files
- you want an MCP/AI-agent integration rather than a Python SDK

## Facets
- artifact type: library
- maturity: active
- function: http-client, websocket, sdk, trading, streaming
- domain: fintech, apis, data-science, developer-tools
- platform: python, cross-platform
- tags: market-data, stocks, polygon-io, rest-api, realtime-data, financial-data, websocket-client

## Member repositories
- massive-com/client-python (main) score 91

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:54.132914+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-30T04:33:03.108712+00:00, confidence not recorded.
  - readme: https://github.com/massive-com/client-python (fetched 2026-08-28T04:04:54.132914+00:00, sha 85cf674cb857)
  - homepage: https://massive.com/ (fetched 2026-08-29T11:38:19.674007+00:00, sha c2c8032cee5b)
  - site_page: https://massive.com/docs/ai-tools/quickstart (fetched 2026-08-29T11:38:19.682959+00:00, sha 70e7a53fee5a)
  - site_page: https://massive.com/docs (fetched 2026-08-29T11:38:19.684730+00:00, sha b3dd18e6dd72)
  - site_page: https://massive.com/docs/flat-files/quickstart (fetched 2026-08-29T11:38:19.686189+00:00, sha e160588a4135)
  - site_page: https://massive.com/about (fetched 2026-08-29T11:38:19.687740+00:00, sha 35bb1d70e2b3)
- Data as of 2026-08-30T08:39:29.467469+00:00.
