Skip to content

Commit

Permalink
📊 Upgrade Dashboard API version
Browse files Browse the repository at this point in the history
  • Loading branch information
JFWooten4 authored Jan 31, 2025
1 parent 25dcb88 commit fae66ef
Showing 1 changed file with 11 additions and 11 deletions.
22 changes: 11 additions & 11 deletions docs/learn/fundamentals/lumens.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -45,27 +45,27 @@ This section explains how lumen supply metrics are calculated and made available

Unlike many other blockchains, the native network currency is not created through mining- all XLM that has ever existed and will ever exist was created when the Stellar network went live.

[SDF’s Dashboard API endpoint](https://dashboard.stellar.org/api/v2/lumens) will always have the live totals for the essential numbers around lumens. This guide explains important supply metrics like Original Supply, Total Supply, and Circulating Supply entailed in that data.
[The SDF's Dashboard API endpoint](https://dashboard.stellar.org/api/v3/lumens) will always have the live totals for the essential numbers around lumens. This guide explains important supply metrics like Original Supply, Total Supply, and Circulating Supply entailed in that data.

Please reference our [Ecosystem Horizon API Providers](../../data/horizon/horizon-providers.mdx) to access more Stellar network data via Horizon.

### Dashboard API

As of May 28th, 2024, the Dashboard API shows:
As of 31 Jan 2025, the Dashboard API shows:

<CodeExample>

```json
{
"updatedAt": "2024-05-28T16:11:14.622Z",
"updatedAt": "2025-01-31T16:20:58.531Z",
"originalSupply": "100000000000",
"inflationLumens": "5443902087.3472865",
"burnedLumens": "55442115112.9537534",
"totalSupply": "50001786974.3935331",
"upgradeReserve": "259580243.9842749",
"feePool": "4690537.8610771",
"sdfMandate": "20761482987.7713113",
"circulatingSupply": "28976033204.7768698",
"burnedLumens": "55442115192.8967467",
"totalSupply": "50001786894.4505398",
"upgradeReserve": "259580244.9861456",
"feePool": "5197814.2836447",
"sdfMandate": "19192857999.7786541",
"circulatingSupply": "30544150835.4020954",
"_details": "https://www.stellar.org/developers/guides/lumen-supply-metrics.html"
}
```
Expand All @@ -86,7 +86,7 @@ While any address with no signers is counted here, the vast majority of the lume

**totalSupply** The Total Supply is the number of lumens now in existence: 50,001,803,905.97172. The Total Supply includes four major categories of lumens, which the API treats in detail.

**upgradeReserve** The Upgrade Reserve is a special address that’s neither circulating nor a part of SDF’s mandate. When Stellar [changed its consensus algorithm](https://www.stellar.org/blog/upgraded-network-is-here/) in 2015 and relaunched the network these lumens were set aside, to be claimed, one-for-one, by holders of the old network tokens. The [Upgrade Reserve account](https://stellar.expert/explorer/public/account/GBEZOC5U4TVH7ZY5N3FLYHTCZSI6VFGTULG7PBITLF5ZEBPJXFT46YZM) is essentially an escrow, and we don’t expect many claimants to come and pull those lumens into the circulating supply at this point.
**upgradeReserve** The Upgrade Reserve is a special address that’s neither circulating nor a part of the SDF's mandate. When Stellar [changed its consensus algorithm](https://www.stellar.org/blog/upgraded-network-is-here/) in 2015 and relaunched the network these lumens were set aside, to be claimed, one-for-one, by holders of the old network tokens. The [Upgrade Reserve account](https://stellar.expert/explorer/public/account/GBEZOC5U4TVH7ZY5N3FLYHTCZSI6VFGTULG7PBITLF5ZEBPJXFT46YZM) is essentially an escrow, and we don’t expect many claimants to come and pull those lumens into the circulating supply at this point.

**feePool** The Fee Pool is where network fees collect. The lumens do not belong to any particular account. No one has access to the fee pool, so these lumens are non-circulating. Network validators could theoretically vote for a protocol change that would affect the fee pool, so we include it in the total supply. Stellar’s transaction fees are extremely low so the fee pool grows very slowly. The Fee Pool is tracked by the protocol itself, and the current number is visible on the [List All Ledgers](../../data/horizon/api-reference/list-all-ledgers.api.mdx) Horizon API endpoint as `_embedded.records.fee_pool`. See all Stellar Mainnet Horizon data providers [here](../../data/horizon/horizon-providers.mdx).

Expand All @@ -108,4 +108,4 @@ While any address with no signers is counted here, the vast majority of the lume
- [In-App Distribution](https://stellar.expert/explorer/public/account/GDKIJJIKXLOM2NRMPNQZUUYK24ZPVFC6426GZAEP3KUK6KEJLACCWNMX)
- [In-App Distribution (Hot)](https://stellar.expert/explorer/public/account/GAX3BRBNB5WTJ2GNEFFH7A4CZKT2FORYABDDBZR5FIIT3P7FLS2EFOZZ)

**circulatingSupply** The Circulating Supply is lumens in the hands of individuals and independent companies. These are lumens out in the world, used to pay network fees and fund Stellar accounts. They are also used as a general medium of exchange. We expect Stellar’s Circulating Supply to grow steadily as SDF spends and distributes lumens according to its mandate. Lumens in the Total Supply, but not in the SDF Mandate, Upgrade Reserve, or Fee Pool are assumed to be circulating.
**circulatingSupply** The Circulating Supply is lumens in the hands of individuals and independent companies. These are lumens out in the world, used to pay network fees and fund Stellar accounts. They are also used as a general medium of exchange. We expect Stellar’s Circulating Supply to grow steadily as the SDF spends and distributes lumens according to its mandate. Lumens in the Total Supply, but not in the SDF Mandate, Upgrade Reserve, or Fee Pool are assumed to be circulating.

0 comments on commit fae66ef

Please sign in to comment.