v9.1.0

9.1.0 (2026-09-01)

Release Type: ✅ OPTIONAL
DB Migration: ⚠️ Yes — see below

docker pull ghcr.io/hirosystems/stacks-blockchain-api:9.1.0

This major release introduces new V3 endpoints that improve response performance and are much more flexible than their (now deprecated) V1 counterparts. It also improves how the API processes and displays Bitcoin re-orgs.

In order to achieve these gains, it needs to run several DB migrations that optimize indexes and add materialized tables for quick value retrievals. Estimated migration downtime: 20-30 minutes.

New endpoints

Principals

• /extended/v3/principals/:principal/transfers/stx/inbound — inbound STX transfers (#2638)
• /extended/v3/principals/:principal/transfers/stx/outbound — outbound STX transfers (#2638)
• /extended/v3/principals/:principal/transfers/ft/:asset_identifier — per-principal FT transfer history (#2646)

Tokens

• /extended/v3/tokens/stx/supply — STX supply backed by the materialized chain_tip counter (#2639, moved from its original stx-supply shape in #2645)
• /extended/v3/tokens/stx/holders — STX holders (#2645)
• /extended/v3/tokens/ft/:asset_identifier/supply — FT supply (#2645)
• /extended/v3/tokens/ft/:asset_identifier/holders — FT holders, migrated from v1 (#2645)
• /extended/v3/tokens/nft/:asset_identifier/:value/history — NFT history, migrated from v1 (#2648)

Staking

• /extended/v3/staking/cycles/:cycle_number/signers — cycle signers with signer manager key bindings (#2636)

Smart contracts

• /extended/v3/smart-contracts/:contract_id — smart contract details with resolved clarity versions (#2649)

What's Changed

• chore(deps): bump socket.io-parser from 4.2.4 to 4.2.7 by @dependabot[bot] in #2627
• chore(deps): bump fast-uri from 3.1.0 to 3.1.4 by @dependabot[bot] in #2617
• chore(deps-dev): bump svgo from 2.8.2 to 2.8.3 in /client by @dependabot[bot] in #2618
• chore(deps): bump find-my-way from 9.5.0 to 9.7.0 by @dependabot[bot] in #2620
• chore(deps): bump undici by @dependabot[bot] in #2622
• chore(deps): bump fastify from 5.8.2 to 5.10.0 by @dependabot[bot] in #2625
• chore(deps): bump valibot from 1.3.1 to 1.4.2 by @dependabot[bot] in #2621
• chore(deps): bump yaml from 2.5.0 to 2.9.0 by @dependabot[bot] in #2624
• chore(deps-dev): bump postcss from 8.4.41 to 8.5.23 in /client by @dependabot[bot] in #2623
• chore(deps): bump lodash from 4.17.21 to 4.18.1 by @dependabot[bot] in #2626
• fix: reset principal ETags on PoX forced-unlock boundaries by @rafa-stacks in #2631
• chore: improve startup logging and silence the FSTDEP022 Fastify warning by @rafa-stacks in #2630
• chore: rename master branch references to main by @rafa-stacks in #2637
• feat: cycle signers endpoint with signer manager key bindings by @rafa-stacks in #2636
• feat: v3 STX supply endpoint backed by a materialized chain_tip counter by @rafa-stacks in #2639
• chore: deprecate old v1 burnchain endpoints by @rafa-stacks in #2640
• feat: v3 principal STX transfer endpoints (inbound/outbound) by @rafa-stacks in #2638
• chore(deps): bump socket.io-parser from 4.2.4 to 4.2.7 in /client by @dependabot[bot] in #2632
• chore(deps): bump fast-uri by @dependabot[bot] in #2633
• chore(deps-dev): bump js-yaml from 4.1.0 to 4.3.1 by @dependabot[bot] in #2634
• feat: deprecate v1 BNS endpoints and add an asset_identifier filter to v3 NFT balances by @rafa-stacks in #2641
• chore: deprecate v1 network block time endpoints by @rafa-stacks in #2642
• feat: switch to the new canonical chain tip immediately during Nakamoto re-orgs by @rafa-stacks in #2643
• feat: migrate FT holders to v3 and add STX/FT supply and holder endpoints by @rafa-stacks in #2645
• feat: add per-principal fungible token transfer history endpoint by @rafa-stacks in #2646
• test: remove old krypton test suite and split v3 tests by @rafa-stacks in #2647
• feat: migrate NFT history endpoint to v3 and retire v1 NFT mints by @rafa-stacks in #2648
• feat: add v3 smart contract endpoint and resolve null clarity versions by @rafa-stacks in #2649
• refactor: replace hand-rolled Stacks node RPC client with @stacks/rpc-client by @rafa-stacks in #2650
• chore: log pending and running SQL migration names at startup by @rafa-stacks in #2651
• chore(release): 9.1.0 by @rafa-stacks in #2652

Full Changelog: v9.0.2...v9.1.0