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.

Authorization: Bearer YOUR_API_KEY (optional)

Query Parameters

date · string

Specific attestation date (YYYY-MM-DD format)

Default: Latest available attestation

include_history · boolean

Include historical attestation data

Default: false

format · string

Response format: “summary”, “detailed”, “regulatory”

Default: “summary”

Response

attestation · object

Latest monthly attestation data

Show Attestation Object

date · string

Attestation date

report_url · string

Link to signed PDF attestation report

auditor · object

CPA firm details

Show Auditor Details

name · string

Registered public accounting firm name

license_number · string

CPA license number

signature_date · string

Date of auditor signature

officer_signatures · array

C-suite officer signatures

Show Officer Signature

name · string

Officer name

title · string

Officer title (CEO, CFO, etc.)

signature_date · string

Date of signature

reserves · object

Current reserve composition

Show Reserve Breakdown

total_value_usd · string

Total reserve value in USD

last_updated · string

ISO 8601 timestamp of last update

composition · object

Detailed breakdown by asset type

Show Asset Composition

cash · object

U.S. Dollar bank deposits (10%)

Show Cash Details

amount · string

Total USD in bank accounts

percentage · number

Percentage of total reserves

banks · array

List of custodian banks

treasury_bills · object

U.S. Treasury Bills (70%)

Show T-Bill Details

amount · string

Total value of T-Bills

percentage · number

Percentage of total reserves

average_maturity_days · number

Weighted average maturity (max 93 days)

cusips · array

List of CUSIP identifiers

money_market_funds · object

Government-only Money Market Funds (15%)

Show MMF Details

amount · string

Total MMF holdings

percentage · number

Percentage of total reserves

funds · array

List of fund names and tickers

repo_agreements · object

Overnight tri-party repos (5%)

Show Repo Details

amount · string

Total repo value

percentage · number

Percentage of total reserves

counterparties · array

OCC-approved counterparties

supply · object

ssUSD supply metrics

Show Supply Metrics

total_supply · string

Total ssUSD in circulation

total_issued · string

Cumulative ssUSD issued

total_redeemed · string

Cumulative ssUSD redeemed

reserve_ratio · number

Reserves / Supply ratio (should be >= 1.0)

chains · object

Supply breakdown by blockchain

Show Chain Distribution

stateset · string

ssUSD on StateSet network

base · string

ssUSD bridged to Base

solana · string

ssUSD bridged to Solana

cosmos_ibc · string

ssUSD on Cosmos chains via IBC

compliance · object

Regulatory compliance status

Show Compliance Status

occ_approval · object

OCC approval details

Show OCC Details

status · string

Approval status

approval_date · string

Date of OCC approval

license_number · string

Federal license number

next_attestation_due · string

Date of next required attestation

last_audit_date · string

Date of last quarterly audit

Example Response

{
  "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

Node.js

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);
  }
}