> ## 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.

# StateSet USD (ssUSD) API Overview

> Complete API reference for StateSet USD stablecoin - GENIUS Act compliant stablecoin for instant global commerce

<Info>
  **Quick Access**: [Issue ssUSD](/stablecoin/issue) | [Redeem for USD](/stablecoin/redeem) | [Check Reserves](/stablecoin/reserves) | [View Attestations](/stablecoin/attestation)
</Info>

## 🪙 What is StateSet USD (ssUSD)?

StateSet USD (ssUSD) will be a fully-backed, regulatory-compliant stablecoin designed for instant global commerce. ssUSD combines the stability of the US dollar with the efficiency of blockchain technology.

<CardGroup cols={3}>
  <Card title="1:1 USD Backing" icon="shield-check">
    Every ssUSD is backed by \$1 in secure, audited reserves
  </Card>

  <Card title="Instant Settlement" icon="bolt">
    Sub-second finality on StateSet, instant bridging to other chains
  </Card>

  <Card title="Full Compliance" icon="scale-balanced">
    GENIUS Act compliance with monthly attestations and criminal penalties for misreporting
  </Card>
</CardGroup>

## 💰 Reserve Composition

Our conservative reserve structure ensures ssUSD stability and liquidity:

<div className="overflow-x-auto">
  <table className="min-w-full divide-y divide-gray-200">
    <thead className="bg-gray-50">
      <tr>
        <th className="px-6 py-3 text-left text-xs font-medium text-gray-500 uppercase tracking-wider">Asset Type</th>
        <th className="px-6 py-3 text-left text-xs font-medium text-gray-500 uppercase tracking-wider">Allocation</th>
        <th className="px-6 py-3 text-left text-xs font-medium text-gray-500 uppercase tracking-wider">Description</th>
        <th className="px-6 py-3 text-left text-xs font-medium text-gray-500 uppercase tracking-wider">Risk Level</th>
      </tr>
    </thead>

    <tbody className="bg-white divide-y divide-gray-200">
      <tr>
        <td className="px-6 py-4 whitespace-nowrap">U.S. Dollar Cash</td>
        <td className="px-6 py-4 whitespace-nowrap font-medium">10%</td>
        <td className="px-6 py-4">FDIC-insured deposits at regulated banks</td>
        <td className="px-6 py-4"><span className="text-green-600">●</span> Minimal</td>
      </tr>

      <tr>
        <td className="px-6 py-4 whitespace-nowrap">Treasury Bills</td>
        <td className="px-6 py-4 whitespace-nowrap font-medium">70%</td>
        <td className="px-6 py-4">U.S. T-Bills with ≤93 days maturity</td>
        <td className="px-6 py-4"><span className="text-green-600">●</span> Minimal</td>
      </tr>

      <tr>
        <td className="px-6 py-4 whitespace-nowrap">Government MMFs</td>
        <td className="px-6 py-4 whitespace-nowrap font-medium">15%</td>
        <td className="px-6 py-4">Government-only money market funds</td>
        <td className="px-6 py-4"><span className="text-green-600">●</span> Minimal</td>
      </tr>

      <tr>
        <td className="px-6 py-4 whitespace-nowrap">Overnight Repos</td>
        <td className="px-6 py-4 whitespace-nowrap font-medium">5%</td>
        <td className="px-6 py-4">Tri-party repo agreements</td>
        <td className="px-6 py-4"><span className="text-yellow-600">●</span> Low</td>
      </tr>
    </tbody>
  </table>
</div>

## 🔑 Key Features

<AccordionGroup>
  <Accordion title="Regulatory Compliance" icon="building-columns">
    * **Monthly Attestations**: CPA-signed reserve reports published on-chain
    * **Criminal Penalties**: C-suite officers face criminal liability for misreporting
    * **Segregated Accounts**: Customer assets held separately from corporate funds
  </Accordion>

  <Accordion title="Multi-Chain Support" icon="link">
    * **Native on StateSet**: Instant, low-cost transactions
    * **Base Integration**: Bridge to Coinbase's L2 network
    * **Solana Support**: High-speed DeFi integration
    * **Cosmos IBC**: Connect to 50+ IBC-enabled chains
  </Accordion>

  <Accordion title="Enterprise Features" icon="briefcase">
    * **Bulk Operations**: Issue/redeem millions in a single transaction
    * **Automated Compliance**: Built-in KYC/AML checks
    * **Audit Trail**: Complete transaction history and reporting
    * **White-Label API**: Custom branding for partners
  </Accordion>
</AccordionGroup>

## 📊 API Capabilities

### Core Operations

<CardGroup cols={2}>
  <Card title="Issue ssUSD" icon="plus-circle" href="/stablecoin/issue">
    Mint new ssUSD tokens upon receipt of USD. Requires issuer permissions.

    ```bash theme={null}
    POST /v1/stablecoin/issue
    ```
  </Card>

  <Card title="Redeem for USD" icon="minus-circle" href="/stablecoin/redeem">
    Burn ssUSD and receive USD via ACH/wire. T+1 settlement.

    ```bash theme={null}
    POST /v1/stablecoin/redeem
    ```
  </Card>

  <Card title="Transfer ssUSD" icon="arrow-right" href="/stablecoin/transfer">
    Send ssUSD between addresses. Supports single and batch transfers.

    ```bash theme={null}
    POST /v1/stablecoin/transfer
    ```
  </Card>

  <Card title="Check Balance" icon="wallet" href="/stablecoin/balance">
    Query ssUSD balance for any address across all supported chains.

    ```bash theme={null}
    GET /v1/stablecoin/balance/{address}
    ```
  </Card>
</CardGroup>

### Analytics & Compliance

<CardGroup cols={2}>
  <Card title="View Reserves" icon="shield-check" href="/stablecoin/reserves">
    Real-time reserve composition and historical data

    ```bash theme={null}
    GET /v1/stablecoin/reserves
    ```
  </Card>

  <Card title="Attestations" icon="file-certificate" href="/stablecoin/attestation">
    Access monthly CPA-signed reserve reports

    ```bash theme={null}
    GET /v1/stablecoin/attestations
    ```
  </Card>

  <Card title="Transaction History" icon="clock-rotate-left" href="/stablecoin/transactions">
    Query transaction history with advanced filtering

    ```bash theme={null}
    GET /v1/stablecoin/transactions
    ```
  </Card>

  <Card title="Analytics" icon="chart-line" href="/stablecoin/analytics">
    Supply metrics, velocity, and usage statistics

    ```bash theme={null}
    GET /v1/stablecoin/analytics
    ```
  </Card>
</CardGroup>

## 🚀 Quick Start Example

<CodeGroup>
  ```javascript Node.js theme={null}
  import { StateSet } from '@stateset/sdk';

  const stateset = new StateSet({
    apiKey: 'sk_test_...'
  });

  // Check ssUSD balance
  const balance = await stateset.stablecoin.balance({
    address: 'stateset1abc...'
  });

  // Transfer ssUSD
  const transfer = await stateset.stablecoin.transfer({
    to: 'stateset1xyz...',
    amount: '100.00',
    memo: 'Payment for invoice #123'
  });

  // View current reserves
  const reserves = await stateset.stablecoin.reserves();
  console.log(`Total reserves: $${reserves.total_usd}`);
  ```

  ```python Python theme={null}
  from stateset import StateSet

  stateset = StateSet(api_key='sk_test_...')

  # Check ssUSD balance
  balance = stateset.stablecoin.balance(
      address='stateset1abc...'
  )

  # Transfer ssUSD
  transfer = stateset.stablecoin.transfer(
      to='stateset1xyz...',
      amount='100.00',
      memo='Payment for invoice #123'
  )

  # View current reserves
  reserves = stateset.stablecoin.reserves()
  print(f"Total reserves: ${reserves['total_usd']}")
  ```

  ```bash cURL theme={null}
  # Check balance
  curl https://api.stateset.com/v1/stablecoin/balance/stateset1abc... \
    -H "Authorization: Bearer sk_test_..."

  # Transfer ssUSD
  curl -X POST https://api.stateset.com/v1/stablecoin/transfer \
    -H "Authorization: Bearer sk_test_..." \
    -H "Content-Type: application/json" \
    -d '{
      "to": "stateset1xyz...",
      "amount": "100.00",
      "memo": "Payment for invoice #123"
    }'
  ```
</CodeGroup>

## 💡 Use Cases

<Tabs>
  <Tab title="E-Commerce">
    ### Online Payments

    * Accept ssUSD for instant settlement
    * No chargebacks or payment reversals
    * Lower fees than credit cards
    * Global reach without currency conversion

    ```javascript theme={null}
    // Accept payment
    const payment = await stateset.payments.create({
      amount: 99.99,
      currency: 'ssusd',
      description: 'Premium subscription'
    });
    ```
  </Tab>

  <Tab title="Payroll">
    ### Instant Payroll

    * Pay employees instantly in ssUSD
    * Automated tax withholding
    * Multi-currency support
    * Detailed payment records

    ```javascript theme={null}
    // Batch payroll
    const payroll = await stateset.stablecoin.batchTransfer({
      transfers: employees.map(emp => ({
        to: emp.address,
        amount: emp.salary,
        memo: `Payroll ${month}`
      }))
    });
    ```
  </Tab>

  <Tab title="Treasury">
    ### Corporate Treasury

    * Hold reserves in stable, liquid assets
    * Earn yield on idle balances
    * Instant liquidity when needed
    * Full audit trail

    ```javascript theme={null}
    // Check reserves and yield
    const treasury = await stateset.stablecoin.treasuryStats({
      address: 'corporate_wallet'
    });
    ```
  </Tab>
</Tabs>

## 🔒 Security & Compliance

<Warning>
  All ssUSD operations require proper authentication and may be subject to compliance checks based on amount and jurisdiction.
</Warning>

### Security Features

* **Multi-signature wallets** for large transactions
* **Hardware security module (HSM)** key storage
* **Rate limiting** and fraud detection
* **Webhook signatures** for secure notifications

### Compliance Requirements

* **KYC/AML** verification for issuance/redemption
* **Transaction monitoring** for suspicious activity
* **Sanctions screening** via Chainalysis
* **Tax reporting** (1099 forms for US entities)

## 📈 Performance

<CardGroup cols={3}>
  <Card>
    <h3>\< 1 second</h3>
    <p>Transaction finality</p>
  </Card>

  <Card>
    <h3>10,000+ TPS</h3>
    <p>Network capacity</p>
  </Card>

  <Card>
    <h3>\$0.01</h3>
    <p>Average tx cost</p>
  </Card>
</CardGroup>

## 🆘 Support & Resources

<CardGroup cols={2}>
  <Card title="Integration Guide" icon="book" href="/guides/ssusd-integration">
    Step-by-step guide to integrate ssUSD
  </Card>

  <Card title="GitHub Examples" icon="github" href="https://github.com/stateset/ssusd-examples">
    Sample code and reference implementations
  </Card>

  <Card title="API Status" icon="signal" href="https://status.stateset.com">
    Real-time API status and uptime
  </Card>

  <Card title="Contact Sales" icon="phone" href="mailto:sales@stateset.com">
    Enterprise support and custom solutions
  </Card>
</CardGroup>