> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stateset.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Get Stablecoin Reserves
> Retrieve real-time reserve composition and monthly attestation data for StateSet USD (ssUSD)
This endpoint provides transparent access to ssUSD reserve data, including real-time composition and monthly attestations as required by the GENIUS Act of 2025.
## Authentication
This endpoint is publicly accessible. Optional authentication provides additional data.
```bash theme={null}
Authorization: Bearer YOUR_API_KEY (optional)
```
## Query Parameters
Specific attestation date (YYYY-MM-DD format)
Default: Latest available attestation
Include historical attestation data
Default: `false`
Response format: "summary", "detailed", "regulatory"
Default: "summary"
## Response
Latest monthly attestation data
Attestation date
Link to signed PDF attestation report
CPA firm details
Registered public accounting firm name
CPA license number
Date of auditor signature
C-suite officer signatures
Officer name
Officer title (CEO, CFO, etc.)
Date of signature
Current reserve composition
Total reserve value in USD
ISO 8601 timestamp of last update
Detailed breakdown by asset type
U.S. Dollar bank deposits (10%)
Total USD in bank accounts
Percentage of total reserves
List of custodian banks
U.S. Treasury Bills (70%)
Total value of T-Bills
Percentage of total reserves
Weighted average maturity (max 93 days)
List of CUSIP identifiers
Government-only Money Market Funds (15%)
Total MMF holdings
Percentage of total reserves
List of fund names and tickers
Overnight tri-party repos (5%)
Total repo value
Percentage of total reserves
OCC-approved counterparties
ssUSD supply metrics
Total ssUSD in circulation
Cumulative ssUSD issued
Cumulative ssUSD redeemed
Reserves / Supply ratio (should be >= 1.0)
Supply breakdown by blockchain
ssUSD on StateSet network
ssUSD bridged to Base
ssUSD bridged to Solana
ssUSD on Cosmos chains via IBC
Regulatory compliance status
OCC approval details
Approval status
Date of OCC approval
Federal license number
Date of next required attestation
Date of last quarterly audit
```json Example Response theme={null}
{
"attestation": {
"date": "2025-07-31",
"report_url": "https://reserves.stateset.com/attestations/2025-07-31.pdf",
"auditor": {
"name": "Ernst & Young LLP",
"license_number": "CPA-123456",
"signature_date": "2025-08-05"
},
"officer_signatures": [
{
"name": "John Smith",
"title": "Chief Executive Officer",
"signature_date": "2025-08-05"
},
{
"name": "Jane Doe",
"title": "Chief Financial Officer",
"signature_date": "2025-08-05"
}
]
},
"reserves": {
"total_value_usd": "1,234,567,890.00",
"last_updated": "2025-08-15T14:30:00Z",
"composition": {
"cash": {
"amount": "123,456,789.00",
"percentage": 10.0,
"banks": [
{
"name": "JPMorgan Chase Bank",
"amount": "61,728,394.50"
},
{
"name": "Bank of New York Mellon",
"amount": "61,728,394.50"
}
]
},
"treasury_bills": {
"amount": "864,197,523.00",
"percentage": 70.0,
"average_maturity_days": 45,
"cusips": [
"912796YG7",
"912796YH5",
"912796YJ1"
]
},
"money_market_funds": {
"amount": "185,185,183.50",
"percentage": 15.0,
"funds": [
{
"name": "Vanguard Federal Money Market Fund",
"ticker": "VMFXX",
"amount": "92,592,591.75"
},
{
"name": "Fidelity Government Money Market Fund",
"ticker": "SPAXX",
"amount": "92,592,591.75"
}
]
},
"repo_agreements": {
"amount": "61,728,394.50",
"percentage": 5.0,
"counterparties": [
"Federal Reserve Bank of New York",
"Bank of New York Mellon"
]
}
}
},
"supply": {
"total_supply": "1,234,567,890.00",
"total_issued": "1,500,000,000.00",
"total_redeemed": "265,432,110.00",
"reserve_ratio": 1.0,
"chains": {
"stateset": "500,000,000.00",
"base": "400,000,000.00",
"solana": "300,000,000.00",
"cosmos_ibc": "34,567,890.00"
}
},
"compliance": {
"occ_approval": {
"status": "approved",
"approval_date": "2025-07-04",
"license_number": "OCC-NBPSI-2025-001"
},
"next_attestation_due": "2025-08-31",
"last_audit_date": "2025-07-15"
}
}
```
## Rate Limits
Public access: 100 requests per minute
Authenticated: 1,000 requests per minute
## Code Examples
```javascript Node.js theme={null}
const axios = require('axios');
async function getReserveData() {
try {
const response = await axios.get(
'https://api.stateset.com/v1/stablecoin/reserves',
{
params: {
format: 'detailed',
include_history: true
}
}
);
const data = response.data;
console.log('Total Reserves: $' + data.reserves.total_value_usd);
console.log('Total Supply: $' + data.supply.total_supply);
console.log('Reserve Ratio:', data.supply.reserve_ratio);
// Verify 1:1 backing
if (data.supply.reserve_ratio >= 1.0) {
console.log('✓ Fully backed');
} else {
console.log('⚠ Under-collateralized');
}
return data;
} catch (error) {
console.error('Failed to fetch reserve data:', error);
}
}
```
```python Python theme={null}
import requests
def get_reserve_attestation(date=None):
"""Get reserve attestation data"""
url = "https://api.stateset.com/v1/stablecoin/reserves"
params = {
"format": "regulatory"
}
if date:
params["date"] = date
response = requests.get(url, params=params)
response.raise_for_status()
data = response.json()
# Display reserve composition
print("StateSet USD (ssUSD) Reserve Report")
print("=" * 40)
print(f"Attestation Date: {data['attestation']['date']}")
print(f"Total Reserves: ${data['reserves']['total_value_usd']}")
print(f"Total Supply: ${data['supply']['total_supply']}")
print(f"Reserve Ratio: {data['supply']['reserve_ratio']}")
print("\nReserve Composition:")
composition = data['reserves']['composition']
for asset_type, details in composition.items():
print(f" {asset_type.replace('_', ' ').title()}: "
f"${details['amount']} ({details['percentage']}%)")
return data
# Get latest attestation
get_reserve_attestation()
# Get specific month
get_reserve_attestation("2025-07-31")
```