> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usexfg.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Deposits API

> RPC for HEAT CDs — list, mature, rollover, withdraw.

CDs lock **HEAT**. Mint HEAT first (`mintHeatV10`). COLD / XFG-deposit types are removed.

## GET /getdeposits

**Request:** `{}`

**Response (shape):**

```json theme={null}
{
  "deposits": [
    {
      "id": 0,
      "amount": 100000000,
      "term": 5400,
      "unlock_height": 181000,
      "creating_tx_hash": "abc123...",
      "deposit_type": "HEAT"
    }
  ],
  "status": "OK"
}
```

| Field          | Description                                                       |
| -------------- | ----------------------------------------------------------------- |
| `amount`       | Atomic units (`COIN = 1e7`)                                       |
| `term`         | Term in **blocks** (or wallet-normalized epochs — check response) |
| `deposit_type` | **`HEAT`** for CDs; mint/burn markers are not yield CDs           |

***

## GET /get\_maturing\_deposits

```json theme={null}
{
  "current_height": 0,
  "maturing_in": 0
}
```

`maturing_in: 0` → already mature only.

***

## POST /rollover\_deposit

Claims interest and opens a new HEAT CD for principal + interest.

```json theme={null}
{
  "deposit_id": "0",
  "new_term": 6
}
```

`new_term` in epochs (6–72 mainnet).

***

## Mint vs CD

| RPC / method                         | Purpose              |
| ------------------------------------ | -------------------- |
| `mintHeatV10` / HEAT mint wallet RPC | Burn XFG → mint HEAT |
| create deposit (term ≠ HEAT\_TERM)   | Lock HEAT as CD      |

Do not document `deposit_type: "COLD"` as current.