unisat-dev-docs

Fractal Only API

This API is limited to Fractal only. It provides endpoints to interact with the Fractal network, including supply information, address statistics, and rich lists.

👉 View Swagger UI


📑 Table of Contents

Route Summary
GET /v1/public/fractal/supply Get current circulating Fractal supply and block height
GET /v1/public/fractal/total-supply Get total Fractal supply and indexed block height
GET /v1/public/address/total Get total indexed Fractal address count
GET /v1/public/address/rich-list List richest Fractal addresses by indexed balance

Public-Fractal

Get current circulating Fractal supply and block height

Method: GET
Path: /v1/public/fractal/supply
Swagger Link: View in Swagger UI

Description

Returns the indexed Fractal supply snapshot, including the latest indexed block count and current supply value. Use this read-only endpoint for Fractal dashboards, wallet balance context, and supply monitoring where data may lag the chain tip because of indexer confirmation and synchronization rules.

Response (200)

Successful operation

Response (401)

Invalid API Key


Get total Fractal supply and indexed block height

Method: GET
Path: /v1/public/fractal/total-supply
Swagger Link: View in Swagger UI

Description

Returns the indexed Fractal total supply snapshot with block count and supply amount. Use this read-only endpoint to display aggregate FB issuance, compare supply metrics across environments, or power public Fractal statistics pages without creating orders, signatures, or transactions.

Response (200)

Successful operation

Response (401)

Invalid API Key


Get total indexed Fractal address count

Method: GET
Path: /v1/public/address/total
Swagger Link: View in Swagger UI

Description

Returns the total number of Fractal addresses tracked by the indexer as a numeric value. Use this read-only endpoint for network growth metrics, explorer overviews, and public statistics where the count reflects UniSat indexing progress rather than an immediate chain-tip scan.

Response (200)

Successful operation

Response (401)

Invalid API Key


List richest Fractal addresses by indexed balance

Method: GET
Path: /v1/public/address/rich-list
Swagger Link: View in Swagger UI

Description

Returns a paginated rich list of Fractal address balances, with each item containing the address and indexed balance amount. Use cursor and size to page through holders for explorer leaderboards, distribution analysis, or wallet analytics; results are read-only and may lag final chain state while indexing catches up.

Parameters

Response (200)

Successful operation

Response (401)

Invalid API Key