# Get yield snapshots by asset

Endpoint reference for the 1delta API. Index: https://docs.1delta.io/llms.txt · every endpoint: https://docs.1delta.io/llms-full.txt

---

### GET /v1/data/lending/yields/by-asset/snapshots

- operationId: `get-yield-snapshots-by-asset`
- docs: https://docs.1delta.io/1delta-api/get-yield-snapshots-by-asset/
- markdown: https://docs.1delta.io/1delta-api/get-yield-snapshots-by-asset.md
- tags: Yields

Get yield snapshots by asset

Returns historical yield time series grouped by asset for a given chain.

**Parameters**

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `chainId` | query | string | yes | Chain ID See the `ChainId` schema for the full set of supported chains. |
| `assets` | query | string[] | no | Filter by asset group keys (repeatable) |
| `lenders` | query | string[] | no | Filter by lender keys (repeatable) See the `LenderId` schema for the full set of accepted values. |
| `start` | query | string | no | ISO start date |
| `end` | query | string | no | ISO end date |

**Response `200`** — Yield snapshot data by asset

| Field | Type | Description |
| --- | --- | --- |
| `success` | true |  |
| `data` | object |  |
| `data.count` | integer | Number of entries in `items`. |
| `data.data` | object | Informational payload. `null` when the endpoint only builds calldata. |
| `actions` | null |  |

**Example response**

```json
{
  "success": true,
  "data": {
    "count": 1,
    "data": {}
  }
}
```

**Response `429`** — Rate limited. Unauthenticated callers share a per-IP budget; send an `x-api-key` header to lift it. Retry with exponential backoff.

**Response `500`** — Unexpected server error. Safe to retry with backoff.

**Response `502`** — An upstream data source or protocol origin failed (`error.code` is `ORIGIN_FAILED`). `error.details` carries the per-origin status. This is also what a missing or malformed required parameter currently returns, rather than a 400.