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

# List strategy versions

> Returns the strategy's allocation version history, newest first.

Returns the strategy's allocation version history. Versions are immutable —
once published, a version's allocation never changes. Use this endpoint to
inspect history and identify the active version.

* Auth: `x-api-key` header (required)
* Required scope: `strategies:read`

### Response

Each entry contains:

* `version` — sequential integer, server-assigned. `1` at create; each
  publish increments by 1.
* `allocation` — assets and weights for that version.
* `changeLog` — optional note from the publish call; `null` when not
  provided.
* `isHead` — `true` for the active version. Exactly one per strategy.
* `createdAt` — ISO 8601 timestamp.

### Pagination

Cursor-paginated, newest first. Pass the previous response's `nextCursor`
verbatim as the next request's `?cursor=`. Default `limit=50`, max `200`.

### Cross-tenant access

Returns `404` — strategies you don't own are not exposed.

<RequestExample>
  ```bash cURL — first page theme={null}
  curl --request GET \
    --url 'https://api.glider.fi/v2/strategies/01JWZEE2MF30KVRMRX53N88VA4/versions' \
    --header 'x-api-key: gldr_sk_your_api_key'
  ```

  ```bash cURL — next page theme={null}
  curl --request GET \
    --url 'https://api.glider.fi/v2/strategies/01JWZEE2MF30KVRMRX53N88VA4/versions?cursor=<nextCursor>' \
    --header 'x-api-key: gldr_sk_your_api_key'
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    "https://api.glider.fi/v2/strategies/01JWZEE2MF30KVRMRX53N88VA4/versions",
    { headers: { "x-api-key": "gldr_sk_your_api_key" } },
  );
  const { data, nextCursor } = await response.json();
  const head = data.versions.find((v) => v.isHead);
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "data": {
      "versions": [
        {
          "version": 3,
          "allocation": {
            "assets": [
              {
                "assetId": "eip155:1/erc20:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
                "weight": "100"
              }
            ]
          },
          "changeLog": "Switched to USDC-only",
          "isHead": true,
          "createdAt": "2026-04-29T12:00:00.000Z"
        },
        {
          "version": 2,
          "allocation": {
            "assets": [
              {
                "assetId": "eip155:1/erc20:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
                "weight": "50"
              },
              {
                "assetId": "eip155:1/erc20:0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
                "weight": "50"
              }
            ]
          },
          "changeLog": null,
          "isHead": false,
          "createdAt": "2026-03-01T12:00:00.000Z"
        }
      ]
    },
    "nextCursor": null
  }
  ```
</ResponseExample>