# Market Cap

Use these API operations to obtain details about market-capitalization supply for a stablecoin currency.

| Operation | Method | Description |
| --------- | ------ | ----------- |
| [Get total supply](#operation/getMarketCapTotal) | GET | Get the total amount of currency supply, with a per-chain breakdown. |
| [Get total supply amount](#operation/getMarketCapTotalAmount) | GET | Get the total supply as a plain decimal string. |
| [Get circulating supply](#operation/getMarketCapCirculating) | GET | Get the circulating amount of currency supply, with a per-chain breakdown. |
| [Get circulating supply amount](#operation/getMarketCapCirculatingAmount) | GET | Get the circulating supply as a plain decimal string. |

**Note:** These Market Cap operations do not require authentication.


## Get total supply

 - [GET /v1/stablecoin/market-cap/{currencyCode}/total](https://docs.ripple.com/products/stablecoin/api/reference/rlusd-openapi/market-cap/getmarketcaptotal.md): Returns the total RLUSD supply (all issued tokens, regardless of circulating status)
with a per-chain breakdown. No authentication required.

## Get total supply amount

 - [GET /v1/stablecoin/market-cap/{currencyCode}/total/amount](https://docs.ripple.com/products/stablecoin/api/reference/rlusd-openapi/market-cap/getmarketcaptotalamount.md): Returns the total RLUSD supply as a plain decimal string (e.g. "1000000000.00").
Useful for lightweight integrations that only need the aggregate figure.
No authentication required.

## Get circulating supply

 - [GET /v1/stablecoin/market-cap/{currencyCode}/circulating](https://docs.ripple.com/products/stablecoin/api/reference/rlusd-openapi/market-cap/getmarketcapcirculating.md): Returns the circulating RLUSD supply with a per-chain breakdown.
Returns 404 if the circulating supply API is not enabled.
No authentication required.

## Get circulating supply amount

 - [GET /v1/stablecoin/market-cap/{currencyCode}/circulating/amount](https://docs.ripple.com/products/stablecoin/api/reference/rlusd-openapi/market-cap/getmarketcapcirculatingamount.md): Returns the circulating RLUSD supply as a plain decimal string.
Returns 404 if the circulating supply API is not enabled.
No authentication required.

