StateSet API Docs

Get Stablecoin Reserves

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

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

}

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

Get Stablecoin Reserves

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

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

}

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

string

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

boolean

Include historical attestation dataDefault: false

string

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

Response

object

Latest monthly attestation data

Show Attestation Object

string

Attestation date

string

Link to signed PDF attestation report

object

CPA firm details

Show Auditor Details

string

Registered public accounting firm name

string

CPA license number

string

Date of auditor signature

array

C-suite officer signatures

Show Officer Signature

string

Officer name

string

Officer title (CEO, CFO, etc.)

string

Date of signature

object

Current reserve composition

Show Reserve Breakdown

string

Total reserve value in USD

string

ISO 8601 timestamp of last update

object

Detailed breakdown by asset type

Show Asset Composition

object

U.S. Dollar bank deposits (10%)

Show Cash Details

string

Total USD in bank accounts

number

Percentage of total reserves

array

List of custodian banks

object

U.S. Treasury Bills (70%)

Show T-Bill Details

string

Total value of T-Bills

number

Percentage of total reserves

number

Weighted average maturity (max 93 days)

array

List of CUSIP identifiers

object

Government-only Money Market Funds (15%)

Show MMF Details

string

Total MMF holdings

number

Percentage of total reserves

array

List of fund names and tickers

object

Overnight tri-party repos (5%)

Show Repo Details

string

Total repo value

number

Percentage of total reserves

array

OCC-approved counterparties

object

ssUSD supply metrics

Show Supply Metrics

string

Total ssUSD in circulation

string

Cumulative ssUSD issued

string

Cumulative ssUSD redeemed

number

Reserves / Supply ratio (should be >= 1.0)

object

Supply breakdown by blockchain

Show Chain Distribution

string

ssUSD on StateSet network

string

ssUSD bridged to Base

string

ssUSD bridged to Solana

string

ssUSD on Cosmos chains via IBC

object

Regulatory compliance status

Show Compliance Status

object

OCC approval details

Show OCC Details

string

Approval status

string

Date of OCC approval

string

Federal license number

string

Date of next required attestation

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

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

Get started

Platform

StateSet One

StateSet Response

StateSet ResponseCX

Temporal Engine

StateSet iCommerce

StateSet EDI

StateSet Mail

StateSet Voice

StateSet NSR

AI Agents

StateSet Sandbox

StateSet ACP

StateSet UCP

StateSet ICP

StateSet Sequencer

StateSet Set L2

StateSet Cloud

Tools

Get Stablecoin Reserves

Authentication

Query Parameters

Response

Rate Limits

Code Examples

​Authentication

​Query Parameters

​Response

​Rate Limits

​Code Examples

Authentication

Query Parameters

Response

Rate Limits

Code Examples