API

The POLTRACK public API provides programmatic access to Polygon PoS economic data, validator analytics, and staking metrics derived from on-chain reads.

Status — Public API is currently in private development. Endpoints below reflect the planned interface at api.poltrack.tech. This page will be updated when the API opens for public use.

What the API will expose

• POL economics — current supply, 24h/30d mint, 24h/30d burn, net issuance, annualized inflation, deflationary status.
• Fee flow — base-fee burn per day, priority-fee accrual and distribution (PIP-65 batches, 74%/26% split, per-batch totals).
• Staking — total staked POL, staking share of net supply, per-validator stake, commission, delegator counts, modeled APR components.
• Validators — full registry with POLTRACK Score, tags, performance index, checkpoint participation, stake trend, and 30-day stake change.
• Validator detail — per-validator PIP-65 income history, staker metrics (HHI, top-1 share, churn, retail/whale counts), and on-chain addresses.

Access model

• Public tier — open, rate-limited, no authentication. Best for low-volume integrations, dashboards, and research.
• Service tier — authenticated with a service token for higher rate limits and guaranteed SLAs.

Data freshness

• Economics snapshots — refreshed hourly during normal operations.
• Fee batches — updated within 15 minutes of on-chain finalization.
• Validator metrics — recomputed daily from checkpoint and staking contract reads.
• POLTRACK Score — recomputed when any component (performance, stake, commission, decentralization) changes materially.

Response format

All endpoints return JSON. Numeric POL amounts are returned as decimal strings with fixed precision (18 decimals where applicable) to preserve exactness across language boundaries. USD values are returned as floating-point numbers. Timestamps are ISO 8601 UTC.

Rate limits

Public tier rate limits are documented in response headers:

• X-RateLimit-Limit — requests per window
• X-RateLimit-Remaining — requests remaining in current window
• X-RateLimit-Reset — Unix timestamp when the window resets

Usage and attribution

API responses are covered by the POLTRACK Data License. You may reuse them for commercial and non-commercial purposes with clear attribution to POLTRACK and a link back to poltrack.tech or the relevant endpoint.

Changelog and notices

• Breaking changes will be announced via a versioned endpoint path (/v2/, /v3/).
• Deprecations will run for a minimum of 90 days with a Sunset header before removal.