Get Stablecoin Reserves

curl --request GET \
  --url https://api.stateset.com/v1/stablecoin/reserves \
  --header 'Authorization: Bearer <token>'

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

Get Stablecoin Reserves

curl --request GET \
  --url https://api.stateset.com/v1/stablecoin/reserves \
  --header 'Authorization: Bearer <token>'

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

date

string

Specific attestation date (YYYY-MM-DD format)Default: Latest available attestation

include_history

boolean

Include historical attestation dataDefault: 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

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

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

Upload Reserve Attestation ssUSD Smart Contracts

StateSet Commerce

​Authentication

​Query Parameters

​Response

​Rate Limits

​Code Examples

Authentication

Query Parameters

Response

Rate Limits

Code Examples