> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spark.money/llms.txt
> Use this file to discover all available pages before exploring further.

# getIssuerTokenDistribution

> Get token distribution stats: circulating supply, holders, and transactions.

Gets the token distribution information for the token associated with this `IssuerSparkWallet`.

<Warning>
  This feature is currently under development and will be available in a future release of Spark.
</Warning>

## Method Signature

```typescript theme={null}
interface TokenDistribution {
  totalCirculatingSupply: bigint;
  totalIssued: bigint;
  totalBurned: bigint;
  numHoldingAddress: number;
  numConfirmedTransactions: bigint;
}

async function getIssuerTokenDistribution(): Promise<TokenDistribution>;
```

## Returns

<ResponseField name="totalCirculatingSupply" type="bigint" required>
  Total circulating supply of the token
</ResponseField>

<ResponseField name="totalIssued" type="bigint" required>
  Total issued tokens
</ResponseField>

<ResponseField name="totalBurned" type="bigint" required>
  Total tokens burned
</ResponseField>

<ResponseField name="numHoldingAddress" type="number" required>
  Number of addresses holding the token
</ResponseField>

<ResponseField name="numConfirmedTransactions" type="bigint" required>
  Number of confirmed transactions
</ResponseField>

## Example

```typescript theme={null}
const distribution = await issuerWallet.getIssuerTokenDistribution();
console.log("Circulating supply:", distribution.totalCirculatingSupply);
console.log("Total issued:", distribution.totalIssued);
console.log("Total burned:", distribution.totalBurned);
console.log("Holding addresses:", distribution.numHoldingAddress);
console.log("Confirmed transactions:", distribution.numConfirmedTransactions);
```
