Get Stablecoin Reserves
curl --request GET \
--url https://api.stateset.com/v1/stablecoin/reserves \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.stateset.com/v1/stablecoin/reserves"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.stateset.com/v1/stablecoin/reserves', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.stateset.com/v1/stablecoin/reserves",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.stateset.com/v1/stablecoin/reserves"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.stateset.com/v1/stablecoin/reserves")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.stateset.com/v1/stablecoin/reserves")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"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"
}
}
Get Stablecoin Reserves
Retrieve real-time reserve composition and monthly attestation data for StateSet USD (ssUSD)
GET
/
v1
/
stablecoin
/
reserves
Get Stablecoin Reserves
curl --request GET \
--url https://api.stateset.com/v1/stablecoin/reserves \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.stateset.com/v1/stablecoin/reserves"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.stateset.com/v1/stablecoin/reserves', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.stateset.com/v1/stablecoin/reserves",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.stateset.com/v1/stablecoin/reserves"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.stateset.com/v1/stablecoin/reserves")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.stateset.com/v1/stablecoin/reserves")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"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"
}
}
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.Authorization: Bearer YOUR_API_KEY (optional)
Query Parameters
Specific attestation date (YYYY-MM-DD format)Default: Latest available attestation
Include historical attestation dataDefault:
falseResponse format: “summary”, “detailed”, “regulatory”Default: “summary”
Response
Latest monthly attestation data
Show Attestation Object
Show Attestation Object
Attestation date
Link to signed PDF attestation report
Current reserve composition
Show Reserve Breakdown
Show Reserve Breakdown
Total reserve value in USD
ISO 8601 timestamp of last update
Detailed breakdown by asset type
Show Asset Composition
Show Asset Composition
ssUSD supply metrics
Show Supply Metrics
Show Supply Metrics
Total ssUSD in circulation
Cumulative ssUSD issued
Cumulative ssUSD redeemed
Reserves / Supply ratio (should be >= 1.0)
Regulatory compliance status
{
"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 minuteCode Examples
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);
}
}
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")
⌘I