diff --git a/content/docs/en/apis/stacks-blockchain-api/reference/faucets/get-faucet-btc.mdx b/content/docs/en/apis/stacks-blockchain-api/reference/faucets/get-faucet-btc.mdx
new file mode 100644
index 000000000..179f0f47b
--- /dev/null
+++ b/content/docs/en/apis/stacks-blockchain-api/reference/faucets/get-faucet-btc.mdx
@@ -0,0 +1,12 @@
+---
+title: Get BTC regtest or signet tokens
+sidebarTitle: BTC regtest or signet tokens
+description: "Sends BTC to the specified regtest or signet BTC address. The response reports the amount sent, in satoshis, and the transaction id, which you can use to view the transaction in a regtest or signet Bitcoin block explorer. The tokens are delivered once the transaction has been included in a block. Each request sends a fixed amount configured by the API operator, which the response reports. If you need more for testing (for example, to enroll in a staking bond), reach out to request a custom faucet transaction. **Note:** This is a Bitcoin regtest/signet-only endpoint. This endpoint will not work on Bitcoin mainnet."
+full: true
+---
+
+
diff --git a/content/docs/en/apis/stacks-blockchain-api/reference/faucets/get-faucet-sbtc.mdx b/content/docs/en/apis/stacks-blockchain-api/reference/faucets/get-faucet-sbtc.mdx
new file mode 100644
index 000000000..aae6e4a98
--- /dev/null
+++ b/content/docs/en/apis/stacks-blockchain-api/reference/faucets/get-faucet-sbtc.mdx
@@ -0,0 +1,12 @@
+---
+title: Get sBTC testnet tokens
+sidebarTitle: SBTC testnet tokens
+description: "Sends sBTC to the specified testnet address. The endpoint performs a SIP-010 `transfer` contract call on the configured testnet sBTC token contract. Testnet STX addresses begin with `ST`. The response reports the amount sent, in satoshis, and the transaction id, which you can use to view the transaction in the [Stacks Explorer](https://explorer.hiro.so/?chain=testnet). The tokens are delivered once the transaction has been included in a block. Each request sends a fixed amount configured by the API operator, which the response reports. If you need more for testing (for example, to enroll in a staking bond), reach out to request a custom faucet transaction. **Note:** This is a testnet only endpoint. This endpoint will not work on mainnet."
+full: true
+---
+
+
diff --git a/content/docs/en/apis/stacks-blockchain-api/reference/faucets/get-faucet-stx.mdx b/content/docs/en/apis/stacks-blockchain-api/reference/faucets/get-faucet-stx.mdx
new file mode 100644
index 000000000..0cb761eb2
--- /dev/null
+++ b/content/docs/en/apis/stacks-blockchain-api/reference/faucets/get-faucet-stx.mdx
@@ -0,0 +1,12 @@
+---
+title: Get STX testnet tokens
+sidebarTitle: STX testnet tokens
+description: "Sends STX to the specified testnet address. Testnet STX addresses begin with `ST`. The response reports the amount sent, in µSTX, and the transaction id, which you can use to view the transaction in the [Stacks Explorer](https://explorer.hiro.so/?chain=testnet). The tokens are delivered once the transaction has been included in a block. Each request sends a fixed amount configured by the API operator, which the response reports. If you need more for testing (for example, to enroll in a staking bond), reach out to request a custom faucet transaction. **Note:** This is a testnet only endpoint. This endpoint will not work on mainnet."
+full: true
+---
+
+
diff --git a/content/docs/en/apis/stacks-blockchain-api/reference/faucets/meta.json b/content/docs/en/apis/stacks-blockchain-api/reference/faucets/meta.json
index 044879fad..4a3245d2b 100644
--- a/content/docs/en/apis/stacks-blockchain-api/reference/faucets/meta.json
+++ b/content/docs/en/apis/stacks-blockchain-api/reference/faucets/meta.json
@@ -1,9 +1,5 @@
{
"title": "Faucets",
- "pages": [
- "...",
- "run-faucet-btc",
- "run-faucet-sbtc"
- ],
+ "pages": ["get-faucet-stx", "get-faucet-btc", "get-faucet-sbtc"],
"defaultOpen": false
}
diff --git a/content/docs/en/apis/stacks-blockchain-api/reference/faucets/run-faucet-btc.mdx b/content/docs/en/apis/stacks-blockchain-api/reference/faucets/run-faucet-btc.mdx
deleted file mode 100644
index 24534c4ef..000000000
--- a/content/docs/en/apis/stacks-blockchain-api/reference/faucets/run-faucet-btc.mdx
+++ /dev/null
@@ -1,12 +0,0 @@
----
-title: Get BTC regtest tokens
-sidebarTitle: BTC regtest tokens
-description: Add 0.01 BTC token to the specified regtest BTC address.
-full: true
----
-
-
diff --git a/content/docs/en/apis/stacks-blockchain-api/reference/faucets/run-faucet-sbtc.mdx b/content/docs/en/apis/stacks-blockchain-api/reference/faucets/run-faucet-sbtc.mdx
deleted file mode 100644
index b2332b309..000000000
--- a/content/docs/en/apis/stacks-blockchain-api/reference/faucets/run-faucet-sbtc.mdx
+++ /dev/null
@@ -1,12 +0,0 @@
----
-title: Get sBTC testnet tokens
-sidebarTitle: sBTC testnet tokens
-description: Add sBTC tokens to the specified testnet address.
-full: true
----
-
-
diff --git a/content/docs/en/apis/stacks-blockchain-api/reference/faucets/stx.mdx b/content/docs/en/apis/stacks-blockchain-api/reference/faucets/stx.mdx
deleted file mode 100644
index 960dc101b..000000000
--- a/content/docs/en/apis/stacks-blockchain-api/reference/faucets/stx.mdx
+++ /dev/null
@@ -1,12 +0,0 @@
----
-title: Get STX testnet tokens
-sidebarTitle: STX testnet tokens
-description: Delivers testnet STX tokens to a specified address.
-full: true
----
-
-
diff --git a/content/docs/en/apis/stacks-blockchain-api/reference/mempool/get-mempool-summary.mdx b/content/docs/en/apis/stacks-blockchain-api/reference/mempool/get-mempool-summary.mdx
new file mode 100644
index 000000000..46235bafe
--- /dev/null
+++ b/content/docs/en/apis/stacks-blockchain-api/reference/mempool/get-mempool-summary.mdx
@@ -0,0 +1,12 @@
+---
+title: Get mempool summary
+sidebarTitle: Mempool summary
+description: "Retrieves a summary of the transactions currently pending in the mempool: how many there are, and the fee, size, and receipt percentiles across them, both overall and broken down by transaction type. Percentiles are discrete: each is a value some pending transaction actually has, not an interpolation between two of them."
+full: true
+---
+
+
diff --git a/content/docs/en/apis/stacks-blockchain-api/reference/mempool/meta.json b/content/docs/en/apis/stacks-blockchain-api/reference/mempool/meta.json
index 827133ea6..5c74a1473 100644
--- a/content/docs/en/apis/stacks-blockchain-api/reference/mempool/meta.json
+++ b/content/docs/en/apis/stacks-blockchain-api/reference/mempool/meta.json
@@ -1,8 +1,5 @@
{
"title": "Mempool",
- "pages": [
- "...",
- "get-mempool-transactions"
- ],
+ "pages": ["get-mempool-summary", "get-mempool-transactions", "transaction-fee-priorities"],
"defaultOpen": false
}
diff --git a/content/docs/en/apis/stacks-blockchain-api/reference/search/search-by-id.mdx b/content/docs/en/apis/stacks-blockchain-api/reference/search/search-by-id.mdx
deleted file mode 100644
index a0a07a5a0..000000000
--- a/content/docs/en/apis/stacks-blockchain-api/reference/search/search-by-id.mdx
+++ /dev/null
@@ -1,12 +0,0 @@
----
-title: Search by ID
-sidebarTitle: Search by ID
-description: Search blocks, transactions, contracts, or accounts by hash/ID.
-full: true
----
-
-
diff --git a/content/docs/en/apis/stacks-blockchain-api/reference/search/search.mdx b/content/docs/en/apis/stacks-blockchain-api/reference/search/search.mdx
new file mode 100644
index 000000000..7a91e3586
--- /dev/null
+++ b/content/docs/en/apis/stacks-blockchain-api/reference/search/search.mdx
@@ -0,0 +1,12 @@
+---
+title: Search
+sidebarTitle: Search
+description: "Searches for the blocks, transactions, addresses, smart contracts, and token assets that a term refers to. The term can be a complete identifier or the beginning of one: a block or transaction hash, a Stacks or Bitcoin block height, an address, a contract id, or an asset identifier. Contract and asset names are matched anywhere in the name, so a term like `arkadiko` finds the contracts and tokens named after it. Names must contain the term; misspellings are not matched. At most 20 results are returned, best match first; there is no pagination, so narrow the term to see something that did not surface. A term that matches nothing returns an empty list rather than an error. Only canonical, mined entities are searched."
+full: true
+---
+
+
diff --git a/content/docs/en/apis/stacks-blockchain-api/reference/stacking-pool/get-events-for-a-stacking-address.mdx b/content/docs/en/apis/stacks-blockchain-api/reference/stacking-pool/get-events-for-a-stacking-address.mdx
deleted file mode 100644
index 5c22909ce..000000000
--- a/content/docs/en/apis/stacks-blockchain-api/reference/stacking-pool/get-events-for-a-stacking-address.mdx
+++ /dev/null
@@ -1,12 +0,0 @@
----
-title: Get events for a stacking address
-sidebarTitle: Events for a stacking address
-description: Get events for a stacking address.
-full: true
----
-
-
diff --git a/content/docs/en/apis/stacks-blockchain-api/reference/stacking-pool/get-latest-pox-events.mdx b/content/docs/en/apis/stacks-blockchain-api/reference/stacking-pool/get-latest-pox-events.mdx
deleted file mode 100644
index e071a1e17..000000000
--- a/content/docs/en/apis/stacks-blockchain-api/reference/stacking-pool/get-latest-pox-events.mdx
+++ /dev/null
@@ -1,12 +0,0 @@
----
-title: Get latest PoX events
-sidebarTitle: Latest PoX events
-description: Get latest PoX events.
-full: true
----
-
-
diff --git a/content/docs/en/apis/stacks-blockchain-api/reference/stacking-pool/get-pox-events-for-a-transaction.mdx b/content/docs/en/apis/stacks-blockchain-api/reference/stacking-pool/get-pox-events-for-a-transaction.mdx
deleted file mode 100644
index b5e4ef42d..000000000
--- a/content/docs/en/apis/stacks-blockchain-api/reference/stacking-pool/get-pox-events-for-a-transaction.mdx
+++ /dev/null
@@ -1,12 +0,0 @@
----
-title: Get PoX events for a transaction
-sidebarTitle: PoX events for a transaction
-description: Get PoX events for a transaction.
-full: true
----
-
-
diff --git a/content/docs/en/apis/stacks-blockchain-api/reference/stacking-pool/members.mdx b/content/docs/en/apis/stacks-blockchain-api/reference/stacking-pool/members.mdx
deleted file mode 100644
index 76bd9e06c..000000000
--- a/content/docs/en/apis/stacks-blockchain-api/reference/stacking-pool/members.mdx
+++ /dev/null
@@ -1,12 +0,0 @@
----
-title: Get stacking pool members
-sidebarTitle: Stacking pool members
-description: Retrieves the list of stacking pool members for a given delegator principal.
-full: true
----
-
-
diff --git a/content/docs/en/apis/stacks-blockchain-api/reference/stacking-pool/meta.json b/content/docs/en/apis/stacks-blockchain-api/reference/stacking-pool/meta.json
deleted file mode 100644
index a9822727c..000000000
--- a/content/docs/en/apis/stacks-blockchain-api/reference/stacking-pool/meta.json
+++ /dev/null
@@ -1,10 +0,0 @@
-{
- "title": "Stacking Pool",
- "pages": [
- "...",
- "get-latest-pox-events",
- "get-pox-events-for-a-transaction",
- "get-events-for-a-stacking-address"
- ],
- "defaultOpen": false
-}
diff --git a/content/docs/en/apis/stacks-blockchain-api/reference/staking/get-bond-events.mdx b/content/docs/en/apis/stacks-blockchain-api/reference/staking/get-bond-events.mdx
new file mode 100644
index 000000000..c5ece2c8e
--- /dev/null
+++ b/content/docs/en/apis/stacks-blockchain-api/reference/staking/get-bond-events.mdx
@@ -0,0 +1,12 @@
+---
+title: Get bond events
+sidebarTitle: Bond events
+description: "A bond's pox-5 event log, newest first: setup, allowlist additions, registrations and registration updates, early exits (`announce-l1-early-exit`, and `unstake-sbtc` with a `new_amount_sats` of 0), partial sBTC unstakes, reward distributions, and staker reward claims."
+full: true
+---
+
+
diff --git a/content/docs/en/apis/stacks-blockchain-api/reference/staking/get-staking-cycle.mdx b/content/docs/en/apis/stacks-blockchain-api/reference/staking/get-staking-cycle.mdx
new file mode 100644
index 000000000..0b4b5b856
--- /dev/null
+++ b/content/docs/en/apis/stacks-blockchain-api/reference/staking/get-staking-cycle.mdx
@@ -0,0 +1,12 @@
+---
+title: Get staking cycle
+sidebarTitle: Staking cycle
+description: A summary of staking for one PoX reward cycle.
+full: true
+---
+
+
diff --git a/content/docs/en/apis/stacks-blockchain-api/reference/staking/get-staking-rewards.mdx b/content/docs/en/apis/stacks-blockchain-api/reference/staking/get-staking-rewards.mdx
new file mode 100644
index 000000000..15188dbeb
--- /dev/null
+++ b/content/docs/en/apis/stacks-blockchain-api/reference/staking/get-staking-rewards.mdx
@@ -0,0 +1,12 @@
+---
+title: Get network staking reward totals
+sidebarTitle: Network staking reward totals
+description: Get the total Bitcoin generated by staking on the Stacks network across all history, along with the total BTC burned by block commits. Values are in satoshis and always reflect the latest ingested chain state.
+full: true
+---
+
+
diff --git a/content/docs/en/apis/stacks-blockchain-api/reference/staking/meta.json b/content/docs/en/apis/stacks-blockchain-api/reference/staking/meta.json
index 96e33e9a9..309217a33 100644
--- a/content/docs/en/apis/stacks-blockchain-api/reference/staking/meta.json
+++ b/content/docs/en/apis/stacks-blockchain-api/reference/staking/meta.json
@@ -9,10 +9,13 @@
"get-bond-allowlist-entry",
"get-bond-registrations",
"get-bond-registration",
+ "get-bond-events",
+ "get-staking-cycle",
"get-cycle-signers",
"get-staking-signers",
"get-staking-signer",
- "get-staking-signer-stakers"
+ "get-staking-signer-stakers",
+ "get-staking-rewards"
],
"defaultOpen": false
}
diff --git a/content/docs/en/apis/stacks-blockchain-api/reference/transactions/details-for-transactions.mdx b/content/docs/en/apis/stacks-blockchain-api/reference/transactions/details-for-transactions.mdx
deleted file mode 100644
index 5f8da7e17..000000000
--- a/content/docs/en/apis/stacks-blockchain-api/reference/transactions/details-for-transactions.mdx
+++ /dev/null
@@ -1,12 +0,0 @@
----
-title: Get details for transactions
-sidebarTitle: Details for transactions
-description: Retrieves details for a list of transactions.
-full: true
----
-
-
\ No newline at end of file
diff --git a/content/docs/en/apis/stacks-blockchain-api/reference/transactions/get-transactions-batch.mdx b/content/docs/en/apis/stacks-blockchain-api/reference/transactions/get-transactions-batch.mdx
new file mode 100644
index 000000000..093694305
--- /dev/null
+++ b/content/docs/en/apis/stacks-blockchain-api/reference/transactions/get-transactions-batch.mdx
@@ -0,0 +1,12 @@
+---
+title: Get a batch of transactions
+sidebarTitle: Batch of transactions
+description: "Retrieves the summaries of up to 20 mined transactions in a single call, given their transaction ids. Provide them as repeated querystring values (`?tx_id=A&tx_id=B`) or as a single comma-separated value (`?tx_id=A,B`). Results are returned in canonical chain order (newest first), not in the order the ids were supplied. Only transactions mined in the canonical chain are returned: an id that is unknown, non-canonical, or still in the mempool is absent from `results` rather than reported as an error, so compare the response against the ids you sent to find the ones that did not resolve. Use `GET /extended/v3/transactions/{tx_id}` for a single transaction, which also covers mempool transactions."
+full: true
+---
+
+
diff --git a/content/docs/en/apis/stacks-blockchain-api/reference/transactions/meta.json b/content/docs/en/apis/stacks-blockchain-api/reference/transactions/meta.json
index 444223c8f..23d1fd48b 100644
--- a/content/docs/en/apis/stacks-blockchain-api/reference/transactions/meta.json
+++ b/content/docs/en/apis/stacks-blockchain-api/reference/transactions/meta.json
@@ -1,8 +1,7 @@
{
"title": "Transactions",
"pages": [
- "statistics-for-mempool-transactions",
- "details-for-transactions",
+ "get-transactions-batch",
"get-block-transactions",
"get-principal-transactions",
"get-principal-transaction-balance-changes",
diff --git a/content/docs/en/apis/stacks-blockchain-api/reference/transactions/statistics-for-mempool-transactions.mdx b/content/docs/en/apis/stacks-blockchain-api/reference/transactions/statistics-for-mempool-transactions.mdx
deleted file mode 100644
index d380cb30a..000000000
--- a/content/docs/en/apis/stacks-blockchain-api/reference/transactions/statistics-for-mempool-transactions.mdx
+++ /dev/null
@@ -1,13 +0,0 @@
----
-title: Get statistics for mempool transactions
-sidebarTitle: Statistics for mempool transactions
-description: Retrieves statistics for transactions in the mempool, such as counts, ages, and fees.
-full: true
----
-
-
-
diff --git a/content/docs/en/apis/stacks-blockchain-api/v1-to-v3-migration.mdx b/content/docs/en/apis/stacks-blockchain-api/v1-to-v3-migration.mdx
index 754ff2426..af68305b8 100644
--- a/content/docs/en/apis/stacks-blockchain-api/v1-to-v3-migration.mdx
+++ b/content/docs/en/apis/stacks-blockchain-api/v1-to-v3-migration.mdx
@@ -246,7 +246,7 @@ touched this principal" and "what changed for this principal".
For the FT and NFT detail that v1 packed into `stx_transfers` / `ft_transfers` / `nft_transfers`,
call `GET /extended/v3/principals/{principal}/transactions/{tx_id}/balance-changes`, or fetch
several transactions at once with
-`GET /extended/v3/principals/{principal}/balance-changes?tx_id=A,B,C` (up to 50 IDs).
+`GET /extended/v3/principals/{principal}/balance-changes?tx_id=A,B,C` for several IDs in one call.
Each balance change is `{ asset: { type, identifier? }, balance_change: { sent, received, net } }`,
where `type` is `stx`, `ft`, or `nft`.