# Market rate trends (GET /rate-trends)

Source: DepositScout Data API docs — https://depositscout.com/developers/docs/rate-trends

How average rates have moved over time by account type.

---

- **Cost:** 5 DS Credits per request
- **Scope:** `history:read`
- **Same data as:** `/api/rate-trends` on the DepositScout website

**Test keys only for now.** This endpoint returns sample data to test keys; a live key gets `403 endpoint_restricted` and is not charged. When it opens it will cost 5 DS Credits per request. Early access: <mailto:api@depositscout.com>.

## Request

GET https://depositscout.com/api/developer/v1/rate-trends

No parameters.

## Example

**curl**

```bash
curl "https://depositscout.com/api/developer/v1/rate-trends" \
  -H "Authorization: Bearer $DS_API_KEY"
```

**Node**

```javascript
const res = await fetch("https://depositscout.com/api/developer/v1/rate-trends", {
  headers: { Authorization: `Bearer ${process.env.DS_API_KEY}` },
});
const { data, meta } = await res.json();
console.log(meta.creditsCharged, data);
```

**Python**

```python
import os, requests

res = requests.get(
    "https://depositscout.com/api/developer/v1/rate-trends",
    headers={"Authorization": f"Bearer {os.environ['DS_API_KEY']}"},
)
body = res.json()
print(body["meta"]["creditsCharged"], body["data"])
```

## Response

`data` is a single object. Every 2xx also sets `X-DS-Request-Id`, `X-DS-Credits-Charged`, `X-DS-Credits-Balance`, the `X-RateLimit-*` trio and an `ETag`.

```json
{
  "data": {
    "…": "the item"
  },
  "meta": {
    "requestId": "req_7f3a9c2d1b4e5a6f7c8d",
    "generatedAt": "2026-09-21T09:00:00.000Z",
    "creditsCharged": 5,
    "creditsBalance": 199,
    "attribution": "Rates powered by DepositScout — depositscout.com"
  }
}
```

**Provider logos:** `series[].providerLogoUrl`. An absolute, public HTTPS URL for the provider's logo that you can load directly (usually SVG; PNG or JPG for a few providers), or null when the provider has no logo.

Errors follow the [shared error contract](https://depositscout.com/developers/docs#errors). Back to [all endpoints](https://depositscout.com/developers/docs#endpoints).