# Get vault rate history

`GET /api/vaults/{vault}/rates/{timeframe}`

## Authorization



## Parameters

- path: vault (string; required). 

Type: string

Example: "0:72c310c83de5060d21674d58379b9a153854338a63d82588f8d912f83a3f8660"

- path: timeframe (string · enum; required). 

Type: string · enum

Allowed values: ["week","month","year"]

## Example · cURL

```bash
curl --request GET 'https://api.storm.tg/api/vaults/{vault}/rates/{timeframe}' \
  --header 'Accept: application/json'
```

## Example · JavaScript

```javascript
const response = await fetch("https://api.storm.tg/api/vaults/{vault}/rates/{timeframe}", {
  method: "GET",
  headers: {
    "Accept": "application/json"
  },
});
console.log(response.status, await response.text());
```

## Example · Python

```python
import requests

response = requests.request(
    "GET",
    "https://api.storm.tg/api/vaults/{vault}/rates/{timeframe}",
    headers={"Accept":"application/json"},
    timeout=30,
)
print(response.status_code, response.text)
```

## Response 200 · Data.VaultRatesResponse

**200** application/json — Response

Schema: Data.VaultRatesResponse

Type: object

Required fields: roiPercentage, history

Required field types: roiPercentage (string · int64; required), history (object[]; required)

- roiPercentage (string · int64; required)

roiPercentage example: 0

roiPercentage.Type: string · int64

roiPercentage.format: int64

roiPercentage.pattern: ^(0|-?[1-9][0-9]*)$

- history (object[]; required)

history example: [
  {
    "timestamp": "2026-01-01T00:00:00Z",
    "value": "0",
    "balance": "0"
  }
]

history.Type: object[]

history.[]Type: object

history.[]Required fields: timestamp, value, balance

history.[]Required field types: timestamp (string · date-time; required), value (string · int64; required), balance (string · int64; required)

- history.[]timestamp (string · date-time; required)

history.[]timestamp example: 2026-01-01T00:00:00Z

history.[]timestamp.Type: string · date-time

history.[]timestamp.format: date-time

- history.[]value (string · int64; required)

history.[]value example: 0

history.[]value.Type: string · int64

history.[]value.format: int64

history.[]value.pattern: ^(0|-?[1-9][0-9]*)$

- history.[]balance (string · int64; required)

history.[]balance example: 0

history.[]balance.Type: string · int64

history.[]balance.format: int64

history.[]balance.pattern: ^(0|-?[1-9][0-9]*)$

Example



```json
{
  "roiPercentage": "0",
  "history": [
    {
      "timestamp": "2026-01-01T00:00:00Z",
      "value": "0",
      "balance": "0"
    }
  ]
}
```