Developers

Public API

A read-only REST + SSE API over the full Pactus chain. No key required.

Base URL

https://pactus.space/api

Append any path below, e.g. https://pactus.space/api/blocks/1. Responses are JSON.

Amounts

Returned as { nanopac, pac } — an exact integer string in NanoPAC (1 PAC = 10⁹) plus a float for display.

Pagination

List endpoints are keyset-paginated; follow next_cursor until it is null.

Caching

Responses carry short Cache-Control TTLs; statistics are precomputed and served from cache.

Chain status

GET/status

Chain head and headline totals: height, blocks, transactions, accounts, validators, minted/circulating/staked supply, treasury, average block time.

GET/sync

Indexing progress vs. the live network tip: indexed_height, node_height, network_height, blocks_behind, progress_pct, is_syncing.

Blocks

GET/blocks

Latest blocks, newest first. Keyset-paginated.

cursor: Return blocks with height below this value.
limit: Page size (max 100, default 25).

GET/blocks/{height}

A single block by height, including its transactions and certificate.

GET/blocks/hash/{hash}

A single block by its block hash.

Transactions

GET/txs

Latest transactions, newest first. Keyset-paginated.

cursor: Opaque cursor from the previous page's next_cursor.
limit: Page size (max 100, default 25).

GET/txs/{id}

A single transaction with its decoded, type-specific payload.

Accounts

GET/addresses/{addr}

Account summary: balance, number, first/last seen, transaction count.

GET/addresses/{addr}/txs

Transactions involving an address (sent, received, staked), newest first.

cursor: Pagination cursor.
limit: Page size (max 100).

GET/addresses/{addr}/balance-history

Daily balance reconstructed from genesis to now, bounded point count.

Validators

GET/validators

Validator set with stake, availability, blocks proposed and status.

sort: stake | score | blocks | number.
limit: Page size.
offset: Offset for paging.

GET/validators/{addr}

A single validator's details.

GET/validators/{addr}/rewards

Reward history for a validator.

GET/validators/{addr}/blocks

Blocks proposed by a validator.

GET/validators/{addr}/availability

Availability-score history for a validator.

Search

GET/search

Resolve a query to a block height, block hash, transaction id or address.

q: Height, 64-hex hash/txid, or pc1… / treasury address.

Statistics

All stats endpoints accept ?range=7d|30d|90d|1y|all (default 7d). Daily-bucketed series are cached and refreshed on a schedule for instant delivery.

GET/stats/overview

Same payload as /status (dashboard alias).

GET/stats/transactions

Transaction count, fees and block stats per bucket.

bucket: day | hour.

GET/stats/tx-types

Transaction counts per day, pivoted by payload type.

GET/stats/volume

Transferred value per day (excludes block rewards).

GET/stats/supply

Cumulative minted supply over time.

GET/stats/fees

Total fees per day.

GET/stats/block-time

Average block interval per day.

GET/stats/accounts

New and active accounts per day, plus cumulative total.

GET/stats/staking

Cumulative staked over time from bond/withdraw flows.

GET/stats/chain-state

Reconstructed total staked, validators, active validators and pending unstake per day.

GET/stats/validator-activity

Daily bond/unbond/withdraw counts and unique proposers.

GET/stats/participation

Daily committee participation rate.

GET/stats/fee-histogram

Distribution of transaction fees by bucket.

GET/stats/concentration

Wealth concentration: top-N share, Gini and a balance histogram (circulating holders only).

GET/stats/richlist

Top accounts by balance with share of circulating supply.

limit: Rows (max 200).

GET/stats/largest-transactions

Largest transfers all-time by value (excludes block rewards).

limit: Rows (max 100).

GET/stats/network-history

Time series of a network metric.

metric: staked | committee | validators | active | accounts | peers.

Live network

Served from the node in real time.

GET/committee

Current committee, power and protocol-version distribution.

GET/consensus

Live consensus snapshot (instances, votes, proposal).

GET/mempool

Pending transactions in the node's mempool.

GET/peers

Connected peers with agent, direction, height and sessions.

GET/peers/geo

Geo-located peers and per-country tally for the world map.

GET/peers/{id}

Stored peer detail with uptime and height history.

GET/network

Node and network overview (peers, reachability, agent, clock offset).

Live stream

SSE/stream/blocks

Server-Sent Events. Emits `event: block` and `event: tx` as new blocks and transactions are indexed. Connect with an EventSource and listen for both event types.