Polygon REST API

Triport's product layer for Polygon under https://triport.io/v1/polygon/… — wallet data, mempool intel, bor/heimdall chain-layer queries, tracing, senders, and firehose WebSocket channels.


Method / Endpoint	`GET`/`POST https://triport.io/v1/polygon/…`
Network	Polygon (PoS)
Authentication	`x-token` header (SDK-preferred); see Authentication
Required scope	— (tier-gated per endpoint)
Tier / rate limit	Any tier; see Rate Limits

What this surface is

Unlike JSON-RPC, which proxies the chain's native methods verbatim, the REST layer is built by Triport: indexed, opinionated endpoints that answer product questions in one call.

cURL

curl "https://triport.io/v1/polygon/wallet/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balance" \
  -H "x-token: $TRIPORT_API_KEY"

Endpoint groups

Wallet — balance, tokens, NFTs, history.
Bor / Heimdall — checkpoints, spans, current validators, and a heimdall consensus-layer proxy.
Tracing — trace-call and replay-transaction without your own archive node.
Mempool — snapshot and stats.
Sender — raw-tx submission over HTTP.
Firehose WS — raw bor and heimdall stream channels (connect-info pages included).
Mesh & metrics — mesh health and metrics mirror.

The full endpoint list is below.

WS Bor pending-transaction WebSocket firehose

⚠️ НЕ ОТДАЁТСЯ (2026-07-26). Эндпоинт отключён и отвечает

GET Get aggregate mempool statistics

Returns rolling, pre-aggregated Polygon mempool metrics — throughput, gas-price percentiles, and the most active sending addresses — over a configurable time window.

GET Get current Polygon validators

Returns the active Polygon PoS (Bor) validator set for the current span, with each validator's signer address and voting power.

GET Get ERC20 token balances

Returns the list of ERC20 token balances held by a Polygon address, each with its on-chain metadata.

GET Get logs firehose connection info

Returns a short-lived, signed WebSocket URL and token for connecting to the

GET Get MATIC wallet balance

Returns the current native MATIC balance of a Polygon address, in both wei and decimal MATIC.

GET Get mempool firehose connection info

⚠️ БЕСПОЛЕЗЕН, ПОКА FIREHOSE ВЫКЛЮЧЕН (2026-07-26). Эндпоинт выдаёт

GET Get mempool snapshot

Returns a point-in-time snapshot of the Polygon PoS transaction pool — all

GET Get NFT holdings (ERC721 + ERC1155)

Returns the ERC721 and ERC1155 NFTs held by a Polygon address, with per-asset metadata, paged with limit/offset.

GET Get Polygon checkpoint

Fetch Heimdall checkpoint metadata for a single Polygon checkpoint by its numeric id.

GET Get Polygon span info

Returns the bor span with the given id — its block range, validator set, and selected block producers.

GET Get wallet transaction history

Returns a paginated list of recent transactions for a Polygon address, newest first, with cursor-based paging.

WS Heimdall CometBFT WebSocket fanout

⚠️ НЕ ОТДАЁТСЯ (2026-07-26). Эндпоинт отключён и отвечает

ANY Heimdall consensus RPC proxy

A transparent reverse-proxy that forwards Polygon Heimdall consensus-layer requests (Tendermint RPC, Cosmos LCD, and the consensus Prometheus port) through a single authenticated path on the Triport edge.

GET Polygon mesh admin health

Internal, loopback-only admin endpoint that reports the live health of the Polygon mesh pool blocks (bor, heimdall, aggregator).

GET Polygon node Prometheus metrics mirror

Proxies the raw Prometheus exposition from a specific Polygon node (Bor, Heimdall, or an aggregator Prometheus) so you can scrape per-node chain metrics through the Triport edge.

POST Replay transaction trace (Parity-style)

Re-executes an already-mined Polygon transaction and returns its Parity-style trace envelope (call trace, VM trace, and/or state diff).

POST Send signed raw transaction

Broadcast an already-signed, RLP-encoded Polygon transaction to the network through Triport's multi-route dispatch chain.

POST Simulate call with Parity trace output

Executes a contract call against the state of a chosen Polygon block and returns the full Parity-style execution trace — without broadcasting anything.