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

# Residual Value

> API docs for querying Forward Residual Value historical data

## <span style={{ color: 'white', fontWeight: 'bold', backgroundColor: '#007BFF', border: '2px solid #007BFF', borderRadius: '5px', padding: '5px', display: 'inline-block' }}>POST</span> /api/forward-residual/value

Get historical residual values.

### Authorization

**🔒OAuth2**: OAuth2PasswordBearer\
**Flow type**: password\
**Token URL**: token

### Request Body

The request body must be in `application/json` format. All fields are optional. An empty body `{}` returns all supported GPUs from the default history start through today.

| Field           | Type            | Required | Description                                   | Constraints         |
| --------------- | --------------- | -------- | --------------------------------------------- | ------------------- |
| `starting_date` | string          | No       | Start date of the range, in YYYY-MM-DD format | Inclusive           |
| `ending_date`   | string          | No       | End date of the range, in YYYY-MM-DD format   | Inclusive           |
| `gpu_list`      | array of string | No       | List of GPU types to query                    | \[A100, B200, H100] |

### Request Example

```json theme={null}
{
  "starting_date": "2026-06-01",
  "ending_date": "2026-06-30",
  "gpu_list": ["H100", "B200"]
}
```

To request one specific date, set both dates to the same value:

```json theme={null}
{
  "starting_date": "2026-06-15",
  "ending_date": "2026-06-15",
  "gpu_list": ["H100"]
}
```

### Responses

Response consists of meta and data, where:

* meta is the metadata regarding the request. `code` in `meta` indicates the error code of the request, with 0 indicating no error.
* Dates are inclusive.
* Values are four-decimal strings.
* Missing dates or GPU keys mean no observation; they must not be treated as zero.

```json theme={null}
{
  "meta": {
    "code": 0,
    "url": "/api/forward-residual/value",
    "message": "OK",
    "timestamp": 1748908800
  },
  "data": {
    "starting_date": "2026-06-01",
    "ending_date": "2026-06-30",
    "data": {
      "H100": {
        "2026-06-01": "0.3761",
        "2026-06-02": "0.3714"
      }
    }
  }
}
```